手记

研读本:一个知识库的视觉方向

88 篇知识条目该长什么样?我给了三个方向,最后选了"研读本"——暖纸、墨色、朱红批注。顺便说说那轮评审挑出的 6.5 分意味着什么。

知识库正文的形态和博客不一样。博客是一段一段写下去的,知识库是被反复查的——通勤时扫一眼,盘前查一个信号,盘后深读一篇战法。

两种读法对界面的要求是打架的。所以我先做了三个方向。

三个方向

索引册。双栏,右栏常驻目录。适合查找,但缺点是正文被挤窄,长段落读起来累。

盯盘台。密排的看板行,等宽数字,琥珀色高亮。适合盘中扫读,但整站无衬线读长文会累,而且它离”知识库”的语义太远。

研读本。最后选的这个。生成引擎是:讲师的批注本被整理成册。

研读本长什么样

核心手法是取消所有卡片边框,改用留白和发丝线。

颜色是暖纸 #f7f4ec、墨 #1c1917、朱红批注色 #a8321f。分类色统一降到土化的低饱和,像印在纸上而不是印在屏幕上。

字体是中文衬线。理由有点无奈:系统宋体只有 Mac 有,在 Windows 上会整站塌回黑体,等于这个方向白做。所以自托管了子集化后的 Noto Serif SC,1922 个字,两个字重加起来 686KB。

三个判断

衬线是方向的一部分,不是装饰。 一开始我以为换个颜色就行了。做完截图才明白,暖纸 + 衬线 + 朱红批注是一整套,拆开任何一个都不成立。

发丝线要能看出边界。 第一版发丝线是 #ded7c7,对比度只有 1.30:1,在屏幕上等于没有。压到 1.9:1 之后才立得住。这是”取消边框”的必要代价。

朱红只用在一处。 摘要用朱红批注引线,分类做成带边框的签条。多一处就散了。

评审说 6.5 分

定稿后派了个独立的评审 agent,它自己开浏览器逐页看,给了 6.5/10。它说最大的问题是”文章页右半屏全空”——这我认同,也确实改了:正文左边 34em,右边 13rem 放真正的边注(目录、交叉引用、图谱邻居),整块居中。

但它也报了几条我没改的:

  • “移动端整站横向溢出”——我复核后是它把铺满的背景色当成了墨
  • “移动端导航与搜索消失”——那是有意按断点收起的
  • “mermaid 渲染成源码”——它截图时 dev server 正卡在一个 frontmatter 错误上,整个布局都没加载

评审的结论要复核,不能直接照着改。 它的观察是证据,但它的判断是猜测。

改完那几条之后,[[防守哲学]] 说的”先把防守做对再谈进攻”用在这个环节上意外地合适——先把工具的准确性做对,再谈产出多少。