你好,我正在尝试通过grunt和ngdoc为我的ionicframework/angularjs应用程序创建一个文档。
我已经安装了 http://gruntjs.com/getting-started 中首选的所有内容
好吧,如果我现在咕噜咕噜地跑
我得到:
Running "jshint:gruntfile" (jshint) task
>> 1 file lint free.
Running "jshint:lib_test" (jshint) task
>> 0 files linted. Please check your ignored files.
Running "qunit:files" (qunit) task
Warning: 0/0 assertions ran (0ms) Use --force to continue.
Aborted due to warnings.
有了这个,我无法显示文档。
我的咕噜咕噜文件看起来像这样:
/*global module:false*/
module.exports = function(grunt) {
// Project configuration.
grunt.initConfig({
// Task configuration.
jshint: {
options: {
curly: true,
eqeqeq: true,
immed: true,
latedef: true,
newcap: true,
noarg: true,
sub: true,
undef: true,
unused: true,
boss: true,
eqnull: true,
browser: true,
globals: {
jQuery: true
}
},
gruntfile: {
src: 'Gruntfile.js'
},
lib_test: {
src: ['lib/**/*.js', 'test/**/*.js']
}
},
qunit: {
files: ['test/**/*.html']
},
ngdocs: {
all: ['src/resources/js/*.js']
},
watch: {
gruntfile: {
files: '<%= jshint.gruntfile.src %>',
tasks: ['jshint:gruntfile']
},
lib_test: {
files: '<%= jshint.lib_test.src %>',
tasks: ['jshint:lib_test', 'qunit']
}
}
});
// These plugins provide necessary tasks.
grunt.loadNpmTasks('grunt-contrib-qunit');
grunt.loadNpmTasks('grunt-contrib-jshint');
grunt.loadNpmTasks('grunt-contrib-watch');
grunt.loadNpmTasks('grunt-ngdocs');
// Default task.
grunt.registerTask('default', ['jshint', 'qunit']);
grunt.registerTask('build','Build the application',['ngdocs']);
};
我是为 angularjs 创建文档的新手,那么为此目的的最佳实践是什么?
当你从命令行使用"grunt"时,它将尝试运行Gruntfile.js中的每个任务。
您只想运行 ngdocs,因此应使用 grunt ngdocs
作为命令行命令。
您还添加了一个名为"build"的任务,该任务仅运行ngdocs,因此您还可以使用: grunt build