javascript如何生成文档
安装了 dox 和 docco, 但是 dox 现在只输出json, docco直接出错.
还有个工具叫 Sphinx, 但是是python的, 不知道如何使用.
各位是如何生成文档的, 求个5分钟教程.
10 回复
docco 依赖 python 和 pygments, 先装好这两个然后在命令行下直接运行 docco yourfilename.js
就会生成 yourfilename.html
文件。
之前还试过 jsdoc,与javadoc 类似,在源码中按照规定的格式写上注释,然后就就可以生成相应的文档。使用帮助: http://code.google.com/p/jsdoc-toolkit/wiki/CommandlineOptions
还有个叫joDoc的,也是用注释生成文档的工具,语法比较简单,xuijs.com上的文档就是用这个生成的,你可以对比下文档和源码,入门很容易
哪个好啊.
@guilin 它们两个定位不同,docco 强调的是文学化编程,方便别人或自己阅读源码。而 jsdoc 强调的是 API 文档的生成,方便用户查阅各个函数用法。
@xqunix 多谢
我用的是Sencha ExtJS风格的文档, 工具地址: https://github.com/senchalabs/jsduck
试用了下,效果很好