最近迁移了博客,从心爱的 Stellar 主题(Hexo)切换到了 Narrow 主题(Hugo)。一方面是我的 wiki 页无法编译了,另一方面是想着正好借此机会重构一下的我的博客内容和写法,清理一些遗留的 “垃圾”。

在迁移和重构中我发现了一些问题,当然说到底还是我的经验不够,也偏向于使用中文记录的方式导致的。

命名

  1. 文件目录组织分类管理,英文名称全部小写
  2. 文件名称尽量使用英文 or 拼音,多个单词使用 - 分割,全部小写
  3. 文章 frontmatter 越少越好,尽量只保留 titlecategoriestagsdate,其中 categoriestags 使用数组 之前浪子使用 hexo 时不是数组,迁移后改了好久QAQ
  4. hexo 和 hugo 都支持 sulg/permalink。参见 hexo 支持 ,参见 hugo 支持 ,此项一般根据需要而定。比如有时候 title 用英文会很别扭,用拼音则显不出水平 才、才不是浪子的英文水平不太行呢😤。比如 “朝花夕拾”、“月章星句” 之类的。总感觉有点儿翻译不到位,缺点儿什么。此时可以使用自定义 slug;如果是术语则非常简单
  5. 文章摘要可以在 <!-- --> 中编写,hexo、hugo 都支持

强烈推荐文件名称使用 英文/拼音 的方式命名,多个单词间可使用 - 隔开。frontmatter 中尽量只写必填项,能少就少,而像其它的尤其是主题特定的例如 coverpin 可以根据实际需要编写 这些总没有那多吧。 这样做的好处就是 url 一般不会变动(除非修改文件名)。每篇文章中的 frontmatter 少一项还挺好,每次看到头部文章很长的的 yml 就很痛苦😅而且不需要使用任何插件,无需担心中文转义的问题。

顺带提一下,虽然 date 可以根据 git 记录的日期填写但还是推荐直接定义。

内容

对于内容方面,不能一概而论。但对于一般使用者而言,常用的也不多,慢慢修改吧。浪子之前有很多诗句收录,现在这些都还没改动呢🥲

使用静态的博客主题时无法避免使用一些特殊的语法块,这样拥有更舒适、美观的效果,但是对于迁移来说可能就是灾难。

目录组织

目录推荐按照 categories 归类,例如:

BASH
1├── 技术
2│   └── c
3        └── index.md
4│   └── kotlin
5└── 生活
6    ├── 日记
7    └── 梦想
点击展开查看更多

有些博客支持按照目录名自动分类,这样 frontmatter 又可以少写一项😃不过即便如此,浪子也建议写文章的时候带上。

版权声明

作者: 浮生一梦

链接: /posts/2025/10/blog-migration-reflections/

许可证: 知识共享署名-非商业性使用-相同方式共享 4.0 国际许可协议

本作品采用知识共享署名-非商业性使用-相同方式共享 4.0 国际许可协议进行许可。

评论

开始搜索

输入关键词搜索文章内容

↑↓
ESC
⌘K 快捷键