最近迁移了博客,从心爱的 Stellar 主题(Hexo)切换到了 Narrow 主题(Hugo),后来又发现了 Reimu 主题(Hugo)。一方面是我的 wiki 页无法编译了,后面全是空白,另一方面是想着正好借此机会重构一下的我的博客内容和写法,清理一些遗留的 “垃圾”。在迁移和重构中我发现了一些关于写法上的问题,这里总结一下。
Note
- 目前,规范了 md 的书写规范,添加了
datefrontmatter。但是,几乎所有文章的时间全部不可找回(之前浪子使用的 hexo 插件读取的 git 提交时间自动设置),因此统一设置为当前时间。- 关于内容正在逐步重构中,技术文章会可能会以最新版本为主,之前的旧配置酌情保留。
编写 md 要点
-
文件目录组织按照分类管理,英文名称全部小写
├── skill │ └── java └── index.md │ └── kotlin └── 生活 ├── social └── dream -
文件名称尽量使用英文 or 拼音,多个单词使用
-分割,全部小写 -
每篇文章的 frontmatter 尽量包含
title、categories、tags、date四项,基本支持 md 的博客主题都支持。其中categories、tags使用数组形式之前浪子使用 hexo 时源文件不是数组,但没报错,迁移后改了好久QAQ -
hexo 和 hugo 都支持 slug/permalink,在无法使用英文/拼音的情况下较为有用。参见 hexo 支持,参见 hugo 支持
-
文章摘要可以在
<!-- -->中编写,hexo、hugo 都支持(但略有不同,使用 AI 可以快速写一个脚本批量替换,对非程序猿很友好)
总之,每篇文章确保 title、categories、tags、date 存在,其他的 frontmatter 能少就少,对于是主题特定支持的例如 cover、pin 等可以根据实际需要编写 这些文章可能没有那多,后续维护、迁移都比较方便。
优点:
- 有些博客/博客主题支持按照目录名自动完成分类,这样 frontmatter 又可以少写一项😃不过即便如此,浪子也建议写文章的时候带上
categories。 - 在不使用任何插件的情况下无需担心中文转义的问题。因为只要文件名不变,url 也不会变。
- 每篇文章 frontmatter 简短好维护,便于迁移。
Warning
当然啦,万事没有绝对,使用英文的坏处也是显而易见的,经过翻译后会失去中文独有的意境和韵味,有时候还会非常的长。此时看自身喜好啦!这种情况自定义 slug 是比较好的选择(浪子在一些文章也没有使用 slug,中文果然是最优美的~)。

说些什么吧!