This tool converts SASS and SCSS files into CSS. This tool explicitly supports
both the version written in C (sassc) and the original Ruby implementation
(scss) but other variants might also work. In addition to tool-specific
features, described in this section, the tool recognizes features <flags>
and <include>
.
Sets the output style. Available values are
nested
: each property is put on its own line, rules are indented based on
how deeply they are nested;expanded
: each property is put on its own line, rules are not indented;compact
: each rule is put on a single line, nested rules occupy adjacent
lines, while groups of unrelated rules are separated by newlines;compressed
: takes minimum amount of space: all unnecessary whitespace is
removed, property values are compressed to have minimal representation.The feature is optional
and is not propagated
to dependent targets. If no
style is specified, then, if property set contains property <optimization>on
,
compressed
style is selected. Otherwise, nested
style is selected.
Enables emitting comments showing original line numbers for rules. This can be
useful for debugging a stylesheet. Available values are on
and off
. The
feature is optional
and is not propagated
to dependent targets. If no value
for this feature is specified, then one is copied from the feature
debug-symbols
.
To use the sass
tool you need to declare it in a configuration file with the
using
rule. The initialization takes the following arguments:
command
: the command, with any extra arguments, to execute.For example you could insert the following in your user-config.jam
:
using sass : /usr/local/bin/psass -p2 ; # Perl libsass-based version
If no command
is given, sassc
is tried, after which scss
is tried.