凡例

一、阅读界面

句子是基本单位

正文按句切分，每句有稳定 ID（s001…s092）。点击任意一句，右侧面板显示该句原文、今译与四家注释；再点一次不会收起，而是保持选中。左侧目录按原段落分组，并记录本机阅读进度。

字词卡与义位词典

有字词注的字带虚线下划线，点击弹出字卡。字卡区分「本句训释」「旧注通义」与「常用义（本站）」，并列出异体、通假与参证来源；若该词有全篇用例，会就近列出前几处。按「查看完整词条与音义」进入义位词典，可检索字词、拼音或释义，查看异体互查、全部用例句号，以及四家注中的音义与训释。没有字注的字也可以点，此时会明确显示「此字在本句暂无专条」，不拿猜测填充；若该字在常用字表中，会给出简明通义。

诸家并观

选中一句后按「诸家并观」，会把原文、今译与郭象注、成玄英疏、陆德明释文、清儒按语五栏并置。并观始终展示全部四家，不受来源筛选影响；窄屏可横向滑动。这样更适合比较郭注与成疏的取舍，或看释文保存的旧音与异文。

来源筛选

句注面板顶部的来源标签可以独立开关：只看郭注、只看释文，或四家全开。筛选会按句记忆在本机，刷新后保持。正文句末的上标数字表示该句的四家注总条数，不随筛选变化。

锚点与分享

每句都有永久锚点，例如 #s012。选中句子后，地址栏会更新；按「分享本句」或「复制本句链接」即可复制带锚点的地址。打开带锚点的链接会直接定位并展开该句，适合课堂、文章与讨论中引用。跨篇引用使用 xiaoyaoyou:s012 这样的全库句键；旧有的 #s012 链接不重写、不跳转，继续有效。

二、三种阅读模式

白文

只读原文。句末注号、字词下划线与校记标记全部隐藏，字卡暂时关闭；点击句子仍可在右侧看到今译。适合先通读一遍，不被注文打断。

集注

默认模式。正文显示注号与字词下划线；右侧按来源分组展示四家注与今译，可筛选、可并观。日常精读用这一档。

考据

在集注基础上增加「考据」页签与句末「校」标记。考据页列出该句的版本校记、字词异文与底本用字提示。当前仅有 8 条校记，集中在关键异文，不是完整校勘记。

三、数据怎样组织

阅读器不在运行时连接 MySQL 或 SQLite。全部内容在构建期按「书 → 卷 → 篇 → 段 → 句」整理，逐篇生成独立 JSON，随站点一起发布到 Cloudflare Pages。阅读器只加载当前篇；全书检索索引在第一次检索时单独载入。这样部署简单、没有数据库连接与并发成本，也便于把单篇数据归档、审校与二次利用。

• 书 / 卷 / 篇：data/book.json 保存书名、版本、卷次、篇目顺序与完成度；篇目路由为 /zhuangzi/<slug>/，每篇一份 /data/chapters/<slug>.json。整理中的篇目只公开进度，不生成空页。
• 段 / 句：段落号 pNNN 在篇内稳定；句是引用单位，篇内编号 sNNN，跨篇引用写作 xiaoyaoyou:s001。页面锚点仍使用 #s001，旧链接保持有效。
• 全书检索：/data/search-index.json 按正文、今译、注文、字词、观念、校记六类字段生成，阅读器首次打开搜索时载入，支持跨篇跳转与字段限定。
• 注释：每条注有来源、所属注块、通释范围 target.start–target.end、词头、类型与引文出处。注释不必与句子一一对应，跨句总论会标明范围。
• 字词注：绑定到具体句子的字符区间，保存繁简两套偏移；另有常见虚词表作为未出注字词的兜底。
• 校记：按句绑定，记录词头、说明与依据。校记是编辑判断，不等同于底本原注。
• 用户笔记：只存在浏览器 localStorage，不进入构建数据，也不上传服务器。

义位词典

词典由字词注与常用字表在构建期生成，合并繁体、简体与异体写法，统计每一词形在全篇的出现句。详情页先列本句训释与旧注通义，再列全部用例句号；「旧注音义与训释」只取词头明确包含该词的四家注文，不把正文中偶然出现该字的段落混入。词典只覆盖已出注的字词，不声称是全篇逐字词典。

观念矩阵

六组议题（逍遥、小大之辩、有待与无待、性分与自得、无用之用、至人·神人·圣人）按四家来源列出提要、工作类型与注文编号。提要与讨论链由编者据注文整理，讨论链只表示同题对读次序，不是师承谱系；郭象、成玄英的「义理注/疏解」与陆德明「音义」的区分，依注文措辞与所处注块标注，仍需人工复核。

开放数据集

同一批数据在构建期导出为 JSON、CSV 与 TEI P5，并提供文件清单、SHA-256 与变更记录。句、注、字词、校记与观念各有稳定标识；版本号随结构或内容修订递增。开放数据页列出全部下载与字段说明。

四、校记与编号

清儒按语中常出现（一）（二）等编号，它们是底本注块中的校记序号。阅读器保留编号并以较小字号排印，避免把多条校记误读成一段连续论述。由于数字转录的注块可能把不同句的校记合在一起，个别按语的通释范围会偏宽；这类情况已在来源页列为校对重点。

