plumbum的模板

title: plumbum的模板
date: 2024-11-14 09:25:00
author: plumbum
img: /source/images/xxx.jpg
top: true 是否是推荐文章
hide: false
cover: true 这是主页是否放在最前面
coverImg: /medias/banner/1.jpg
password:
toc: false
mathjax: false
summary: 这是自定义的文章摘要内容，如果这个属性有值，文章卡片摘要就显示这段文字，否则程序会自动截取文章的部分内容作为摘要
categories: Markdown
tags:

• Typora
• Markdown

在 Hexo 的 Matery 主题中，文章 Front-matter（YAML 头部配置）的字段有特定用途。以下是各字段的详细解释：

---

1. title

• 作用：文章的标题。
• 示例：title: "Plumbum的模板"
• 注意：会显示在文章列表、正文页面的标题栏和浏览器标签页中。

---

2. date

• 作用：文章的创建时间（发布时间）。
• 格式：必须为 YYYY-MM-DD HH:mm:ss（年月日 时分秒）。
• 示例：date: 2024-11-14 09:25:00
• 注意：Hexo 根据此字段排序文章，最新文章默认显示在最前面。

---

3. author

• 作用：文章作者。
• 示例：author: plumbum
• 注意：如果主题配置中已全局定义作者，此字段可覆盖全局配置。

---

4. img

• 作用：文章在首页列表中显示的缩略图（封面图）。
• 示例：img: /images/thumbnail.jpg
• 注意：
  • 路径基于 hexo/source 目录（如 /images/xxx.jpg 对应 source/images/xxx.jpg）。
  • 如果未设置，Matery 主题显示默认图片或随机图片（取决于主题配置）。

---

5. top

• 作用：是否将文章置顶。
• 值：true 或 false。
• 示例：top: false
• 注意：置顶文章会显示在首页列表的最前面。

---

6. hide???

• 作用：是否隐藏文章（不在首页列表显示）。
• 值：true 或 false。
• 示例：hide: false
• 注意：即使设为 true，仍可通过直接链接访问文章。

---

7. cover

• 作用：是否在文章正文页显示封面图。
• 值：true 或 false。
• 示例：cover: false
• 注意：需配合 coverImg 字段使用。我发现写false也会因为什么bug还是会显示在首页最上面，所以不用的话直接删除 cover 和 coverImg字段

---

8. coverImg

• 作用：文章正文页的封面图路径。
• 示例：coverImg: /medias/banner/1.jpg
• 注意：需开启 cover: true 才会生效。

---

9. password

• 作用：为文章设置访问密码。
• 示例：password: 123456
• 注意：需要 Matery 主题或插件支持（默认可能不启用，需自行配置加密逻辑）。

---

10. toc

• 作用：是否自动生成文章目录（Table of Contents）。
• 值：true 或 false。
• 示例：toc: false
• 注意：Matery 主题默认据文章标题自动生成目录。

---

11. mathjax

• 作用：是否启用数学公式渲染（如 LaTeX）。
• 值：true 或 false。
• 示例：mathjax: false
• 注意：需主题支持并正确配置 MathJax 库。

---

12. summary

• 作用：自定义文章摘要。若未设置，主题会自动截取文章前部分内容作为摘要。
• 示例：summary: 这是自定义摘要...
• 注意：在首页列表中显示，用于简要描述文章内容。

---

13. categories

• 作用：文章分类（支持多级分类）。
• 示例：

  categories: 
    - 技术
    - Hexo

• 注意：分类名会显示在文章页和归档页。

---

14. tags

• 作用：文章标签（用于关联相关文章）。
• 示例：

  tags:
    - Typora
    - Markdown

• 注意：标签名会显示在文章页和标签云页面。

---

参考 Matery 主题官方文档 获取最新配置说明。