grunt-assetic-dump
v0.1.0
Published
Grunt task to dump assets from symfony2 assetic config.yml to physical files
Downloads
16
Readme
grunt-assetic-dump
Grunt task to dump assets from symfony2 assetic config.yml to physical files
Getting Started
This plugin requires Grunt ~0.4.0
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-assetic-dump --save-dev
Once the plugin has been installed, it may be enabled inside your Gruntfile with this line of JavaScript:
grunt.loadNpmTasks('grunt-assetic-dump');
The "assetic_dump" task
Overview
In your project's Gruntfile.js
, add a section named assetic_dump
to the data object passed into grunt.initConfig()
.
grunt.initConfig({
assetic_dump: {
options: {
// Task-specific options go here.
},
your_target: {
// Target-specific file lists and/or options go here.
},
},
});
Options
options.banner
Type: String
Default value: empty string
This string will be prepended to the beginning of the output fole.
options.footer
Type: String
Default value: empty string
This string will be append to the end of the output file.
options.configFile
Type: String
Default value: app/config/config.yml
Your symfony config file where your assets are defined
options.assetsBaseDir
Type: String
Default value: web/
Base dir of your inputs assets (relative to Gruntfile.js
)
options.webDir
Type: String
Default value: web/
Target dir where your output file will be saved (relative to Gruntfile.js
)
Usage Examples
I sugest to put your assets in bundles public directories and install them in web/
dir via php app/console assets:install --symlink
. Then you have to set up your assets in config file like:
# app/config/config.yml
assetic:
# ...
assets:
all_css:
inputs:
- 'bundles/bundle-name/normalize.css'
- 'bundles/bundle-name/screen.css'
output: 'css/all.css'
all_js:
inputs:
- 'bundles/bundle-name/jquery.js'
- 'bundles/bundle-name/app.js'
output: 'js/all.js'
Then you can dump them to filesystem via:
grunt.initConfig({
// ...
assets_dump: {
prod: {}
}
});
Custom config file
You can also put your assets config in separate file (for example app/config/assets.yml
) and include then in your app/config/config.yml
.
Then you can dump them to filesystem via:
grunt.initConfig({
// ...
assets_dump: {
prod: {
configFile: 'app/config/assets.yml'
}
}
});