0.27.0:博客变成了文件,不再是代码

发布不再是一次代码改动。同一个版本还查出了:为什么六个网站里有四个正文低于对比度门槛。

在这个版本之前,一篇文章是一条 TypeScript 记录:正文在一个文件里,译文在另一个里,索引在第三个里。文章只有三篇的时候,这样是行的。到第十篇就看得很清楚:发布是一次代码改动,也就意味着只有能改代码的人才能发布。

现在一篇文章就是一个文件。`content/resources/2026-06-18-first-post.en.md`:日期和短名在文件名里,语言在后缀里,图片在旁边的文件夹里。frontmatter 是十行 `key: value`,正文是段落、一级标题、一张图和一组图。索引、它归到哪一组、路线和站点地图,全部从「这个文件存在」推导出来。

图组自己决定长什么样

正文里可以放一组图片,怎么画出来只取决于有几张。一张是一个画框。两三张并排。四张以上变成带缩略图的一条。

作者不需要选。这件事比听上去重要:一篇图组跟上一篇长得不一样的文章,意味着这篇文章里夹了一个版式决定,而没有人是为了这个才打开文件的。

没人算过的对比度

这个版本的另一半是颜色。「文字压在底色上必须过 AA」这条规矩从一开始就写着,却没有任何东西在检查它。等到真有东西去查,**六个网站里有四个在线以下**:2.15、2.55、2.96 和 3.59 比 1。

事情就是这么发生的:品牌色当背景挺好看,颜色搭配靠眼睛挑,中橄榄绿上的米白看着很像回事,量出来是 2.96。现在这一对是算出来的,不达标的时候审计会直说,并且停止给其余项目打分:在底色和文字能一起被读清楚之前,页面上别的颜色都不值得讨论。

那些弱化的标签也不再是「黑色 55%」了。用黑色的前提是底色浅;在深绿上,那就是深绿上的黑。它们现在继承文字的颜色,在浅色网站上略深一点,在深色网站上则是「读得清」和「读不清」的分别。

02继续读

博客里的更多内容

两篇,不会更多。 更长的一条会把文章结尾变成第二个目录页,而读者已经选过一次了。