grunt-bower-install-shopware
v0.2.2
Published
Inject your Bower dependencies right into your HTML from Grunt.
Downloads
5
Readme
grunt-bower-install
Inject your Bower dependencies right into your HTML from Grunt.
What is this?
Grunt is great.
Bower is great.
And now they work great together.
grunt-bower-install
is a Grunt plug-in, which finds your components and injects them directly into the HTML file you specify.
Whether you're already using Bower and Grunt, or new to both, grunt-bower-install
will be easy to plug in, as you will see in the steps below.
do note: Bower is still a young little birdy, so things are changing rapidly. Authors of Bower components must follow certain conventions and best practices in order for this plug-in to be as accurate as possible. It's not a perfect world out there, so needless to say, some Bower components may not work as well as others.
Getting Started
*If you are new to Grunt, you will find a lot of answers to your questions in their getting started guide.
To install the module:
npm install grunt-bower-install --save-dev
Include the task in your Gruntfile:
grunt.loadNpmTasks('grunt-bower-install');
Create a config block within your Gruntfile:
'bower-install': {
// Point to the html file that should be updated
// when you run `grunt bower-install`
html: 'app/index.html',
// Optional:
// If your scripts shouldn't contain a certain
// portion of a url, it can be excluded
ignorePath: 'app/'
}
Pop this in your HTML file:
<!-- bower -->
<!-- endbower -->
Install a Bower component:
grunt bower-install:jquery
You're in business!
<!-- bower -->
<script src="bower_components/jquery/jquery.js"></script>
<!-- endbower -->
If you want to uninstall a Bower component:
grunt bower-uninstall:jquery
Behind the Scenes
This plug-in decorates the native Bower commands. So, by saying grunt bower-install:jquery
, you are really saying:
bower install jquery --save
After the Bower command finishes executing, this plug-in will take a look at all of the components you have, and determine the best order to inject your scripts in to your HTML file.
Putting script tags that aren't managed by grunt-bower-install
is not advised, as anything between <!-- bower -->
and <!-- endbower -->
will be overwritten with each command.
Examples
A simple sample apple: website | github
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.
License
Copyright (c) 2013 Stephen Sawchuk Licensed under the MIT license.