mirror of
https://github.com/Hopiu/linkchecker.git
synced 2026-05-24 22:23:43 +00:00
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)
48 lines
1.2 KiB
Markdown
48 lines
1.2 KiB
Markdown
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.
|