grunt-file-tags v0.1.4
grunt-file-tags
Dynamically includes source tags for script/link/whatever files on disk.
Getting Started
This plugin requires Grunt ~0.4.5
If you haven't used Grunt before, be sure to check out the Getting Started guide, as it explains how to create a Gruntfile as well as install and use Grunt plugins. Once you're familiar with that process, you may install this plugin with this command:
npm install grunt-file-tags --save-dev
Once the plugin has been installed, it may be enabled inside your Gruntfile with this line of JavaScript:
grunt.loadNpmTasks('grunt-file-tags');
The "file_tags" task
Overview
In your project's Gruntfile, add a section named file_tags
to the data object passed into grunt.initConfig()
.
grunt.initConfig({
file_tags: {
scripts: {
options: {
tagTemplate: '<script src="{{ path }}"></script>',
openTag: '<!-- start script tags -->',
closeTag: '<!-- end script tags -->'
},
src: [
'source/**/*.js'
],
dest: 'build/file-tags.html'
}
}
});
Options
options.tagTemplate
Type: String
Default value: <script src="{{ path }}"></script>
Example value (stylesheet): <link rel="stylesheet" href="{{ path }}"/>
A matched file will compile the options.tagTemplate
template with the file path.
options.openTag
Type: String
Default value: <!-- start file tags -->
Specify where in the destination file to start adding script/link/whatever tags.
options.closeTag
Type: String
Default value: <!-- end file tags -->
Specify where in the destination file to stop script/link/whatever tags.
Usage Examples
Default Options
The following is the default configuration. tags
will generate script tags for all matching src
files and using the default tagTemplate
defined above. It will then add these tags to site/index.html
between the default <!-- start file tags -->
and <!-- end file tags -->
.
grunt.initConfig({
file_tags: {
build: {
src: [
'site/js/**/*.js',
'!site/js/vendor/**/*.js'
],
dest: 'site/index.html'
}
}
});
grunt.registerTask('default', ['file_tags:build']);
Custom Options
You can override all default options. In the following multi-task, we have four tasks, one for compiling scripts scripts
, one for compiling link tags, styles
, one for compiling image tags, images
, one for compiling LESS imports, less
.
All tasks override the default tagTemplate
, letting your define you own template with extra attributes. It also overrides openTag
and closeTag
, specifying that they are for the associated files.
grunt.initConfig({
file_tags: {
scripts: {
options: {
tagTemplate: '<script src="{{ path }}" type="text/javascript"></script>',
openTag: '<!-- start custom script tags -->',
closeTag: '<!-- end custom script tags -->'
},
src: [
'source/**/*.js'
],
dest: 'build/index.html'
},
styles: {
options: {
tagTemplate: '<link rel="stylesheet" href="{{ path }}" type="text/css"/>',
openTag: '<!-- start custom style tags -->',
closeTag: '<!-- end custom style tags -->'
},
src: [
'source/**/*.css'
],
dest: 'build/index.html'
},
images: {
options: {
tagTemplate: '<img src="{{ path }}"/>',
openTag: '<!-- start custom image tags -->',
closeTag: '<!-- end custom image tags -->'
},
src: [
'source/img/folder/*.jpg'
],
dest: 'build/index.html'
},
less: {
options: {
tagTemplate: '@import "{{ path }}";',
openTag: '/* start style tags */',
closeTag: '/* end style tags */'
},
src: [
'js/**/*.less'
],
dest: 'build/style/app.less'
},
}
});
grunt.registerTask('default', ['file_tags:scripts', 'file_tags:styles']);
This plugin will scan through the src
files, and insert all matching files into the dest
file between the openTag
and closeTag
.
Contributing
In lieu of a formal styleguide, take care to maintain the existing coding style. Add unit tests for any new or changed functionality. Lint and test your code using Grunt.
Credits
This project is basically a refactor of the excellent work done by Andrew Mead (@andrewjmead on npm) with his grunt-script-link-tags plugin.
Release History
2015-04-03 v0.1.4 Updated README, performed code cleanup. 2015-04-02 v0.1.3 Warn instead of fail on missing start/close tags 2015-04-02 v0.1.2 Updated README 2015-03-13 v0.1.1 Initial release