使用 hexo 搭建博客

感觉写这个还是比较有必要的。2024.9.17 配置完成的博客，现在作一下经验总结。持续更新。

前置

• 安装 Git。https://git-scm.com/。
• 安装 nodejs 新版。https://nodejs.org/en/download/。这里当时以为用 nvm 升级，结果 nvm 只有旧版本，不要用。
• 安装 Hexo。npm install hexo -g。
• 安装一键部署包。npm install --save hexo-deployer-git。

配置 SSH Key

这一段，我是直接参照 https://www.cnblogs.com/chenlove/p/15058170.html（不如说整个流程都是参照它的），直接做即可。

搭建

仍然可以查看上面这一篇，或者查看 Hexo 官方文档 https://hexo.io/zh-cn/docs/setup。整体的逻辑就是用 npm 管理所有的软件包。

编写博客

使用 Markdown。

一般有一个 front matter，就是在每篇文章的最上方有这样的文字：

---
layout: post
title: ...
date: ...
tags:
  - ...
  - ...
categories: ...
---

其他是正常的。

about 页的 layout 设置成 about。

渲染

为了支持 KaTeX 渲染，使用了 hexo-math 和 hexo-renderer-markdown-it-plus 插件。

我目前使用的主题是 Fluid，官方文档很全面，整体也很好看。不过有一些细节文档没有提及，在下面贴出我的 _config.yml 和 _config.fluid.yml（可能不随时更新）。事实上至今我也不知道到底谁管的大谁管的小，反正都提供参考就是了。

附加功能

评论使用 giscus 插件，网页统计使用 busuanzi，加密使用 hexo-blog-encrypt 插件，具体配置直接看下方的主题配置文件吧，就跟在 post 一段后面。

配置文件

本来想直接给出，结果发现一直在修改，如果在这方面觉得有疑惑可以直接联系本人，比如在文章下评论。

如果在加入 hexo-renderer-markdown-it-plus 后未将 fluid 语言调整为 zh-cn，将会变成德语，但不知道为啥。

我一开始尝试过其他主题，其中觉得比较好看的只有 particlex。但是它不支持 hexo-renderer-markdown-it-plus，代码高亮会死掉。开发者说推荐的渲染器是 hexo-renderer-pandoc，不过我没整成，懒了。

默认主题是 landscape。

维护

以下全部都是工作目录在博客目录下，终端的命令。

• 清空：hexo clear/hexo cl。
• 生成网页：hexo generate/hexo g。（它是惰性的，如果需要全部刷新需要先执行 hexo cl。）
• 本地预览：hexo server/hexo s。
• 上传到 GitHub：hexo deploy/hexo d。