做完博客主题 hexo-theme-xfm 之后,我接到了一个完全不同性质的需求:给机构做官网——企业、政务、学校。做完才发现,这两类站点看着都是「一堆网页」,实际是两种物种。 这个系列记录 hexo-theme-xongyi 从零到落地的全过程。它比博客主题更短、更简单,但产品决策的密度更高——因为它的用户不是开发者,是需要自己改文案的客户。

写主题时有个很现实的问题:提示块、选项卡、时间轴这些「好看的排版」,官方 Markdown 都不支持。常见做法是装一堆 hexo-tag-* 插件,但那违背了「零第三方依赖」的初衷——而且每装一个,就多一份「升级后不兼容」的风险。 于是我把它们全写进了主题的 scripts/tags/index.js,一共 14 个标签。这一篇讲实现思路和几个必须知道的坑。