2011年9月21日 星期三

於Trac新增phpdoc文件


之前中秋在家狂寫註解,這次使用phpdoc的格式,可以順利生出看起來像是程式碼的文件[疑!!]
但是code更新後都要人工去renew很煩,既然SVN都能自動sync了為啥phpdoc不能順便產生呢??
再加上嵌在Trac中多方變啊,根本就不會忘了URL是多少XD

安裝PhpDocumentor
pear install PhpDocumentor

#修正樣版編碼
cd /usr/share/php/data/PhpDocumentor/phpDocumentor
find ./ -name '*.tpl' | xargs sed -i 's/iso-8859-1/utf-8/g'


匯出SVN並製做phpdoc
rm -rf /tmp/tipc
svn export file:///data/svn/tipc /tmp/tipc
rm -rf /data/trac/tipc/htdocs/phpdoc
phpdoc --parseprivate -o HTML:frames:earthli -d /tmp/tipc/ -t /data/trac/tipc/htdocs/phpdoc


Trac安裝MenusPlugin
http://trac-hacks.org/wiki/MenusPlugin
#trac.ini設定
[components]
tracmenus.* = enabled

[mainnav]
phpdoc = enabled
phpdoc.parent = browser
phpdoc.href = /tipc/chrome/site/phpdoc/index.html
phpdoc.label = PHPDoc