Как использовать jsdoc с gulp?

Question

Как я могу создать команду gulp для создания документации с использованием jsdoc?

Я не хочу использовать пакет gulp-jsdoc, так как он не поддерживается. И пакет, который я использовал для вызова из командной строки, gulp-shell, находится в черном списке gulp.

Answer 1

Используйте встроенный в 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, но это легко изменить синтаксис вызова.)