2018-04-27 搭建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
按照README运行后, 即在www文件夹中生成汉化后的文档
相关代码库
文档构建脚本库: nobodxbodon/docsbuild-scripts
po文件库: nobodxbodon/python-docs-zh
生成的HTML演示库: nobodxbodon/py36zh
其他参考
低调大师中文资讯倾力打造互联网数据资讯、行业资源、电子商务、移动互联网、网络营销平台。
持续更新报道IT业界、互联网、市场资讯、驱动更新,是最及时权威的产业资讯及硬件资讯报道平台。
转载内容版权归作者及来源网站所有,本站原创内容转载请注明来源。
- 上一篇
2018-04-21 搭建Python官方文档翻译环境
参考PEP 545 -- Python Documentation Translations fork的编译脚本: nobodxbodon/docsbuild-scripts, 添加了zh语言标签, 以及fork的PO文件库nobodxbodon/python-docs-ko, 仅作演示用(更改字段"测试python入门教程": Update index.po · nobodxbodon/python-docs-ko@00b8073) 据非常有限的理解, 大概过程是, PO文件包含了所有翻译的段落, 像打补丁似地附加到原英文文档后生成rEst格式文件, 再编译成HTML文档(html库地址:nobodxbodon/py36zh. 演示: 4. 기타 제어 흐름 도구 - Python 3.6.5 文档) 接下去要解决的是, 如何汉化程序部分, 效果如下. 所有现有的其他语言的翻译文档都没有对程序进行本地化(字符串/命名等) 现在可以通过直接修改rst文件, 但PEP 545的流程是修改PO文件. 问了其他翻译组的作者, 似乎需要修改Sphinx配置才能实现(在PO文件中添加程序部分, ...
- 下一篇
vim关于python的自动补全插件
一、克隆代码mkdir -p ~/.vim/toolscd ~/.vim/toolsgit clone https://github.com/rkulla/pydiction.git二、配置Pydiction - UNIX/LINUX/OSX: Put python_pydiction.vim in ~/.vim/after/ftplugin/ - WINDOWS: Put python_pydiction.vim in C:vimvimfilesftplugin\ Assuming you installed Vim to C:vim\ cp -r ~/.vim/tools/pydiction/after/ ~/.vim三、编辑.vimrc文件vim ~/.vimrc在.vimrc文件添加如下配置:filetype plugin onlet g:pydiction_location = '~/.vim/tools/pydiction/complete-dict'let g:pydiction_menu_height = 3四、重启
相关文章
文章评论
共有0条评论来说两句吧...
文章二维码
点击排行
推荐阅读
最新文章
- SpringBoot2整合Redis,开启缓存,提高访问速度
- SpringBoot2配置默认Tomcat设置,开启更多高级功能
- Hadoop3单机部署,实现最简伪集群
- CentOS7,CentOS8安装Elasticsearch6.8.6
- CentOS6,7,8上安装Nginx,支持https2.0的开启
- Docker使用Oracle官方镜像安装(12C,18C,19C)
- SpringBoot2编写第一个Controller,响应你的http请求并返回结果
- CentOS7安装Docker,走上虚拟化容器引擎之路
- CentOS8编译安装MySQL8.0.19
- Docker安装Oracle12C,快速搭建Oracle学习环境