本地化文档¶
Sphinx支持使用gettext以支持项目的本地化。gettext是本地化常用的一个标准。
下图是一个Sphinx本地化的大致流程:
以下是具体操作方法:
用
pip install sphinx-intl
命令安装sphinx-intl。在conf.py文件中添加以下配置::
locale_dirs = ['locale/'] # path is example but recommended. gettext_compact = False # optional.
生成gettext的pot文件::
make gettext
创建或者更新locale文件夹,这里我们可以指定目标语言::
sphinx-intl update -p _build/gettext -l en
翻译上一步在locale/en/LC_MESSAGES文件夹下生成的po文件。
生成翻译的文档::
make -e SPHINXOPTS="-D language='en'" html
或者直接使用 sphinx-build 来生成在指定文件夹::
sphinx-build -M html source en -D language=en