哪些应用程序可用于离线阅读 Python 文档？

Question

我有兴趣在旅行时阅读 Python 文档。

现在，我通过输入命令来做到这一点：

$ pydoc2.7 PyQt4.QtGui.QPushButton
Help on class QPushButton in PyQt4.QtGui:

PyQt4.QtGui.QPushButton = class QPushButton(QAbstractButton)
 |  QPushButton(QWidget parent=None)
 |  QPushButton(QString, QWidget parent=None)
 |  QPushButton(QIcon, QString, QWidget parent=None)
 |  
 |  Method resolution order:
 |      QPushButton
 |      ...
 |      ...
 |      ...

我真的不喜欢这种阅读文档的方式。如果有其他应用程序可以让我离线阅读 Python 文档，我很感兴趣。

Answer 1

Ubuntu 将 Python 及其主要库的文档作为不同的包提供。该文档采用 HTML 格式，安装后即可在浏览器中查看。

这些文档作为子目录安装在/usr/share/doc/. 安装软件包后，我们可以浏览到此文件夹并index.html使用浏览器打开其中包含的文件，并将其位置添加为书签以便于访问。

最好在 Ubuntu 软件中心搜索您想要的文档包。将关键字用作：

• python-<library_name>-doc与 Python 2 第三方库相关的文档；和
• python3-<library_name>-doc 有关 Python 3 第三方库的文档。

您应该能够通过反复试验找到它们，否则 Google 就是您的朋友。

安装 Python 文档和 PyQt4 参考指南的示例

以下是与以下相关的示例：

• Python 2 文档（其中还包含其标准库的文档），可在此处在线找到；和
• PyQt4 参考指南可在此处在线找到。

安装文档包

sudo apt-get update
sudo apt-get install python-doc python-qt4-doc

添加为浏览器书签

打开文件管理器并浏览/usr/share/doc/python-doc并查找index.html文件以使用浏览器打开它。然后将其添加为书签。

同样，浏览/usr/share/doc/python-qt4-doc/html并查找index.html并将其添加为书签。我还建议/usr/share/doc/python-qt4-doc/examples为一些用 PyQt4 编写的优秀示例代码的位置添加书签。

您可以采用类似的方法访问其他第三方 Python 库的离线文档。