Developing Hieroglyph

Hieroglyph uses Buildout to manage dependencies and development.

  1. Check out the repository:

    $ git clone
  2. Bootstrap and run buildout:

    $ python
    $ ./bin/buildout

After running Buildout, you can run ./bin/python to execute an interpreter with Hieroglyph and its dependencies installed.

Running Tests

The unit tests can be run via

$ ./bin/python test

Tox can be used to run the tests with both Python 2 and 3. The Tox configuration will run the tests with Sphinx 1.1.x, Sphinx 1.2.x, and the development branch. Note that Hieroglyph requires Tox 1.8.

$ tox

Jasmine Tests for Javascript

There are some Jasmine tests in src/jstests that test theme Javascript functionality. You can open src/jstests/SpecRunner.html in your browser to run those. Alternately, you can install the jasmine gem to do so.

If you have Bundler installed, get started by installing the necessary gems:

$ bundle install

Then run the tests using rake:

$ rake jasmine:ci JASMINE_CONFIG_PATH=./src/jstests/jasmine.yml