python - 如何获取 Texinfo Info 格式的 Python 文档？

Question

从 Python 2.6 开始，文档似乎在新的 reStructuredText 中格式，构建 Texinfo Info 似乎并不容易文件开箱即用。

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

有没有人有 Python 2.6 或更高版本的 Texinfo 格式的文档？你是如何转换它们的？或者，那里有维护的构建吗？

我知道我可以使用 w3m 或 haddoc查看 html 文档 - 我真的希望它们出现在 Info 中。

我玩过Pandoc但是经过一些小实验后，它似乎并不能很好地处理文档之间的链接，而我的更大的实验——在所有文档中运行它，看看会发生什么——自从我开始它以来，它仍在持续两天!

两个好答案

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

• @wilfred-hughes: Installing from MELPA是将预构建信息导入 Emacs 的最快方法
• @alioth: Building it yourself看起来比我在 2009 年问这个问题时要容易得多

Answer 1

乔恩·沃尔特曼 http://bitbucket.org/jonwaltman/sphinx-info已经 fork 了 sphinx 并编写了一个 texinfo 构建器，它可以构建 python 文档(我还没有完成)。看来它很快就会被合并到 sphinx 中了。

这里是下载的快速链接(临时):

• 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 目标将 $(PYTHON) tools/sphinx-build.py 替换为 sphinx-build，然后在makefile中加入这个target，注意，echo前面的空格是TAB:

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/conf.py 添加:

texinfo_documents = [
    ('contents', 'python', 'Python Documentation', 'Georg Brandl',
     'Python', 'The Python Programming Language', 'Documentation tools',
     1),
]

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