e297b1a477
Makes it easier to contribute and accept translations.
Does add a new dependency on installation from source, polib. This is
not made mandatory because not all users will want translations.
polib has no further dependencies and can be installed anywhere
LinkChecker can, using pip too.
Add release process step to check polib is installed
The Wheel still includes translations. Recommend install from PyPI in
the README.
Translations were being compiled in setup.py until 2014, using a bundled
copy of msgfmt.py.
9c3739f1c ("Replace msgfmt.py with local tools.", 2014-09-08)
1.2 KiB
LinkChecker Translations
Translations for the application are stored in po/. Translations for the man pages are stored in doc/.
Application Translations
Makefiles using GNU gettext utilities are provided to manage .po and .pot files.
If the strings in the application change, update the .pot and .po files:
linkchecker/po $ rm linkchecker.pot; make
Do make a commit at this point.
Translation progress and validity can be monitored with:
linkchecker/po $ make check
.mo files are not stored in the repository and are created on building, using polib.
Man Page Translations
Sphinx is used to generate .pot and .po (with sphinx-intl) files in i18n/ and man pages in man/.
Create man.pot file in i18n/gettext/:
linkchecker/doc $ make -C src gettext
Create man.po file in i18n/locales/:
linkchecker/doc/src $ sphinx-intl update -p ../i18n/gettext -l de
These two steps can be performed with:
linkchecker/doc $ make locale
Create man pages:
linkchecker/doc $ make man
After updating the source files all steps need to be repeated, if translations alone have been changed in the .po file only the last step is needed.