Development

共369篇文章。

给代码块加上可填写的示例参数:Chaos主题的code_vars和其他一些近期更新

• Development

我平时会写不少技术文档。其中的示范代码,特别是涉及命令行操作的部分,往往包含一些需要临时填写并在后文重复使用的参数,读者不能直接照搬例子去运行,而是需要先做一些修改才能使用。

前几天在写生成SSHFP和TLSA记录这篇作弊条的时候,我顺手给本站使用的Chaos主题加上了一个可交互的示例参数功能,并把之前合并BIND 9子域等几篇旧文也一并改了过来。

从减少重复手工操作、避免忙中出错的角度来说,许多时候(尤其是对于「作弊条」这类题材的内容),比较理想的文档形式应该是一个可以填写、填完就能直接复制的模板。这是因为在这些操作里,变量(或者说需要读者填写的内容)通常是主机名、IP地址,或是本地某条命令的输出结果(例如公钥的hash值),而其余参数则应与原文保持严格一致,且同一组参数往往会贯穿全文。

例如在TLSA和SSHFP那篇里,域名example.net、邮件服务器mx1、SSH主机beastie,以及前一步刚用OpenSSL算出来的公钥SHA-256和SHA-512散列值,会在后面的命令行和BIND区域文件模板里反复出现。假如完全靠手工在各个代码块之间来回查找替换,不仅繁琐,而且漏改或是贴错一段,还很容易导致一些其他问题。

在一些文档系统的DSL中,有一种用<var>标签标记的可编辑占位符:在渲染出来的页面上填入新值之后,整篇文档里的示例命令就会跟着一起变,点复制按钮拿到的也是替换好的命令。我认为这种交互非常适合类似作弊条这样的内容,于是用Antigravity给Chaos主题也做了一套类似的实现。这里记录一下它在实际文章中的写法,以及在迭代过程中考虑的一些细节。

阅读全文…(本文约6676字,阅读大致需要14分钟)

给博客做个站内全文搜索:纯前端离线倒排索引的设计与取舍

• Development

最近给本站正在使用的Chaos主题增加并逐步完善了一套在客户端进行的全文检索功能。

早年本站使用的是Google站内搜索,不过换成Hugo以后模板中的这个搜索框也就去掉了,毕竟现在也没什么人看blog了,写下去除了给自己留点记录之外,或多或少其实是一种行为艺术,而本站的读者基本上也都知道如何使用搜索引擎。

不过,有时我自己也会希望在blog里找一些以前的文章,虽然本站在Google搜索中的覆盖率还相当高,但有些时候新的文章会搜索不到,或是其实内容已经过时但仍然被索引。虽然在大语言模型的帮助下我整体重建了分类和标签的标注,但这些对于定位有时还是不太方便。

Hugo作为一个静态站点生成器,其实已经有了不少成熟的本地搜索方案。不过,今年都已经2026年了,vibe一个本地搜索并不困难。这里记录一下这个本地搜索的演化过程,以及在这个过程中的一些工程取舍。

阅读全文…(本文约4455字,阅读大致需要9分钟)

polyxslt:给浏览器补上一个轻量级 XSLT 处理器

• Development

我给本站的RSS和Atom feed加了一个纯JavaScript实现的XSLT处理器,为浏览器移除内建XSLT支持做准备。

本站在2021年2月5日为RSS feed和sitemap添加了XSLT样式,后来重新设计本站主题chaos-theme时也沿用了这一做法。

这些XML文档便于程序读取,但直接给人看就不太直观;XSLT可以把它们转换成HTML,让同一份内容同时服务于程序和人类读者。

阅读全文…(本文约3613字,阅读大致需要8分钟)

如何:不借助第三方服务粗略检测访客是否来自中国大陆

• Development

作为一个平时基本不怎么碰前端代码的开发者,以前偶尔遇到需要折腾前端的需求时,我总有一种「摸着石头过河」的感觉。

