Included more details about adding defaults to static files
Based on the functionality released in [3.4.2](http://jekyllrb.com/news/2017/03/09/jekyll-3-4-2-released/) re adding defaults to static files, I thought this page needed some more detail.
This commit is contained in:
parent
351e3abd8e
commit
f9243c5ab1
|
@ -65,3 +65,35 @@ following metadata:
|
||||||
</tbody>
|
</tbody>
|
||||||
</table>
|
</table>
|
||||||
</div>
|
</div>
|
||||||
|
|
||||||
|
Note that in the above table, `file` can be anything. It's simply an arbitrarily set variable used in your own logic (such as in a for loop). It isn't a global site or page variable.
|
||||||
|
|
||||||
|
## Add front matter to static files
|
||||||
|
|
||||||
|
Although you can't directly add front matter values to static files, you can actually set front matter values through the [defaults property](../configuration/#front-matter-defaults) in your configuration file. When Jekyll builds the site, it will use the front matter values you set.
|
||||||
|
|
||||||
|
Here's an example:
|
||||||
|
|
||||||
|
In your `_config.yml` file, add the following values to the `defaults` property:
|
||||||
|
|
||||||
|
```yaml
|
||||||
|
defaults:
|
||||||
|
- scope:
|
||||||
|
path: "assets/img"
|
||||||
|
values:
|
||||||
|
image: true
|
||||||
|
```
|
||||||
|
|
||||||
|
This assumes that your Jekyll site has a folder path of `assets/img` where you have images (static files) stored. When Jekyll builds the site, it will treat each image as if it had the front matter value of `image: true`.
|
||||||
|
|
||||||
|
Suppose you want to list all your image assets as contained in `assets/img`. You could use this for loop to look in the `static_files` object and get all static files that have this front matter property:
|
||||||
|
|
||||||
|
```liquid
|
||||||
|
{% raw %}{% for myfile in site.static_files %}
|
||||||
|
{% if myfile.image == true %}
|
||||||
|
{{ myfile.path }}
|
||||||
|
{% endif %}
|
||||||
|
{% endfor %}{% endraw %}
|
||||||
|
```
|
||||||
|
|
||||||
|
When you build your site, the output will list the path to each file that meets this front matter condition.
|
||||||
|
|
Loading…
Reference in New Issue