markuszoeller / hieroglyph

Generate HTML presentations from plain text sources with all the power of Sphinx.

Home Page:http://hieroglyph.io

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Hieroglyph

https://api.travis-ci.org/nyergler/hieroglyph.png?branch=master https://coveralls.io/repos/nyergler/hieroglyph/badge.png?branch=master

Hieroglyph is an extension for Sphinx which builds HTML presentations from ReStructured Text documents.

Installing

You can install Hieroglyph using easy_install or pip:

$ pip install hieroglyph

You can also install the latest development version, which may contain new features:

$ pip install git+https://github.com/nyergler/hieroglyph#egg=hieroglyph

Hieroglyph supports Sphinx 1.4 and later, and Python 2.7 and 3.6.

Using Hieroglyph

You can start a new Hieroglyph presentation using the included quickstart script:

$ hieroglyph-quickstart

This will generate the Sphinx configuration, along with an optional Makefile and batch file, with Hieroglyph enabled.

If you're on something UNIX-like (Linux, Mac OS X, etc), you can then generate your slides by running make:

$ make slides

You can also add Hieroglyph as a Sphinx extension to your existing configuration:

extensions = [
    'hieroglyph',
]

Read the documentation for all the details about using, configuring, and extending Hieroglyph.

Connect

You can connect with other Hieroglyph users and the developers via the hieroglyph-users email list (Google Groups). A Gmane archive is also available.

License

Hieroglyph is made available under a BSD license; see LICENSE for details.

Included slide CSS and JavaScript originally based on HTML 5 Slides and io-2012-slides projects licensed under the Apache Public License.

About

Generate HTML presentations from plain text sources with all the power of Sphinx.

http://hieroglyph.io

License:BSD 3-Clause "New" or "Revised" License


Languages

Language:JavaScript 41.6%Language:Python 33.0%Language:CSS 20.0%Language:HTML 5.3%Language:Ruby 0.2%