Це стара версія документу!

Локализация

Для применения перевода текста в формате ReST при помощи Sphinx¹⁾, понадобится дополнительная программа sphinx-intl.

Сначала нужно извлечь все подлежащие переводу строки из исходных файлов в соответствующие POT-файлы:

cd project-src
sphinx-build -b gettext ./ ../project-build/gettext

Затем сгенерировать из них PO-файлы для нужных языков:

sphinx-intl update -p ../project-build/gettext/ -l ru -l uk

После чего можно приступать к их переводу в полученных PO-файлах. Существует много программ для удообного редактирования такого формата.²⁾

После перевода можно собрать переведённый проект:

sphinx-build -b html -Dlanguage='uk' ./ ../project-build/

Ссылки

¹⁾

²⁾