Skip to content

Commit 39e0be3

Browse files
committed
Expose preferred_syntax configuration in README
This is the most important configuration one can set for sass-rails, yet the only reliable place to find it is [StackOverflow](http://stackoverflow.com/questions/6006360/how-to-make-rails-3-1-use-sass-over-scss-as-the-default).
1 parent 7138bbb commit 39e0be3

File tree

1 file changed

+9
-7
lines changed

1 file changed

+9
-7
lines changed

README.md

Lines changed: 9 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -19,17 +19,19 @@ properties that will be passed to Sass.
1919
The [list of supported options](http://sass-lang.com/docs/yardoc/file.SASS_REFERENCE.html#options)
2020
can be found on the Sass Website with the following caveats:
2121

22-
1. `:style` - This option is not supported. This is determined by the Rails environment. It's `:expanded` only on development, otherwise it's `:compressed`.
23-
2. `:never_update` - This option is not supported. Instead set `config.assets.enabled = false`
24-
3. `:always_update` - This option is not supported. Sprockets uses a controller to access stylesheets in development mode instead of a full scan for changed files.
25-
4. `:always_check` - This option is not supported. Sprockets always checks in development.
26-
5. `:syntax` - This is determined by the file's extensions.
27-
6. `:filename` - This is determined by the file's name.
28-
7. `:line` - This is provided by the template handler.
22+
1. `preferred_syntax` - This option determines the default Sass syntax and file extensions that will be used by Rails generators. Can be `:scss` (default CSS-compatible SCSS syntax) or `:sass` (indented Sass syntax).
23+
2. `:style` - This option is not supported. This is determined by the Rails environment. It's `:expanded` only on development, otherwise it's `:compressed`.
24+
3. `:never_update` - This option is not supported. Instead set `config.assets.enabled = false`
25+
4. `:always_update` - This option is not supported. Sprockets uses a controller to access stylesheets in development mode instead of a full scan for changed files.
26+
5. `:always_check` - This option is not supported. Sprockets always checks in development.
27+
6. `:syntax` - This is determined by the file's extensions.
28+
7. `:filename` - This is determined by the file's name.
29+
8. `:line` - This is provided by the template handler.
2930

3031
### Example
3132

3233
MyProject::Application.configure do
34+
config.sass.preferred_syntax = :sass
3335
config.sass.line_comments = false
3436
config.sass.cache = false
3537
end

0 commit comments

Comments
 (0)