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:

    *   RT: CPAN's request tracker

        <http://rt.cpan.org/NoAuth/Bugs.html?Dist=Dancer-Plugin-Preprocess-S
        ass>

    *   AnnoCPAN: Annotated CPAN documentation

        <http://annocpan.org/dist/Dancer-Plugin-Preprocess-Sass>

    *   CPAN Ratings

        <http://cpanratings.perl.org/d/Dancer-Plugin-Preprocess-Sass>

    *   Search CPAN

        <http://search.cpan.org/dist/Dancer-Plugin-Preprocess-Sass/>

SEE ALSO
    *   Sass website

        <http://sass-lang.com/>

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.