Генератор Sphinx¶
Sphinx хорош тем, что позволяет легко создавать интерактивную и красивую документацию в различных форматах:
HTML
(включая справку Windows HTML
), LaTeX
(для печатных версий PDF
), ePub
, Texinfo
, страницы справочника
, простой текст
. Основной язык разметки reStructuredText, но файлы на языке разметки Markdown также обрабатывает.
Недостатком пока является отсутствие стабильных расширений для генерации API-документации непосредственно из кода для .NET. Следует обратить внимание на расширение Sphinx AutoAPI, в котором такая возможность закладывается и реализовывается.