pydocは矛盾していますか？

Question

は、私はこのような構造のパッケージを持っている：

/A1/a1.py

/A2/a2.py

A3では/ A3/a3.py

。 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であるはずです。 誰かがどのように修正するための提案がありますか？ありがとう

[更新]。生成されたa.a3.a3.htmlがa.htmlように1つのリンクのみを持っている

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

：私は今までa3.pyで輸入を変更します。私はまだa1.a1とa2.a2へのリンクが必要です。助言がありますか？

Answer 1

さて、あなたは可能性があります。a /ディレクトリに

• 変更は、その後、（すなわちimport a.a1.a1またはfrom ..a1 import a1にPythonなどの3つの軍あなた、
• は、インポート構造と厳密に分けてごディレクトリにpydocを実行します）
• Sphinxのような新しい方法でHTMLドキュメントを作成します（ただし、学習曲線はあります）。