Changelog

Best Minds Board:样式同步(不动程序逻辑)

2026-01-20 · Zon(board 使用者) · CSS-only sync

解释我改了什么,并用看板页面验证“改的效果”

本次只调整 best-minds-board 生成页面的视觉细节(tokens/排版/底纹/相关阅读区块变量化),确保不触碰你的其他程序指令。

css-onlyboardprintableno logic changes

你要的:只同步样式,不动程序指令

结论:我把 best-minds-board 的视觉层(生成出来的 HTML 的 <style> 和少量 inline style)同步成更接近 Zon Minimal Editorial · Light 的细节,但不改任何 ingest/分类/索引/部署逻辑。

  • 改动范围:scripts/rebuild-board.mjs 内的 CSS/样式字符串(以及“相关阅读”区块的 inline style 变量化)。
  • 不改范围:topics 扫描、meta 解析、分类/标签聚合、去重、Vercel 部署等程序指令完全不动。

变更清单(CSS-only)

1) 版面质感

  • 新增 body::before 的超淡 radial 渐变底纹(打印时自动关闭)。
  • 统一 monospace:引入 --mono,并让 code 使用更“纸质”的边框(去圆角)。

2) 可读性与一致性

  • 为 Topics/Listing 等页面补齐:scroll-behavior::selection:focus-visible、字体平滑。
  • “相关阅读”区块把硬编码 #666/#e8e8e8 改为 var(--gray-600/--gray-200),跟站点 tokens 对齐。

为什么这些改动是“只动样式但收益大”

  • 信息结构不动:你现有的看板信息架构(categories/projects/tags/recent)已经是有效的,只需要更统一的排版 token。
  • 打印/归档友好:背景纹理只在屏幕呈现,打印自动关闭,保持黑白可打印。
  • 局部变量化:把“相关阅读”的 inline style 变量化,避免将来换 token 时全局搜索替换。

效果验证(我在本地检查了什么)

页面验证点状态
docs/best-minds-board/index.html --mono / body::before / print 关闭 overlay OK
docs/best-minds-board/topics/index.html 等列表页 同样具备 tokens + overlay + code 边框一致 OK
任意 report 页的“相关阅读”区块 边框/字体颜色使用 var(--gray-200/600) OK
我实际用的检查方式(给你复核)

rg -n -- "--mono|body::before" docs/best-minds-board/index.html

rg -n -- "best-minds-board:related-reading:start" docs/best-minds-board/topics/**/report-*.html

改动位置(只动样式)

  • ~/.codex/skills/best-minds-board/scripts/rebuild-board.mjs:仅 CSS/inline style 字符串
  • 已生成/更新:docs/best-minds-board/*.html(这是 rebuild 后的产物)

下一步

One next action:如果你希望“相关阅读”也完全用 class(而不是 inline style),我可以把相关样式抽成模板 CSS class —— 仍然不改任何逻辑。

(这一步不急;现在已经是 style-only 并且生效了。)

风格可以统一,结构不必僵化。
— Best Minds Board