sam的小窝

导出js注释工具-JSDOC

Posted on Feb 4, 2015

what

官网在此 代码在此

install

sudo npm install -g git+https://github.com/jsdoc3/jsdoc.git

或者

npm install jsdoc@"<=3.3.0"

how

JSDoc会从/**开头的注释中抽取信息。

标签就是一些以@开头的命令，所有标签用法见这里

jsdoc where-is-js-files

访问当前目录下/out/index.html

使用docstrap美化界面

官网在此，下载地址戳这里

配置docstrap

修改文件docstrap/template/jsdoc.conf.json，文件在此：

编写首页内容

保存到README.md文件。（必须是md文件）

## why
让更多的人一起来做自己喜欢的网站

## what
前端框架

## how
js

制作tutorials

放其它的描述文档，比如总体介绍，背景说明，示例文档等。

必须先创建一个目录（名称不限，例子中用tutorials），然后把上述文档转成md文件后复制进改目录。（原则上所有扩展名为xml，xhtml，html，htm，md的文件都可以。）

最后生成的页面上会增加新菜单tutorials，菜单项默认是文件名。如果想要重新命名，那么必须要在这个目录下新建同名json文件，例如README.json,内容为

{
"title" : "首页"
}

如果文件很多，还可以将组织成嵌套菜单，这时每个文件都建同名json文件，只要新建一个json文件（比如也叫README.json）即可，内容如下：

{
"README":{
    "title" : "首页",
    "children" : {
	"a": {"title":"测试A"},
	"b": {"title":"测试B"}}
}
}

生成帮助文档

运行以下命令后访问当前目录下/out/index.html：

jsdoc where-is-js-files README.md -t where-is-docstrap/template -c where-is-docstrap/template/jsdoc.conf.json -u where-is-js-files/turorials