Jekyll 模板数据 - Havee's Space

原文地址：https://github.com/mojombo/jekyll/wiki/Template-Data

Jekyll 会遍历你的站点，来寻找需要处理的文件。任何具有 YAML 前置数据的文件都将会被处理，每一个这样的文件，Jekyll 都会通过 Liquid 模板系统使用许多可用的页面变量。下面是一个可用变量的列表。

变量	描述
site	全站的信息加 `_config.yml` 文件中的配置选项
page	这个变量中包含 YAML 前置数据，另外加上两个额外的变量值：url和content。
content	在布局模板文件中，这里变量包含了页面的子视图。这个变量将会把渲染后的内容插入到模板文件中。这个变量不能在文章和页面文件中使用。
paginator	一旦paginate配置选项被设置了，这个变量才能被使用。

变量	描述
site.time	当前的时间（当你运行 Jekyll 时的时间）
site.posts	一个按时间逆序的文章列表。
site.related_posts	如果当前被处理的页面是一个文章文件，那这个变量是一个包含了最多 10 篇相关文章的列表。默认来说，这些相关文章是低质量但计算快的。为了得到高质量但计算慢的结果，运行 Jekyll 命令时可以加上 –lsi 选项。（潜在语意索引）
site.categories.CATEGORY	所有在 CATEGORY 分类中的文章列表
site.tags.TAG	所有拥有 TAG 标签的文章的列表
site.CONFIGURATION_DATA	截止 0.5.2 版本，所有在 `_config.yml` 中的数据都能够通过 site 变量调用。举例来说，如果你有一个这样的选项在你的配置文件中：url: http://mysite.com，那在文章和页面文件中可以这样调用 {{ site.url }} 。Jekyll 并不会自动解析修改过的 `_config.yml` 文件，你想要启用新的设置选项，你需要重启 Jekyll

变量	描述
page.content	页面中未渲染的内容
page.title	文章的标题
page.url	除去域名以外的URL，例子：/2008/12/14/my-post.html
page.date	指定每一篇文章的时间，这个选项能够覆盖一篇文章中前置数据设置的时间，它的格式是这样的：YYYY-MM-DD HH:MM:SS
page.id	每一篇文章的唯一标示符(在RSS中非常有用) 例子：/2008/12/14/my-post
page.categories	这篇文章隶属的分类的一个列表，分类是通过在 `_post` 目录中的目录结构推导而来的。举例来说，在路径 /work/code/_posts/2008-12-24-closures.textile 下的文件，这个变量将会是 [work,code]。这个变量也能在YAML前置数据中被指定。
page.tags	这篇文章的标签的列表。这些数据能够在 YAML 前置数据中指定
page.next	按时间序的下一篇文章
page.previous	按时间序的上一篇文章
page.path	页面源码的地址，可以链接到托管服务器上的md文件地址

注意:任何你自己指定的自定义前置数据都能够通过page调用。举例来说，如果你在页面的前置数据中设置了custom_css: true，那这个值可以在模板可以这样调用:page.custom_css

注意:这个变量只能在索引文件中才能使用。