五、笔记与隐私

选中句子后打开「笔记」页签，可以为该句写本地笔记。笔记保存在当前浏览器的 localStorage 中，换设备、换浏览器或清理站点数据后不会自动恢复；阅读器提供「导出全部笔记 JSON」用于自行备份。本站不设账号、不设服务端存储，也不会上传笔记内容。

六、用字、竖排与主题

「繁 / 简」切换会同时切换正文、注文、校记与章题的显示；界面文案保持简体。字词注的字符区间在繁简两套文本中分别计算，切换后仍能准确点中。竖排模式使用 vertical-rl，正文横向滚动；在手机上也可用，但长句阅读仍建议横排。明暗主题按本机偏好保存。

七、排版、键盘与离线

工具栏的「字号」打开排版面板，可以分别调整正文大小（85%–150%）与行距（1.60–2.80）。设置保存在本机浏览器，只影响阅读器排版，不改动底本文字。竖排模式沿用同一组设置。

键盘阅读：按 j 读下一句，按 k 回到上一句；按 / 或 Ctrl/⌘ + K 打开全书搜索，Esc 关闭浮层。搜索框可用「注：」「译：」「字：」「观念：」「校记：」等前缀限定字段，也可以点上方范围按钮。

站点提供 PWA 安装与离线缓存：首次访问后会缓存已发布篇目的页面、正文数据、注疏与检索索引。断网时仍可继续阅读已访问过的篇目；未缓存的整理中篇目不会伪装成可读页面。离线缓存随构建版本更新，旧缓存会自动清理。

八、长辈模式与朗读

页眉的「长辈」按钮，或「字号」面板里的长辈模式开关，可以开启一套面向长辈和低视力读者的阅读设置。它不会改写底本，也不会改变引用中的句号与锚点；只是把同一份内容排得更容易看清、点中。

• 更大的字：正文在个人字号设置之上再放大 16%，行距不低于 2.05；标题、今译、注文、搜索与对话框同步放大，正文栏宽收窄到 42rem，减少长行回扫。
• 更高的对比：提高浅色与深色主题下正文、次要文字和分隔线的对比度，去掉纸张纹理背景，并把键盘焦点框加粗。颜色仍保留纸墨与朱砂的基调，不另做一套割裂的主题。
• 更大的控件：工具按钮、页签、来源筛选、搜索范围与关闭按钮统一提高到约 40–48 像素，减少误触；文字句本身仍可整句点选。
• 固定逐句工具条：阅读器底部出现「上一句 / 下一句 / 第 n 句 / 朗读」，不必精确点中某句，也能顺序阅读，并可随时听到当前句。
• 朗读本句：句注面板与长辈工具条都可以朗读当前句；朗读简繁文本时分别请求中文语音。再次点击即可停止，切换句子也会自动停止。

朗读调用浏览器内置的语音合成，不经过本站服务器。读音是否准确取决于系统和所选语音：四声、多音字、通假字与古音无法保证，朗读只作为辅助，不能替代注音与训释。部分系统语音可以离线使用，部分可能需要系统服务；本站不会上传正文，也不记录朗读内容。

长辈模式保存在本机浏览器（lb.senior），对全书各页生效，刷新与重新打开后保持。它与字号、行距互为叠加：如果仍觉得小，可以继续调大字号，或使用浏览器的页面缩放。关闭长辈模式后，个人字号与行距设置仍然保留。

九、引用建议

引用本站时，请同时给出句锚点与访问日期，例如：
LibreBook《庄子·逍遥游》第 12 句，https://librebook.net/zhuangzi/xiaoyaoyou/#s012，2026-10-28 访问。

引用数据时，请注明数据集版本与稳定标识，例如：
LibreBook 编辑. 《庄子·逍遥游》集注数据集, v0.2.0, 2026-10-28. https://librebook.net/dataset/.

原文与旧注属公有领域；本站今译与字词注以 CC BY-SA 4.0 发布，可复制、改编与再分发，但需署名 LibreBook 并以相同方式共享。底本标点与数字转录的权利状态不完全等同于原文，正式出版前请回到来源页核对。

十、已知限制

• 标点尚未逐字复核原刻；注疏自动对齐在少数注块可能仍需人工校正。
• 字词注覆盖 58 句，尚未逐字出注；词典只覆盖已出注字词；考据仅 8 条，不是完整校勘记。
• 观念矩阵与讨论链是编者研究视图，不是师承谱系或学界定论；注文工作类型依措辞启发式标注。
• 王夫之、憨山等后世注本因未取得可靠全文而暂缺；现代版权译注一律不用。
• 移动端注释面板为底部抽屉；在极小屏幕上，长注文需要较多滚动。
• 本站为静态阅读站，不含账号、云同步、协作批注与服务端搜索；所有笔记与阅读设置只保存在本机浏览器。

十一、技术说明

前端为无框架静态 HTML / CSS / JavaScript；构建脚本用 Node 标准库生成页面、静态数据、开放数据集、站点地图与缓存头，输出 dist/ 后可直接部署到 Cloudflare Pages。数据整理脚本用 Python 标准库完成注块切分与校验，繁简映射在构建期一次性生成，运行时不加载转换库。