很好的python文档站点,如ruby-doc.org

很好的python文档站点,如ruby-doc.org,python,ruby-on-rails,ruby,documentation,Python,Ruby On Rails,Ruby,Documentation,我喜欢python,但我对它提供的在线文档感到失望。Ruby似乎有更多的文档站点: (我知道,这是rails,不仅仅是 红宝石) 我当然知道官方文件:。我正在寻找更强大的功能,如搜索自动完成、评论等。就我个人而言,我发现官方文档导航和阅读有点僵化 如果没有这样的替代网站存在,你会建议我如何着手创建一个?是否有某种API来查询python文档 请注意,这个问题是相关的:这不是另一个网站,而是访问文档的另一种方式(如果您慷慨大方,甚至可以作为文档的api)。您只需要一个python解释器:

我喜欢python,但我对它提供的在线文档感到失望。Ruby似乎有更多的文档站点:

  • (我知道,这是rails,不仅仅是 红宝石)
我当然知道官方文件:。我正在寻找更强大的功能,如搜索自动完成、评论等。就我个人而言,我发现官方文档导航和阅读有点僵化

如果没有这样的替代网站存在,你会建议我如何着手创建一个?是否有某种API来查询python文档


请注意,这个问题是相关的:

这不是另一个网站,而是访问文档的另一种方式(如果您慷慨大方,甚至可以作为文档的api)。您只需要一个python解释器:

import csv
print csv.__doc__
dir(csv)
print csv.reader.__doc__
我发现这是一种很好的方法,可以快速检查方法的拼写,或者参数的顺序,而无需打开web浏览器

或者,正如史蒂文·伦巴尔斯基(Steven Rumbalski)所指出的,还有一个问题。这可以交互地用于显示有关给定模块的更多信息。此外,正如rplnt所指出的,许多shell在访问python的帮助/自我文档功能时具有一些语法上的优势

但是,如果您真的很想通过编程方式创建自己的文档网站/系统,那么一个好的开始可能是使用
目录
内置,在给定模块的对象层次结构中爬行,并编译所有不同方法/函数的名称(这就是
\uuuuu doc\uuuuu
正在访问的内容)

然而,我个人认为,在大多数情况下,将交互式帮助和在google中使用
站点:docs.python.org
相结合就足够了。

多年来,我一直使用Thomas Heller的帮助快速访问python库参考资料、语言参考资料和python/C API手册中的资料


由于它是基于CGI的,在Windows上,在您最喜欢的Python IDE或纯文本编辑器中选择一些文本后,可以使用类似于制作键盘宏的东西来访问它。

我从来没有遇到过简单地使用google搜索Python文档的问题。此外,我相信在python的禅宗中,只有一种正确的方法来完成任务(比如文档):“应该有一种——最好只有一种——显而易见的方法来完成它。”值得一提的是,这个python程序员经常对ruby文档感到失望。我非常喜欢Python文档,因为它们只是一个指南,而不仅仅是一系列方法。也许当你成长为一种语言时,你的大脑会适应它的文档实践。。。然后将
放在后面,按enter键并获取信息(包括docstring)。在模块上使用dir也不是必需的,因为您已经完成了选项卡。更好的方法是
help(csv)
。它将为您提供与打印csv.\uuuuu doc\uuuuu相同的简介,以及模块中定义的所有类、函数和数据。这些都是优点。我已经编辑了我的回复,将其包括在内。尽管如此,我仍然非常确定,
dir
\uuuuu doc\uuuu
的组合是以编程方式访问这些内容的最佳方式(如果op确实有兴趣尝试),这一点我一开始可能并不清楚。Ipython还包括当前命名空间中的制表符完成。所以你可以输入csv。弹出窗口将列出csv模块中的所有内容。