rump-sass
v0.6.2
Published
Rump piece for building CSS from Sass
Downloads
14
Readme
Rump Sass
About
Rump Sass is a Rump module for styles authored in Sass with Autoprefixer included. For more information, visit the Rump repository.
API
The following is appended to the core Rump API:
rump.addGulpTasks(options)
This module adds the following tasks:
build:sass
will process SCSS stylesheets with Sass and Autoprefixer. For more information on source and destination paths seerump.configure()
below. This task is also added to thebuild
task.watch:sass
will runbuild:sass
, then monitor for changes and process updated files as needed. This task is also added to thewatch
task.info:sass
will display information on what this specific module does, specifically the source and destination paths as well as what files would get processed. This task is also added to theinfo
task.
rump.configure(options)
Redefine options for Rump and Rump modules to follow. In addition to what options Rump and other Rump modules offer, the following options are available alongside default values:
options.paths.source.sass
('styles'
)
This is the directory where styles to be processed are contained. This path is
relative to the root source path. (If the default root and Sass path is used,
then the path would be src/styles
)
options.paths.destination.sass
('styles'
)
This is the directory where styles are copied to. This path is relative to the
root destination path. (If the default root and Sass path is used, then the
path would be dist/styles
)
options.globs.build.sass
('*.scss'
)
This specifies which stylesheets to process. By default it processes all SCSS files in the immediate directory of the root source path for styles.
options.globs.watch.sass
('**/*.scss'
)
This specifies which stylesheets to monitor for changes. By default it watches all SCSS files in the root source path for styles, including those in subdirectories.
options.styles.minify
(options.environment === 'production'
)
This specifies whether to minify generated CSS. (minified if true
) By default
CSS is minified only if the environment is set to production. (visit the main
Rump repository for more information on environment)
options.styles.sourceMap
(options.environment === 'development'
)
This specifies whether to include inline source maps to generated CSS. (source
maps included if true
) By default source maps are included only if the
environment is set to development. (visit the main Rump repository for more
information on environment)
options.styles.autoprefixer
This specifies any options you want to add to Autoprefixer. (specifically gulp-autoprefixer)
options.styles.sass
This specifies any options you want to override in Sass. (specifically
gulp-sass) Compression by default is
enabled or disabled based on the minify option above. Default search paths for
@import
are also added, including: node_modules
, bower_components
, and
root source path for styles detailed above. If the Rump Image modules is
included, image-url
is set up so that it relative to the destination paths of
Sass and images. (if the defaults are used for Sass dist/styles
and dist/images
, then the image path is set to ../images
)
rump.configs.autoprefixer
, rump.configs.sass
This contains the generated options that are passed to Autoprefixer and Sass, respectively, in the Gulp task. This is a good way to see what options are generated based on defaults and overrides.