所有字段均为可选,如有遗漏或错误欢迎点击右侧的【编辑本文】提交 PR 进行补充。
Hexo 内置字段
| 参数 | 描述 | 默认值 |
|---|---|---|
layout |
布局 | config.default_layout |
title |
标题 | 文章的文件名 |
date |
建立日期 | 文件建立日期 |
updated |
更新日期 | 文件更新日期 |
sticky |
置顶(数字越大越靠前) | |
pin |
置顶排序值(设置即置顶,数字越大越靠前,true 视作 1;兼容 sticky 别名)。article.pin_style 为默认 carousel 时,文章由置顶轮播展示且首页列表不重复;为 flat 时,文章在首页第一页列表靠前展示,卡片不再显示置顶图标 |
|
comments |
开启文章的评论功能 | true |
tags |
标签(不适用于分页) | |
categories |
分类(不适用于分页) | |
permalink |
覆盖文章的永久链接,永久链接应该以 / 或 .html 结尾 |
null |
excerpt |
纯文本的页面摘要。使用 该插件 来格式化文本 | |
disableNunjucks |
启用时禁用 Nunjucks 标签 {{ }}/{% %} 和 标签插件 的渲染功能 |
false |
lang |
设置语言以覆盖 自动检测 | 继承自 _config.yml |
published |
文章是否发布 | 对于 _posts 下的文章为 true,对于 _draft 下的文章为 false |
Stellar 特有字段
| 参数 | 描述 | 默认值 | 可用版本 |
|---|---|---|---|
| wiki | 该页面所属的 wiki 项目 | ||
| menu_id | 高亮的菜单按钮 id | ||
| sidebar | 侧边栏配置 | 1.0.0 ~ 1.26.8 | |
| leftbar | 左侧边栏配置 | 1.27.0 ~ | |
| rightbar | 右侧边栏配置 | 1.27.0 ~ | |
| comment_title | 评论区标题 | ||
| subtitle | hero 卡片与置顶轮播的一行小字:subtitle > description > excerpt 前 50 字 | ||
| banner | 页面顶部横幅背景 | ||
| banner_info | 横幅信息,包含 avatar/title/subtitle 子配置 | ||
| logo | 左侧边栏顶部 logo 区域信息,包含 icon/avatar/title/subtitle 子配置 | ||
| indent | 段落是否缩进 | false | |
| topic | 所属话题/专栏 | 1.25.0 ~ | |
| author | 该文章的作者 | 1.23.0 ~ | |
| type | 页面类型 | 1.26.0 ~ | |
| ai_label | AI 成分标记:manual / polished / generated / reviewed;未设置时取 article.ai_label.default(为空则不显示);文案由多语言系统提供(meta.ai_label.*),颜色与图标由 article.ai_label 配置 |
||
| references | 参考资料 | ||
| h1 | 页内标题 | title | 1.26.0 ~ |
| breadcrumb | 面包屑导航 | true | |
| indexing | 页面能否是否能被搜索 | true |
第三方插件
| 参数 | 描述 | 类型 |
|---|---|---|
| mathjax | 渲染文章公式 | boolean |
| katex | 同上 | boolean |
| mermaid | 渲染图表 | boolean |