Bulldoc — это программа для построения документации на основе текстовых файлов, которые можно хранить в svn. Документацию можно собрать как в виде статического набора html файлов с классической навигацией в виде меню, ссылок взад-вперед, так и подготовить файлы проекта для сборки в chm с помощью Microsoft CHM SDK.
Программа работает в двух качествах — как веб-приложение под управлением веб-сервера Apache, или как консольное приложение из командной строки. В первом случае, вы можете смотреть результаты своей правки не собирая проект в статические файлы, править тексты через веб-интерфейс. А из командной строки вы собираете уже написанную справку в готовый к использованию конечными пользователями вид (статический HTML или CHM).
Собранную документацию Вы можете предложить для скачивания пользователям ваших программ, проектов и т.д.
Код в тексте подсвечивается с помощью GeSHi, который поддерживает солидное количество языков, включая Perl, PHP, CSS, HTML и т.д.
Программа и документация к ней распространяются по свободной лицензии MIT и Creative Commons Attribution, т.е. вы можете свободно использовать, изменять код, создавать производные продукты под более закрытыми лицензиями и продавать их до тех пор, пока указываете автора данной программы.
Рекомендуем сразу попробовать систему в работе, прочитав Быстрый старт. Несколько шагов и небольшая книжка готова.
© H-type, 2008
www.bulldoc.ru
mail: info@bulldoc.ru