Python：pydoc 模块可以输出带有相对路径的 HTML 文档吗？

Question

我正在使用 pydoc 模块输出我使用 C API 定义的某些类型的文档。在解释器嵌入到我的 C 程序中之前，我想要记录的类型并不存在，因此我无法使用 pydoc 命令。

我让我的 C 代码调用一个函数，该函数执行如下操作：

d = pydoc.HTMLDoc()
content = d.docmodule(sys.modules["mymodule"])

这可行，但会生成带有硬编码“file:/”链接目标的 HTML 页面。有没有办法使用链接的相对路径？

（额外积分是为了更好地记录 C API 中定义的类型）

Answer 1

我认为Sphinx在这方面做得更好。以下是记录 C 域的方法：

http://www.sphinx-doc.org/en/master/usage/restructedtext/domains.html#the-c-domain