Pydoc не соответствует?

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/

Он производит A.HTML, A.A1.HTML, A.A1.A1.HTML, A.A2.HTML, A.A2.A2.HTML, A.A3.HTML, A.A3.A3.HTML. Проблема с A3 - это ссылки импорта, т. Е. А1.А1 и 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, как Сфинкс (Хотя есть некоторая кривая обучения).