У нас есть многомодульный проект, задокументированный (превосходным) Sphinx. Наша настройка не похожа на одну описанную в списке рассылки. В целом, отлично работает! Но у нас есть несколько вопросов об этом:
-
Содержание подмодулей будет содержать индексные ссылки. В лучшем случае они свяжутся с неправильными индексами. (В худшем случае это, похоже, вызывает ошибку в Sphinx, но я использую версию devel, чтобы это было разумно). Есть ли способ генерации индексных ссылок только для самого верхнего toctree?
-
Существуют ли лучшие методы для синхронизации конфигурации Sphinx между несколькими проектами? Я мог представить себе что-то взломанное вокруг
from common_config import *
, но любопытно о других подходах. -
Пока мы находимся в этом вопросе, вопрос, поднятый в почте списка рассылки (альтернативный symlinking subproject docs?), никогда не отвечал. Это не важно для меня, но это может быть важно для других читателей.