适合阅读的排版¶
页面应在细读之前展示结构。醒目的标题、安静的导航栏和适度宽的正文栏已能完成大部分工作。颜色应标明关系或操作,不独自承担含义。
网页¶
自定义布局分为项目导航、正文和当前页面纲要三部分,小屏使用导航抽屉。阅读版随附 Libertinus Serif 和 Libertinus Sans。标题用粗体衬线字;导航、标签和控件用配套无衬线字。压缩 WOFF2 文件随站点提供,不请求字体服务。
默认浅色。 主题控件也提供深色和系统模式,并记住同一浏览器来源上的选择。系统模式跟随操作系统。打印 HTML 使用浅色。禁用 JavaScript 后,内容和导航仍可用;主题控件与增强搜索属于渐进增强。
英文正文可在浏览器中使用整段 Knuth–Plass 断行。小型模板脚本测量已加载字体,建立文字盒、空格与连字断行惩罚,选择整段断点。Frank Liang 的模式方法提供英文断词候选。原始 TeX 模式和库许可证随站点提供。
增强排版保留强调和原始文字,正文宽度改变时重新计算。复制一个优化段落内的内容,得到的是源文,不含视觉换行或新增连字符。打印时恢复普通段落,交由打印布局分页。
链接、数学、代码、交互内容、窄栏和其他语言采用浏览器原生布局;无合适间距解的段落也如此。禁用 JavaScript 后仍可阅读。回退使用语言感知的 hyphens: auto 和 text-wrap: pretty;这两项 CSS 本身不保证 Knuth–Plass 优化。
PDF 页面¶
书籍模板使用与 Web 相同的 Libertinus 字体,设置两端对齐、优化断行和语言感知断词,也控制间距、页眉、题注、代码块和表格线。字体、断词成本与段落宽度共同作用。强制换行通常不能正确修复松散段落。
Typst 优化 PDF 段落,Web 增强优化适用正文。它们共享源文、字体和视觉层级,但断行可能不同。见 Typst 文本契约 和 浏览器断词契约。
修改设计¶
编辑 _static/editorial.css 调整视觉变量,编辑 _templates/layout.html 调整结构,编辑 _templates/book.typ 调整印刷布局。保留阅读顺序、焦点指示、标签和足够对比度。
修改后构建两种格式,检查含代码、表格、图示和公式的页面。漂亮封面不能证明全书可用。完整模板契约见 模板;完整 API 见 API Reference,也包含在同一本 PDF 中。