Static site generator
Clone or download
piranha Merge pull request #7 from cxong/master
Travis CI and some fixes
Latest commit 4b20825 Oct 25, 2018
Type Name Latest commit message Commit time
Failed to load latest commit information.
content Make urls usage for cyrax more consistent: Apr 24, 2010
cyrax Fix smartypants Oct 24, 2018
docs support glob patterns in exclude list Oct 11, 2016
.gitignore ignore file Aug 16, 2011
.travis.yml Create .travis.yml Oct 24, 2018
LICENSE switch to ISC license Oct 5, 2016
README.rst 2.7 Oct 11, 2016 Add markdown dependency Oct 24, 2018



Cyrax is a static site generator using Jinja2 template engine.

It's inspired by Jekyll and Hyde site generators and started when I realized that I'm dissatisfied with both of them for different reasons. When I tried to come up with name I remembered my favourite character from Mortal Kombat 3 so here we go.


Well, it's quite simple, as usually:

pip install cyrax

Cyrax depends on the Jinja2 template library, so you can install it through your OS package system (in other case pip will install it automatically).

Note, please, that in order to use parsers like markdown, or reST, or textile, corresponding libraries should be installed (either python-markdown or python-markdown2 are good enough for markdown).


Read some docs, run cyrax --help to read about command line options, look at example site.

Also it's really easy to extend Cyrax, see an example.


Indeed something happens with each release and you are probably interested what (and too lazy to read changelog).

2.7 (11.10.2016)

  • support for globs in exclude in settings.cfg

2.6 (10.10.2016)

  • make Jinja2 do extension available in templates

2.4-2.5 (16.08.2011)

  • drop unused dependency on cherrypy
  • make rst render start with h2 in inner sections

2.3 (28.12.2010)

  • rework RstPost a bit, removing nasty bugs with template caching

2.1-2.2 (21.12.2010)

  • nasty bug with circular dependecies
  • forget to process tags in RstPost

2.0 (18.12.2010)

  • refactored module system, no more cyraxlib, only cyrax now exists
  • completely refactored internal models system, now it uses usual inheritance instead of some strange composition (which means it's easier to understand and to extend now)
  • ability to write posts in reStructuredText (which as well could serve as an example to writing your own models).

1.0-1.1 (28.11.2010)

  • now most of urls generated on page (by function url_for) are relative to current page, which means that you mostly can view your site without using web-server (though you'll need to click on index.html yourself :)
  • some docs, heh. This part needs attention anyway