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

Answer 1

好吧，你可以:

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