Hieroglyph is an extension for Sphinx which builds HTML5 slides from ReStructured Text documents.
This document provides a basic overview of Hieroglyph; dive deeper with the following documents:
Add Hieroglyph as a Sphinx extension to your configuration:
extensions = [
'hieroglyph',
]
Build your slides:
$ sphinx -b html5slides output/slides
You make optionally want to add the following to your Makefile:
slides:
$(SPHINXBUILD) -b slides $(ALLSPHINXOPTS) $(BUILDDIR)/slides
@echo "Build finished. The HTML slides are in $(BUILDDIR)/slides."
dirslides:
$(SPHINXBUILD) -b dirslides $(ALLSPHINXOPTS) $(BUILDDIR)/slides
@echo "Build finished. The HTML slides are in $(BUILDDIR)/slides."
(Don’t forget, Makefiles love tabs!)
Slides are just HTML, so you can write CSS to style them, either individually or as a whole
You can add a custom CSS file to most themes by adding a custom_css theme options:
slide_theme_options = {'custom_css':'custom.css'}
Custom CSS files are contained in your documentation’s static files directory (usually _static)
Hieroglyph includes two themes:
slides
Two slides levels: the first level of headers become “section” headers, and the second become the real content.
single-level
Only one style of slide, every slide has a title at the top.
See Styling Slides for more information on using themes and writing your own.
Hieroglyph has some configuration dials you can turn to customize the output. In addition to the theme, you can configure:
See Hieroglyph Configuration for more information.
Hieroglyph is made available under a BSD license; see LICENSE for details.
Included slide CSS and javascript licensed under the Apache Public License. See http://code.google.com/p/html5slides/.