你怎么得到蟒蛇文件Texinfo信息格式?
-
20-08-2019 - |
题
由于Python2.6,看来该文件是在新的 reStructuredText 格式,并且它似乎并不非常容易建立一个 Texinfo信息 文件箱了。
我Emacs的一个吸毒者和更喜欢我的文件安装在信息。
没有任何人有Python2.6或后来的文档在Texinfo格式?你怎么把他们吗?或者,是否有一个维持建立某个地方在那里?
我知道我可以使用或w3m haddoc 查看html文档-我真的希望他们在信息。
我已经打了 Pandoc 但之后几个小实验,它似乎并没有处理好与之间的联系的文件,以及我更大的实验运行的,它跨越所有文件cat'ed一起来看看会发生什么情况-是仍然沿隆隆两天,因为我开始吧!
两个很好的答案
突出两个答案如下,因为这样不会让我接受的答案:
解决方案
我已经打包了 蟒蛇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.py
与 sphinx-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执行这你可能会喜欢尝试:
另一个"解决方法"是执行 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输出格式。目前它具有:
- HTML
- 乳胶
- 纯文本
也许你可以得到你想要什么使用的乳胶输出。与案文输出,你就会丢失的交叉参考。
Personnaly我更喜欢使用pydoc当我想要的文字输出。与Vim我有一个shorcut呼pydoc并打开一个窗口与医生对于该实体根据我的光标...