NAME¶
Plack::Middleware::File::Sass - Sass and SCSS support for all Plack frameworks
SYNOPSIS¶
use Plack::App::File;
use Plack::Builder;
builder {
mount "/stylesheets" => builder {
enable "File::Sass";
Plack::App::File->new(root => "./stylesheets");
};
};
# Or with Middleware::Static
enable "File::Sass", syntax => "scss";
enable "Static", path => qr/\.css$/, root => "./static";
DESCRIPTION¶
Plack::Middleware::File::Sass is a Plack middleware component that works with
Plack::App::File or Plack::Middleware::Static to compile Sass
<
http://sass-lang.com/> templates into CSS stylesheet in every request.
When a request comes in for
.css file, this middleware changes the
internal path to
.sass or
.scss, depending on the configuration,
in the same directory. If the Sass template is found, a new CSS stylesheet is
built on memory and served to the browsers. Otherwise, it falls back to the
original
.css file in the directory.
This middleware should be very handy for the development. While Sass to CSS
rendering is reasonably fast, for the production environment you might want to
precompile Sass templates to CSS files on disk and serves them with a real web
server like nginx or lighttpd.
SASS BACKENDS¶
If you have the sass gem version higher than 3 installed and have the
"sass" executable available in your PATH, this module automatically
uses the command to convert Sass or SCSS into CSS. If the command is not
available and you have Text::Sass perl module available, it will be used.
Otherwise you'll get an exception during the initialization of this middleware
component.
OPTIONS¶
- syntax
- Defines which syntax to use. Valid values are sass
and scss. Defaults to sass.
AUTHOR¶
Tatsuhiko Miyagawa <miyagawa@bulknews.net>
LICENSE¶
This library is free software; you can redistribute it and/or modify it under
the same terms as Perl itself.
SEE ALSO¶
Plack::App::File Text::Sass
http://sass-lang.com/
<
http://sass-lang.com/>