如何使用jsdoc与gulp？

Question

如何使用jsdoc创建gulp命令来构建文档？

我不想使用gulp-jsdoc包,因为它没有被维护.我用来从命令行gulp-shell调用它的包是在gulp黑名单上.

Answer 1

使用node的内置child_process,如下所示:

var child_exec = require('child_process').exec;

gulp.task('docs', function(done) {
    child_exec('node ./node_modules/jsdoc/jsdoc.js ./lib -c ./jsdoc.json', undefined, done);
});

(此示例假设您有一个配置文件./jsdoc.json,但很容易更改调用语法.)