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の問題は、インポートのリンク、IE、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には、AS A.HTMLへのリンクは1つしかありません。 A1.A1およびA2.A2へのリンクが必要です。助言がありますか？

Answer 1

まあ、あなたはできます：

• A/ディレクトリに変更してから、ディレクトリのPydocを個別に実行します
• Python 3が強制するので、輸入構造に厳密になります（すなわち import a.a1.a1 また from ..a1 import a1)
• 新しい方法を使用して、HTMLドキュメントを作成します。 スフィンクス （ただし、いくつかの学習曲線があります）。