Hexo模板使用规范

概述

本文档旨在规范Hexo博客系统的模板使用，包括文章(post)、页面(page)和草稿(draft)三种类型的模板。通过统一的模板规范，确保博客内容的一致性和SEO优化效果。

模板类型及使用场景

1. 文章模板 (post)

使用命令：

hexo new "文章标题"
# 或
hexo new post "文章标题"

适用场景：

• 日常博客文章
• 技术分享
• 教程文档
• 需要在首页展示的内容

2. 页面模板 (page)

使用命令：

hexo new page "页面名称"

适用场景：

• 关于页面
• 友情链接
• 项目介绍
• 不需要在首页展示的独立页面

3. 草稿模板 (draft)

使用命令：

hexo new draft "草稿标题"

适用场景：

• 尚未完成的文章
• 需要进一步完善的文档
• 临时记录的想法

Front-matter 字段说明

通用字段

字段名	类型	必填	说明
title	String	是	文章标题
date	Date	是	文章创建日期
categories	Array	否	文章分类，建议只设置一个主分类
tags	Array	否	文章标签，可设置多个
keywords	Array	否	SEO关键词
description	String	否	页面描述，用于SEO优化
comments	Boolean	否	是否开启评论，默认为true
cover	String	否	封面图片路径

特殊标记

• <!-- more -->：摘要分隔符，以上部分会作为文章摘要在首页显示

最佳实践建议

1. 分类与标签使用规范

• 分类(categories)：建议一篇文章只归属一个主要分类，体现文章的核心主题
• 标签(tags)：可以设置多个标签，用于细化文章内容和方便检索

2. SEO优化建议

• 填写 keywords 和 description 字段，有助于搜索引擎收录
• 标题应简洁明了，能够准确概括文章内容
• 描述应控制在150字符以内

3. 封面图片规范

• 推荐尺寸：1200px × 630px
• 格式：JPG或PNG
• 文件命名应具有描述性

4. 内容结构建议

1. 使用清晰的标题层级（H1, H2, H3…）
2. 合理使用列表、代码块等格式化元素
3. 在适当位置插入图片以增强可读性
4. 使用 <!-- more --> 标记文章摘要部分

模板维护

当需要更新模板时，请注意：

1. 保持各模板间字段的一致性
2. 更新后及时通知团队成员
3. 在版本控制系统中记录变更原因

常见问题

Q: 如何预览草稿？

A: 使用以下命令启动服务器并预览草稿：

hexo server --drafts

Q: 如何将草稿发布为正式文章？

A: 使用以下命令：

hexo publish draft "草稿标题"

Q: 分类和标签有什么区别？

A: 分类是文章的归类，通常比较固定且数量较少；标签是对文章内容的细化描述，可以灵活设置。

---

本文档最后更新于 2025年12月18日