• 全局变量
  • 网站变量
  • 页面变量

    全局变量

    变量描述类型
    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上一个页面。如果此为第一个页面则为 null。string or null
    page.next下一个页面。如果此为最后一个页面则为 null。string 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上一页的页数。如果此页是第一页的话则为 0。number
    page.prev_link上一页的网址。如果此页是第一页的话则为 ''。string
    page.next下一页的页数。如果此页是最后一页的话则为 0。number
    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