среда, 1 мая 2013 г.

Документация Doxygen в Google Code

При публикации проектов в Google Code нет прямой возможности вставить в онлайн результат сборки Doxygen. По крайней мере, напрямую.

Ключевой идея решения проблемы — изменение свойств файлов mime-type, которые стоят под контролем SVN.

Сначала генерируем документацию и ставим локально под контроль. После этого изменяем mime-type. Doxygen генерирует (обычно) ограниченное число типов файлов, определяемых расширением, поэтому для них нужно прописать такое соответствие:

  1. *.css = svn:mime-type=text/css
  2. *.html = svn:mime-type=text/html
  3. *.js = svn:mime-type=text/javascript
  4. *.gif = svn:mime-type=image/gif
  5. *.png = svn:mime-type=image/png

Теперь изменяем mime-type. Например это запуск такого bat-файла под Win:

svn pset svn:mime-type text/html *.html
svn pset svn:mime-type text/html search/*.html

svn pset svn:mime-type text/css *.css
svn pset svn:mime-type text/css search/*.css

svn pset svn:mime-type text/javascript *.js
svn pset svn:mime-type text/javascript search/*.js

svn pset svn:mime-type image/gif *.gif
svn pset svn:mime-type image/gif search/*.gif

svn pset svn:mime-type image/png *.png
svn pset svn:mime-type image/png search/*.png

После этого — коммит и остается только найти ссылку в SVN, которая имеет вид http://PROJECTNAME.googlecode.com/svn/PATH/index.html

Теперь можно радоваться (;