avatar

你好,世界!

2026-02-12 15:28

想法

我喜欢浏览各种各样的个人主页、博客。 不管这些网站是用于展示技能、分享日常还是单纯作为一个笔记, 它们带给我的感觉总是一座跨越时空的桥梁, 我作为读者,可以愉快地跑到作者的伊甸园里细细观摩品鉴。

看多了之后,自己就也想做一个了。

机遇

是的,就和当初切换到某个特定的发行版的经历一样, 我在互联网的角落里偶然发现了 Hugo。

当然啦,没有想法的话这短暂的一瞥可能就这么过去了。

尝试

照着文档一顿操作之后,一个热乎的静态网站页面就做好了。 黑箱科技真是厉害。

不过我立刻就发现了一个(对我来说很重要的)问题: Ananke 主题没有深色主题。

作为一个重度浏览器用户,怎么能没有深色主题呢? 于是就去寻找合适的 Hugo 主题。

一番搜索和体验之后,我锁定了这几个主题: PaperPaper-ModStack。 这几个主题都有深色、浅色主题切换开关、柔和的配色以及不错的界面布局设计和使用体验。

但是在实际使用这几个主题并进行配置的时候,我发现我或许并不需要这么多的特性和功能。

除此以外,我对这几个主题的深色、浅色切换功能并不满意, Paper 和 Paper-Mod 压根没有能跟随系统设置的“自动模式”, Stack 的切换功能是自动的,但我没法设置到“自动”,因为它没给“自动”这个选项。

改?直接写一个!

“那我能不能直接做一个功能够用而且有我想要的深色浅色主题切换功能的 Hugo 主题呢?” (这是在我折腾没多久就冒出来的想法,现在看来有些过于大胆了……)

于是我一头钻进 Hugo 的文档里啃了起来。 因为这套文档里并没有关于 Hugo 主题的详细信息, 只有一句话:“主题和站点一样,就是一个 Hugo 模块。”。 因此毫不夸张地说,这一啃就是一个月。 这中间是不断的尝试理解、实践、吃瘪、重来…… 这样的流程丢出来给读者看太枯燥了,于是就跳过吧。

小插曲,Archie 这个简洁的主题, 甚至用的还是旧版的模板系统,却帮助我理解了 Hugo 的模板系统。

收尾

最终,我写好了我的主题:Mage, 它有我需要的所有功能:头像展示、主页文章、自定义的分页样式、归档、关于页、分类标签,以及深色浅色主题切换功能, 也有类似前面所说的主题的配色和卡片式布局样式。

有了合适的主题,我就静下心来把这篇文章给完成了。

那么,前面是想法、中间忘了、最后写好了(

写在最后

虽然有点唐突,但是我还是要感谢我的好朋友们。 感谢你们的帮助和支持,不管是不是在建站这件事上。


评论功能由 Giscus 驱动