pydoc ist inkonsistent?

Question

Ich habe ein Paket wie folgt aufgebaut:

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 Verbindungen 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. Jeder hat irgendwelche Vorschläge, wie man es beheben? Dank

[Update]. Ich nun die Einfuhren in a3.py ändern:

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

Der erzeugte a.a3.a3.html hat nur einen Link auf eine als a.html. Ich möchte noch Links zu a1.a1 und a2.a2. Irgendwelche Vorschläge?

Answer 1

Nun, man kann:

• Wechseln Sie in das a / Verzeichnis, dann führen pydoc auf Ihre Verzeichnisse separat
• Seien Sie streng mit Ihrer Importstruktur, wie Python 3 zwingt Sie zu (d import a.a1.a1 oder from ..a1 import a1)
• Verwenden Sie eine neuere Art und Weise HTML-Dokumentation zu machen, wie Sphinx (es gibt einige Lernkurve, obwohl).