1. Hexo 文章的元数据配置完全指南
Hexo 强大的功能部分归功于它的元数据配置,即 Front-matter,这些配置项位于 Markdown 文件顶部,并影响着文章的显示和行为。本文章深入解析了 Hexo 博客文章中各项元数据配置,帮助你更精确地控制文章的展示。
---
title: Your Title Here
date: YYYY-MM-DD HH:MM:SS
author: Your Name
img: http://example.com/feature-image.jpg
top: true
hide: false
cover: false
coverImg: http://example.com/cover-image.jpg
password: your-sha256-encypted-password
toc: true
mathjax: false
summary: Your custom article summary.
categories: Category
tags:
- Tag1
- Tag2
keywords: Keyword1, Keyword2, Keyword3
reprintPolicy: cc_by
---
# Your Title Here
Your article content starts here.
请记得将上述模板中的占位(例如 Your Title Here
或 YYYY-MM-DD HH:MM:SS
)替换成相应的信息。
解释一下每个配置的作用:
配置选项 | 默认值 | 描述 |
---|---|---|
title |
Markdown 文件标题 | 文章标题,应明确填写以便识别。 |
date |
文件创建时间 | 发布时间对于排序很重要,建议设为唯一。 |
author |
_config.yml的author值 | 文章的作者名。 |
img |
random featureImages值 | 文章特色图像,推荐使用可依赖的CDN服务。 |
top |
true |
是否将文章置顶在博客首页。 |
hide |
false |
设为true 则文章不显示在首页。 |
cover |
false |
自 v1.0.2 起,加入是否作为首页轮播封面文章。 |
coverImg |
无 | 首页轮播封面图片路径,如未指定使用img作为默认。 |
password |
无 | 文章密码,使用SHA256加密,激活主题配置中的verifyPassword 功能。 |
toc |
true |
是否为文章生成目录。 |
mathjax |
false |
是否为文章启用MathJax解析数学公式。 |
summary |
无 | 自定义文章摘要,如果为空自动截取内容。 |
categories |
无 | 文章分类,建议单分类以维护结构清晰。 |
tags |
无 | 文章的标签,可以有多个。 |
keywords |
文章标题 | 关键词有助于SEO。 |
reprintPolicy |
cc_by |
文章的转载规则,根据需求选择。 |
注意:
- 如果你放置了
password
,那么只有获知密码的读者才能访问这篇文章。 cover
和coverImg
选项,在主题版本 v1.0.2 及以后版本中才开始支持。- 'summary’可以让您控制显示在文章列表上的简介内容。
- 数学公式(
mathjax
)和TOC(toc
)的特有选项需要在主题的配置文件中开启。 - 正确设置SEO相关字段(
keywords
,summary
)有助于提高搜索引擎排名。