最近迁移了博客,从心爱的 Stellar 主题(Hexo)切换到了 Narrow 主题(Hugo)。一方面是我的 wiki 页无法编译了,另一方面是想着正好借此机会重构一下的我的博客内容和写法,清理一些遗留的 “垃圾”。
在迁移和重构中我发现了一些问题,当然说到底还是我的经验不够,也偏向于使用中文记录的方式导致的。
命名
- 文件目录组织分类管理,英文名称全部小写
- 文件名称尽量使用英文 or 拼音,多个单词使用
-
分割,全部小写 - 文章 frontmatter 越少越好,尽量只保留
title
、categories
、tags
、date
,其中categories
、tags
使用数组之前浪子使用 hexo 时不是数组,迁移后改了好久QAQ - hexo 和 hugo 都支持 sulg/permalink。参见 hexo 支持
,参见 hugo 支持
,此项一般根据需要而定。比如有时候
title
用英文会很别扭,用拼音则显不出水平才、才不是浪子的英文水平不太行呢😤。比如 “朝花夕拾”、“月章星句” 之类的。总感觉有点儿翻译不到位,缺点儿什么。此时可以使用自定义 slug;如果是术语则非常简单 - 文章摘要可以在
<!-- -->
中编写,hexo、hugo 都支持
强烈推荐文件名称使用 英文/拼音 的方式命名,多个单词间可使用 -
隔开。frontmatter 中尽量只写必填项,能少就少,而像其它的尤其是主题特定的例如 cover
、pin
可以根据实际需要编写 这些总没有那多吧。
这样做的好处就是 url 一般不会变动(除非修改文件名)。每篇文章中的 frontmatter 少一项还挺好,每次看到头部文章很长的的 yml 就很痛苦😅而且不需要使用任何插件,无需担心中文转义的问题。
顺带提一下,虽然 date 可以根据 git 记录的日期填写但还是推荐直接定义。
内容
对于内容方面,不能一概而论。但对于一般使用者而言,常用的也不多,慢慢修改吧。浪子之前有很多诗句收录,现在这些都还没改动呢🥲
使用静态的博客主题时无法避免使用一些特殊的语法块,这样拥有更舒适、美观的效果,但是对于迁移来说可能就是灾难。
目录组织
目录推荐按照 categories 归类,例如:
1├── 技术
2│ └── c
3 └── index.md
4│ └── kotlin
5└── 生活
6 ├── 日记
7 └── 梦想
有些博客支持按照目录名自动分类,这样 frontmatter 又可以少写一项😃不过即便如此,浪子也建议写文章的时候带上。
评论