diff --git a/site/_includes/docs_contents.html b/site/_includes/docs_contents.html index 523b5227..bed2a66c 100644 --- a/site/_includes/docs_contents.html +++ b/site/_includes/docs_contents.html @@ -3,7 +3,7 @@

Getting Started

{% include docs_ul.html items='home quickstart installation usage structure configuration' %}

Your Content

- {% include docs_ul.html items='frontmatter posts drafts pages variables datafiles migrations' %} + {% include docs_ul.html items='frontmatter posts drafts pages variables datafiles assets migrations' %}

Customization

{% include docs_ul.html items='templates permalinks pagination plugins extras' %}

Deployment

diff --git a/site/_includes/docs_contents_mobile.html b/site/_includes/docs_contents_mobile.html index bbc367d4..6313a59f 100644 --- a/site/_includes/docs_contents_mobile.html +++ b/site/_includes/docs_contents_mobile.html @@ -5,7 +5,7 @@ {% include docs_option.html items='home quickstart installation usage structure configuration' %} - {% include docs_option.html items='frontmatter posts drafts pages variables datafiles migrations' %} + {% include docs_option.html items='frontmatter posts drafts pages variables datafiles assets migrations' %} {% include docs_option.html items='templates permalinks pagination plugins extras' %} diff --git a/site/docs/assets.md b/site/docs/assets.md new file mode 100644 index 00000000..5191dc15 --- /dev/null +++ b/site/docs/assets.md @@ -0,0 +1,46 @@ +--- +layout: docs +title: Assets +prev_section: datafiles +next_section: migrations +permalink: /docs/assets/ +--- + +Jekyll provides built-in support for Sass and CoffeeScript. In order to use +them, create a file with the proper extension name (one of `.sass`, `.scss`, +or `.coffee`) and start the file with two lines of triple dashes, like this: + +{% highlight sass %} +--- +--- + +// start content +.my-definition + font-size: 1.2em +{% endhighlight %} + +## Sass/SCSS + +Jekyll allows you to customize your Sass conversion in certain ways. + +If you are using Sass `@import` statements, you'll need to ensure that your +`sass_dir` is set to the base directory that contains your Sass files. You +can do that thusly: + +{% highlight yaml %} +sass: + sass_dir: _sass +{% endhighlight %} + +The Sass converter will default to `_sass`. + +You may also specify the output style with the `style` option in your +`_config.yml` file: + +{% highlight yaml %} +sass: + style: :compressed +{% endhighlight %} + +These are passed to Sass, so any output style options Sass supports are valid +here, too. diff --git a/site/docs/datafiles.md b/site/docs/datafiles.md index b3421c38..55af6ec4 100644 --- a/site/docs/datafiles.md +++ b/site/docs/datafiles.md @@ -2,25 +2,25 @@ layout: docs title: Data Files prev_section: variables -next_section: migrations +next_section: assets permalink: /docs/datafiles/ --- In addition to the [built-in variables](../variables/) available from Jekyll, -you can specify your own custom data that can be accessed via the [Liquid +you can specify your own custom data that can be accessed via the [Liquid templating system](http://wiki.github.com/shopify/liquid/liquid-for-designers). -Jekyll supports loading data from [YAML](http://yaml.org/) files located in the +Jekyll supports loading data from [YAML](http://yaml.org/) files located in the `_data` directory. This powerful feature allows you to avoid repetition in your templates and to -set site specific options without changing `_config.yml`. +set site specific options without changing `_config.yml`. Plugins/themes can also leverage Data Files to set configuration variables. ## The Data Folder -As explained on the [directory structure](../structure/) page, the `_data` +As explained on the [directory structure](../structure/) page, the `_data` folder is where you can store additional data for Jekyll to use when generating your site. These files must be YAML files (using either the `.yml` or `.yaml` extension) and they will be accessible via `site.data`. diff --git a/site/docs/migrations.md b/site/docs/migrations.md index 27ecf71d..f9ecc1f5 100644 --- a/site/docs/migrations.md +++ b/site/docs/migrations.md @@ -1,7 +1,7 @@ --- layout: docs title: Blog migrations -prev_section: datafiles +prev_section: assets next_section: templates permalink: /docs/migrations/ ---