Module: Sass

Extends:
Sass::Version
Defined in:
/var/www/sass-pages/.sass/lib/sass.rb,
/var/www/sass-pages/.sass/lib/sass/css.rb,
/var/www/sass-pages/.sass/lib/sass/repl.rb,
/var/www/sass-pages/.sass/lib/sass/util.rb,
/var/www/sass-pages/.sass/lib/sass/root.rb,
/var/www/sass-pages/.sass/lib/sass/scss.rb,
/var/www/sass-pages/.sass/lib/sass/exec.rb,
/var/www/sass-pages/.sass/lib/sass/error.rb,
/var/www/sass-pages/.sass/lib/sass/engine.rb,
/var/www/sass-pages/.sass/lib/sass/plugin.rb,
/var/www/sass-pages/.sass/lib/sass/logger.rb,
/var/www/sass-pages/.sass/lib/sass/shared.rb,
/var/www/sass-pages/.sass/lib/sass/script.rb,
/var/www/sass-pages/.sass/lib/sass/version.rb,
/var/www/sass-pages/.sass/lib/sass/scss/rx.rb,
/var/www/sass-pages/.sass/lib/sass/selector.rb,
/var/www/sass-pages/.sass/lib/sass/tree/node.rb,
/var/www/sass-pages/.sass/lib/sass/importers.rb,
/var/www/sass-pages/.sass/lib/sass/callbacks.rb,
/var/www/sass-pages/.sass/lib/sass/plugin/rack.rb,
/var/www/sass-pages/.sass/lib/sass/scss/parser.rb,
/var/www/sass-pages/.sass/lib/sass/environment.rb,
/var/www/sass-pages/.sass/lib/sass/script/lexer.rb,
/var/www/sass-pages/.sass/lib/sass/cache_stores.rb,
/var/www/sass-pages/.sass/lib/sass/script/parser.rb,
/var/www/sass-pages/.sass/lib/sass/script/funcall.rb,
/var/www/sass-pages/.sass/lib/sass/importers/base.rb,
/var/www/sass-pages/.sass/lib/sass/tree/root_node.rb,
/var/www/sass-pages/.sass/lib/sass/tree/warn_node.rb,
/var/www/sass-pages/.sass/lib/sass/selector/simple.rb,
/var/www/sass-pages/.sass/lib/sass/scss/css_parser.rb,
/var/www/sass-pages/.sass/lib/sass/script/variable.rb,
/var/www/sass-pages/.sass/lib/sass/util/subset_map.rb,
/var/www/sass-pages/.sass/lib/sass/tree/debug_node.rb,
/var/www/sass-pages/.sass/lib/sass/tree/return_node.rb,
/var/www/sass-pages/.sass/lib/sass/tree/import_node.rb,
/var/www/sass-pages/.sass/lib/sass/logger/log_level.rb,
/var/www/sass-pages/.sass/lib/sass/script/css_lexer.rb,
/var/www/sass-pages/.sass/lib/sass/cache_stores/base.rb,
/var/www/sass-pages/.sass/lib/sass/script/css_parser.rb,
/var/www/sass-pages/.sass/lib/sass/scss/script_lexer.rb,
/var/www/sass-pages/.sass/lib/sass/tree/content_node.rb,
/var/www/sass-pages/.sass/lib/sass/cache_stores/null.rb,
/var/www/sass-pages/.sass/lib/sass/selector/sequence.rb,
/var/www/sass-pages/.sass/lib/sass/scss/script_parser.rb,
/var/www/sass-pages/.sass/lib/sass/tree/function_node.rb,
/var/www/sass-pages/.sass/lib/sass/cache_stores/chain.rb,
/var/www/sass-pages/.sass/lib/sass/tree/variable_node.rb,
/var/www/sass-pages/.sass/lib/sass/scss/static_parser.rb,
/var/www/sass-pages/.sass/lib/sass/cache_stores/memory.rb,
/var/www/sass-pages/.sass/lib/sass/tree/mixin_def_node.rb,
/var/www/sass-pages/.sass/lib/sass/plugin/configuration.rb,
/var/www/sass-pages/.sass/lib/sass/importers/filesystem.rb,
/var/www/sass-pages/.sass/lib/sass/selector/comma_sequence.rb,
/var/www/sass-pages/.sass/lib/sass/cache_stores/filesystem.rb,
/var/www/sass-pages/.sass/lib/sass/selector/simple_sequence.rb,
/var/www/sass-pages/.sass/lib/sass/plugin/staleness_checker.rb,
/var/www/sass-pages/.sass/lib/sass/selector/abstract_sequence.rb

