由于Python2.6,看来该文件是在新的 reStructuredText 格式,并且它似乎并不非常容易建立一个 Texinfo信息 文件箱了。

我Emacs的一个吸毒者和更喜欢我的文件安装在信息。

没有任何人有Python2.6或后来的文档在Texinfo格式?你怎么把他们吗?或者,是否有一个维持建立某个地方在那里?

我知道我可以使用或w3m haddoc 查看html文档-我真的希望他们在信息。

我已经打了 Pandoc 但之后几个小实验,它似乎并没有处理好与之间的联系的文件,以及我更大的实验运行的,它跨越所有文件cat'ed一起来看看会发生什么情况-是仍然沿隆隆两天,因为我开始吧!

两个很好的答案

突出两个答案如下,因为这样不会让我接受的答案:

  • @威尔弗雷德-hughes: 安装自MELPA 是最快捷的方式获得预先建立的信息进Emacs
  • @玉衡: 建立它自己 看起来像是一个容易得多,当我问这个问题在2009年
有帮助吗?

解决方案

我已经打包了 蟒蛇docs作为一个texinfo文件.

如果你使用Emacs与MELPA,你可以简单地安装这一用 M-x package-install python-info.

其他提示

Jon Waltman http://bitbucket.org/jonwaltman/sphinx-info 有分叉的狮身人面像,以及编写一texinfo建设者,它可以建立python文件(我还没完成它)。看来,它将合并很快成狮身人面像。

这是快速链接,用于下载(临时):

步产生的蟒蛇医生在texinfo格式:

下载的蟒蛇的源代码

下载,安装 狮身人面像-info 包(在虚拟环境)

在Python/Doc目录python源

编辑的生成文件, build 目标替换 $(PYTHON) tools/sphinx-build.pysphinx-build, ,那么添加这一目标的生成文件,要注意,空间之前的回声是一个标签:

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 它应该产生texifile在建立/texinfo目录。生成的信息文件的运行 makeinfo python.texi

毫无疑问,这将是冷静和富有挑战性的产生Python文件对你特别是蟒蛇的版本。只要遵循 EmacsWiki, 或随时汇编在本地(在Debian杰西对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

现在它是可能的审查python文件 本机在Emacs 通过

C-u C-h我python的信息RET

蟒蛇的信息是一个文件(第四棵树),并甚至可以签一些任意的节点对于惯常和定期审查提供方便。

对于那些以下这个问题在希望的一种回答,我找到另一个rst2texinfo执行这你可能会喜欢尝试:

http://bitbucket.org/jonwaltman/rst2texinfo/src

另一个"解决方法"是执行 pydoc 正如所建议的Nikokrock直接在Emacs:

(defun pydoc (&optional arg)
  (interactive)
  (when (not (stringp arg))
    (setq arg (thing-at-point 'word)))

  (setq cmd (concat "pydoc " arg))
  (ad-activate-regexp "auto-compile-yes-or-no-p-always-yes")
  (shell-command cmd)
  (setq pydoc-buf (get-buffer "*Shell Command Output*"))
  (switch-to-buffer-other-window pydoc-buf)
  (python-mode)
  (ad-deactivate-regexp "auto-compile-yes-or-no-p-always-yes")
)

Michael Ernst用于维持信息的格式的蟒蛇文档:

http://www.cs.washington.edu/homes/mernst/software/#python-info

你可以尝试使用他的生成文件和html2texi脚本生成的更新版本。两者都是联系在上述网址。我不知道该如何以及它现在的作品(最后一个版本是在2001年),但他的剧本是很好的注释(查询为"蟒").

蟒蛇的文档,现在产生的斯芬克斯使用的框架。这一框架并没有texinfo输出格式。目前它具有:

  1. HTML
  2. 乳胶
  3. 纯文本

也许你可以得到你想要什么使用的乳胶输出。与案文输出,你就会丢失的交叉参考。

Personnaly我更喜欢使用pydoc当我想要的文字输出。与Vim我有一个shorcut呼pydoc并打开一个窗口与医生对于该实体根据我的光标...

许可以下: CC-BY-SA归因
不隶属于 StackOverflow
scroll top