网站前台开发,你用什么工具生成文档?
随着在日常工作中接触CSS/Javascript编写的机会越来越多,才发现和后台程序比起来,这方面的开发还处于一个较初级的阶段,比如,找不到一个十分好用的文档注释生成工具。以下两个是目前我在使用的:
CSSDOC
我不知道是否还有其它更好的方案了,抑或CSS不需要注释和文档?反正这是我唯一找到的一个CSS注释文档生成工具,而且它才刚刚起步而已!目前CSSDOC的开发者提供了第一个草案,内容很少,但大致对CSS注释的规范作了一些设定。所幸这个工具遵循DocBlock规范,更新速度也不错,并且计划支持Aptana,从这几方面来看还是颇值得期待的。
JSDoc
JSDoc要稍微完善一些。同样基于DocBlock规范,提供了使用Perl编写的文档分析和生成工具,我简单试用了一下,不管怎么说它能用(要求相当的低,哈哈)。但对我来说最为可惜的是,这东西尚不支持jQuery。

