变量

全局变量

变量 描述 类型
site 站点信息。 object; 请参考 站点变量
page 页面特定信息和在 front-matter 中设置的自定义变量。 object; 请参考 页面变量
config 站点配置。 object (您站点的 _config 文件)
theme 主题配置。继承自站点配置。 object (您主题的 _config 文件)
path 当前页面的路径 string
url 当前页面的完整 URL string
env 环境变量 ???

自 Hexo 5.0.0 起,Lodash 已从全局变量中移除。 You-Dont-Need-Lodash-Underscore 可能对您的迁移有所帮助。

站点变量

变量 描述 类型
site.posts 所有文章 array of post objects
site.pages 所有页面 array of page objects
site.categories 所有分类 array of ???
site.tags 所有标签 array of ???

页面变量

文章 (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(不包含根 URL)。我们通常在主题中使用 url_for(page.path) string
page.permalink 文章的完整(编码)URL string
page.prev 上一篇文章,如果文章是第一篇文章,则为 null ???
page.next 下一篇文章,如果文章是最后一篇文章,则为 null ???
page.raw 文章的原始数据 ???
page.photos 文章的图片(用于图库文章) array of ???
page.link 文章的外部链接(用于链接文章) string

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

变量 描述 类型
page.published 如果文章不是草稿,则为 True boolean
page.categories 文章的所有分类 array of ???
page.tags 文章的所有标签 array of ???

首页 (index)

变量 描述 类型
page.per_page 每页显示的文章数量 number
page.total 总页数 number
page.current 当前页码 number
page.current_url 当前页面的 URL string
page.posts 此页面的文章 (数据模型) object
page.prev 上一页的页码。如果当前页面是第一页,则为 0 number
page.prev_link 上一页的 URL。如果当前页面是第一页,则为 '' string
page.next 下一页的页码。如果当前页面是最后一页,则为 0 number
page.next_link 下一页的 URL。如果当前页面是最后一页,则为 '' string
page.path 当前页面的 URL(不包含根 URL)。我们通常在主题中使用 url_for(page.path) string

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

变量 描述 类型
page.archive 等于 true boolean
page.year 归档年份(4 位数字) number
page.month 归档月份(2 位数字,不含前导零) number

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

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

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

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