Перейти к содержанию

Генератор Sphinx

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

Недостатком пока является отсутствие стабильных расширений для генерации API-документации непосредственно из кода для .NET. Следует обратить внимание на расширение Sphinx AutoAPI, в котором такая возможность закладывается и реализовывается.