pydoc es inconsistente?

Question

Tengo un paquete estructurado de la siguiente manera:

a / a1 / a1.py

a / a2 / a2.py

a / a3 / a3.py

En a3.py, Importé módulos A1 y A2 como los siguientes:

import a1.a1
import a2.a2

Luego ejecutar

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 . El problema con a3 es, los enlaces de las importaciones, es decir, a1.a1 y a2.a2 son a1.a1.html y a2.a2.html. Se supone que deben ser a.a1.a1.html y a.a2.a2.html. Alguien tiene alguna sugerencia sobre cómo solucionarlo? Gracias

[Actualización]. Ahora me cambio las importaciones en a3.py a:

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

El a.a3.a3.html generada sólo tiene un enlace a una como a.html. Todavía quiero enlaces a a1.a1 y a2.a2. ¿Alguna sugerencia?

Answer 1

Bueno, usted podría:

• Cambio en el a / directorio, a continuación, ejecutar pydoc en sus directorios por separado
• Ser estricto con su estructura de las importaciones, como Python 3 obliga a (es decir import a.a1.a1 o from ..a1 import a1)
• Usar una forma nueva de hacer la documentación HTML, como Sphinx (hay algunas dificultades de aprendizaje, sin embargo).