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

Question

从Python2.6开始，文档似乎采用了新的reStructuredText格式，而且似乎不太容易构建一个现成的德州信息文件。

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

有没有人有Texinfo格式的Python2.6或更高版本的文档？你是怎么改变他们的？或者，外面有一个可维护的建筑吗？

我知道我可以使用w3m或哈多克来查看html文档--我非常希望它们在Info中。

我玩过潘多克，但经过几次小实验后，它似乎不能很好地处理文档之间的链接，而我的更大的实验--将它运行到所有的文档猫一起查看发生了什么--在我开始运行的两天后仍然在缓慢地运行！

两个好答案

在下面突出两个答案，因为我不能同时接受这两个答案：

• @wilfred：从MELPA安装是在Emacs中获取预构建信息的最快方法。
• @alioth：自己建的看起来比2009年我问这个问题时容易得多

Answer 1

我把Python文档作为文本信息文件打包好了。

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

Answer 2

Jon http://bitbucket.org/jonwaltman/sphinx-info已经对狮身人面像进行了分叉，并编写了一个文本信息构建器，它可以构建python文档(我还没有完成)。看来很快就会合并成狮身人面像。

以下是下载(临时)的快速链接：

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

以texinfo格式生成python的步骤：

下载python源代码

下载并安装狮身人面像包(在虚拟环境中)

从python源输入Python/Doc目录

编辑Makefile，将build目标替换为sphinx-build，然后将这个目标添加到makefile，注意，回显之前的空格是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 . the添加：

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

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

Answer 3

毫无疑问，自己在特定Python版本上生成Python文档既酷又有挑战性。只需遵循EmacsWiki，或者自由地在本地编译它( Debian 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

我有一棵树：

.                                                                                                                              
├── logging_flow.png                                                                                                           
├── Makefile                                                                                                                   
├── pathlib-inheritance.png                                                                                                    
├── python.info                                                                                                                
├── python.info-1                                                                                                              
├── python.info-10                                                                                                             
├── python.info-11                                                                                                             
├── python.info-12                                                                                                             
├── python.info-13                                                                                                             
├── python.info-14                                                                                                             
├── python.info-15                                                                                                             
├── python.info-16                                                                                                             
├── python.info-17                                                                                                             
├── python.info-18                                                                                                             
├── python.info-19                                                                                                             
├── python.info-2                                                                                                              
├── python.info-20                                                                                                             
├── python.info-21                                                                                                             
├── python.info-22                                                                                                             
├── python.info-23                                                                                                             
├── python.info-24                                                                                                             
├── python.info-25                                                                                                             
├── python.info-26                                                                                                             
├── python.info-27                                                                                                             
├── python.info-28                                                                                                             
├── python.info-29                                                                                                             
├── python.info-3                                                                                                              
├── python.info-30                                                                                                             
├── python.info-31                                                                                                             
├── python.info-32                                                                                                             
├── python.info-33                                                                                                             
├── python.info-34                                                                                                             
├── python.info-4                                                                                                              
├── python.info-5                                                                                                              
├── python.info-6                                                                                                              
├── python.info-7                                                                                                              
├── python.info-8                                                                                                              
├── python.info-9                                                                                                              
├── python.texi                                                                                                                
├── python-video-icon.png                                                                                                      
├── tulip_coro.png                                                                                                             
└── turtle-star.png

现在可以在Emacs中以本地方式查看python文档

C-u C-h i python-info RET

python是一个文件名(在上面的树中是第四个)，甚至可以对一些任意的节点进行书签，以便进行常规的检查。