Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Generate a slideshow using the slides that power the html5-slides presentation
Python
branch: master

This branch is 6 commits ahead, 371 commits behind n1k0:master

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
.gitignore
README.md
base.html
render.py
slides.md

README.md

html5-slides-markdown

Generates a slideshow using the slides that power the html5-slides presentation.

A sample slideshow is here.

News

06/11/10 - Current slideshows will need to be updated. As of tonight's changes (48024cfe), title slides are rendered like any other. This means that you must render them to an h1 element (# or = below). This is cleaner and more consistent.

Requirements

python and the following modules:

  • jinja2
  • markdown
  • pygments

Markdown Formatting Instructions

  • To create a title slide, render a single h1 element
  • Separate your slides with a horizontal rule (--- in markdown)
  • Your other slides should have a heading that renders to an h1 element
  • To highlight blocks of code, put !{{lang}} as the first indented line
  • See the included slides.md for an example

Rendering Instructions

  • Put your markdown content in a file called slides.md
  • Run python render.py (or ./render.py)
  • Enjoy your newly generated presentation.html

Options

Several options are available using the command line:

$ ./render.py --help
Usage: render.py [options]

Options:
  -h, --help            show this help message and exit
  -s FILE, --source=FILE
                        The path to the markdown source file
  -d FILE, --destination=FILE
                        The path to the to the destination
  -t FILE, --template=FILE
                        The path to the to the Jinja2 template file
  -e ENCODING, --encoding=ENCODING
                        The encoding of your files (defaults to utf8)

TODO

  • Test CSS for all Markdown features

Thanks

  • Nicolas Perriault (n1k0)
  • Vincent Agnano (Particules)
  • Brad Cupit (bradcupit)
Something went wrong with that request. Please try again.