Overview

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.

Defined Under Namespace

Modules: CacheStores, Callbacks, Exec, Importers, Logger, Media, Plugin, SCSS, Script, Selector, Shared, Supports, Tree, Util, Version Classes: CSS, Callable, Engine, Environment, Repl, SyntaxError, UnitConversionError

Constant Summary

ROOT_DIR = The root directory of the Sass source tree. 
File.expand_path(File.join(__FILE__, "../../.."))
VERSION = A string representing the version of Sass. 
version[:string] unless defined?(Sass::VERSION)

Class Attribute Summary

Class Method Summary

Class Attribute Details

+ logger

Returns the value of attribute logger



11
12
13
 
# File '/var/www/sass-pages/.sass/lib/sass/logger.rb', line 11

def logger
  @logger
end

Class Method Details

+ compile(contents, options = {})

Compile a Sass or SCSS string to CSS. Defaults to SCSS.

Parameters:

  • (String) contents — The contents of the Sass file.
  • ({Symbol => Object}) options (defaults to: {}) — An options hash; see the Sass options documentation

Raises:

  • (Sass::SyntaxError) — if there’s an error in the document
  • (Encoding::UndefinedConversionError) — if the source encoding cannot be converted to UTF-8
  • (ArgumentError) — if the document uses an unknown encoding with @charset 


52
53
54
55
 
# File '/var/www/sass-pages/.sass/lib/sass.rb', line 52

def self.compile(contents, options = {})
  options[:syntax] ||= :scss
  Engine.new(contents, options).to_css
end

+ (String) compile_file(filename, options = {}) + compile_file(filename, css_filename, options = {})

Compile a file on disk to CSS.

Overloads:

  • + (String) compile_file(filename, options = {})

    Return the compiled CSS rather than writing it to a file.

    Returns:

    • (String) — The compiled CSS.
  • + compile_file(filename, css_filename, options = {})

    Write the compiled CSS to a file.

    Parameters:

    • (String) css_filename — The location to which to write the compiled CSS.

Parameters:

  • (String) filename — The path to the Sass, SCSS, or CSS file on disk.
  • ({Symbol => Object}) options — An options hash; see the Sass options documentation

Raises:

  • (Sass::SyntaxError) — if there’s an error in the document
  • (Encoding::UndefinedConversionError) — if the source encoding cannot be converted to UTF-8
  • (ArgumentError) — if the document uses an unknown encoding with @charset 


76
77
78
79
80
81
82
83
84
85
86
87
 
# File '/var/www/sass-pages/.sass/lib/sass.rb', line 76

def self.compile_file(filename, *args)
  options = args.last.is_a?(Hash) ? args.pop : {}
  css_filename = args.shift
  result = Sass::Engine.for_file(filename, options).render
  if css_filename
    options[:css_filename] ||= css_filename
    open(css_filename,"w") {|css_file| css_file.write(result)}
    nil
  else
    result
  end
end

+ (Array<String, Pathname, Sass::Importers::Base>) load_paths

The global load paths for Sass files. This is meant for plugins and libraries to register the paths to their Sass stylesheets to that they may be @imported. This load path is used by every instance of Sass::Engine. They are lower-precedence than any load paths passed in via the :load_paths option.

If the SASS_PATH environment variable is set, the initial value of load_paths will be initialized based on that. The variable should be a colon-separated list of path names (semicolon-separated on Windows).

Note that files on the global load path are never compiled to CSS themselves, even if they aren’t partials. They exist only to be imported.

Examples:

  Sass.load_paths << File.dirname(__FILE__ + '/sass')

Returns:



37
38
39
40
 
# File '/var/www/sass-pages/.sass/lib/sass.rb', line 37

def self.load_paths
  @load_paths ||= ENV['SASS_PATH'] ?
    ENV['SASS_PATH'].split(Sass::Util.windows? ? ';' : ':') : []
end