Я пытаюсь использовать Sphinx для документирования моего проекта Python, но я борюсь с различиями между этим инструментом и обычными инструментами, такими как JavaDoc, которые предназначены для документирования API. Конечно, я вижу, что у Sphinx гораздо больше применений, чем документирование API, но, похоже, ему не хватает более простой задачи.
Мне удалось узнать, как сообщить Sphinx о структуре вашего пакета, чтобы у вас не было вручную реплицировать его в файлы ReST. Моя следующая проблема:
Можно ли включить ссылку на источник для всех классов со Sphinx?
Конечно, исходник должен быть хорошо отформатирован, но поскольку Sphinx использует pygments, я не думаю, что это проблема.