Интеграция другой документации html в документы sphinx

Question

Как включить в документ Sphinx html-документы, созданные другими инструментами, такими как отчеты о нотах, охвате и пилинге. Должны ли они войти в каталог _static? и если да, то как вы ссылаетесь на них?

Я пытаюсь создать краткий пакет всей документации по разработке кода в формате .pdf или html.

Answer 1

У меня есть аналогичная проблема, и я мог бы решить ее, выполнив следующее. Обратите внимание, что это только для вывода HTML.

1. Создать index.rst поле с только следующее:

====================== Javadoc of the API XXX ======================

Как я использую расширение "sphinx.ext.autosectionlabel", это становится раздел "Уровень 1" ,

2. Измените файл Make так, чтобы после создания HTML он заменил index.html раздела «Javadoc API XXX» на Javadoc моего API.

После этого изменения на toctree у меня есть ссылка на «Javadoc API XXX», и когда вы нажимаете на нее, вы видите Javadoc.

Я знаю, что это не надлежащим образом, но это единственное, что я придумал после многих поисков Google.