gitlab + doxygen не дружат
Всем привет.
На работе стоит гитлаб, где есть куча проектов. Большая часть из них содержит подробную документацию внутри кода с использованием doc-блоков. На локальном компьютере документация отлично генерируется через doxygen.
Есть задача централизовано генерировать по всем этим проектам документацию на самом сервере gitlab и иметь доступ к ней. Причем, для оперативности процесса, хочется после каждого «git push» на gitlab-сервер, чтобы документация генерировалась заново.
То есть алгоритм такой: На сервер приходят новые коммиты, обновляется git-репозиторий, запускается doxygen по текущему git-репозиторию, doxygen складывает результат своей деятельности в определенную папку в которую смотрит веб-сервер и отдает оттуда результат.
Сейчас я написал post-recieve hook для git'a. Можно посмотреть тут - http://pastebin.com/MecjMUfs
Работает он так: Если в папке с проектом есть doxygen/Doxyfile.cfg, он генерирует имя проекта исходя из его пути и запускает doxygen.
Громадный недостаток в том, что этот скрипт нужно класть вручную в каждый проект на gitlab. Более того, в свежесозданные проекты его тоже нужно будет класть.
Как Вы решаете задачу генерации документации по своему коду?
Может я неправ и мне не нужно чтобы документация генерировалась автоматически? Может быть достаточно скрипта который будет по крону раз в день ходить по всем папкам gitlab-овских репозиториев и генерировать документацию раз в день?
