我们是否有在 Ubuntu 存储库中提供离线 Python 文档浏览器来有一个“服务点”来阅读和搜索 Python 文档和 API?

我们是否有在 Ubuntu 存储库中提供离线 Python 文档浏览器来有一个“服务点”来阅读和搜索 Python 文档和 API?

问题就在标题中。作为一个用例,我们可以想象根据已知功能查找函数的情况。

我已经知道 Zeal已打包。它从 Dash 项目下载文档集。这很棒,但 Python 版本与系统上安装的版本不同。它们通常较新。

开发者帮助应用程序不了解 Python 库。上的搜索pydoc3 -p 8080未按预期工作。KHelpCenter 不了解 Python。文档中心包似乎被打破很长时间。文档帮助仅显示索引/usr/share/doc-help,不提供全文搜索。

我还应该尝试什么才能从 (和类似位置) 离线阅读和搜索 Python 文档/usr/share/doc
我的系统报告说那里有 467 个文件夹 ( ls -1d /usr/share/doc/*python* | wc -l)。

答案1

如果您谈论的是 Python 本身的文档(可从python3-doc依赖于实际系统 Python 版本的 doc 包的包中安装),那么您只需从中运行 Web 服务器即可/usr/share/doc/python3/html(例如,使用python3 -m http.server)。Python 文档使用 Sphinx,它支持客户端搜索。

使用 18.04 的示例:

  • 索引页:

    侧边栏链接大多是外部的。

  • 參考部分:

  • 正在搜索:

答案2

我已经创建了 Bash shell 脚本,用于在基于 Debian 的系统(例如 Ubuntu)上搜索本地安装的 Python 文档,并将其放在在 GitHub 上

该脚本允许人们运行首先初步的全文搜索以获取 Python 包名称和以 HTML 格式阅读相关文档的方法。

它用于aptitudePython 包选择,html2text和/或pandoc包运行从 HTML 到纯文本的转换以获得更好的搜索结果。

该脚本显示在默认的网络浏览器中找到的本地 HTML 文档,并提供有关进一步阅读文档的方法的信息 - 通过 DevHelp、DocHelp 或网络浏览器。

相关内容