Hexo配置详解


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 HereYYYY-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 文章的转载规则,根据需求选择。

注意

  1. 如果你放置了 password,那么只有获知密码的读者才能访问这篇文章。
  2. covercoverImg 选项,在主题版本 v1.0.2 及以后版本中才开始支持。
  3. 'summary’可以让您控制显示在文章列表上的简介内容。
  4. 数学公式(mathjax)和TOC(toc)的特有选项需要在主题的配置文件中开启。
  5. 正确设置SEO相关字段(keywords, summary)有助于提高搜索引擎排名。

后续更新


文章作者: 阿坤
版权声明: 本博客所有文章除特別声明外,均采用 CC BY 4.0 许可协议。转载请注明来源 阿坤 !
  目录