0

我正在尝试为一组简单的 JS 代码（如下所示）构建文档。如果我使用 gulp，文档会按照我的预期创建。如果我使用 CLI，则文档不完整。

这是我的 JS 代码：

// BASE.js
/** @module BASE */
var BASE = {};

// MOD1.js
/** @class MOD1 - Test module */
BASE.MOD1 = Object.create({});

/**
 * Just a test function
 * @param {Object} var1 - A test variable
 */
BASE.MOD1.testFunction = function(var1){
    alert('hi');
};

我的吞咽文件：

var gulp = require('gulp'),
    jsdoc = require('gulp-jsdoc'),
    outDir = './gulp-docs/',
    docInfo = {},
    docOptions = {},
    docTemplate = {},
    srcFiles = [
        "BASE.js",
        "MOD1.js"
    ];

gulp.task('default', function() {
    return gulp.src(srcFiles)
            .pipe(jsdoc.parser(docInfo))
            .pipe(jsdoc.generator(outDir, docTemplate, docOptions))
});

我的命令行：

C:\DocTest> jsdoc BASE.js MOD1.js --configure rawconf.json --destination raw-docs

rawconf.json：

{
    "tags": {
        "allowUnknownTags": true
    },
    "plugins": [],
    "templates": {},
    "opts": {
        "package": "./rawpackage.json"
    }
}

原始包.json：

{}

我从 Node.js 命令提示符运行 gulp 和 jsdoc 命令。

gulp 的输出是以下文件：

BASE.js.html
BASE.MOD1.html
index.html
MOD1.js.html
module-BASE.html

CLI 的输出是以下文件：

BASE.js.html
index.html
MOD1.js.html
module-BASE.html
module-BASE-BASE.MOD1.html

我可以将一些小的差异归结为 jsdoc 的 gulp-jsoc 版本（3.3.0-alpha5）和当前版本（3.3.0-beta3）之间的差异。

但最大的区别是，虽然在 gulp 输出中，我可以找到关于的信息，但在 CLI 输出中的任何地方testFunction都找不到任何信息。testFunction我什至搜索过 HTML 代码——什么都没有。

那我是不是做错了什么？我只是想在这一点上实现平等，而且我已经用尽了我可以在网上找到的所有文档。

4

1 回答 1

0

如果您查看 gulp-jsdoc github 页面，这里有一个“大警告”，表明该插件没有保持最新。

尝试使用 gulp-shell 插件。您可以完全使用您在命令行中键入的内容。

于 2015-04-20T22:03:20.223 回答