Це стара версія документу!
Для применения перевода текста в формате ReST при помощи Sphinx1), понадобится дополнительная программа 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-файлах. Существует много программ для удообного редактирования такого формата.2)
После перевода можно собрать переведённый проект:
sphinx-build -b html -Dlanguage='uk' ./ ../project-build/