Buu 当前希望 llm-wiki 的网站更像 Wiki 而不是文章站
Decision(决策)
当前 llm-wiki 的网站展示,优先追求 Wiki(维基)式的阅读和导航体验,而不是普通文章站 / 博客站的展示气质。
同时保持本地 Markdown 文件为唯一真源,让展示层来适应现有文档,而不是反过来重塑文档结构。
Context(背景)
Buu 当前已经让 Hermes 持续记录 llm-wiki,但一直没有直接在网页里看过这套内容的真实长相。
在这种情况下,先看到“网站里的成品感”比继续抽象讨论框架更重要。
而一旦进入网站 review,问题就会从“能不能建站”转成“这看起来像不像自己想要的 Wiki”。
Criteria(判断标准)
当前网站展示层至少应满足:
- 直接从现有 Markdown 生成,不要求先改本地文档结构
- 读起来更像知识条目网络,而不是按文章顺序消费
- 便于 review 当前内容长相
- 不打断 Markdown 作为长期真源的地位
- 后续仍能保留向 Digital Garden 风格融合的空间
Facts(事实)
- Buu 明确表示:当前最想看到的是网站里的所见即所得效果,而不是额外整理的一份 Markdown 审阅文档。
- Buu 明确表示:当前本地 Markdown 结构和格式优先不改,应由工具来适配本地文档。
- Buu 认为理想体验更接近维基百科式的阅读和使用手感,而不是偏文章 / 笔记展示的站点。
- Buu 同时承认,在真正看到内容长相后,未来也可能再考虑和 Digital Garden 做结合。
- 当前 Quartz 已经作为展示层接入现有 wiki,并生成了可直接访问的网站。
Interpretation(解释)
当前更该看的,是站点做出来之后像不像一个可浏览、可跳转、可 review 的 Wiki。
Digital Garden 目前先放在后续选项里,等 Wiki 体验跑顺后再考虑怎么融合。
Current Rule(当前规则)
- 当前 llm-wiki 网站优先往 Wiki 阅读体验靠,而不是文章站体验。
- 本地 Markdown 继续作为唯一真源。
- 展示工具应优先适配现有文档,而不是要求先改写内容结构。
- 在正式 review 完当前网站前,不因为抽象风格争论而反复换方向。
- Digital Garden 可以作为后续可能的融合方向,但不是当前第一目标。
Exceptions(例外)
- 如果某种 Digital Garden 特性明显提升了 Wiki 可读性,也可以局部吸收。
- 如果后续 review 发现“更像纯 Wiki”的框架明显更适合当前文档,也可以重新评估 Quartz。
- 如果实际内容增长后,当前页面组织方式开始妨碍检索和跳转,则应优先优化展示层。
Review Trigger(复查触发条件)
出现以下情况时,应复查这条决定:
- 当前网站看起来仍然明显像文章站
- 导航和跳转无法支撑条目式浏览
- Buu 在实际 review 后强烈不喜欢当前展示气质
- 现有 Markdown 结构与展示层之间出现明显冲突
- 出现更适合当前文档结构、且更像 Wiki 的候选方案