常用工具说明--jsdoc 前端文档输出工具

1.利用npm安装jsdoc模块
npm install jsdoc -g
 
2.由于jsdoc默认的生成文档模板不好看,可以下载一套好看些的模板,如 jaguar.js
也可用npm下载
 
3.将node_modules/jsdoc/templates/default下面的内容删除掉,然后将第二步下载的全部内容放在里面
 
4.创建jsdoc的配置文件
建立一个conf.json
{
    "tags": {
        "allowUnknownTags": true
    },
    "source": {
        "include": ["lib"],
        "includePattern": ".+\.js(doc)?$",
        "excludePattern": "(^|\/|\\)_"
    },
        "templates": {
                "cleverLinks": true,
                "monospaceLinks": true,
                "default": {
                        "outputSourceFiles" : true
                },
                "applicationName": "demo",
                "openGraph": {},
                "meta": {}
        }
}
保存在根目录下。
 
5.cmd下输入 jsdoc -c conf.json,生成的out文件夹就是文档生成的位置。
 
 
 
原文地址:https://www.cnblogs.com/tanwei81/p/8822074.html