NAME Dist::Zilla::Plugin::TwitterBootstrap - Include a customized Twitter Bootstrap in your distribution VERSION version 0.02 SYNOPSIS [TwitterBootstrap] js_include = * css_include = * img_include = * DESCRIPTION Plugin which downloads a custom Twitter Bootstrap using WebService::TwitterBootstrap::Download::Custom from the Twitter Bootstrap website and includes it in your distribution. ATTRIBUTES js_include 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: [TwitterBootstrap] js_include = * js_exclude = bootstrap-transition.js css_include 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. img_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. vars Which variables to override. For example to set @linkColor to red: [TwitterBootstrap] vars = @linkColor = #f00 dir 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. location Where to put your custom Twitter Bootstrap. Choices are: build This puts your custom Twitter Bootstrap in the directory where the dist is currently being built, where it will be incorporated into the dist. root 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. cache 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. INSTANCE METHODS $plugin->gather_files 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. CLASS METHODS Dist::Zilla::Plugin::TwitterBootstrap->default_customization 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". % perl -MDist::Zilla::Plugin::TwitterBootstrap \ -E 'Dist::Zilla::Plugin::TwitterBootstrap->default_customization' \ > dist.ini Dist::Zilla::Plugin::TwitterBootstrap->mvp_multivalue_args Returns list of attributes that can be specified multiple times. Can also be called as an instance method. CAVEATS 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. SEE ALSO WebService::TwitterBootstrap::Download::Custom AUTHOR Graham Ollis COPYRIGHT AND LICENSE 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.