0.03
No commit activity in last 3 years
No release in over 3 years
Slide'em up is a presentation tool that displays markdown-formatted slides
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

~> 2.3

Runtime

~> 2.7
= 1.0.2
~> 2.1
~> 1.1
 Project Readme

Slide'em up

Slide'em up is a presentation tool. You write some slides in markdown, choose a style and it displays it in HTML5. With a browser in full-screen, you can make amazing presentations!

How to do your first presentation with Slide'em up?

  1. Install slide-em-up: gem install slide-em-up

  2. Create a directory for your presentation: mkdir foobar && cd foobar

  3. Create a section for your slides: mkdir main

  4. Write some slides: vim main/slides.md

    !SLIDE
    # My First slide #
    It's awesome
    
    !SLIDE
    # My second slide #
    This rocks too!
    
  5. Write the presentation.json file with the metadata:

    {
      "title": "My first presentation",
      "theme": "CSSS",
      "duration": 20,
      "sections": {
          "main": "Title of my main section"
      }
    }
    
  6. Launch the tool: slide-em-up

  7. Open your browser on http://localhost:9000/

  8. Use the arrows keys to navigate between the slides

Themes

Several themes are available: io2012, shower, 3d_slideshow, reveal, html5rocks, CSSS and memories. To choose the theme for your presentation, edit the presentation.json file and change the "theme" element.

You can also create your own theme, for example, by copying the template:

mkdir -p ~/.slide-em-up
cp -r themes/template ~/.slide-em-up/my-theme
$EDITOR ~/.slide-em-up/my-theme/README

Markup for the slides

This slides are writen in Markdown and !SLIDE is the indicator for a new slide.

Example:

!SLIDE
# Title of the first slide #
## A subtitle ##
And some text...

!SLIDE
# Another slide #

* a
* bullet
* list

!SLIDE
# Third slide #

1. **bold**
2. _italics_
3. https://github.com/

Syntax Highlighting

To highlight some code in your slides, you have to install pygments. Then, surround your code with backticks like this:

```ruby
class Foobar
  def baz
    puts "Foobar says baz"
  end
end
```

Remote Control

When your start slide-em-up in console, a message says something like:

Your remote key is 652df

This remote key can be used to send actions to browsers that display the presentation. For example, this command goes to the next line:

curl http://localhost:9000/remote/652df/next

The last part of the URL is the action and can be next, prev, up or down.

It's also possible to force slide-em-up to use a specific remote key by setting the APIKEY environment variable:

APIKEY=foobar slide-em-up

Export to PDF

You can export your presentation to PDF by installing phantomjs and then run slide-em-up2pdf.

Examples

I'm using slide-em-up for my own presentations, so you can find some real slides powered by slide-em-up on https://github.com/nono/Presentations.

For example, you can try the presentation "Welcome to the nice world of Golang" on http://blog.menfin.info/Presentations/20120709_Golang_introduction/ and see the sources of it on https://github.com/nono/Presentations/tree/master/20120709_Golang_introduction.

Issues or Suggestions

Found an issue or have a suggestion? Please report it on Github's issue tracker.

If you wants to make a pull request, please check the specs before:

bundle exec spec/slide-em-up_spec.rb

Credits

Scott Chacon is the guy who made ShowOff. Slide'em up is only a copy of ShowOff with multiple themes and sinatra replaced by Goliath.

Themes were picked from the internet. Thanks to:

  • Hakim El Hattab for 3d_slideshow and reveal
  • Google for html5rocks
  • Vadim Makeev for shower
  • Lea Verou for CSSS (and its modified version, memories)
  • Google for io2012

♡2011 by Bruno Michel. Copying is an act of love. Please copy and share. Released under the MIT license