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 的链接为 a.html。我仍然想要指向 a1.a1 和 a2.a2 的链接。有什么建议吗？

Answer 1

好吧，您可以：

• 更改为 a/ 目录，然后分别在您的目录上运行 pydoc
• 严格控制您的导入结构，因为 Python 3 强制您这样做（即 import a.a1.a1 或 from ..a1 import a1)
• 使用更新的方法来制作 HTML 文档，例如 Sphinx (不过，有一些学习曲线）。