Пидок противоречив?

Question

У меня есть пакет с такой структурой:

a / a1 / a1.py

a / a2 / a2.py

a / a3 / a3.py

В a3.py я импортировал модули a1 и a2 следующим образом:

import a1.a1
import a2.a2

Затем я запускаю

pydoc -w a/

Он производит .html, a.a1.html, a.a1.a1.html, a.a2.html, a.a2.a2.html, a.a3.html, a.a3.a3.html.Проблема с a3 заключается в том, что ссылки для импорта, то есть a1.a1 и a2.a2, представляют собой a1.a1.html и a2.a2.html.Они должны быть a.a1.a1.html и a.a2.a2.html.У кого-нибудь есть предложения как это исправить?Спасибо

[Обновление].Теперь я изменяю импорт в a3.py на:

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

Сгенерированный a.a3.a3.html имеет только одну ссылку на a в виде a.html.Я все еще хочу ссылки на a1.a1 и a2.a2.Есть предложения?

Answer 1

Ну, вы могли бы:

• Перейдите в каталог a /, затем запустите pydoc для ваших каталогов отдельно
• Будьте строги с вашей структурой импорта, так как Python 3 заставляет вас (т.е. import a.a1.a1 или from ..a1 import a1)
• Используйте новый способ создания HTML-документации, например Sphinx (хотя есть некоторая кривая обучения).