翻译文档¶

如果你想帮助我们本地化Salt文档, 请访问 Transifex 网站并 `signup`_ 一个账户.

一旦注册完成, 请访问 `Salt Translation Project`_ , 如果没有找到你所需的语言, 请点击 Request Language. 如果想贡献的语言已存在, 点击 Join Team .

Transifex 在他们的 support domain 中提供了一些有用的阅读资源, 即 `directed to translators`_ 中就有一些非常有用的文章.

建立一个本地化版本的文档¶

在 Transifex 上进行翻译的同时, 你可以想看看它的翻译情况.

想与 Transifex web服务交互, 你需要安装 `transifex-client`_ :

pip install transifex-client

安装完毕后, 你需要在你的电脑上进行配置. 我们创建了一个脚本帮你完成这些工作:

.scripts/setup-transifex-config

有一个简单的脚本来完成下载远程翻译的工作(该脚本比之前的要简单的多.) 因此, 假设你在翻译葡萄牙语 (对应的语言代码是 pt_PT) . 切换到Salt检出的 doc/ 目录, 运行下载翻译操作:

make download-translations SPHINXLANG=pt_PT

To download pt_PT, Portuguese(Portugal), and nl, Dutch, you can use the helper script directly:

.scripts/download-translation-catalog pt_PT nl

在下载操作完成后, 下一步将进行生成本地化文档版本. 依然以 pt_PT 为例:

make html SPHINXLANG=pt_PT

打开你的浏览器, 访问本地化文档路径, 去检查刚刚生成的本地化文档.