Hexo平台配置指南
官网
https://hexo.io/zh-cn/
准备工作
bash
npm install hexo-cli -g
hexo init hexo-blog
cd blog
npm install
hexo server
Hexo 的 Front-matter
Front-matter | Hexo
我开发此功能的测试博客：https://hexo.terwer.space
源码：https://github.com/terwer/hexo-blog
发布指南
基本设置
平台导入
1.
导入 Hexo 平台（如果是使用 Gitlab，Gitlab 需要自己部署，需要导入 Gitlabhexo，其他的类似，教程以 Github 为例）
点击发布工具图标：
依次选择 通用设置 -> 发布设置。
在弹出的对话框中依次点击 插件商店 -> Github -> Hexo，在弹出的抽屉里面点击 启用，然后 提交：
注意：这是首次添加。因为目前支持多个实例，如果是第二次添加可自定义设置名称。
然后关闭弹窗。重新点击 通用设置 -> 发布设置，在列表中可以看到刚刚新加的平台。
注意：强烈建议重新打开，避免配置未同步的可能。
2.
点击 通用设置 -> 发布设置，找到新增的 Hexo 平台。
3.
设置最小可用配置
点击 设置 进入平台设置界面。一般情况下，下列段是必须的。其他的配置可酌情修改。
配置 1
配置 2
配置 3-更多配置（可选）
4.
正确配置之后显示如下：
5.
开始发布，直接 一键发布 -> hexo 即可。
成功提示
6.
常规发布，支持更多个性化设置，点击 常规发布 -> Hexo，然后进去个性化设置之后发布即可。
7.
删除或者解除关联
发布成功之后可 删除 或者 解除关联，只能在常规发布操作。
删除：对应「取消」按钮，先删除远程文章，然后解除远程与本地的关联。
解除关联：对应「强制删除」按钮，强制解除关联，不管远程文章是否删除。此功能也可用于远程文章被删除之后的修复，以便于二次发布。
高级个性化设置
发布目录
默认是 source/_posts，如需修改请遵循 Hexo 官方说明
图床服务与图片存储路径 v1.34.0+
1.
不使用图床，不处理图片
2.
PicGo，使用图床绝对路径
3.
当前平台，此时可设置 图片存储路径 和 图片链接地址
图片存储路径：图片，默认为 source/images，一般情况不建议修改，如果修改请设置为 source/xxx
图片链接地址：文档里面引用的图片路径，本平台与图片存储路径保持一致即可，即 images ，一般情况不建议修改，如果修改请对应。
官方文档：Hexo 全局资源文件夹
文件规则
路径暂时不支持动态配置，但是可以通过自定义文件名规则来实现v1.29.1+。
基本配置
文件规则：[yyyy]/[MM]/[filename].md
其中，可用占位符如下，会动态替换：
[yyyy] 年，例如：2025
[MM] 月，例如：02
[mm]
[dd] 天 ，例如：26
[slug] 别名，例如：test-document-xdfr45f
[filename] 文件名，例如：测试文档
例如：[filename].md、[slug].md、[yyyy]-[mm]-[dd]-[slug].md
链接字符只能为 / - _ . ~ 其他的均会被移除。
分类和标签
对于分类和标签，新增两个变量
[category] 获取第一个分类，没有忽略
[cats] 所有分类组合起来
[tag] 获取第一个标签，没有忽略
[tags] 所有标签组合起来
YAML 预设
预览规则