This guide is intended to run on Linux, preferably with aptitude and in Debian (tl;dr you have Ubuntu)
I suggest you check out the Guide to Setting Up Linux if you want to do this.
However, it CAN still work, provided that you have all the stuff needed here. It would work because showoff, git and gem have their respective Windows versions.
(Ruby and RubyGems in particular, and if your path to RubyGems is correct.)
Prerequisites....
- You have Ruby and RubyGems and is set up.
- Heroku is set up.
- Git is set up properly (SSH keys and all that).
Pointers...
- Get showoff and its dependencies
- Make your showoff presentation
- Deploy to Heroku
- Finish!
Procedure
Once again, Linux only! However, there are ways to do this in Windows. That's what the pointers are for.
<name> refers to the name of your presentation. It's up to you.
I. Getting showoff
-
Open up a terminal
-
Showoff requires Nokogiri. To do that:
-
sudo apt-get install libxslt-dev libxml2-dev
-
sudo gem install nokogiri
-
Type gem install showoff. Use sudo when necessary.
- Done. If you enter showoff, you should get something like this.
II. Make your showoff presentation
Initialize Showoff
- Create a showoff presentation. Use showoff create <name>
- This will create a folder with the presentation stuff in it. It's a starter presentation that you can use.
- Go to your presentation folder. (cd <folder name>, or open it as usual)
- Initialize Git. (git init)
Have fun
You should have new stuff from here on out. You'll get these files:
- showoff.json - a file showoff refers to when you run it. You can customize the slide title and sections here. (think: manifest)
- one - a folder for your slides
- .git - the git folder, ignore it.
You can open any of these files through a text editor like gedit.
I'll only explain up to there. Read up on how markdown files work on showoff. It's in showoff's GitHub repo.
Running your slideshow
- Go back to the terminal.
- Enter showoff serve.
- When it shows the line with HTTPServer#Start, open your web browser then go to http://localhost:9090/
- You should see your presentation there.
- To end your slideshow and continue using the terminal again, press CTRL+C
III. Deploy to Heroku
- Enter showoff heroku <name>. You'll get these:
- heroku create <name>
- git add .gems config.ru
- git commit -m 'herokuized'
- git push heroku master
- Done!
- If it fails, try doing this after performing the commands above:
- git add .
- git commit -m 'this one adds all files'
- git push heroku master