📋 Hexo 模版使用指南
本指南将详细介绍如何使用 Hexo 博客系统中的各种模版文件来创建不同类型的内容。
🎯 模版类型说明
1. 普通文章模版 (post.md)
适用场景： 日常博客文章、技术笔记、生活分享等
使用方法：
1 | hexo new "文章标题" |
模版特点：
- 包含完整的 SEO 元数据
- 内置文章要点提示框
- 预设相关文章和参考资料区域
- 支持目录导航和评论功能
2. 教程文章模版 (tutorial.md)
适用场景： 技术教程、操作指南、学习笔记
使用方法：
1 | hexo new tutorial "教程标题" |
模版特点：
- 学习目标清单
- 难度等级和预计时间
- 结构化的教程步骤
- 常见问题解答区域
- 前置准备和环境要求
3. 技术分享模版 (tech-share.md)
适用场景： 项目分享、技术方案、代码示例
使用方法：
1 | hexo new tech-share "技术分享标题" |
模版特点：
- 技术栈展示
- 项目链接和演示地址
- 性能对比表格
- 最佳实践总结
- 代码示例区域
4. 读书笔记模版 (book-note.md)
适用场景： 读书心得、学习笔记、知识总结
使用方法：
1 | hexo new book-note "《书名》读书笔记" |
模版特点：
- 书籍信息卡片
- 精彩摘录和页码引用
- 知识脉络图
- 个人思考和实践应用
- 行动计划模块
5. 页面模版 (page.md)
适用场景： 关于页面、联系页面、项目介绍等静态页面
使用方法：
1 | hexo new page "页面标题" |
模版特点：
- 适合静态页面布局
- 包含联系方式模块
- 功能介绍和使用说明区域
- 默认关闭评论功能
6. 草稿模版 (draft.md)
适用场景： 文章草稿、灵感记录、未完成内容
使用方法：
1 | hexo new draft "草稿标题" |
模版特点：
- 草稿状态提醒
- 文章大纲和编写进度
- 灵感记录区域
- 待完善内容跟踪
🛠️ 实用技巧
批量创建文章
1 | # 创建多篇教程 |
发布草稿
1 | # 将草稿移动到正式文章 |
自定义模版
你可以在 scaffolds 目录下创建自己的模版文件：
1 | # 创建新模版 |
模版变量
在模版中可以使用以下变量：
{{ title }}- 文章标题{{ date }}- 创建日期{{ layout }}- 布局类型
📝 最佳实践
- 选择合适的模版： 根据内容类型选择最适合的模版
- 完善元数据： 填写完整的 keywords、description 等 SEO 信息
- 使用标签分类： 合理使用 tags 和 categories 进行内容分类
- 保持格式统一： 使用模版能保证文章格式的一致性
🔧 故障排除
如果遇到 ValidationError: null is not a string! 错误：
- 检查 front matter 中的字段是否有空值
- 将空值改为空字符串
"" - 确保所有必填字段都有有效值
例如：
1 | # 错误写法 |