Инструмент для создания документации по коду C++

Я хочу автоматически генерировать HTML-документы для кода C++ и использовал Doxygen в прошлом, но если я, например, посмотрю документацию NVIDIA CUDA , должны быть инструменты получше ;-)

Кто-нибудь знает инструмент генерации документов с сопоставимым качеством. В Википедии есть большая страница сравнения , но она настолько велика, что не может служить рекомендацией.

При всем уважении, Стив, но ваш вопрос также не годится для рекомендации . Если вы не указываете критерии, которым должно соответствовать программное обеспечение, как кто-то может дать рекомендацию? Просто указать на пример NVidia недостаточно.
Расскажите, что вам не нравится в документации NVIDIA? Есть ли функции, которые «должны быть» или «хорошо бы иметь»? Трудно рекомендовать, когда мы не знаем шляпу, которую вы ищете.
Лично я не считаю его намного лучше, чем Doxygen. Но, если вы не дадите нам список требований, операционную систему или бюджет, мы можем только предложить вам использовать то, что использовала NVDIA. Я не вижу упоминания об этом на странице, но вы всегда можете связаться с ними по их ссылке для обратной связи (mailto:cudatools@nvidia.com?subject=Отзыв о документации по CUDA Toolkit: cuRAND), спросить, что они используют, и если это ФОСС.
Хорошо, этому уже 6 месяцев, и Стив не хочет его улучшать. Голосование против как запрос рекомендации низкого качества.

Ответы (1)

Я настоятельно рекомендую генератор документов Sphinx — в качестве примера сайта взгляните на новую документацию wxPython .

Формирует документацию из:

  • Код Python
  • Код С/С++
  • реструктурированный текст 3
  • Несколько выходных форматов — HTML (включая справку Windows HTML), LaTeX (для печатных версий PDF), ePub, Texinfo, справочные страницы, обычный текст
  • Подсветка кода для широкого спектра языков
  • Темы
  • Генерация индекса и оглавления

Бесплатная и кроссплатформенная.

Ваша ссылка на вики - Sphinx тоже генерирует это (или загружает контент в существующую вики)? Кроме того, чем он отличается/лучше, чем doxygen?
Sphinx генерирует документацию и вики wxPython AFAIK - ОП сказал, что им «не понравился» внешний вид документов, сгенерированных Doxygen - Sphinx имеет ряд более современных готовых шаблонов и множество параметров настройки.
Инструмент для создания документации по коду C++
СпросиСетьПолитика конфиденциальности1y, 0v