Document SASS_PATH

This commit is contained in:
Natalie Weizenbaum 2018-10-31 17:09:57 -07:00
parent 29c32eec1a
commit 6f7e4929ec
2 changed files with 27 additions and 0 deletions

View File

@ -98,6 +98,17 @@ Earlier load paths will take precedence over later ones.
$ sass --load-path=node_modules/bootstrap/dist/css style.scss style.css
```
Load paths are also loaded from the `SASS_PATH` [environment variable][], if
it's set. This variable should be a list of paths separated by `;` (on Windows)
or `:` (on other operating systems). Load paths on `SASS_PATH` take precedence
over load paths passed on the command line.
[environment variable]: https://en.wikipedia.org/wiki/Environment_variable
```shellsession
$ SASS_PATH=node_modules/bootstrap/dist/css sass style.scss style.css
```
#### `--require`
This option (abbreviated `-r`) loads a [Ruby gem][] before running Sass. It can

View File

@ -285,6 +285,11 @@ h1
### `includePaths`
<% impl_status dart: '1.15.0', node: '3.9.0' %>
Earlier versions of Dart Sass and Node Sass didn't support the `SASS_PATH`
environment variable.
<% end %>
This array of strings option provides [load paths][] for Sass to look for
imports. Earlier load paths will take precedence over later ones.
@ -297,6 +302,17 @@ sass.renderSync({
});
```
Load paths are also loaded from the `SASS_PATH` [environment variable][], if
it's set. This variable should be a list of paths separated by `;` (on Windows)
or `:` (on other operating systems). Load paths from the `includePaths` option
take precedence over load paths from `SASS_PATH`.
[environment variable]: https://en.wikipedia.org/wiki/Environment_variable
```shellsession
$ SASS_PATH=node_modules/bootstrap/dist/css sass style.scss style.css
```
### Output
These options control how Sass produces output files.