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.html。 我仍然想要鏈接到a1.a1和a2.a2。 有什么建議么？

Answer 1

好吧，您可以：

• 切換到a /目錄，然后在目錄上分別運行pydoc
• 請嚴格遵守您的導入結構，因為Python 3會強制您進行import a.a1.a1 （即， import a.a1.a1或from ..a1 import a1 ）
• 使用一種新的方式來制作HTML文檔，例如Sphinx （盡管有一些學習過程）。