jekyll/docs/_docs/variables.md

2.6 KiB
Raw Blame History

title permalink
Variables /docs/variables/

Jekyll traverses your site looking for files to process. Any files with front matter are subject to processing. For each of these files, Jekyll makes a variety of data available via the Liquid. The following is a reference of the available data.

Global Variables

{% for var in site.data.jekyll_variables.global %} {% endfor %}
Variable Description

{{ var.name }}

{{- var.description -}}

Site Variables

{% for var in site.data.jekyll_variables.site %} {% endfor %}
Variable Description

{{ var.name }}

{{- var.description -}}

Page Variables

{% for var in site.data.jekyll_variables.page %} {% endfor %}
Variable Description

{{ var.name }}

{{- var.description -}}

ProTip™: Use Custom Front Matter

Any custom front matter that you specify will be available under page. For example, if you specify custom_css: true in a pages front matter, that value will be available as page.custom_css.

If you specify front matter in a layout, access that via layout. For example, if you specify class: full_page in a layouts front matter, that value will be available as layout.class in the layout and its parents.

Paginator

{% for var in site.data.jekyll_variables.paginator %} {% endfor %}
Variable Description

{{ var.name }}

{{- var.description -}}

Paginator variable availability

These are only available in index files, however they can be located in a subdirectory, such as /blog/index.html.