用途:在消费仓库中管理 Prelude 文档查看器的内容,包括编写的 Markdown 页面、导航分组、README 主视觉页和生成的 nixosOptions 页面。前提是仓库已导入 prelude.flakeModules.default;文档查看器没有 enable 开关,当 prelude.docs.pages 非空时自动激活,并安装 docs 命令、x docs 调度与 d 加速器。
主要能力:prelude.docs.pages 是按声明顺序排列的导航树,每个节点为 leaf、group 或 generate 之一。leaf 用 text 指向 Markdown 路径,首个 H1 作为侧边栏标签,可用 title 覆盖;group 仅作侧边栏嵌套,不设 text;text 接受任意 store 路径,可直接引用外部依赖文档。设置 prelude.docs.rootReadme 并在 leaf 的 text 精确匹配该路径时,查看器将其渲染为项目主视觉页;用 inputs.prelude.lib.mdSplit 可按 H2 边界拆分 README 并保留主视觉样式。仅当项目自定义模块选项时,才通过 prelude.docs.nixosOptions 配合 lib.evalModules 侧求值生成选项文档,避免手工维护选项表。
验证与用法:从仓库根目录运行 nix build .#prelude-docs 构建 bundle,./result/bin/docs 1 可非交互打印首个 leaf;在 devshell 内可用 docs 或 x docs 打开 TUI,docs <page> 打印单页,docs next / docs prev 翻页,管道输出会去除 ANSI。
限制:需先将新引用文件暂存以对 Git 后端 flake 求值可见;不要 JSON 序列化 nixosOptions;生成节点不应手工编辑;未提供收费、平台或额外效果信息。