Expand document collections with Pretext tutorial and simplify library navigation

README.md

@@ -17,7 +17,7 @@ pnpm dev
 
 ```text
 apps/docs/       Next.js Pages Router + React + TypeScript + Tailwind CSS
-content/docs/    Markdown 文档源，文件名成为 /docs/<slug> 路由
+content/docs/    Markdown 文档源，支持目录，路径成为 /docs/<path> 路由
 tools/figures/  独立 Python 项目，使用 drawsvg 编程制图
 ```
 
@@ -30,11 +30,13 @@ tools/figures/  独立 Python 项目，使用 drawsvg 编程制图
 - `pnpm start`：在本地预览已构建站点。
 - `pnpm check`：依次执行 lint、类型检查、制图与构建。
 
-站点默认浅色，使用本地系统字体。全站搜索支持正文关键词、`⌘/Ctrl K`、方向键与 Enter；代码块提供复制与反馈。桌面提供分组导航和滚动高亮的页内目录，小屏可展开文档菜单与页内目录。首页入口、草案提示、前后篇导航均引用现有 Markdown 内容。
+站点默认浅色，使用本地系统字体。全站搜索支持正文关键词、`⌘/Ctrl K`、方向键与 Enter；代码块提供复制与反馈。桌面提供分组导航和滚动高亮的页内目录，小屏可展开文档菜单与页内目录。首页入口、草案提示、前后篇导航均引用现有 Markdown 内容和资料目录配置。
 
 参考设计截图与研究记录保存在 `design/references`；浏览器验收截图与检查说明保存在 `design/verification`。这些文件不作为站点静态资源发布。
 
-文档标题取首个 `# 标题`，文档排序按文件名。普通 Markdown 与 GFM 表格可用，嵌入图使用 `/figures/<name>.svg`。不解析原始 HTML。
+文档标题取首个 `# 标题`，文档排序按相对路径。支持多层目录（例如 `content/docs/pretext/01-chapter.md` 对应 `/docs/pretext/01-chapter`）；旧文档地址保持可用。`content/catalog.json` 管理合集、分类、摘要、草案与推荐，新增资料无需修改页面代码。首页推荐最多3篇，目录每页8条，可按合集与标题筛选；全站搜索仍覆盖全文。相邻篇目限于当前合集。
+
+Pretext 教程位于 `content/docs/pretext`，包含导读与12章，来自本地 Pretext 研究成果。源码链接锁定上游研究版本；实验脚本与原始记录位于 `apps/docs/public/materials/pretext`，和正文一样经过登录验证。普通 Markdown 与 GFM 表格可用，嵌入图使用 `/figures/<name>.svg`。不解析原始 HTML。
 
 生产构建会生成文档路由；新增或修改文档后重新运行 build。开发模式按请求读取内容。
 main 推送通过 CI 验证后自动部署；Pull Request 只验证，不部署。工作流也支持手动触发。