pydoc è incoerente?

Question

Ho un pacchetto strutturato in questo modo:

A / A1 / a1.py

A / A2 / a2.py

A / A3 / a3.py

In a3.py, ho importato i moduli A1 e A2 come questi:

import a1.a1
import a2.a2

Poi ho eseguito

pydoc -w a/

Produce a.html, a.a1.html, a.a1.a1.html, a.a2.html, a.a2.a2.html, a.a3.html, a.a3.a3.html . Il problema con a3 è, i vincoli della importazioni, cioè a1.a1 e a2.a2 sono a1.a1.html e a2.a2.html. Essi dovrebbero essere a.a1.a1.html e a.a2.a2.html. Qualcuno ha qualche suggerimento su come risolvere il problema? Grazie

[Aggiornamento]. Ora cambiare le importazioni in a3.py a:

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

L'a.a3.a3.html generato ha un solo collegamento a un come a.html. Voglio ancora collegamenti a a1.a1 e a2.a2. Qualche suggerimento?

Answer 1

Bene, si potrebbe:

• Cambia in una directory /, pydoc poi girare sulle directory separatamente
• essere severi con la struttura di importazione, come Python 3 obbliga a (vale a dire import a.a1.a1 o from ..a1 import a1)
• Usa un modo più nuovo per rendere la documentazione HTML, come Sfinge (v'è una certa curva di apprendimento, però).