Hexo 文章开头被两组 --- 包围的内容叫做 Front Matter(文章元信息)。
用于设置文章标题、日期、链接、摘要、封面、标签和分类等信息。
标准模板
1 |
|
字段说明
| 字段 | 作用 |
|---|---|
title |
文章标题,显示在首页、文章页面和 RSS 中。 |
date |
文章第一次发布的时间。 |
updated |
文章最后一次修改的时间。首次发布时可以和 date 相同。 |
permalink |
文章访问地址。当前规则为 /posts/英文文件名/。 |
notify |
是否向 QQ 群发送新文章通知。true 发送,false 不发送。 |
excerpt |
文章摘要,用于首页文章卡片和 QQ 群通知。 |
description |
文章简介,主要用于搜索引擎,也会在 excerpt 为空时作为通知摘要。 |
cover |
文章封面图片路径。 |
tags |
文章涉及的具体主题,可以填写多个。 |
categories |
文章所属的主要栏目,通常填写一个。 |
封面路径
本地文件:
1 | source/images/posts/文章英文名/cover.webp |
文章中填写:
1 | cover: /images/posts/文章英文名/cover.webp |
路径中不要写 source。
标签和分类
标签可以填写多个:
1 | tags: |
分类通常填写一个:
1 | categories: |
可以把分类理解为文章所在的栏目,把标签理解为文章包含的具体内容。
QQ 群通知
正常发送通知:
1 | notify: true |
正常发布文章,但不发送 QQ 群通知:
1 | notify: false |
不填写 notify 时,当前通知脚本默认仍会发送通知。
完整示例
1 |
|
写文章时的注意事项
- 文章标题可以使用中文。
- 文章文件名尽量使用英文,避免 URL 出现中文编码。
excerpt写给读者和 QQ 群看,文章摘要。description主要写给搜索引擎看。- 不想通知 QQ 群时使用
notify: false。 - 封面路径从
/images/开始,不要带source。 - 标签可以有多个,分类通常只选一个。
评论