pydoc est incompatible?

Question

J'ai un paquet structuré comme celui-ci:

a / a1 / a1.py

a / a2 / a2.py

a / a3 / a3.py

a3.py, je modules importés A1 et A2 comme ceux-ci:

import a1.a1
import a2.a2

Puis-je utiliser

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, les liens des importations, à savoir, a1.a1 et a2.a2 sont a1.a1.html et a2.a2.html. Ils sont censés être a.a1.a1.html et a.a2.a2.html. Toute personne 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é a un seul lien dans une a.html que. Je veux encore des liens vers a1.a1 et a2.a2. Toutes les suggestions?

Answer 1

Eh bien, vous pouvez:

• Modifier 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 à (à savoir import a.a1.a1 ou from ..a1 import a1)
• Utilisez une nouvelle façon de faire de la documentation HTML, comme Sphinx (il y a une courbe d'apprentissage, cependant).