2

通过 Internet 访问,IDLE 上的 < F1 > 在 Linux 上运行良好。没有互联网访问当然是行不通的。我已将 Python 文档下载为 html,但无法让 IDLE 直接引用它。

“IDLE Preferences”下有一个名为“Additional Help Sources”的对话框,但这仅允许用户为单个主题指定单个文件,而不是整个目录结构。我可以输入一个 URL,但我不清楚我应该输入什么作为“菜单项”。

我应该补充一点,将本地目录的 URL 添加到我的浏览器使我能够查看离线文档,这只是我缺少的 IDLE 链接。

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

4

2 回答 2

2

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

  1. 将 Python 版本的文档下载为zipped html
  2. 将该存档解压缩到您想要的目录,例如/home/username/python-docs
  3. 转到空闲:选项 -> 配置空闲... -> 常规 -> 其他帮助资源 -> 添加。
  4. 为“菜单项”字段输入标签(它将是出现在 IDLE 的帮助菜单中的新菜单项的标签),例如“本地文档”。
  5. 按“浏览”按钮并在解压缩的帮助源中选择“index.html”的路径。
  6. 移至帮助 -> 本地文档,它将打开您本地版本的 Python 文档。

更新:

我在 Python 问题跟踪器上创建了一张票,请求增强标准 IDLE 键配置,因此可以为自定义添加的附加帮助源菜单项添加键绑定。

于 2012-08-29T10:00:19.130 回答
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/. 例如,在当前的 Debian 系统上,Python doc 包安装在/usr/share/doc/pythonx.y-doc/html. 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 打开的问题中)。

于 2012-08-29T19:56:35.007 回答