参考

命令

键入 sphinx-intl，不带参数，选项显示命令帮助。

环境变量

所有的命令行选项都可以用环境变量来设置，格式为 SPHINXINTL_<UPPER_LONG_NAME>。破折号（-）必须用下划线（_）代替。

例如，要设置语言

export SPHINXINTL_LANGUAGE=de,ja

这和直接把选项传给 sphinx-intl 一样

sphinx-intl <command> --language=de --language=ja

Sphinx conf.py

如果下面的设置不存在，请添加到 Sphinx 文档的 conf.py 中

locale_dirs = ['locale/']   #for example
gettext_compact = False     #optional

Makefile / make.bat

make gettext 会在 _build/gettext 目录下生成 pot 文件，但是如果将 pot 文件生成到 locale/pot 目录下会更方便。你可以通过把 _build/gettext 替换成 locale/pot 在你的 Makefile 和/或由 sphinx-quickstart 生成的 make.bat 中实现。