Sass integration for pub
Simply add the following lines to your
:::yaml dependencies: sass: any transformers: - sass
After adding the transformer your
.scss files will be automatically transformed to
You need to have Sass installed and available on the path.
You can also pass options to Sass if necessary:
:::yaml transformers: - sass: executable: /path/to/sass # Sass executable to use compass: true # Include compass line-numbers: true # Include line numbers in output style: compact # Style of generated CSS copy-sources: true # Copy original .scss/.sass files to output directory
You can use SassC instead of normal Sass by specifying executable as 'sassc' (or any path ending with 'sassc'):
:::yaml transformers: - sass: executable: sassc # or /path/to/sassc
SassC only supports
.scss-files and does not support Compass.
Normally the transformer simply asks Sass to process the primary input files and Sass will then read the dependent inputs from file system. However, if the input files for Sass are themselves produced by other transformers, they might not exist on the file system at all. The normal transformer will not work in those cases.
To work around this problem, you can use
inlined_sass_transformer. It will use Barback's APIs
to read and inline all imports into one big Sass file which it will then pass to Sass.
The downside is that line numbers on error messages and source maps might be incorrect. (See
To enable the use of inlined transformer, use
sass/inlined_sass_transformer as your transformer:
::yaml transformers: - sass/inlined_sass_transformer <possible configuration settings>
- UTF8-encoding is assumed for all input files.