Statirator

Multilingual static site and blog generator.

Reason

• Needed good multilingual static site generator, which enables:

  • Blog posts in reStructuredText_
  • Single resource (file) for all the translations of that post or page
  • Explicitly specifying slug for various non-Latin links in addition to posts (e.g: Tag names, pages, etc.)
  • Separate RSS feeds for each language and each tag/language
  • Keeps reference between the translations
  • Optional Multi-domain support - One for each language (TODO)
  • Translated elements in pages

• No need to reinvent the wheel:

  • Many know Django_, we can reuse the knowledge
  • Make use of reusable apps
  • Hack around i18n bits of Django_.
  • Use Django_'s Internationalization and localization_

For users

See the Statirator documentation_ at Read the Docs.

.. _Statirator documentation: https://statirator.readthedocs.org/en/latest/

For developers:

• Create a virtualenv (python2 till django moves to 3)
• Clone the repo
• run python setup.py develop

To build the docs:

• install Sphinx_
• cd docs; make html

.. _Sphinx: http://sphinx.pocoo.org/ .. _Django: https://www.djangoproject.com/ .. _Internationalization and localization: https://docs.djangoproject.com/en/1.4/topics/i18n/ .. _reStructuredText: http://docutils.sourceforge.net/rst.html