编译Python 2.6 文档
适用范围
理论上讲本方法适用于所有(自Python 2.5起)使用reST格式发布的Python官方文档。不过我没有在Python 2.5环境下试过,目前Python 3.0和在翻译中的Python 2.6的Tutorial都是用这个方法生成的。
本文只适用于 *nix 环境,在Windows上没有经过测试。
编译方法
准备
- 无论你想编译哪一版的文档,将完整的Python源码从官网上下载下来,找一个目录,解压。
Download Python Software 下载源代码包!
编译Python,是的,你没看错,编译整个Python,在它的目录下就有 configure 和 MakeFile,像普通项目那样配置编译就好,但是不需要安装。
配置
- 一般说只要基础环境靠谱,或是以编辑方式安装过软件,配置都会很快过去的,,,
$ make
编译
进入 Doc 目录,你会看到另一个 MakeFile。如果你直接make。它会提示你需要指定格式,可选的有html、pdf、latex等等。
OK,选你需要的,编译就好了。pdf版实际上是用latex再编译成pdf,我没找到MakeFile中指定的工具,就没有去做它。
一般使用 $ make dist ~ 制作本地发行版~将输出所有可以输出的!包括压缩包下载的,,,
所以,建议使用 $ make html ~ 就编译出 HTML页面组织成和 http://docs.python.org 一样的网站!
自个儿的版本
如果你需要编译一份简体中文版的Tutorial,只要把简体中文版文档的rst文件,覆盖到相应的目录下。回到Doc目录,make html(或其它你想要生成的格式)。就可以啦。
反馈
- 081217 Zoom,Quiet
编译后,不是根据下载的源代码包版本来输出文档,一直是 2.5.2 版本?!
经过测试,确认是使用了ln -s导致make 时调用的系统库不同;
- 更新编译帮助文档,建议在源代码目录树中进行编译!
- 081216 Zoom,Quiet
- 编译时有模块丢失
error building Python 2.6.1 documentation- sphinx-dev | Google 网上论坛 有解决
- 我们得输出男人版本Python:
$ svn co http://svn.python.org/projects/python/trunk python-svn
然后将Doc/tools/sphinxext 复制到当前编译文档的 Python-2.6.1/Doc/tools 中就好
发现使用 PyTutorial_zh/2.6Revision 2067的会编译时失败!
- 继续尝试确认
errors.rst 也无法编译过,,
inputoutput.rst:3: (SEVERE/4) Title overline & underline mismatch
- 编译时有模块丢失
创建 by -- MarchLiu [2008-12-04 14:14:24]