https://github.com/MeirKriheli/statirator

Multilingual static site and blog generator
https://github.com/MeirKriheli/statirator

Last synced: 3 months ago
JSON representation

Multilingual static site and blog generator

• Host: GitHub
• URL: https://github.com/MeirKriheli/statirator
• Owner: MeirKriheli
• License: mit
• Archived: true
• Created: 2011-04-27T18:47:17.000Z (over 13 years ago)
• Default Branch: master
• Last Pushed: 2018-08-22T08:58:28.000Z (about 6 years ago)
• Last Synced: 2024-05-03T06:24:41.936Z (7 months ago)
• Language: Python
• Homepage:
• Size: 254 KB
• Stars: 24
• Watchers: 4
• Forks: 2
• Open Issues: 9
• Metadata Files:
  • Readme: README.rst
  • Changelog: CHANGES.txt
  • License: LICENSE.txt

Awesome Lists containing this project

README

        
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