如何获得Texinfo格式的Python文档？

Question

从Python2.6开始，文档似乎是以新的reStructuredText格式编写的，而且似乎不太容易现成地构建Texinfo Info文件了。在

我是一个Emacs迷，我更喜欢在Info中安装我的文档。在

有没有人有Texinfo格式的Python2.6或更高版本的文档？你是怎么把它们改过来的？或者，有没有维护过的建筑？在

我知道我可以使用w3m或haddoc来查看html文档—我真的很想在Info中看到它们。在

我用过Pandoc，但经过一些小实验后，它似乎不能很好地处理文档之间的链接，而我的更大的实验——在所有文档上运行它，看看会发生什么——从我开始的两天以来，它仍在缓慢地进行着！在

两个好答案

在下面突出显示两个答案，因为这样不允许我同时接受这两个答案：

• @wilfredhughes:Installing from MELPA是在Emacs中获取预构建信息的最快方法
• @alioth:Building it yourself看起来比我2009年问这个问题容易得多

Answer 1

毫无疑问，独自在特定的Python版本上生成Python文档将是一件很酷且具有挑战性的事情。只需遵循EmacsWiki，或者可以在本地编译它（在Debian Jessy for Python3.4.2）：

sudo apt-get install python3-sphinx
cd ~/Desktop
wget https://www.python.org/ftp/python/3.4.2/Python-3.4.2rc1.tar.xz
tar -xf Python-3.4.2rc1.tar.xz
cd Python-3.4.2rc1/Doc/
sphinx-build -b texinfo -d build/doctrees . build/texinfo
# extra time to build
cd build/texinfo/
makeinfo python.texi
# extra time for convertation

我得到了这棵树：

^{pr2}$

现在可以通过

C-u C-h i python-info RET

python-info是一个文件名（在上面的树中是第四个），甚至可以为一些任意节点添加书签，以方便习惯性和定期的查看。在

Answer 2

jonwaltmanhttp://bitbucket.org/jonwaltman/sphinx-info派生了sphinx并编写了一个texinfo构建器，它可以构建python文档（我已经完成了）。看来它很快就会并入斯芬克斯。在

以下是下载的快速链接（临时）：

• http://dl.dropbox.com/u/1276730/python.info
• http://dl.dropbox.com/u/1276730/python.texi

生成texinfo格式python doc的步骤：

下载python源代码

下载并安装sphinx-info包（在virtualenv中）

从Python源代码中输入Python/Doc目录

编辑Makefile，将build目标替换为sphinx-build，然后将这个目标添加到Makefile中，注意，echo前面的空格是一个制表符：

texinfo: BUILDER = texinfo
texinfo: build
    @echo
    @echo "Build finished. The Texinfo files are in _build/texinfo."
    @echo "Run \`make' in that directory to run these through makeinfo" \
          "(use \`make info' here to do that automatically)."

编辑Python/Doc/配置文件添加：

^{pr2}$

然后运行make texinfo，它应该在build/texinfo目录中生成texifile。 要生成信息文件，请运行makeinfo python.texi

Answer 3

我已经把Python docs as a texinfo file打包了。在

如果您在MELPA中使用Emacs，只需使用M-x package-install python-info安装它。在