День добрый,
решил оптимизировать пользовательскую документацию и привести ее к виду удобной для коллективного работы.
Требования:
Форматирование исходных файлов — markdown.
Генерация многостраничной документация (многие генераторы работают только с одним файлом).
Self-host
Желательно наличие уже готовых шаблонов, которое было бы достаточно только изменить.
Пока остановился на следующих вариантах:
Beautiful docs
mdoc
markdoc
Может у кого-то уже был опыт по поиску похожего решения?
Спасибо!
note: я так же тестировал
sphinx-doc — хорошая система генерации, но использует reStructuredText. Можно конечно заморочиться и сделать прозрачную конвертацию через
pandoc, но пока пытаюсь найти альтернативу.