pydoc est incohérent?

Question

I ont un paquet structuré comme suit:

a/a1/a1.py

a/a2/a2.py

a/a3/a3.py

Dans a3. py, I importé modules a1 et a2 de ce genre:

import a1.a1 
import a2.a2 

Ensuite, je cours

pydoc -w a/ 

Il produit a.html, a.a1.html, a.a1.a1.html, a.a2.html, a.a2.a2.html, a.a3.html, a.a3.a3. html Le problème avec a3 est, les liens des importations, à savoir, a1.a1 et a2.a2 sont a1.a1.html et a2.a2.html. Ils sont supposés être a.a1.a1.html et a.a2.a2.html. Quelqu'un a des suggestions sur la façon de résoudre ce problème? Merci

[Mise à jour]. Je change maintenant les importations a3.py à:

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

Le a.a3.a3.html généré n'a qu'un lien vers un comme a.html. Je veux toujours des liens vers a1.a1 et a2.a2. Aucune suggestion?

Answer 1

Eh bien, vous pouvez:

• changement dans le un/répertoire, puis exécutez pydoc sur vos répertoires séparément
• Soyez strict avec votre structure des importations, que les forces Python 3 vous à (c.-à-import a.a1.a1 ou from ..a1 import a1
• Utilisez une méthode plus récente pour créer de la documentation HTML, par exemple Sphinx (il existe cependant une courbe d'apprentissage).