Включите внешние файлы HTTP или Git reStructuredText в качестве исходных файлов в Sphinx - PullRequest
0 голосов
/ 07 января 2019

Я хочу иметь глобальный репозиторий документации Sphinx, который может встраивать документы, поступающие из других репозиториев Git или из файлов, извлекаемых с использованием HTTP.

Идея состоит в том, чтобы хранить документацию с каждым программным компонентом (с их собственным деревом TOC) в проекте с большим количеством компонентов, но также включать их в дерево TOC окончательного центрального хранилища документации, как будто существует только один большой хранилище документации.

Директива .. include работает только с локальными файлами.

Intersphinx, кажется, работает только с сгенерированными objects.inv файлами, тогда как я хотел бы использовать и включать необработанные файлы reStructuredText.

Что будет наиболее похоже на следующий вопрос StackOverflow: Включение внешней документации в проект Sphinx

Однако это касается SVN, и вопрос был задан 8 лет назад, поэтому мне интересно, появилось ли что-то лучшее и новое за это время.

У вас есть идеи? Есть ли плагин, который я мог пропустить?

...