Proposed re-wording of Sass note. :)

[jpasholk]

This is a 🔦 documentation change.

Summary

If I am understanding this right, my re-wording helps me clearly visualize what's going on in plainer English.

Context

Semver Changes

[DirtyF]

Thanks Josh 👍

[jpasholk]

@DirtyF Yeah man!

I had to read that whole thing like 10 times to understand wtf was going on, lol. I hope my version is a bit clearer.

Also, dude that was fast!

Hope you have a wonderful Thanksgiving. :)

[DirtyF]

@jpasholk People have troubles understanding this the first time.

Any file in _sass directory is a normal .scss or .sass file and does not need empty front matter to be processed by Jekyll. We don't want to process these files, just to import them in a main Sass file that is located in the source directory.

Any Sass file, for instance /assets/css/styles.scss in the source directory, has to have the empty front matter to be processed by Jekyll. The corresponding CSS output will be then located in _site/assets/css/style.css.

To put things differently: you store various small Sass files in the _sass directory and then you import them all in your main Sass file, that has to live in the source directory to be processed by Jekyll. And everytime you want Jekyll to render a file, be it a Sass file, a Markown file or any other type, it has to have front matter. That's how you tell jekyll to process a file. If you just want Jekyll to copy a file to the destination folder (like a regular HTML file) you don't need to add front matter.

That is the file you want to point to in the head of your template:

<link rel="stylesheet" href="{{ "/assets/css/styles.css" | relative_url }}">

@jekyllbot: merge +docs

[jpasholk]

@DirtyF Yeah for sure. I think I'm understanding it enough to actually start using it now, rather than just vanilla CSS. This is such a nice feature of Jekyll, takes all of the work out of using Sass for the most part.

Anyway, thanks for the quick response on this man!

Cheers!!

[DirtyF]

@jpasholk 🍻 for your first contribution, keep'em coming 🦃