Hexo 博客迁移 Hugo 的一些感想

最近迁移了博客，从心爱的 Stellar 主题(Hexo)切换到了 Narrow 主题(Hugo)，后来又发现了 Reimu 主题(Hugo)。一方面是我的 wiki 页无法编译了，后面全是空白，另一方面是想着正好借此机会重构一下的我的博客内容和写法，清理一些遗留的 “垃圾”。在迁移和重构中我发现了一些关于写法上的问题，这里总结一下。

Note

• 目前，规范了 md 的书写规范，添加了 date frontmatter，因此，几乎所有文章的时间全部不可找回（之前浪子使用的 hexo 插件读取的 git 提交时间），统一设置为当前时间
• 关于内容正在逐步重构中，技术文章会可能会以最新版本为主，之前的旧配置酌情保留。

编写 md 要点

1. 文件目录组织按照分类管理，英文名称全部小写

   ├── skill
   │   └── Java
           └── index.md
   │   └── kotlin
   └── 生活
       ├── social
       └── dream
   

2. 文件名称尽量使用英文 or 拼音，多个单词使用 - 分割，全部小写

3. 文章 frontmatter 尽量包含 title、categories、tags、date 四项，基本支持 md 的博客主题都支持，其中 categories、tags 使用数组形式 之前浪子使用 hexo 时源文件不是数组，但没报错，迁移后改了好久QAQ

4. hexo 和 hugo 都支持 sulg/permalink，在无法使用英文/拼音的情况下较为有用。参见 hexo 支持，参见 hugo 支持。

5. 文章摘要可以在 <!-- --> 中编写，hexo、hugo 都支持

6. frontmatter 的 date 虽然可以根据一些插件，例如 git 记录的自动设置但还是推荐直接定义，这次迁移浪子的所有日期丢了。

总之，每篇文章确保 title、categories、tags、date 存在，其他的 frontmatter 能少就少，对于是主题特定支持的例如 cover、pin 等可以根据实际需要编写 这些文章可能没有那多，后续维护、迁移都比较方便。

优点：

1. 有些博客/博客主题支持按照目录名自动分类，这样 frontmatter 又可以少写一项😃不过即便如此，浪子也建议写文章的时候带上 categories。
2. url 一般不会变动(除非修改文件名)，不需要使用任何插件，无需担心中文转义的问题。
3. 每篇文章 frontmatter 简短好维护，便于迁移。

Warning

文件名使用英文的坏处也是显而易见的，经过翻译后会失去中文独有的意境和韵味，有时候非常的长。此时自定义 slug 是比较好的选择（当然啦，浪子也没有使用 slug，有些中文翻译不太到位）。