搭建Python官方文檔翻譯環境-漢化示例代碼

通過官方i18n流程, 實現文檔中的代碼段的漢化, 效果如下(4. More Control Flow Tools):

步驟

基於python官方3.6版文檔cpython/Doc生成pot文件. 參考The build configuration file, 需要在Doc/conf.py中添加配置:

gettext_compact = False
gettext_additional_targets = ['literal-block']

如下命令在_build文件夾中生成pot文件, 如果不設置gettext_compact就不能生成對應路徑結構(所有tutorial中文檔的可翻譯字段都在一個pot文件)

$ sphinx-build -M gettext . _build

如下命令生成對應po文件(參考Internationalization - Sphinx 1.8.0+ documentation):

$ sphinx-intl update -p _build/gettext -l zh

修改構建腳本: 實現代碼段翻譯. use gettext_additional_targets to translate code samples in … · nobodxbodon/docsbuild-scripts@68e7578)

按照README運行後, 即在www文件夾中生成漢化後的文檔

相關代碼庫

文檔構建腳本庫: nobodxbodon/docsbuild-scripts

po文件庫: nobodxbodon/python-docs-zh

生成的HTML演示庫: nobodxbodon/py36zh

其他參考

Getting Started: Overview & Introduction to Concepts