Подтвердить что ты не робот

Является ли Sphinx уже подходящим для документации на С++?

Я хочу попробовать генераторы документации для нового проекта на С++. Я думаю, что мои варианты - Doxygen или Sphinx. Поскольку у меня есть проекты на Python, для которых я бы хотел использовать Sphinx, интересно, подходит ли Sphinx для С++. На веб-сайте Sphinx указано, что поддерживается С++, но я не смог найти документ, чтобы начать работу с документацией на С++.

Аналогичный вопрос уже обсуждался qaru.site/info/125692/..., и в главном ответе:

еще не полностью используется,
   но продолжайте смотреть

Поскольку обсуждение хорошо в течение года, мне интересно, остается ли этот вывод действительным. Должен ли я выбрать Doxygen над Sphinx для моей документации на С++?

4b9b3361

Ответ 1

Sphinx не может извлекать документацию из источников С++ и сам по себе. Однако есть расширения, в первую очередь Breathe, которые используют Doxygen для извлечения документации из С++. Я не тестировал их.

Ответ 2

Для С++ Doxygen очень хорош; Поддержка Sphinx С++ выполняется через Doxygen (используя Breathe).

Вы хотите иметь только один инструмент для двух языков, чтобы улучшить ремонтопригодность. Doxygen может генерировать документацию из кода Python, поэтому я рекомендую использовать Doxygen для обоих источников, если это возможно. Вот учебник для Doxygen и Python.