最近我就碰到了这样一个棘手的场景:我的某个网站上需要调用的一些服务,在中国大陆的网络环境下访问时经常会出现加载失败或极度缓慢的问题。为了保证用户的浏览体验,比较理想的做法是:检测到访客来自中国大陆时,默认将他们重定向到支持大陆访问的同类型备用服务上。

阅读全文…(本文约1223字,阅读大致需要3分钟)

cron 的 PAM 支持

• Development

在上一家公司的时候曾经有很多关于cron(8) 的想法,但一直没有付诸实施,很多东西放在本地慢慢生锈了。

去年年底的时候我开始着手去修了一些cron(8) 的bug,其中包括为cron之前不够完整的PAM支持进行了改进。

背景:PAM

Pluggable Authentication Module (PAM) 为一系列身份验证相关的操作提供了一组通用的接口。在没有PAM之前,应用程序需要实现大量重复的代码来完成类似的操作,例如要求用户输入密码并进行验证等。这么做的问题在于缺乏灵活性,例如,管理员可能希望将用户数据保存到LDAP目录中,或是使用指纹等新式验证方式。PAM使这些相关操作可以通过插件来完成,应用程序不再需要关心「如何验证用户身份」(用户名、密码等等是不是正确),而只需要向PAM询问「该用户的身份是否合法?」即可。这层抽象简化了应用程序开发者的工作,并且赋予了系统管理员更大的灵活性。

PAM将系统的认证工作分成了四组基本操作:

  • auth:验证用户身份(比如检查密码)。
  • account:检查账户是否有效(比如是否过期、是否允许在此时间登录)。
  • password:用于修改密码。
  • session:会话管理,即用户「进门前」和「出门后」需要进行的环境搭建或清理工作。这是本次更新的核心。
阅读全文…(本文约983字,阅读大致需要2分钟)

CSS 中的标点悬挂及其现状

• Development

什么是标点悬挂

标点悬挂 (Hanging punctuation) 是一种排版微调技术。当一行文字以标点开头或结尾时,标点可以「悬出」段落的对齐边界,使正文文字的视觉边缘保持整齐。虽然差别细微,但在大段文字的排版中,这种整齐的边缘能在一定程度上提升阅读体验。

阅读全文…(本文约1104字,阅读大致需要3分钟)

Hugo blog 主题模板重构

• Development

借着Vibe Coding的东风,我为blog 重新设计了一套模板,希望解决一些此前用的基于ink模板中存在的一些问题,并彻底清理掉一些历史包袱。

这件事还要从Search Console的Core Web Vitals报告说起。报告显示,旧主题使用的Noto Serif SC网页字体加载缓慢,并在渲染过程中导致了显著的累积布局偏移(CLS)问题。

在调整网站CSS的过程中,我逐渐意识到原有主题模板存在不少结构性问题;与其零碎修补,倒不如直接推倒重来。我的想法是,首先用Hugo新建一个最新版的最小模板,然后逐渐在上面添加我需要的功能,于是我列了一个需求wishlist清单:

阅读全文…(本文约1367字,阅读大致需要3分钟)

git submodule 与 subtree 的异同

• Development

前几天有小伙伴在整理某个代码仓库的时候,希望把仓库里的代码和数据分离以便于管理。由于他使用的是git,所以很快大语言模型便引导他用上了包括filter-repo在内的一系列禁术,其间就有了一段关于是应该使用git submodule还是git subtree的讨论。

先说我的结论,对于绝大多数人,特别是已经动了重写历史这种念头的人来说,理想的选择是git submodule。

阅读全文…(本文约1912字,阅读大致需要4分钟)

C++ 中的 main 定义

• Development

新的C++ 标准中不允许给main指定linkage-specification了。

当然,考虑到原本main() 也是C运行环境在开始运行程序的时候调用的,而C运行环境自然也预期C linkage,即不按照C++ 的习惯对符号根据参数增加名字前缀,因此大部分编译器在遇到C++ 程序定义全局main() 的时候也会按照习惯采取C linkage方式去翻译。这一规则首先被GCC采纳,随后LLVM也跟进了。

阅读全文…(本文约395字,阅读大致需要1分钟)