本文整理自网络,侵删。
项目脚手架
grunt-init
grunt-init
是一个用于自动创建项目脚手架的工具。它会基于当前工作环境和你给出的一些配置选项构建一个完整的目录结构。至于其所生成的具体文件和内容,依赖于你所选择的模版和构建过程中你对具体信息所给出的配置选项。
注意:这个独立的程序曾经是作为Grunt内置的"init"任务而存在的。在从0.3升级到0.4指南中可以查看更多关于它演变的信息。
安装
为了使用grunt-init,需要将其安装到全局环境中。
npm install -g grunt-init
这样就会把grunt-init
命令安装了到你的系统路径,从而允许你在任何目录中都可以运行它。
注意:你可能需要使用sudo权限或者作为超级管理员运行shell命令来执行这个操作。
用法
- 使用
grunt-init --help
来获取程序帮助以及列出可用模板清单 - 使用
grunt-init TEMPLATE
并基于可用模板创建一个项目 - 使用
grunt-init /path/to/TEMPLATE
基于任意其他目录中可用的模板创建一个项目
注意,大多数的模板都应该在当前目录(执行命令的目录)中生成它们的文件(自动生成的项目相关的文件),因此,如果你不想覆盖现有的文件,注意一定要切换到一个新目录中来保证文件生成到其他目录。
安装模板
一旦模板被安装到你的~/.grunt-init/
目录中(在Windows平台是%USERPROFILE%\.grunt-init\
目录),那么就可以通过grunt-init
命令来使用它们了。建议你使用git将模板克隆到项目目录中。例如, grunt-init-jquery模板可以像下面这样安装:
git clone https://github.com/gruntjs/grunt-init-jquery.git ~/.grunt-init/jquery
注意:如果你希望在本地像"foobarbaz"这样使用模板,你应该指定~/.grunt-init/foobarbaz
之后再克隆。grunt-init
会使用实际在于~/.grunt-init/
目录中的实际的目录名。
下面是一些有Grunt官方维护的grunt-init模板:
- grunt-init-commonjs - Create a commonjs module, including Nodeunit unit tests. (sample "generated" repo | creation transcript)
- grunt-init-gruntfile - Create a basic Gruntfile. (sample "generated" repo | creation transcript)
- grunt-init-gruntplugin - Create a Grunt plugin, including Nodeunit unit tests. (sample "generated" repo |creation transcript)
- grunt-init-jquery - Create a jQuery plugin, including QUnit unit tests. (sample "generated" repo | creation transcript)
- grunt-init-node - Create a Node.js module, including Nodeunit unit tests. (sample "generated" repo |creation transcript)
定制模版
你可以创建和使用自定义模板。但是你的模板必须遵循与上述模板相同的文件结构。
下面是一个名为my-template
的模板示例,它必须遵循下面这样的常规文件结构:
my-template/template.js
- 主模板文件。my-template/rename.json
- 模板特定的重命名规则,作为模板进行处理。my-template/root/
- f要复制到目标位置的文件。
假设这些文件存储在/path/to/my-template
目录中,那么命令grunt-init /path/to/my-template
就会处理这些模板。这个目录中可能存在多个命名唯一的模板(多个不重名的模板)。
此外,如果你把这个自定义模板放在你的~/.grunt-init/
目录中(在Windows上是%USERPROFILE%\.grunt-init\
目录),那么只需要使用grunt-init my-template
命令就可以使用这个模版了。
复制文件
当执行初始化模板时, 只要模板使用init.filesToCopy
和init.copyAndProcess
方法,任何位于root/
子目录中的文件都将被复制到当前目录。
注意所有被复制的文件都会被做为模板进行处理,并且所有{% %}
模板都会依据props
数据对象集合中的数据进行替换,除非设置了noProcess
选项。可以看看jquery template中的案例。
重命名或者排除模板文件
rename.json
用于描述sourcepath
到destpath
的重命名映射关系。sourcepath
必须是相对于root/
目录要被复制的文件路径,但是destpath
值可以包含{% %}
模板,用于描述目标路径是什么。
如果destpath
被指定为false
,那么文件就不会被复制。此外,srcpath
还支持通配符匹配模式。
为询问信息指定默认选择
每个初始化提示都会有一个硬编码的默认值或者它会根据当前环境来尝试确定该缺省值。如果你想覆盖某个特定提示信息的默认值,你可以在OS X或者Linux的~/.grunt-init/defaults.json
或者Windows的%USERPROFILE%\.grunt-init\defaults.json
文件中选择性的进行处理。
例如,由于我希望使用一个与众不同的名字来替代默认的名字,并且我还希望排除我的邮箱地址,同时我还希望自动指定一个作者的url,那么我的defaults.json
看起来就可能像下面这样。
{
"author_name": "\"Cowboy\" Ben Alman",
"author_email": "none",
"author_url": "http://benalman.com/"
}
注意:即使所有的内置提示信息都有文档,你还可以在源代码中找到他们的名字和默认值。
定义一个初始化模
exports.description
当用户运行grunt init
或者grunt-init
来显示所有可用的初始化模板时,这个简短的模板描述也会和模板名一起显示。
exports.description = descriptionString;
exports.notes
如果指定了这个选项,这个可选的扩展描述将会在任何提示信息显示之前显示出来。这是一个给用户提供一些解释命名空间相关帮助信息的很好的地方。这些提示可能是必选的也可能是可选的,等等。
exports.notes = notesString;
exports.warnOn
如果这个(推荐指定)可选的通配模式或者通配模式数组有匹配项出现,Grunt将终止并生成一个警告信息,用户可以使用--force
来覆盖这个默认行为。这对于初始化模板可能覆盖现有文件的情况来说是非常有用的。
exports.warnOn = wildcardPattern;
然而最常见的值是'*'
,它能够匹配任意文件或者目录。使用minimatch通配符模式具有很大的灵活性。例如:
exports.warnOn = 'Gruntfile.js'; // Warn on a Gruntfile.js file.
exports.warnOn = '*.js'; // Warn on any .js file.
exports.warnOn = '*'; // Warn on any non-dotfile or non-dotdir.
exports.warnOn = '.*'; // Warn on any dotfile or dotdir.
exports.warnOn = '{.*,*}'; // Warn on any file or dir (dot or non-dot).
exports.warnOn = '!*/**'; // Warn on any file (ignoring dirs).
exports.warnOn = '*.{png,gif,jpg}'; // Warn on any image file.
// This is another way of writing the last example.
exports.warnOn = ['*.png', '*.gif', '*.jpg'];
exports.template
虽然exports
属性定义在该函数的外面,然而所有实际的初始化代码指定在它内部。这个函数接受三个参数,grunt
参数是一个grunt的引用,它包含所有的grunt方法和库。init
参数是一个包含特定于这个初始化模板而存在的方法和属性的对象。done
参数是在初始化模板执行完成时必须调用的函数。
exports.template = function(grunt, init, done) {
// See the "Inside an init template" section.
};
初始化模板的内部
init.addLicenseFiles
可以给files对象添加适当命名的许可协议证书文件。
var files = {};
var licenses = ['MIT'];
init.addLicenseFiles(files, licenses);
// files === {'LICENSE-MIT': 'licenses/LICENSE-MIT'}
init.availableLicenses
返回一个可用许可协议证书的数组:
var licenses = init.availableLicenses();
// licenses === [ 'Apache-2.0', 'GPL-2.0', 'MIT', 'MPL-2.0' ]
init.copy
它提供一份绝对或者相对源文件路径,以及一个可选的相对的目标文件路径,复制一个文件时,可以通过传递的回调函数来选择性的处理它。
init.copy(srcpath[, destpath], options)
init.copyAndProcess
遍历所传递对象中的所有文件,将源文件复制到目标路径,并处理相关内容。
init.copyAndProcess(files, props[, options])
init.defaults
用户在defaults.json
中指定的默认初始值。
init.defaults
init.destpath
目标文件的绝对路径。
init.destpath()
init.expand
与grunt.file.expand相同。
相关阅读 >>
更多相关阅读请进入《Grunt》频道 >>
Vue.js 设计与实现 基于Vue.js 3 深入解析Vue.js 设计细节
本书对 Vue.js 3 技术细节的分析非常可靠,对于需要深入理解 Vue.js 3 的用户会有很大的帮助。——尤雨溪,Vue.js作者