Michał Wojciechowski > Dancer-Plugin-Preprocess-Sass-0.01 > Dancer::Plugin::Preprocess::Sass

Download:
Dancer-Plugin-Preprocess-Sass-0.01.tar.gz

Dependencies

Annotate this POD

CPAN RT

New  1
Open  0
View/Report Bugs
Module Version: 0.01   Source   Latest Release: Dancer-Plugin-Preprocess-Sass-0.031

NAME ^

Dancer::Plugin::Preprocess::Sass - Generate CSS files from Sass/SCSS files

VERSION ^

Version 0.01

SYNOPSIS ^

Dancer::Plugin::Preprocess::Sass adds support for Sass/SCSS files in a Dancer web application.

Add the plugin to your application:

    use Dancer::Plugin::Preprocess::Sass;

Configure its settings in the YAML configuration file:

    plugins:
      "Preprocess::Sass":
        save: 1
        paths:
          - css
          - subdir/css

DESCRIPTION ^

Dancer::Plugin::Preprocess::Sass adds support for Sass/SCSS files in a Dancer web application.

When a request is received for a CSS file, the plugin looks for a Sass/SCSS file with the same name, and transforms it into CSS. The generated CSS file may then be saved and served as a regular static file. Every time the source Sass/SCSS file gets modified, the corresponding CSS file is regenerated.

CONFIGURATION ^

The available configuration settings are described below.

save

If set to 0, then the CSS files are generated on-the-fly with every request. If set to 1, the files are generated once and saved, then served as static files later on.

The files are saved in the same directory as the Sass/SCSS files, so the system user that the web application is running as must be allowed to write to that directory.

Default: 0

paths

A list of paths to serve CSS files from. Each path is relative to the public directory of the application.

    plugins:
      "Preprocess::Sass":
        paths:
          - css
          - subdir/css

Default: 'css'

AUTHOR ^

Michal Wojciechowski, <odyniec at cpan.org>

BUGS ^

Please report any bugs or feature requests to bug-dancer-plugin-preprocess-sass at rt.cpan.org, or through the web interface at http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Dancer-Plugin-Preprocess-Sass. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.

SUPPORT ^

You can find documentation for this module with the perldoc command.

    perldoc Dancer::Plugin::Preprocess::Sass

You can also look for information at:

SEE ALSO ^

ACKNOWLEDGEMENTS ^

The plugin uses Roger Pettett's Text::Sass module.

LICENSE AND COPYRIGHT ^

Copyright 2011 Michal Wojciechowski.

This program is free software; you can redistribute it and/or modify it under the terms of either: the GNU General Public License as published by the Free Software Foundation; or the Artistic License.

See http://dev.perl.org/licenses/ for more information.

syntax highlighting: