++ed by:
ADAMJS CKRAS KARJALA KEEDI NEYASOV

6 PAUSE user(s)
6 non-PAUSE user(s).

Jan Henning Thorsen

NAME

Mojolicious::Plugin::AssetPack::Preprocessors - Holds preprocessors

METHODS

add

  $self->add($extension => $cb);

Define a preprocessor which is run on a given file extension. These preprocessors will be chained. The callbacks will be called in the order they where added.

The default preprocessor defined is described under "detect".

detect

Will add the following preprocessors, if they are available:

  • jsx

    JSX is a JavaScript XML syntax transform recommended for use with React. See http://facebook.github.io/react/docs/jsx-in-depth.html for more information.

    Installation on Ubuntu and Debian:

      $ sudo apt-get install npm
      $ npm install -g react-tools
  • less

    LESS extends CSS with dynamic behavior such as variables, mixins, operations and functions. See http://lesscss.org for more details.

    Installation on Ubuntu and Debian:

      $ sudo apt-get install npm
      $ sudo npm install -g less
  • sass

    Sass makes CSS fun again. Sass is an extension of CSS3, adding nested rules, variables, mixins, selector inheritance, and more. See http://sass-lang.com for more information. Supports both *.scss and *.sass syntax variants.

    Installation on Ubuntu and Debian:

      $ sudo apt-get install rubygems
      $ sudo gem install sass
  • compass

    Compass is an open-source CSS Authoring Framework built on top of "sass". See http://compass-style.org/ for more information.

    Installation on Ubuntu and Debian:

      $ sudo apt-get install rubygems
      $ sudo gem install compass

    This module will try figure out if "compass" is required to process your *.scss files. This is done with this regexp on the top level sass file:

      m!\@import\W+compass\/!;

    NOTE! Compass support is experimental.

    You can disable compass detection by setting the environment variable MOJO_ASSETPACK_NO_COMPASS to a true value.

  • js

    Javascript is minified using JavaScript::Minifier::XS. This module is optional and must be installed manually.

    EXPERIMENTAL! Not sure if this is the best minifier.

  • css

    CSS is minified using CSS::Minifier::XS. This module is optional and must be installed manually.

    EXPERIMENTAL! Not sure if this is the best minifier.

  • coffee

    CoffeeScript is a little language that compiles into JavaScript. See http://coffeescript.org for more information.

    Installation on Ubuntu and Debian:

      $ npm install -g coffee-script

process

  $self->process($extension => $assetpack, \$text, $filename);

Will run the preprocessor callbacks added by "add". The callbacks will be called with the $assetpack object as the first argument.

map_type

  $self = $self->map_type($from => $to);
  $to = $self->map_type($from);

Method used to map one file type that should be transformed to another file type. Example:

  $self->map_type(coffee => "js");

remove

  $self->remove($extension);
  $self->remove($extension => $cb);

This method will remove all preprocessors defined for an extension, or just a given $cb.

AUTHOR

Jan Henning Thorsen - jhthorsen@cpan.org




Hosting generously
sponsored by Bytemark