凡例

一、阅读界面

句子是基本单位

正文按句切分，每句有篇内稳定 ID（sNNN，各篇独立；内篇七篇分别为 s001–s092、s001–s230、s001–s042、s001–s190、s001–s122、s001–s185 与 s001–s079）。点击任意一句，右侧面板显示该句原文、今译与历代旧注（含船山解）；再点一次不会收起，而是保持选中。左侧目录按原段落分组，并记录本机阅读进度。

字词卡与义位词典

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

诸家并观

选中一句后按「诸家并观」，会把原文、今译与各家旧注并排展开；七篇均为六栏（郭注、成疏、释文、按语、船山解与今译）。并观始终展示该篇全部旧注，不受来源筛选影响；窄屏可横向滑动。这样更适合比较郭注与成疏的取舍，或看释文保存的旧音与异文、船山解与郭注的立异。

来源筛选

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

锚点与分享

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

二、三种阅读模式

白文

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

集注

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

考据

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

三、数据怎样组织

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

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

义位词典

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

观念矩阵

当前共 54 组议题：逍遥游六组（逍遥、小大之辩、有待与无待、性分与自得、无用之用、至人·神人·圣人），齐物论八组（吾丧我、三籁、成心与是非、道枢与环中、朝三暮四、天倪与两行、至人不知利害、梦蝶与物化），养生主八组（有涯与无涯、缘督以为经、庖丁解牛、官知止而神欲行、右师介足、泽雉与樊笼、秦失三号、薪尽火传），人间世八组（德荡乎名、心斋、虚室生白、安之若命、为使之难、形莫若就、栎社散木、无用之用），德充符八组（德充于内·物应于外、死生不变·守其宗、肝胆楚越·万物皆一、止水之鉴、才全、德不形、德有所长而形有所忘、有人之形·无人之情），大宗师八组（真人而后有真知、死生一贯、道自本自根、闻道九重、造化为大冶、游方之外、坐忘、贫也非命），应帝王八组（「非人」之辨、治外与正性、游心于淡合气于漠、明王之治、壶子四示、虚而委蛇雕琢复朴、用心若镜、浑沌之死），按四家旧注（郭注、成疏、释文、按语）列出提要、工作类型与注文编号；船山解已进入并观与检索，暂未列入观念矩阵。提要与讨论链由编者据注文整理，讨论链只表示同题对读次序，不是师承谱系；郭象、成玄英的「义理注/疏解」与陆德明「音义」的区分，依注文措辞与所处注块标注，仍需人工复核。

开放数据集

同一批数据在构建期按篇导出 JSON、TEI P5 与 Markdown，并汇总 CSV、文件清单、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《庄子·齐物论》第 127 句，https://librebook.net/zhuangzi/qiwulun/#s127，2026-10-29 访问。

引用数据时，请注明数据集版本与稳定标识，例如：
LibreBook 编辑. 《庄子》集注数据集（逍遥游、齐物论、养生主、人间世、德充符、大宗师、应帝王）, v0.10.0, 2026-10-29. https://librebook.net/dataset/.

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

十、已知限制

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

十一、技术说明

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