ablog/docs/i18n.rst

34 lines
1.3 KiB
ReStructuredText

Add i18n to ablog
=================
ABlog automatically generates certain strings like "Recent posts",
"Categories". If these strings appear in English on your blog although you specified another language, then this page is for you.
These strings need to be translated. Ablog needs your help.
.. _extract_messages: http://babel.edgewall.org/wiki/Documentation/setup.html#extract-messages
.. _init_catalog: http://babel.edgewall.org/wiki/Documentation/setup.html#init-catalog
.. _update_catalog: http://babel.edgewall.org/wiki/Documentation/setup.html#update-catalog
- extract_messages_ must run each time you changed some translatable
message texts::
$ python setup.py extract_messages -o ablog/locale/sphinx.pot
...
This will create a file :xfile:`ablog/locale/sphinx.pot`, the
central messages catalog used by the different translations.
- init_catalog_ must run after extract_messages_ once for each *new* language::
$ python setup.py init_catalog -l de -i ablog/locale/sphinx.pot -o ablog/locale/de/LC_MESSAGES/sphinx.po
This will create a file :xfile:`ablog/locale/de/LC_MESSAGES/sphinx.po`.
- update_catalog_ must run after extract_messages_ for each existing
language::
$ python setup.py update_catalog -l de -i ablog/locale/sphinx.pot -o ablog/locale/de/LC_MESSAGES/sphinx.po