将脱机文档链接到IDLE - Linux

Question

通过互联网访问，＆lt; F1＆gt;在IDLE上运行良好的Linux。当然没有互联网接入它不起作用。我已经将Python文档下载为html，但无法让IDLE直接引用它。

“IDLE首选项”下有一个名为“其他帮助源”的对话框，但这只允许用户为单个主题指定单个文件，而不是整个目录结构。我可以输入一个网址，但我不清楚我应该输入什么作为“菜单项”。

我应该补充一点，将本地目录的URL添加到我的浏览器使我能够查看脱机文档，它只是我错过IDLE的链接。

我找到了对PYTHONDOCS环境变量的引用，但这似乎不适用于Linux，它似乎特定于Windows。

Answer 1

您几乎完成了通过菜单项参考本地文档所需的所有设置。让我们更准确地看一下可以做些什么：

1. 将您的Python版本的文档下载为zipped html。
2. 将该存档解压缩到您想要的目录，例如 / home / username / python-docs 。
3. 转到空闲：选项 - ＆gt;配置空闲... - ＆gt;一般 - ＆gt;其他帮助来源 - ＆gt;添加。
4. 输入“菜单项”字段的标签（它将是IDLE帮助菜单中显示的新菜单项的标签），例如“本地文档”。
5. 按“浏览”按钮，在解压缩的帮助源中选择“index.html”的路径。
6. 转到帮助 - ＆gt;本地文档，它将打开您的本地版本的Python文档。

<强>更新

我在Python问题跟踪器上创建了一个ticket，它要求增强标准IDLE键配置，以便为自定义添加的addiotional帮助源菜单项添加键绑定。

Answer 2

实际上，IDLE确实有代码来查找html格式的Python文档集的磁盘副本，但这些路径是特定于平台的，并且在Linux的情况下，对于某些发行版至少是过时的。如果您查看Lib/idlelib/EditorWindow.py中的代码（我正在查看当前的Python 3源代码），您会看到，对于Linux平台，它会在index.html或/var/www/html/python中查找/usr/share/doc/python-docs-x.y/Doc/ {1}}。例如，在当前的Debian系统上，Python doc包安装在/usr/share/doc/pythonx.y-doc/html中。如果您安装了doc包然后创建了一个链接，那么当您从Python Docs手册中选择Help时，IDLE应该会离线查找文档。例如，对于Python 3.3，可以执行：

sudo aptitude install python3.3-doc
sudo mkdir -p /var/www/html/
sudo ln -s /usr/share/doc/python3.3-doc/html python

那就是说，应该更新默认位置（我将这个添加到Rostyslav打开的问题）。