编译Python 2.6 文档

适用范围

理论上讲本方法适用于所有(自Python 2.5起)使用reST格式发布的Python官方文档。不过我没有在Python 2.5环境下试过,目前Python 3.0和在翻译中的Python 2.6的Tutorial都是用这个方法生成的。

本文只适用于 *nix 环境,在Windows上没有经过测试。

编译方法

准备

编译

自个儿的版本

如果你需要编译一份简体中文版的Tutorial,只要把简体中文版文档的rst文件,覆盖到相应的目录下。回到Doc目录,make html(或其它你想要生成的格式)。就可以啦。

文档版本

反馈

081217 Zoom,Quiet
  • 编译后,不是根据下载的源代码包版本来输出文档,一直是 2.5.2 版本?!

  • 经过测试,确认是使用了ln -s导致make 时调用的系统库不同;

  • 更新编译帮助文档,建议在源代码目录树中进行编译!
081216 Zoom,Quiet
  1. 编译时有模块丢失
    • makedist-error.png

    • 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 中就好

  2. 发现使用 PyTutorial_zh/2.6Revision 2067的会编译时失败!

    • make_tutorial_error.png

    • 继续尝试确认
      1. errors.rst 也无法编译过,,

      2. inputoutput.rst:3: (SEVERE/4) Title overline & underline mismatch


创建 by -- MarchLiu [2008-12-04 14:14:24]

HowToCompliePythonDocument (last edited 2009-12-25 07:14:41 by localhost)