本仓库为 Optuna 文档的的简体中文翻译。我们通过 sphinx-intl 来进行翻译。
克隆仓库到本地,并创建一个新分支。
安装依赖(这一步推荐在虚拟环境下进行):
pip install -r requirements.txt
生成当前版本的翻译文件:
sphinx-intl update -p build/locale -l zh_CN
在 requirements.txt
中修改 Optuna 到想要的版本号。
安装新版的 Optuna:
pip install -r requirements.txt
克隆 Optuna 的主仓库 到本地。
将 Optuna 的主仓库 reset 到你准备更新的版本发布的 commit。
将 Optuna 主仓库内的 doc/source
目录下的除 config.py
之外的所有文件拷贝到此仓库的 source
目录下,覆盖当前文件。
更新翻译文件:
make gettext
sphinx-intl update -p build/gettext -l zh_CN
更新翻译
.po
文件的变动#, fuzzy
的行进行修改(注意,通常情况下请忽略每个文件开头的 #, fuzzy
)msgstr ""
并对它们进行翻译 (msgstr ""
代表需要翻译但是没完成翻译的句子, 但是多行翻译也会存在首行为 msgstr ""
的情况,这时不一定代表翻译没完成)生成更新后的文档的静态网页,检查是否有错:
make -e SPHINXOPTS="-Dlanguage='zh_CN'" html
确认无误后,在当前分支提交修改并创建 PR,等待更新被 merge 到主分支中。