变量

全局变量

变量描述类型
site网站变量object; 见 网站变量
page针对该页面的内容以及 front-matter 中自定义的变量。object; 见 页面变量
config网站配置object (站点的配置文件)
theme主题配置。继承自网站配置。object (主题配置文件)
_ (单下划线)Lodash 函数库Lodash 文档
path当前页面的路径(不含根路径)string
url当前页面的完整网址string
env环境变量???

网站变量

变量描述类型
site.posts所有文章array of post objects
site.pages所有分页array of page objects
site.categories所有分类object,包含了站点全部的分类
site.tags所有标签array,包含了站点全部的标签

页面变量

页面(page

变量描述类型
page.title页面标题string
page.date页面建立日期Moment.js 对象
page.updated页面更新日期Moment.js 对象
page.comments留言是否开启boolean
page.layout布局名称string
page.content页面的完整内容string
page.excerpt页面摘要string
page.more除了页面摘要的其余内容string
page.source页面原始路径string
page.full_source页面的完整原始路径string
page.path页面网址(不含根路径)。我们通常在主题中使用 url_for(page.path)string
page.permalink页面的完整网址string
page.prev上一个页面。如果此为第一个页面则为 nullstring or null
page.next下一个页面。如果此为最后一个页面则为 nullstring or null
page.raw文章的原始内容???
page.photos文章的照片(用于相簿)array
page.link文章的外部链接(用于链接文章)string

文章 (post):page 布局相同,但新增以下变量。

变量描述类型
page.published如果该文章已发布则为 trueboolean
page.categories该文章的所有分类array of ???
page.tags该文章的所有标签array of ???

首页(index

变量描述类型
page.per_page每页显示的文章数量number
page.total总页数number
page.current目前页数number
page.current_url目前分页的网址string
page.posts本页文章 (Data Model)object
page.prev上一页的页数。如果此页是第一页的话则为 0number
page.prev_link上一页的网址。如果此页是第一页的话则为 ''string
page.next下一页的页数。如果此页是最后一页的话则为 0number
page.next_link下一页的网址。如果此页是最后一页的话则为 ''string
page.path当前页面的路径(不含根目录)。我们通常在主题中使用 url_for(page.path)string

归档 (archive):与 index 布局相同,但新增以下变量。

变量描述类型
page.archive等于 trueboolean
page.year年份归档 (4位)number
page.month月份归档 (没有前导零的2位数)number

分类 (category):与 index 布局相同,但新增以下变量。

变量描述类型
page.category分类名称string

标签 (tag):与 index 布局相同,但新增以下变量。

变量描述类型
page.tag标签名称string