We keep configuration in its own self-contained file so that we can load it independently in Rails 3, where the full plugin stuff is lazy-loaded.
VERSION | = | version[:string] unless defined?(Sass::VERSION) | A string representing the version of Sass. A more fine-grained representation is available from Sass.version. @api public | |
Callable | = | Struct.new(:name, :args, :environment, :tree) |
A Sass mixin or function.
`name`: `String` : The name of the mixin/function. `args`: `Array<(String, Script::Node)>` : The arguments for the mixin/function. Each element is a tuple containing the name of the argument and the parse tree for the default value of the argument. `environment`: {Sass::Environment} : The environment in which the mixin/function was defined. This is captured so that the mixin/function can have access to local variables defined in its scope. `tree`: `Array<Tree::Node>` : The parse tree for the mixin/function. |
|
ROOT_DIR | = | File.expand_path(File.join(__FILE__, "../../..")) | The root directory of the Sass source tree. This may be overridden by the package manager if the lib directory is separated from the main source tree. @api public |
logger | [RW] |
Compile a Sass or SCSS string to CSS. Defaults to SCSS.
@param contents [String] The contents of the Sass file. @param options [{Symbol => Object}] An options hash;
see {file:SASS_REFERENCE.md#sass_options the Sass options documentation}
@raise [Sass::SyntaxError] if there‘s an error in the document @raise [Encoding::UndefinedConversionError] if the source encoding
cannot be converted to UTF-8
@raise [ArgumentError] if the document uses an unknown encoding with `@charset`
Compile a file on disk to CSS.
@param filename [String] The path to the Sass, SCSS, or CSS file on disk. @param options [{Symbol => Object}] An options hash;
see {file:SASS_REFERENCE.md#sass_options the Sass options documentation}
@raise [Sass::SyntaxError] if there‘s an error in the document @raise [Encoding::UndefinedConversionError] if the source encoding
cannot be converted to UTF-8
@raise [ArgumentError] if the document uses an unknown encoding with `@charset`
@overload compile_file(filename, options = {})
Return the compiled CSS rather than writing it to a file. @return [String] The compiled CSS.
@overload compile_file(filename, css_filename, options = {})
Write the compiled CSS to a file. @param css_filename [String] The location to which to write the compiled CSS.