python - pydoc 不一致？

Question

我有一个结构如下的包：

a/a1/a1.py

a/a2/a2.py

a/a3/a3.py

在 a3.py 中，我导入了模块 a1 和 a2，如下所示：

import a1.a1
import a2.a2

然后我跑

pydoc -w a/

它产生 a.html、a.a1.html、a.a1.a1.html、a.a2.html、a.a2.a2.html、a.a3.html、a.a3.a3.html。a3 的问题是，导入的链接，即 a1.a1 和 a2.a2 是 a1.a1.html 和 a2.a2.html。它们应该是 a.a1.a1.html 和 a.a2.a2.html。有人对如何修复它有任何建议吗？谢谢

[更新]。我现在将 a3.py 中的导入更改为：

import a.a1.a1
import a.a2.a2

生成的 a.a3.a3.html 只有一个指向 a as a.html 的链接。我仍然想要到 a1.a1 和 a2.a2 的链接。有什么建议么？

Answer 1

好吧，你可以：

• 切换到 a/ 目录，然后分别在你的目录上运行 pydoc
• 严格遵守您的导入结构，因为 Python 3 强制您（即import a.a1.a1或from ..a1 import a1）
• 使用更新的方式来制作 HTML 文档，比如Sphinx（不过有一些学习曲线）。