pydoc ist inkonsistent?

Question

Ich habe ein Paket wie folgt strukturiert:

a/a1/a1.py

a/a2/a2.py

a/a3/a3.py

In a3. py, ich importierten Module A1 und A2 wie diese:

import a1.a1 
import a2.a2 

Dann laufe ich

pydoc -w a/ 

Es produziert a.html, a.a1.html, a.a1.a1.html, a.a2.html, a.a2.a2.html, a.a3.html, a.a3.a3. html. Das Problem mit a3 ist, die Links der Importe, d. H. A1.a1 und a2.a2 sind a1.a1.html und a2.a2.html. Sie sollen a.a1.a1.html und a.a2.a2.html sein. Hat jemand irgendwelche Vorschläge, wie man es beheben kann? Danke

[Aktualisierung]. Ich wechsle jetzt die Einfuhren in a3.py zu:

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

Die erzeugte a.a3.a3.html nur eine Verbindung zu einem als a.html hat. Ich möchte immer noch Links zu a1.a1 und a2.a2. Irgendwelche Vorschläge?

Answer 1

Nun, man könnte:

• Wechseln Sie in das a/Verzeichnis, dann führt pydoc auf Ihren Verzeichnissen separat
• mit Ihrer Importstruktur streng sein, wie Python 3 zwingt Sie zu (dh import a.a1.a1 oder from ..a1 import a1)
• Verwenden Sie einen neueren Weg, um HTML-Dokumentation, wie Sphinx (es gibt einige Lernkurve, obwohl).