Boost C++ Libraries

PrevUpHomeNext

Miscellaneous Tools

Sass

Sass

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>.

Feature: sass-style

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.

Feature: sass-line-numbers

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.

Initialization

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.


PrevUpHomeNext