全局变量
¥Global Variables
| 变量 | 描述 | 类型 |
|---|---|---|
site |
站点范围信息。 | object；参见 [站点变量] |
page |
在前言中设置的页面特定信息和自定义变量。 | object；参见 [页面变量] |
config |
站点配置。 | object(你网站的 _config 文件) |
theme |
主题配置。继承自站点配置。 | object(你主题的 _config 文件) |
path |
当前页面的路径 | string |
url |
当前页面的完整 URL | string |
env |
环境变量 | ??? |
自 Hexo 5.0.0 起，Lodash 已从全局变量中移除。你不需要 Lodash-Underscore 可能对你的迁移有帮助。
¥Lodash has been removed from global variables since Hexo 5.0.0. You-Dont-Need-Lodash-Underscore might be helpful for your migration.
站点变量
¥Site Variables
| 变量 | 描述 | 类型 |
|---|---|---|
site.posts |
所有帖子 | post 对象的 array |
site.pages |
所有页面 | page 对象的 array |
site.categories |
所有类别 | array 的 ??? |
site.tags |
所有标签 | array 的 ??? |
页面变量
¥Page Variables
文章（page）
¥Article (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 |
文章的照片（用于图库文章） | ??? 数组 |
page.link |
文章的外部链接（用于链接帖子） | string |
帖子（post）：与 page 布局相同，但添加以下变量。
¥Post (post): Same as page layout but add the following variables.
| 变量 | 描述 | 类型 |
|---|---|---|
page.published |
如果帖子不是草稿，则为 True | boolean |
page.categories |
帖子的所有类别 | array 的 ??? |
page.tags |
帖子的所有标签 | array 的 ??? |
主页（index）
¥Home (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 布局相同，但添加以下变量。
¥Archive (archive): Same as index layout but add the following variables.
| 变量 | 描述 | 类型 |
|---|---|---|
page.archive |
等于 true |
boolean |
page.year |
存档年份（4 位数字） | number |
page.month |
存档月份（2 位数字，无前导零） | number |
类别（category）：与 index 布局相同，但添加以下变量。
¥Category (category): Same as index layout but add the following variables.
| 变量 | 描述 | 类型 |
|---|---|---|
page.category |
类别名称 | string |
标签（tag）：与 index 布局相同，但添加以下变量。
¥Tag (tag): Same as index layout but add the following variables.
| 变量 | 描述 | 类型 |
|---|---|---|
page.tag |
标签名称 | string |