Sails.js + apidocjs + grunt – 自动生成文档
我是Sails.js和Node.js的新手,我在为应用程序创build文档时遇到了问题。
这是我的步骤:
- 通过安装apidoc:
npm install apidoc -g
- 安装grunt模块:
npm install grunt-apidoc --save-dev
- 添加
grunt.loadNpmTasks('grunt-apidoc');
Gruntfile.js
- 创build
grunt.initConfig
文件,并把:
apidoc: { myapp: { src: "api/controllers/", dest: "apidoc/" } }
然后我试图运行多个东西,没有一个产生我的api文档:
- 帆升降机
- 咕噜
- 咕噜默认
- 节点app.js
如果我通过apidoc -i api/controllers/ -o apidoc/
手动运行它,它工作正常。
我究竟做错了什么? 怎么做?
超晚回答!
从我修改资产pipe道的经验来看,你会更好:
-
在问题中安装apidoc和Grunt模块
-
在`tasks / config / apidoc.js中创build一个新文件:
module.exports = function (grunt) { grunt.config.set('apidoc', { myapp: { src: "api/controllers/", dest: "apidoc/" } }); grunt.loadNpmTasks('grunt-apidoc'); };
-
编辑
tasks/register/compileAssets.js
(或任何你想要运行的任务):module.exports = function (grunt) { grunt.registerTask('compileAssets', [ 'clean:dev', 'jst:dev', 'less:dev', 'copy:dev', 'coffee:dev', 'apidoc:myapp' // <-- This will now run every time your assets are compiled ]); };
希望这有助于某人