Dist::Zilla::Plugin::TwitterBootstrap - Include a customized Twitter Bootstrap in your distribution
version 0.04
[TwitterBootstrap] js_include = * css_include = * img_include = *
Plugin which downloads a custom Twitter Bootstrap using WebService::TwitterBootstrap::Download::Custom from the Twitter Bootstrap website and includes it in your distribution.
Which jQuery plugins to include. This attribute is considered before js_exclude. You can use * to include all available plugins.
js_exclude
*
Which jQuery plugins to exclude. This attribute will remove any plugin that would otherwise have been included with juts the js_include attribute. For example, to include all plugins, EXCEPT for Transitions:
js_include
[TwitterBootstrap] js_include = * js_exclude = bootstrap-transition.js
Which CSS components to include. This attribute is considered before css_exclude. You can use * to include all available components.
css_exclude
Which CSS components to exclude. This attribute will remove any components that would otherwise have been included with just the css_include attribute.
css_include
Which images to include. This attribute is considered before img_exclude. You can use * to include all available images.
img_exclude
Which images to exclude. This attribute will remove any images that would otherwise have been included with just the img_include attribute.
img_include
Which variables to override. For example to set @linkColor to red:
[TwitterBootstrap] vars = @linkColor = #f00
Which directory to put your custom Twitter Bootstrap into. Defaults to public under the same location of your main module, so if your module is Foo::Bar (lib/Foo/Bar.pm), then the default dir will be lib/Foo/Bar/public.
Where to put your custom Twitter Bootstrap. Choices are:
This puts your custom Twitter Bootstrap in the directory where the dist is currently being built, where it will be incorporated into the dist.
This puts your custom Twitter Bootstrap in the root directory (The same directory that contains dist.ini). It will also be included in the built distribution.
Whether and where to cache custom bootstraps. This value is passed directly into the same attribute of WebService::TwitterBootstrap::Download::Custom, so see that modules documentation for details, but briefly here are the values you can specify:
0 (zero)
Turn off caching
1 (one)
Turn on caching, using the default caching location.
directory path
Use the given path as the cache directory.
This method downloads the appropriate files from the Internet (or retrieves them from the cache) and places them in the location specified by the configuration.
Prints to standard out the default customization as found on the Twitter Bootstrap website. You can use this by appending it to your dist.ini.
dist.ini
% perl -MDist::Zilla::Plugin::TwitterBootstrap \ -E 'Dist::Zilla::Plugin::TwitterBootstrap->default_customization' \ > dist.ini
Returns list of attributes that can be specified multiple times. Can also be called as an instance method.
If you bundle Twitter Bootstrap into your distribution, you should update the copyright section to include a notice that bundled copy of Twitter Bootstrap is copyright Twitter and is licensed under the Apache 2.0 License.
This module does not bundle Twitter Bootstrap itself, but it can be used to include a bundled copy of Twitter Bootstrap into your Perl distribution.
WebService::TwitterBootstrap::Download::Custom
Graham Ollis <plicease@cpan.org>
This software is copyright (c) 2012 by Graham Ollis.
This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.
To install Dist::Zilla::Plugin::TwitterBootstrap, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Dist::Zilla::Plugin::TwitterBootstrap
CPAN shell
perl -MCPAN -e shell install Dist::Zilla::Plugin::TwitterBootstrap
For more information on module installation, please visit the detailed CPAN module installation guide.