From ee5828b2f706a0052b9f54faf3550a1114b3d853 Mon Sep 17 00:00:00 2001 From: Parker Moore Date: Tue, 29 Jul 2014 17:32:36 -0400 Subject: [PATCH] Try to clarify the way sass imports happen. /cc @mrzool https://github.com/jekyll/jekyll-help/issues/104 --- site/docs/assets.md | 20 +++++++++++++++++--- 1 file changed, 17 insertions(+), 3 deletions(-) diff --git a/site/docs/assets.md b/site/docs/assets.md index b733e0eb..41e8b921 100644 --- a/site/docs/assets.md +++ b/site/docs/assets.md @@ -21,9 +21,9 @@ or `.coffee`) and start the file with two lines of triple dashes, like this: Jekyll treats these files the same as a regular page, in that the output file will be placed in the same directory that it came from. For instance, if you -have a file named `/css/styles.scss` in your site's source folder, Jekyll +have a file named `css/styles.scss` in your site's source folder, Jekyll will process it and put it in your site's destination folder under -`/css/styles.css`. +`css/styles.css`. ## Sass/SCSS @@ -38,7 +38,21 @@ sass: sass_dir: _sass {% endhighlight %} -The Sass converter will default to `_sass`. +The Sass converter will default the `sass_dir` configuration option to +`_sass`. + +
+
The sass_dir is only used by Sass
+

+ + Note that the `sass_dir` becomes the load path for Sass imports, + nothing more. This means that Jekyll does not know about these files + directly, so any files here should not contain the YAML front matter as + described above nor will they be transformed as described above. This + folder should only contain imports. + +

+
You may also specify the output style with the `style` option in your `_config.yml` file: