SCSS Compiler

The SCSS Compiler provides a mechanism to translate style files written to the SCSS format into CSS files. The actual compiler is the SCSSPHP compiler that is added as a plugin supplied with Paloose (1.19.x), and is the WP-SCSS version used within the latest version of WordPress. Paloose will work fine if you don't need this facility and you can remove SCSSPHP from the plugins folder.

The SCSS compiler must be considered as a transformer from its behaviour: it must not appear first or last in a pipeline line (i.e. not before a generator or after a serializer). It is declared in the transformers declaration of the sitemap as

where the parameters are

• src — (optional) defines where your SCSS files are stored. This would normally be a folder within the resources folder at the same level as the CSS folder (defaults to "context://resources/scss" if not given).
• dst — (optional) is the destination file for the CSS generated files. It is also the folder where the compilers cache folder (scss_cache) is held (defaults to "context://resources/styles" if not given).
• compact — (optional) defines where the CSS generated is in a compact form (defaults to "no" if not given). Permitted values are "yes", "true" or "1" and "no", "false" or "0".

The default values given above should be always used unless there is a particular reason. Using the component is simple, place it anywhere within a sitemap pipeline as a transformer:

which would compile any scss file in the src folder to the dst folder. If anything in the pipeline relies on generated CSS then the pipeline stage should be moved earlier in the pipeline (but not before the generation stage (the aggregate in the example following). If the scss file has not changed then the compiler uses the already existing css file.