README.rst

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.

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