# 沙盒

> 沙盒的界面：活动栏，正文、书库、章节、资源和字体面板，以及手机上的布局

- HTML版本: https://postext.dev/zh/docs/sandbox
- 最后更新: 2026-11-10
- 阅读时间: 23分钟
- 其他语言: [en](https://postext.dev/en/docs/sandbox.md), [es](https://postext.dev/es/docs/sandbox.md), [ca](https://postext.dev/ca/docs/sandbox.md), [de](https://postext.dev/de/docs/sandbox.md), [fr](https://postext.dev/fr/docs/sandbox.md), [it](https://postext.dev/it/docs/sandbox.md), [pt](https://postext.dev/pt/docs/sandbox.md), [ja](https://postext.dev/ja/docs/sandbox.md), [ar](https://postext.dev/ar/docs/sandbox.md)

## 简单来说

沙盒是本网站上的一个免费工具，不用安装任何东西就能试用Postext。你在一边写文字，另一边就能看到排好的页面，页面会随着你的输入而变化。本页介绍屏幕的各个部分，以及用来写文字、管理书和章节、添加图片和选择字体的面板。版面设计设置、预览、保存与导入，以及把沙盒放进你自己的网站，另有页面说明。

**Postext排版引擎的交互式试验场。**

沙盒提供一个编辑器式的界面。你在这里撰写正文、管理资源和字体、调整版面设计，并在五种同步的视图中实时查看结果：**Canvas**、**PDF**、**书页**（3D呈现的印刷书）、**HTML**和**EPUB 3**。第六个标签页**SCORM**把你选中的章和节打包，供学习管理系统使用。它专为试验而设计。你可以改换字体排印或栏数，尝试把图放在不同位置，观察引擎如何响应。各个面板使用出版行业的说法（书、图、框、书眉），而不是引擎术语，出版从业者不必了解配置结构也能上手。每个控件都支持键盘操作和屏幕阅读器。

## 界面布局

沙盒有三个主要区域：左侧窄窄的**活动栏**用来切换面板，中间可调宽度的**侧栏**放置当前面板，右侧的**视口**有各个输出标签页。各面板的标题栏、视口的标签栏和活动栏顶部的标志格高度相同，因此窗口顶端看上去是贯穿整个窗口的一条横带。

![沙盒界面：左侧打开“正文”面板，显示一本书的Markdown；右侧是Canvas，显示一个跨页，一幅地图横跨两页。](https://postext.dev/docs-shots/zh/sandbox-layout.webp)

*三个区域：活动栏、侧栏中的“正文”面板，以及视口中的Canvas。*

### 活动栏

左边缘的一条窄栏，每个面板对应一个按钮。按钮显示一个图标，图标下方是一个词的标签，鼠标悬停时显示较长的提示（同一段提示也是按钮的无障碍描述）。从上到下依次是：

- **书库**（`Files`图标）：你的书和示例书
- **章节**（`BookOpen`图标）：当前打开的书及其各章
- **正文**（`FileCode`图标）：撰写和编辑当前章的文字
- **资源**（`FolderOpen`图标）：书中使用的图像、SVG图示和表格
- **字体**（`Type`图标）：书中使用的字体，以及你自己的字体文件
- **版面设计**（`Settings2`图标）：页面、字体排印、标题、图、标注框和导出设置
- **检查**（`AlertTriangle`图标）：在版面中发现的排版问题。图标上有一个实时计数徽标，显示当前警告的数量，最多显示`99+`。

点击当前面板的按钮会收起侧栏，点击另一个按钮则切换到对应面板。整个活动栏只占一个Tab焦点位置：方向键（↑ / ↓，首尾循环）、**Home**和**End**在按钮之间移动焦点，Enter或空格键打开获得焦点的面板。

活动栏底部的**大按钮和输入框**让沙盒的每个按钮和输入框至少有44 × 44 px（WCAG 2.5.5）。浏览器会记住这一选择；你还没有选择时，触屏设备上默认打开，使用鼠标时默认关闭。宿主应用可以在活动栏中加入自己的项目：顶部格子里可选的**首页标志链接**（通过`homeUrl`或`homeLink`属性），以及底部、这个开关下方的**主题切换**和**语言切换**。整本书以`.postext`文件的形式在书库面板中导入导出，正文面板和版面设计面板的标题栏则各自导出自己那一部分（见[导出与导入](https://postext.dev/zh/docs/sandbox-books-saving.md#导出与导入)）。

### 内容模式与版面设计模式

预览上方的工具栏最前面是一个切换开关，对应处理一本书的两种方式：

- **内容**：编辑文字，可以在“正文”面板中改，也可以直接在页面上改。模板页上的框留在模板安排的位置，不会移动。
- **版面设计**：编辑页面模板和样式。“正文”面板以只读方式显示本章，附有提示和“编辑文字”按钮，工具栏停用。在模板页上点击某个框，会把这个框选给模板编辑器，而不是放置光标。

在沙盒的任何位置按**Alt+Shift+M**（Mac上为**⌥⇧M**）即可切换模式。在“正文”面板打开时切换到版面设计，会改为打开“版面设计”面板；切换回来时又会打开“正文”面板。浏览器会记住所选模式。智能体用`sandbox_set_view`（`mode`）读取和设置模式。

![同一个跨页处于版面设计模式：左侧是“版面设计”面板和各组设置，页面上的框画有虚线轮廓，地图上每个标注都有一个点。](https://postext.dev/docs-shots/zh/sandbox-modes.webp)

*版面设计模式：侧栏列出各项设置，页面画出各个框和每个标注的锚点。*

### 撤销与重做

沙盒为打开的这本书的正文和版面设计只保留一份历史记录。**Cmd/Ctrl+Z**撤销最近的一次修改，无论是哪一类：在“正文”面板里输入的文字、在页面上做的修改（调整了大小的漫画分格、移动过的标注）、在“版面设计”面板里改动的设置，或在版面设计模式下拖动的框、新加的页面模板。**Shift+Cmd/Ctrl+Z**（或**Ctrl+Y**）重做。这些按键在沙盒的任何位置都有效，只有文本框例外：文本框里输入的内容由它自己撤销。“内容 / 版面设计”切换旁的**撤销**和**重做**按钮，以及“正文”面板工具栏最前面的两个按钮，用的是同一份历史；读屏软件会读出撤销了什么。

- 一个手势算一步：拖动滑块、拖动取色，或逐位输入一个数字，只要停顿不超过一秒，都只算一次。每放下一次框，算单独的一步。
- 每一章有自己的正文历史。撤销另一章的正文修改时，会打开那一章。
- 在“内容”和“版面设计”之间切换，历史不会丢失：在版面设计模式下可以撤销正文修改，在内容模式下也可以撤销框的拖动。
- 打开另一本书（从“书库”面板、示例书、`.postext`文件或链接）会开始新的历史，重置正文或整本书也一样。只重置版面设计算一步，可以撤销。
- 新增、删除、拆分、合并或移动章节，以及资源和字体，都不记入历史。历史只在本次访问中保留，刷新页面后即清空。
- 图片的标记（锚点、安全区和字词区）是资源中的例外：在资源面板中保存这些标记，或在页面上拖动锚点，都算历史中的一步。

智能体用`sandbox_undo`撤销和重做（见[WebMCP](https://postext.dev/zh/docs/webmcp.md)）。

### 侧栏面板

侧栏可以调整宽度。拖动侧栏与视口之间的分隔条，或者用Tab键让它获得焦点后使用键盘：← / →每次把宽度改变2%（按住Shift时为10%），**Home** / **End**分别跳到最窄和最宽。分隔条会向屏幕阅读器报告当前数值，视口始终至少保留200 px。没有面板处于打开状态时，侧栏完全收起；侧栏宽度在会话之间保留。

设置行把标签放在控件旁边，侧栏较窄时则放在控件上方。这是用容器查询实现的，所以跟随的是侧栏的宽度，而不是窗口的宽度。

#### 正文面板

一个CodeMirror 6编辑器，用来编辑本章的Markdown。屏幕阅读器把它读作*章节正文*。它提供：

- **语法高亮**：标题、强调、链接、代码块和引文在视觉上各有区别；以下内容有专门的高亮：**YAML前置元数据**、**LaTeX公式**区域、**行内标签**（`:chip[…]`：方括号和属性加以标记，标签文字着色）、**小型大写字母**（`:smallcaps[…]`：方括号加以标记，文字以小型大写字母显示）、竖排文字的**方向标记**（`:tcy[…]`、`:upright[…]`、`:sideways[…]`：方括号加以标记，文字下加点线），以及**中文注释标记**（`:dots[…]`、`:name[…]`和`:book[…]`在文字下方画出各自的标记；`:ruby[…]{rt="…"}`和`{紅樓|hóng|lóu}`；`:warichu[…]`的注文以较小字号显示）。输入`:do`、`:na`、`:bo`、`:ru`或`:wa`时会提示相应指令
- **行内标签补全**：在词首输入`:c`会提示`:chip[…]`（光标落在方括号之间）。在`{style="…"}`里会提示已配置的行内标签样式id。
- **标注补全**：在`:::figure{resource=…}`内，`::label[…]`行中`at="…"`的值会提示该图片的锚点，并附上每个锚点给出的标注样式，插图中还没有标注的锚点排在前面。在`style="…"`中会提示标注样式；在行首输入`::la`会写出一行标注。
- **小型大写字母补全**：在词首（或紧跟在`*` / `_`之后）输入`:sm`会提示`:smallcaps[…]`，光标落在方括号之间。
- **制表符**：`:tab`和`:tab{…}`与其他行内指令一样加以高亮，并在补全中提示。编辑器的Tab键不输入制表符字符，所以在沙盒中用`:tab`写制表符；随文字粘贴进来的制表符字符会保留，在样式设了制表位的段落中它就是制表符。
- **行号**和当前行高亮
- 长段落**自动换行**
- **从右到左的行**：以阿拉伯字母或希伯来字母开头的行从右到左排列，光标和方向键也随之移动。行内的标记（`{…}`属性、`[^id]`标签、指令名、整个`:ref[fig-1]`、公式、代码、链接地址）保持从左到右，读起来与输入时一样。围栏、前置元数据和以拉丁词开头的行仍从左到右。
- **工具栏**：最前面是**撤销 / 重做**，接着是粗体、斜体、1–3级标题、链接、行内代码、**行内标签**（用`:chip[…]`包住选中内容）、**小型大写字母**（用`:smallcaps[…]`包住选中内容）、**字符样式**（`:span[…]{style="id"}`，荧光笔图标：列出书中字符样式的菜单；选中一个即用`:span`包住所选内容，所选内容位于一段带样式的文字中时则改换这段文字的样式，**移除字符样式**把这段文字还原为普通词语；在`:span`的`style="…"`中输入时会提示各样式的id）、中文、日文或韩文书中的**注音**（`:ruby[…]`）和**纵中横**（`:tcy[…]`）、引文、有序和无序列表，另有五个插入按钮：
  - `:::pagebreak`
  - `:::space`：一行垂直空白（更多行用`:::space{lines=N}`）
  - **分栏**：一个两栏的`:::columns{count=2}`组，光标停在它的第一行，可用在正文中或框内（postext 1.25起）
  - `:::numbering{format="decimal" startAt=1}`：插入时带有示例属性，可以自行调整
  - **模板页**：打开一个选择器，列出本书的页面模板，每个模板都画成一张缩略图，显示其中的空框。选定后写入一个`::::page{template="…"}`页面块，每个框各有一个空的`:::frame{slot="…"}`。只接收别的框接续文字的框不写；用`takes`接收标题的框写入该级标题，框名处于选中状态，直接输入即可替换；流文框留一个空行，用来写正文

代码清单（一个```` ``` ````或`~~~`围栏及其中的行）在编辑器中是一个整体区域：它带有代码底色，其中的Postext标记（公式、行内标签、制表符、索引标记）不着色，因为引擎也不读取它们。编辑器还会把光标和选区报告给预览，由此实现点击定位同步：在渲染结果中点击文字，光标会移到Markdown中对应的位置；预览也可以高亮当前选区。

面板标题栏是一个**章节切换器**：上一章/下一章箭头、本章的序号和标题，以及一个菜单，列出书中的每一章，页码范围一旦确定也会显示出来（见[书与章](https://postext.dev/zh/docs/sandbox-books-saving.md#书与章)）。每一章有自己的编辑器实例，所以撤销历史和光标位置按章分别保存。标题栏还提供六个操作：

- **重置**（需要确认）：重新载入当前示例书的**文档部分**。所有章和整套图都换成示例书中的内容（对内置示例而言，就是当前语言的示例文档和示例资源）。版面设计保持不变，只有示例书自带的字体例外。见[书库面板](https://postext.dev/zh/docs/sandbox.md#书库面板)。
- **导出**：把当前章下载为普通的`.md`文件。多章的书命名为`<book>-<nn>-<chapter>.md`，否则以当前打开的书命名，或命名为`document.md`
- **导入**：用一个`.md`文件的内容替换当前章
- **导入Word文档**：打开一份`.docx`书稿，在做出任何改动之前，先把其中的Word样式对应到Postext样式；如果是从书导出的文件，则把其中的校改带回书中（见[Word文档](https://postext.dev/zh/docs/sandbox-books-saving.md#word文档)）
- **导出为Word**：把当前章或整本书下载为`.docx`，可选语义（只有内容，用朴素的Word样式）或版式（同样可编辑的文字，套用书的设计）；在其中做的校改通过**导入Word文档**带回
- **导出到 InDesign（IDML）**：像PDF那样排好整本书，下载为`<书名>.idml`，以便在InDesign中完成（见[导出与导入](https://postext.dev/zh/docs/sandbox-books-saving.md#导出与导入)）

#### 查找和替换

“正文”面板标题栏里的**查找和替换**按钮（Canvas和PDF的工具栏里也有）会在编辑器上方打开一个查找栏。它搜索当前章节或整本书的Markdown源文本，标记也包括在内，所以它找到和替换的就是编辑器里显示的内容。

- **选项**：**区分大小写**、**全字匹配**、**忽略重音符号**和**正则表达式**。勾选**忽略重音符号**后，*celula*能找到*célula*，阿拉伯语单词无论带不带元音符号都能找到。ñ、ç、й和ё仍是各自独立的字母，假名保留浊音符号（が不等于か）。重音以单独的附加符号输入的文字，按符号与字母合成后的样子查找。中文、日文和泰文的词与词之间没有空格，**全字匹配**按浏览器的分词结果判断词的边界。
- **本章**或**全书**设定查找范围。匹配结果按章节列出，并附行号。单击一条结果，会在编辑器里选中它并打开所在章节，焦点仍留在查找栏。
- **正则表达式**采用JavaScript的语法，按Unicode解释，`^`和`$`匹配行首和行尾。替换内容中，`$1`到`$99`写入对应的分组，`$<name>`写入命名分组，`$&`写入整个匹配，`$$`写入一个美元符号；`\n`、`\t`和`\\`分别写入换行、制表符和反斜杠。其他内容按输入原样写入：用`^Note (\d+)`和`[^$1]`，*Note 3*会变成`[^3]`。不勾选此选项时，替换内容就是纯文本。
- 跨越多个章节的**全部替换**会先请你确认。这些替换在历史记录中算一步：查找栏里出现的**撤销**按钮、紧接着在栏内输入框里按Cmd/Ctrl+Z，或在沙盒任意位置按Cmd/Ctrl+Z，都能把它们全部撤回。
- 停止输入片刻后查找才开始，而且在页面之外单独运行，所以长书也不会拖慢输入。匹配超过5000个，或查找耗时过长时，查找会停下并给出提示，**全部替换**也会停用，直到缩小查找范围。无休止回溯的正则表达式（比如在长行上用`(a+)+$`）会被中止并报告。
- 在**版面设计**模式下，正文是只读的：查找栏可以查找，替换按钮停用，并有一条提示提供**编辑文字**。
- 在手机上，查找栏位于全屏“正文”面板的顶部。

按键（在编辑器和查找栏中都可用）：

- **Cmd/Ctrl+F**：在本章中查找（在一行之内选中的文字会成为查找内容）；**Cmd/Ctrl+Shift+F**：在全书中查找；**Cmd/Ctrl+Alt+F**：查找和替换。
- 在查找框中按**Enter**和**Shift+Enter**：下一个和上一个匹配。在编辑器中按**Cmd/Ctrl+G**或**F3**，加按Shift则跳到上一个。
- 在替换框中按**Enter**：替换当前匹配并跳到下一个；**Cmd/Ctrl+Alt+Enter**：全部替换。
- 替换后立即按**Cmd/Ctrl+Z**：撤销这次替换；**Shift+Cmd/Ctrl+Z**：重做。
- **Esc**：关闭查找栏，回到正文。

输入法正在组字时（中文、日文、韩文），Enter和Esc交给输入法处理。智能体用`sandbox_search_text`和`sandbox_replace_text`执行同样的查找。

#### 书库面板

活动栏中的第一个面板：你的书和示例书的列表，带**新建**菜单、上一次操作的状态，以及示例书有新版本时显示的横幅。在代码和存储中，书仍然叫作*项目*（project），示例书叫作*预设*（preset）。

点击一本书（或示例书的某个语言标签）就会打开它；书显示出来后，侧栏会转到[章节面板](https://postext.dev/zh/docs/sandbox.md#章节面板)。点击已经打开的书会直接转过去。行菜单（重命名、复制、下载、隐藏、删除）不会切换面板。当前打开的书在列表中有标记。面板分为两组：

- **我的书**：保存在浏览器中（IndexedDB）的本地可编辑的书。当前打开的那本有标记，它的各章在章节面板中。

  打开你自己的一本书时，工作文档*就是*这本书。对正文、版面设计、图和字体的每一处修改都会自动存入这本书（与`localStorage`一样有1秒的防抖延迟），所以你可以切换到别的书再回来，不会丢失任何内容。新书从标题栏的**新建**菜单创建：
    - **复制当前的书**把当前打开的书连同其中的图和字体复制成一本新书。
    - **空白书**新建一本空书。
    - **打开.postext文件…**导入一个文件。
    - **使用以下设计…**用图库中的一种设计新建一本空书（见[设计](https://postext.dev/zh/docs/sandbox.md#设计)）。

  你也可以复制任意一行。在你还没有自己的书时，这一组显示空状态，并提供同样的快捷入口。每一行有一个带标签的**⋯**菜单（*“…”的更多操作*），其中有**重命名…**、**添加语言…**（见[多语言的书](https://postext.dev/zh/docs/sandbox-books-saving.md#导出与导入)）、**复制**、**下载（.postext）**和**删除…**。删除时会在⋯按钮旁边直接请你确认。

  重命名会在行内打开名称和说明两个输入框。在任一输入框中按Enter会同时提交两者，按Escape取消。在多语言的书中，输入框下方还有一个复选框**仅用于…版本**，勾选后名称只给屏幕上的那种语言。

  书还带有一张**封面图片**，显示在示例书显示缩略图的位置。复制一本示例书（或另一本书）时，会沿用它的封面。某一行处于重命名状态时，封面本身就是设置封面的控件：点击它选择一张PNG、JPEG、WebP、GIF或SVG图片，或者用旁边的X移除当前封面。封面属于书，而不属于书中的图，导出和导入时随书一起保存。

  没有封面的书会从它的**第一页**（第一章的第一页）取得封面：这一页第一次在Canvas标签页中排版并绘制时，沙盒会在浏览器空闲、字体和页面上的图片都已载入之后，给它拍一张小图（宽240 px，JPEG）。这张图作为书的封面保存，因此下载时会作为文件包的`thumbnail`一并带上。不带缩略图的示例书也以同样的方式获得一张封面，保存在浏览器中（IndexedDB数据库的`presetCovers`存储区，每个示例、每种语言一张），显示在它所在的行中，复制或下载它时也会沿用。已有的封面永远不会被替换，无论它来自示例书、导入的文件、你自己的选择，还是更早的一次截取。你移除的封面会在以后某次访问时重新从第一页截取。

  打开一本书从不需要确认：无论离开的是哪本书，都会先保存。下一本书载入期间，视口显示*正在打开书…*，而不是你离开的那本书。删除当前打开的书后，会回到内置示例。

- **示例书**：列在你的书下面，作为起点。文件包本身永远不会改变，但你对示例书的修改会保留下来：第一次修改时，会在浏览器中保存它的一份副本（它的*草稿*），每个示例、每种语言各一份，该行显示*已修改*标签。再次用同一种语言打开这本示例书时，会载入你的版本；从未修改过的示例书则按发布时的样子打开。每一行的⋯菜单提供：
    - **建立我的副本**把示例书变成你自己的书，其中保存文件包各个文件的独立副本，因此以后磁盘上的文件包再有改动也不会影响它。
    - **下载（.postext）**把示例书保存为`.postext`文件。
    - **从列表中隐藏**把示例书从列表中移除（内置示例不能隐藏）。
    - **恢复原版…**丢弃你对这本示例书的修改（所有语言），如果它当前处于打开状态，就在原处载入发布的版本。它会先请你确认，而且只出现在修改过的示例书上。

  有多种语言的示例书，每种语言显示一个标签，顺序与清单文件中列出的顺序一致：繁体中文和简体中文分别是繁和简，其他语言显示语言代码（EN、ES）；悬停提示用界面语言写出语言名称（*载入繁体中文版本*）。原文语言与界面语言不同的示例书（例如附有英文译本的中文小说）会说明它以哪种语言打开（`openLocale`，见[预设文件包格式](https://postext.dev/zh/docs/sandbox-embedding.md#预设文件包格式)），所以点击该行时打开的是原文。

  隐藏的示例书集中在这一组底部一个*已隐藏的示例书*折叠区中，每一本都有**在列表中显示**。这一选择保存在`localStorage`中。

从**新建**菜单打开的`.postext`文件会成为一本新书并处于打开状态。包含多种语言的文件会先询问先打开哪一种，默认选中它的原文语言（清单文件中的`locale`），这本书会保留所有语言（见[导出与导入](https://postext.dev/zh/docs/sandbox-books-saving.md#导出与导入)）。导出是逐行的操作：当前打开的书所在的行导出屏幕上的内容。`.postext`文件就是把预设文件包目录压缩成的zip（见[导出与导入](https://postext.dev/zh/docs/sandbox-books-saving.md#导出与导入)）。

正文面板和版面设计面板中的重置按钮会恢复这本书所复制的那本示例书。空白书或导入的书没有原版，所以打开这类书时这些按钮是隐藏的。

#### 章节面板

活动栏中的第二个面板，只显示当前打开的书。顶部是书名、书的类别（*你的书*，或*示例书*，附带语言，修改后还有*已修改*标签），以及一个⋯菜单，其中是针对这本书的操作：你自己的书有**重命名…**（双击书名效果相同），此外有**复制**或**建立我的副本**、**下载（.postext）**，修改过的示例书还有**恢复原版…**。

下方的**各章**占满面板其余部分，并且单独滚动（见[书与章](https://postext.dev/zh/docs/sandbox-books-saving.md#书与章)）。每一章所在的行显示页码范围和字数，当前章有标记。中文、日文或韩文的书改为统计字符：每个汉字、假名或谚文字母计为一个，夹在其中的每个拉丁文单词也计为一个。**添加章**位于面板标题栏中章数的旁边；拖动行的拖动柄（或在拖动柄上按方向键）可以调整顺序；每一章的⋯菜单提供**重命名**、**上移 / 下移**、**按一级标题拆分**、**并入上一章**和**删除**（最后一章永远不能删除）。

##### 示例书（预设）

**预设文件包**是作为一个整体载入的完整起点：各章的Markdown、一份`PostextConfig`、资源（连同位图/SVG数据和表格模型），以及配置所引用的自定义字体文件。面板列出沙盒能访问到的所有预设，并标出当前打开的那个：

- **内置预设**：*Postext指南*，随软件包附带的默认示例书。它始终可用，始终排在列表第一位，并且是**公开的**。它有英文、西班牙文、加泰罗尼亚文、阿拉伯文、简体中文、日文、巴西葡萄牙文、法文、德文和意大利文十个版本（该行的ES、CA、EN、ع、简、日、PT、FR、DE和IT按钮；`#preset=postext-guide&lang=zh-Hans`链接到中文版，`lang=ar`链接到阿拉伯文版，`lang=ja`链接到日文版，`lang=pt-BR`链接到巴西葡萄牙文版）。阿拉伯文版按阿拉伯文书籍排版：从右到左，右侧装订，使用东阿拉伯数字，字体为Amiri、Noto Kufi Arabic和IBM Plex Sans Arabic，用卡希达（kashida）延长连笔来两端对齐，插图左右镜像并配阿拉伯文标注。中文版有自己的版面设计（Noto Serif SC和Noto Sans SC、大陆标点和断行规则），图中的标注也改成了中文。日文版同样是竖排的书，按日文的规则（JLReq）排版：Noto Serif JP和Noto Sans JP，9.25 pt的正文，每页上下两栏、每栏34字，节标题占三行（行取り），书眉和阿拉伯数字页码横排在天头和地脚，插图配日文标注。每种界面都打开自己语言的指南。从别的界面（用该版的按钮或`lang=`链接）打开的未经修改的中文、日文或阿拉伯文指南，无论界面是哪种语言都保持原来的语言；中文、日文或阿拉伯文界面自己打开的那一版，则和其他版本一样，下次以哪种界面语言打开沙盒，就换成哪种语言。
- **远程预设**：通过HTTP从`presetSources`属性传入的基础URL提供的文件包（见[属性](https://postext.dev/zh/docs/sandbox-embedding.md#属性)）。每个来源要么是公开的，要么是**私有的**。私有预设在列表中带*私有*标签，用于不能离开本机的材料。公开网站只在本地开发时列出私有来源，此时Next.js应用通过`/api/private-presets`提供`POSTEXT_PRIVATE_PRESETS_DIR`所指定的文件夹。生产环境从不列出它。网站的公开来源`/presets`提供其示例书：西班牙语和英语双语的*Bioquímica*、*Deep Sky*、*Don Quijote*、*Physics (OpenStax)*、*Spanish Painting*和*Signals 2020*，有三个版本的《红楼梦》，只有英文版的*Paradise Lost*（维里蒂的注释作为脚注，配多雷的插图），阿拉伯文的《一千零一夜》，日文的《心》，以及十种语言的漫画*Pepper&Carrot*。每一本都附有许可证和出处。
- **`default: true`**：标为默认的私有预设会在*原始状态*的沙盒（内置文档未经改动）第一次打开时自动载入。有多个预设带此标记时，`locale`与界面语言相符的那个优先。公开预设从不自动载入。

每一行显示预设的名称、可选的说明、语言标签，以及*私有* / *默认*标签。点击一行会**完整**载入示例书：正文、图、版面设计和字体。沙盒先把字体文件和图的数据写入IndexedDB，因此视口永远不会看到只应用了一半的文档。点击一行时，示例书以界面语言打开；但如果你只在另一种语言中修改过它，则打开你最近的版本。双语示例书的语言标签会以对应语言打开它（如果你在该语言中有自己的版本，就打开你的版本）。

**实时预设**。远程预设会被自动跟踪。每次应用预设时，沙盒会记录文件包的*指纹*，以及所应用的Markdown、配置和资源集合的哈希值。页面可见期间，它每3秒轮询一次指纹；标签页重新变为可见或窗口重新获得焦点时，也会立即检查。指纹发生变化时：

- 如果这本书**未经改动**（Markdown、配置和资源的哈希值仍与预设应用时相同），预设会完整地重新应用，面板中会短暂显示一条提示。
- 如果有**本地修改**，这些修改会保留下来。面板顶部出现一条横幅（*这本示例书有新版本。你的修改会保留。*），提供**载入新版本**；它在丢弃你对示例书该语言版本的修改之前会先征求确认。在此期间，活动栏中的书库按钮会显示一个圆点。草稿记得它是基于哪个版本建立的，所以在你载入新版本之前，每次打开它时横幅都会再次出现。草稿中的图如果其文件在新版本中有变化，会保留原来的字节：在写入文件包的新文件之前，草稿会先得到这些文件的独立副本。只有打开示例书时才会跟踪文件包。从示例书复制出来的书保留它自己的副本。

载入时也会执行同样的检查，所以如果你先编辑了文件包再打开沙盒，只要这本书未经改动，沙盒就会载入新版本。指纹来自`<preset-dir>/fingerprint.json`。在开发路由中，这是一个虚拟文件，返回目录的一个只基于元数据的哈希值（见附录[预设文件包格式](https://postext.dev/zh/docs/sandbox-embedding.md#预设文件包格式)）。不提供这个文件的来源不会被跟踪。

当前打开的示例书也决定了其他面板的**重置**按钮恢复什么：

| 面板 | 重置恢复的内容 |
| --- | --- |
| 正文 | 示例书的正文及其整套图（文档部分） |
| 版面设计 | 示例书的版面设计，包括字体 |
| 书库（恢复原版…） | 全部内容：正文、图、版面设计和字体 |

在之前的会话中打开过、但已不再被任何来源列出的预设（通常是某个构建不提供的私有预设）仍会显示，呈灰色并标为*此构建中不可用*。沙盒保留已载入的内容，而不是悄悄换成内置示例。当前打开的预设的id保存在`postext-sandbox-preset`键下（见[持久化](https://postext.dev/zh/docs/sandbox-books-saving.md#持久化)）。文件包格式在附录[预设文件包格式](https://postext.dev/zh/docs/sandbox-embedding.md#预设文件包格式)中说明。

#### 设计

设计是一本书的样子，不包括书的内容：页面和分栏、字体和样式、颜色、书眉、印刷设置。它从不包含正文、资源，也不包含属于整本书的设置（语言、书写方向、数字、资源类型、检查）。设计位于**版面设计面板**：概览中的**设计**一行打开它们，面板标题栏导出和导入设计文件。

- **部分**：设计按版面设计面板的分组切分（页面和分栏、书写系统、颜色、字体排印、排版规则、标题……）。保存、试用、应用或导出时，你可以选择包含哪些分组。
- **图库**：你保存的设计、沙盒内置的四种（*小说*、*技术手册*、*双栏杂志*、*双色书*）、五种排版惯例（*西班牙语（传统）*、*英语（美国）*、*英语（英国）*、*法语*、*德语*，只含排版规则部分，不改动字体排印），以及每本示例书的设计，每种都带有页面示意图和所含部分。
- **试用**：所选部分替换书中的对应设置。一个提示条提供**保留**和**放弃**：放弃只恢复设计替换掉的设置，期间做的其他修改都保留。试用另一种设计会替换前一种。试用属于开始时的那本书，打开另一本书就会结束试用。提示条会列出正文用到而设计没有定义的样式（段落、标题、文本框、标签、字符、标记和表格样式），让你在保留之前看到它们。试用、保留、放弃和应用都是历史记录中的一步（⌘Z / Ctrl+Z）。
- **命名样式**按id合并：设计中的样式替换书中同id的样式，书中的其他样式保留。字体按字族合并，设计设置所引用的调色板颜色也一并带入。
- **多语言的书**无论面板顶部的切换显示哪个范围，设计都写入通用设置；每种语言保留自己的覆盖设置。
- **保存**这本书或你的任何其他书的设计，包含你选择的部分。
- **作为章节样式**：所选部分成为书的一个[章样式](https://postext.dev/zh/docs/configuration-styles.md#章样式)（新建或已有），只包含相对于全书的改动。在**章节**面板或前置信息中的`chapterStyle:`把它分配给章节，用`:::part{style="…"}`分配给一个部分的各章。
- **导出和导入**：设计文件是没有章节的`.postext`（见[设计文件](https://postext.dev/zh/docs/configuration-bundles.md#设计文件)），带有其部分引用的字体文件和颜色配置文件；不可再分发的字体不包含在内。导入也能读取整本书的`.postext`（取其设计）和早期版本的`postext-config.json`。命令行也能写入和读取同样的文件（[`postext design`](https://postext.dev/zh/docs/command-line.md#design)）。已保存的设计可以删除，内置设计和示例书的设计不能删除。postext 1.78 保存的模板会在首次打开图库时移入已保存的设计，其`.postext-template.json`文件也可作为设计导入。

#### 资源面板

管理书中的资源：位图图像、SVG图、表和视频。正文用`::resource{id="…"}`块和`:ref{id="…"}`行内引用来引用它们。引用语法和浮动模型见[文档格式 › 资源](https://postext.dev/zh/docs/document-format-resources.md#资源)。

**列表视图**。标题栏显示资源的数量。资源按资源类型名称分组，每组是一个带计数的列表。`typeId`已与任何配置的类型都不匹配的资源归入*无类型*组，以便你仍能找到它们。每一项在题注和id旁边显示一个36 px的缩略图：位图和SVG显示真实预览，视频显示带播放徽标的封面，表显示一个图标字符。书中资源超过六个时，会出现一个**搜索**框（*搜索资源……*），按题注和id过滤列表，并忽略重音符号。书中还没有资源时，空状态会说明如何添加资源，以及如何用`:ref{#id}`把它们放进正文。**新建**下拉菜单提供四种添加方式：

- **上传图片**：PNG、JPEG、WebP或GIF
- **上传SVG**
- **新建表**：初始为一个2×2的网格，带一行表头
- **添加视频**：一段YouTube或Vimeo视频、一个视频文件，或某个视频的地址（MP4或HLS流；见下文*视频*）。资源类型早于视频功能的书，在添加第一个视频时会得到内置的*视频*类型。

你也可以把磁盘上的文件拖放到面板上，视频文件（MP4、WebM、Ogg、QuickTime）也可以。它们会批量上传，id由文件名转换成的slug生成。不支持的文件会被跳过，并有一条简短的说明报告添加了多少个、跳过了多少个。

**详情视图**。选中一个资源会打开它的编辑器：

- **ID**：可以编辑，并按slug规则校验。重复的id会被标出，永远不会提交；空id会得到一个由题注生成的建议值。重命名时保留已存储的图像或SVG文件。
- **类型**：已配置的资源类型之一
- **题注**：支持行内Markdown（粗体、斜体、代码和`:ref`）。`\\`或行末的反斜杠表示换行；普通的换行符算作一个空格
- **附注**：可选的来源说明、出处或备注，以较小的字号排在资源下方（行内格式和换行规则与题注相同）。它的样式由*题注*设置中的*附注*组决定。
- **替代文字**：供HTML输出使用的无障碍描述
- **表格样式**：对表而言，是这张表所用的命名样式（`table.styleId`）。它要么是*文档表格样式*（默认），要么是设置中声明的某个*表格样式*。没有任何样式声明的id会列为缺失，并以文档表格样式渲染。
- **位置**：
  - **位置**：`auto`（第一个空位，默认值）、`top`、`bottom`或`here`。
  - **整页插图**：用于不在`here`位置的图片（`placement.plate`）。图片在引用之后单独占一页，连同题注放到版心能容纳的最大尺寸，正文在它前后接续。**插页范围**可选*版心*、*成品尺寸*或*出血*：铺满整页时，图片放大到盖住页面并以中心为准裁切，题注留在版心底部、衬着纸色的色带，该页不印书眉和页码；没有裁切线时，出血就等于成品尺寸。设为整页插图后，其他位置字段会隐藏。打开印前检查时，放大到低于最低分辨率的位图会在检查面板中列为*图像分辨率过低*。资源类型的默认位置也提供这两个字段。
  - **跨度**：`column`、`page`或`side`。位置为`here`时不可用。默认值与引擎一致，即`auto` + `column`。
  - **跨栏数**：在多栏页面上，单栏浮动体横跨的相邻栏数（`placement.columns`），例如报纸四栏中跨两栏的图片。等于页面的栏数时就是通栏。书或其中某一章节不止一栏、且跨度为`column`时显示；位置为`here`或资源转向时不显示。
  - **方向**：正放，或者转四分之一圈（顶部朝左或朝右）。转向的资源独占一页，紧贴书脊，所以跨度选择不可用。
  - **宽度**：宽度比例加对齐方式，用于比所在栏窄的浮动体和行内嵌入。**宽度方式**可在以%表示的*比例*和以mm、cm、in、pt表示的*尺寸*（`placement.width: { value, unit }`）之间切换；尺寸按资源所在的位置来量，等于或超过该位置的宽度时就占满整个位置。对齐方式也用来安放以全宽设置、却比所在位置窄的位图或SVG（比栏窄的位图，或被`layout.fitFiguresToPage`缩小的图），所以对图片它始终可用；对表而言，宽度须小于100%。转向的资源两者都没有。
  - **题注在图旁**：用于一栏半版式中侧栏的开关。它只对栏内浮动体有效，所以位置为`here`时隐藏。
  - **缩小以放下**：浮动图片可选*从不*、*新页*或*任意位置*（`placement.shrink`），缩小时还有**最小比例**（`placement.minScale`）；所有未旋转的图片还有**题注宽度**：*位置*或*图片*（`placement.captionMeasure`）。资源类型的默认位置也提供这三项。
  - **置于引用页顶**：用于未旋转的单栏或通栏、位置为顶部或自动的浮动体（`placement.citingPage`）：它可以占据引用它的那一行所在页或栏的顶部，引用处之上的文字移到它下方。资源类型的默认位置中也有同样的开关。
  - **手动放置（不推荐）**：用于未旋转的栏浮动体或跨页浮动体（`placement.pin`）。这一组先说明为何不推荐固定位置，以及应改用哪些规则。**页**可选*自动*、*引用它的页*，或其后一到三页；**栏**为*任意*或某个栏号；**位置**为栏顶或栏底。**恢复为自动**会移除固定位置。**在画布中移动**让浮动体进入可拖动状态，可用鼠标或手指把它拖到页面上的某个位置；使用鼠标时，按住 Alt（Mac 上为 Option）拖动浮动体也能做到这一点而无需先进入该状态，在浮动体上的其他按压仍保持原来的作用（其标签、其文字、页面选择）。拖动浮动体时，它可以占用的每个位置都会亮起；位于引用之上或晚于三页之后的位置显示为灰色。按 Esc 取消。每次修改都是撤销历史中的一步，版式未遵循的固定位置会在检查面板中显示为 `floatPinMissed`。
  - **文字绕排**：对排在正文中的资源或宽一栏的浮动体，选*无*，或选它所在的栏的一侧、正文排在旁边（`placement.wrap`），绕排时还有**绕排间距**（`placement.wrapGap`）；未设宽度的绕排资源显示版式的默认比例。资源类型在默认位置中提供这两个字段。对图片选*沿轮廓*，正文就沿它的形状绕排，图片放在*对齐*所指的一侧（`wrap: "contour"`）：位图随后显示**按透明度取形状**（`contour.alpha`）、**不透明度阈值**（`contour.threshold`）和**轮廓间距**（`contour.margin`），沙盒从存储的文件描摹Alpha通道。形状未知的图片会在这些字段下方注明。
- **数据**：替换位图或SVG文件的上传控件
- **尺寸与分辨率**：对位图，显示它的像素、文件标明的分辨率（*未标明*，或者72和96并注明视为未标明）、按它排版所用的分辨率算出的自然尺寸（mm），以及当前排版中它所在位置的印刷ppi（放置不止一次时取最低值）。低于印前检查的最低值时以警告样式显示，低于严重阈值时以严重样式显示；书设为付印时还有**在检查中打开**。**分辨率**设定图片自身的ppi（`bitmap.resolution`；见[文档格式 › 位图尺寸](https://postext.dev/zh/docs/document-format-resources.md#位图尺寸)），**使用文件的… ppi**从文件填入这个值。上传的图片保留文件标明的分辨率（`bitmap.fileResolution`）。
- **视频**：用于视频资源（[文档格式 › 视频](https://postext.dev/zh/docs/document-format-videos.md#视频)）：
  - **来源**：*YouTube*、*Vimeo*或*文件*。
  - **视频地址**（YouTube、Vimeo）：视频的任意链接。链接指向一个新视频时，会从平台获取它的封面、画面尺寸和标题（替代文字为空时，标题成为替代文字）；**重新获取封面帧**再做一次。不指向该平台任何视频的链接会在字段下方标出。
  - **视频文件**（文件）：上传MP4、WebM、Ogg或QuickTime文件的控件，显示文件的格式、大小和时长。第一张封面取自视频十分之一处。**封面帧**播放文件：停在或拖到你想印出的那一帧，再按**用这一帧作封面**。**正式发布地址**：视频发布后所在的位置（`https://…`），由二维码和PDF链接打开；没有它，印刷版就没有二维码和链接。
  - **视频地址**（文件，且没有上传文件）：视频只从它的地址播放，可以是服务器上的MP4或WebM，也可以是HLS流（`.m3u8`，字段上方标有*HLS流*）。填入地址后会读取视频的尺寸和时长，**封面帧**也从这个地址播放它，HLS同样可以。选取画面需要服务器允许跨源读取（CORS）；否则面板会提示“视频所在的服务器不允许读取其画面（CORS）：请改为上传封面”，这时就上传一张封面。二维码和PDF链接打开这个地址。
  - **封面**：印出的图片及其尺寸，另有一个上传控件，可以换成你自己的图片。
  - **开始（秒）** / **结束（秒）**：播放的片段；0表示不改开头或结尾。
  - **播放器**：这个视频的各项开关（控件、下载按钮、全屏、倍速菜单、画中画、自动播放、静音开始、循环播放、与其他视频同时播放），每项可选*全书设置*、*是*或*否*。只列出该视频播放器支持的开关。
- **安全区**：用于位图和SVG，指图片中任何时候都要显示的部分（`Resource.safeArea`；见[文档格式 › 安全区](https://postext.dev/zh/docs/document-format-resources.md#安全区)）。这一栏显示一张标出安全区的缩略图和安全区的百分比尺寸，图片没有安全区时显示“未设定”，并有**标记安全区** / **编辑安全区**和**移除安全区**按钮。对话框中显示图片：在矩形外拖动画出新的矩形，在矩形内拖动移动它，拖动手柄调整大小；矩形获得焦点时，方向键移动它，Shift加方向键调整大小。*左*、*上*、*宽*、*高*四个字段以百分比设定它，两个预览分别显示安全区允许的最高裁切和最矮裁切。
- **裁剪**：用于位图、SVG 和视频封面图，即图始终显示的那部分（`Resource.crop`；见[文档格式 › 手动裁切](https://postext.dev/zh/docs/document-format-resources.md#手动裁切)）。**裁剪**按钮打开带画框的图片：在框内拖动可移动画框，拖动控制点可调整大小，也可用方向键（按住 Shift 步长更大）；预览按裁切的宽高比显示图，**取消裁剪**恢复显示整张图。安全区在裁切范围内读取。
- **锚点**：用于位图和SVG，指地图或示意图的标注所在的图上位置（`Resource.anchors`；见[模板页 › 带标注的插图](https://postext.dev/zh/docs/composed-pages-figures.md#带标注的插图)）。同一字段中的**锚点**按钮以“锚点”模式打开对话框，字段中还会显示锚点数和尚无锚点的标注数。
  - **点击放置**。对话框在“缺少锚点的标注”下列出正文`::label[…]{at="…"}`行用到、而图上还没有锚点的名称，并先选中第一个：在图上点击一次，就把它放在那里并选中下一个。这样，标注已经写好的地图，每点击一次就得到一个锚点。随时可以改选其他名称，或点“停止放置”。没有选中名称时，点击会添加`anchor1`、`anchor2`……并把光标放进它的名称框。
  - **每个锚点**有**名称**（标注所写的id）、版面设计中的**标注样式**（`labelStyles`）、**对齐**（按标注方向的起始、居中或末尾）、**垂直对齐**、以度为单位的**旋转**，以及**宽度**：占图片宽度的比例，标注在此宽度内换行（0表示保持自然宽度）。新锚点沿用之前选中锚点的标注字段，因此一串城市可以共用一种样式。列表显示每个锚点在当前章节中的标注文字（没有时显示“正文中没有标注”）；图片的锚点多于八个时，还有筛选框。
  - 拖动点即可移动它；点获得焦点时，方向键移动它（Shift加方向键步幅更大），Delete键将其删除。锚点按整张图片的比例记录，所以无论安全区允许怎样裁切，位置都不变；落在安全区外的锚点会被标出。**保存**把锚点写入资源，在撤销历史中算一步。
  - **在页面上**。在版面设计模式下，Canvas显示每个已绘制标注的框（若按样式的最小字号仍放不下，则以红色显示并注明“超出其宽度”）及其锚点。拖动锚点或标注即可移动锚点：标注会在松开的位置重新排版，Cmd/Ctrl+Z可撤销这次移动。单击会在本面板打开图片，双击则打开该图片的锚点并选中这一个。用`at="x% y%"`定位的标注同样可以拖动，松开的位置会写回当前所见版本的正文，改写 `at` 的值：百分比属于该版本自己的文字。在内容模式下，单击标注会在正文面板中选中它的文字。
  - **一次设置多个**。列表中的每一行都有复选框，按住Shift或Ctrl点击图片上的点也可勾选；**选中显示的锚点**会勾选筛选后留下的所有行。已勾选的锚点共用一组字段（样式、对齐、垂直对齐、书写方向），一次修改对所有锚点生效，在历史记录中算一步。各锚点取值不同时，字段显示“不一致”。
  - **密集的地图**。锚点达到24个时，只有被选中、悬停或勾选的点才显示名称，避免标签堆在一起；打开**图片上显示名称**可再次显示全部。**书写方向**让某个锚点的标注竖排（`writingMode`），这时它的**宽度**是图片高度的一部分。
  - **重叠**。默认是*检查*。选*允许*（`overlap: 'allow'`）表示原稿就把这个锚点的标注印得挨着邻近的标注，密集的地图常见这种情况；检查面板不再为包含它的任何一对标注给出`labelOverlap`。勾选的锚点可以一起设置。标注样式也可以为它的所有标注设为允许（**版面设计 › 图与表 › 标注样式**）。自postext 1.42起。
  - **书脊**。默认是*避开*：在跨过跨页书脊的插图上，会伸进订口带的标注停在带的边缘，位于其锚点所在的一侧。*跨越*（`gutter: 'cross'`）让标注留在点所定的位置，横跨两页的标题需要这样。勾选的锚点一并生效。自postext 1.43起。
  - **缩放**。图片上方的按钮、键盘上的`+`、`-`和`0`，以及Ctrl加滚轮或双指捏合，都可以分档放大，最高800%，以指针下的点为中心。放大后的图片可用滚轮、手形按钮，或按住空格（或鼠标中键）拖动来移动。点的大小不变，达到300%后，密集的地图会显示全部名称（自postext 1.40起）。在触摸屏上，两指移动图片，张开或捏合则以两指之间的点为中心放大或缩小（自postext 1.42起）。
  - **在HTML阅读器中**，版面设计模式画出同样的框和点，标记的移动方式与Canvas相同：拖动一个点，锚点（或`at`的百分比）就作为历史记录中的一步写入（自postext 1.40起）。**在书页标签页中**，选择模式下，这些标记画在书页上，拖动方式与Canvas相同：点跟着指针在书页的纹理上移动，松手时写入锚点，按在标记上绝不会翻页（自postext 1.42起）。在触摸屏上，手指按住标注的框，或按在其点周围一指宽的范围内，即可从那里拖动；手指按在空白纸面上仍然滚动页面（自postext 1.43起）。
- **图中的字体**：用于SVG图，列出图中文字指定的字体族（字体族、字重、样式）以及每一种的处理结果：“已嵌入”并给出大小、“SVG中已声明”（文件自带`@font-face`）、“没有字体文件”（图片改用其他字体）或“超出大小上限”。字体先取自书的自定义字体，再取自Google Fonts，只在图片显示或导出时嵌入，从不写入存储的文件。**嵌入书中的字体**开关可为这张图关闭嵌入（`svg.inlineFonts: false`），适用于自带字体或必须保持原样的SVG。
- **SVG源码**：对SVG图而言，上传控件下方有一个源码编辑器。只有文字节点接受编辑：即`<text>` / `<tspan>`元素的内容，在编辑器中着色显示。在其他地方的输入会被拒绝；在文字节点中输入的`<`、`>`和`&`会被转义，使文件保持格式正确。每次修改在短暂停顿后保存为一个**新的**存储文件，图随之重新渲染（包括单色重着色）。SVG没有文字节点时，编辑器会加以说明。
- **预览**：资源外观的实时示意，用`#`代替编号（实际编号取决于资源在文档中落在哪里）。题注以文档设定的标签开头：类型的题注前缀加编号（`Figure #.`）；编号模板为空的类型只有前缀（`Do.`）；没有题注前缀的类型则什么都没有
- **删除**：先请你确认，并提醒正文中有多少处`::resource` / `:ref`引用会因此失去目标

**表格编辑器**。表资源打开一个交互式网格编辑器：

- **工具栏**：
  - 添加或删除行和列，合并或拆分单元格。
  - 开关表头行或表头列。
  - 设置每个单元格的水平和垂直对齐（顶部、居中或底部）。在较高的行中，单元格内容作为一个整体移动。
  - 设置每个单元格的填充色：一个可以关联调色板的颜色选择器，带清除按钮。填充色写入`TableCell.background`，并显示在网格中。
- **列宽**：网格下方每列一个数字权重（`2, 1, 1`使第一列占一半宽度；留空表示等宽），写入`table.model.columnWidths`。添加或删除列时权重保持对应，*等宽*链接可以清除它们。
- **粘贴为表格**：粘贴TSV（或简单的带引号CSV）会填满网格
- **撤销/重做**：Cmd/Ctrl+Z和Shift+Cmd/Ctrl+Z
- **键盘导航**：Tab / Shift-Tab（换行循环）和方向键在单元格之间移动
- **在预览中点击编辑**：在任一预览标签页中点击表格单元格、题注、注释或SVG图中的一段文字。资源面板会打开这个资源，并让对应字段获得焦点，光标落在所点击的字形上。拖动可以在同一单元格或字段中选择一段范围，双击选中一个词。字段获得焦点期间，它的选区会以高亮的形式映射回页面（选区折叠时显示为一条细光标），Canvas和HTML标签页都是如此。 `:::figure`用自己的文字写出的题注或注释（`::caption[…]`、`::note[…]`）则在Markdown中写它的地方被选中。

所有编辑都通过postext核心导出的纯模型函数完成（`addRow`、`addColumn`、`removeRow`、`removeColumn`、`mergeCells`、`unmergeCell`、`setCellContent`、`setAlignment`和`parseTSV`），所以同一个表格模型在沙盒内外的行为完全相同。

#### 字体面板

显示书中使用的字体，并在内置的Google Fonts目录之外管理你自己的字体文件：

- **本书使用的字体**列出版面设计用到的每个字族。每个字族名都用该字体本身排出，并注明其用途（*正文*、*标题*或*其他元素*）和来源：*Google Fonts*、*Fontsource*（Google Fonts没有的字族）、*你的文件*，哪里都没有的字族则标为*未找到*。加载器查明来源之后，来源才会显示。字体本身在**版面设计 › 字体排印**和**标题与目录**中更改。
- **测量一本书所用的文件**：Google Fonts或Fontsource的字族，用jsDelivr上Fontsource的静态文件（`@fontsource/<字族>@5`）排字，每个字重、样式和子集各一个文件。排版食谱的CodePen加载的、PDF嵌入的也是这些文件，所以一本书在预览、PDF和CodePen里都在同样的字词处断行。命令行用`bodyText.shapingLanguage: 'host'`排版，某一行在那里可能断在别的词上（见[与沙盒的区别](https://postext.dev/zh/docs/command-line.md#与沙盒的区别)）。预览声明版面设计和页面用到的字重与样式，浏览器在文字需要时才加载各个文件。postext 1.30起，预览在第一次绘制一章之前，还会等排好的页面用到的每一款字体按这些页面的字符加载完（每款字体切成16个以上文件的字族，即中文或日文字族，照旧加载）。从postext 1.28.3到1.29.2，只有页面用到、文字又不是拉丁字母的字体（阿拉伯文书目录里摘要的斜体），在文件到达之前是用后备字体绘制的。可变字族两个字重之间的字重（如450）没有静态文件：预览用Google的可变文件按该字重排出，PDF则嵌入最接近的那个字重；两者必须一致时，请选用字族本身具备的字重。Fontsource没有文件的字族，从Google的样式表加载。一个字族的所有文件都取自其软件包的同一个版本，也就是jsDelivr回应其样式表时所用的版本：`@5`指向每个地址各自解析到的版本，在重新切分字族的发布之后，它的文件可能来自两套切分。
- **迟到或网络没有给出的文件**：一本书所用字体的文件在第一次排版之前获取，只要文件还在陆续到达，排版就一直等：有几百个文件的书（中文或日文书）在慢速连接上只排一次，用的是全部文件。只有当所有字体文件连续15秒都没有收到任何数据时，这些请求才会放弃；这一章随后用已经到达的字体排版，其余的用警告里写明的后备字体。这样的排版是临时的：它的页数不随书保存，也不写入文件包。文件会再请求三次，每次相隔半分钟，之后每次排版也会再请求；文件到达后，预览和所有缺了它排出的章节都会重新排版，目录和页码引用随之更新，PDF和EPUB标记为已过期。
- **字族没有的字重或倾斜**：预览和PDF都用字族自己的文件排字。字族没有粗体（Bangers、Zen Antique和多数标题字体只有一个字重）或没有斜体时，粗体和斜体用它最接近的字体原样排出，不带浏览器会画出的加粗或倾斜，也不为它们列出`fontFallback`。由字族中另一个真实字体应答的字重（用700排出的600）仍会列出。Fontsource收录而Google Fonts没有的字族（如Commit Mono）从Fontsource加载。
- **你的字体文件**用来添加、重命名和删除自定义字族。
  - 按字重（100–900）和样式（常规 / 斜体）**上传字体文件**。接受的格式为WOFF2、WOFF、TTF和OTF，按文件扩展名识别。文件保存在浏览器的IndexedDB中。
  - 自定义字族出现在每个字体选择器的**自定义**分组中，与Google Fonts的结果并列。自定义字族**优先于**同名的Google字体。
  - 在中文文档中，每个字体选择器首先在*简体中文*或*繁体中文*下列出包含文档所用字符的Google字族（Fontsource的`chinese-simplified`、`chinese-traditional`和`chinese-hongkong`子集），然后才是其余字族。
  - 在阿拉伯文（或其他用阿拉伯字母书写的语言）文档中，每个字体选择器首先在*阿拉伯文*下列出带有Fontsource `arabic`子集的Google字族，书籍字体排在前面（Amiri、Noto Naskh Arabic、Scheherazade New、Markazi Text、Lateef，然后是Noto Kufi Arabic、Reem Kufi、Aref Ruqaa、El Messiri）。预览在第一次排版前加载每种字体的阿拉伯文文件；正文同时用到阿拉伯文和拉丁文时，PDF把两个文件都嵌入。
  - 孤立的字体文件（已不被任何字族使用的上传文件）会自动从IndexedDB中删除。

### 手机与小屏幕

宽度小于768像素时，沙盒改用专门的布局：

- **面板**。面板栏移到窗口底部：最前面是**预览**按钮，其后的按钮和顺序不变；宽度小于352像素时排成两行，每行四个。打开的面板覆盖在预览上，而不是排在它旁边；预览留在下面原来的位置，不在Tab键顺序中，所以关上面板时它还停在同一页。
- **顶栏**。输出标签页、范围选择器（在EPUB和SCORM标签页上是版式选择）和宿主的控件（大按钮、主题、语言）共用预览上方的横栏。宽度小于640像素时它分成两行：上面是标志、范围选择器和控件，下面是各标签页，平分整个宽度；320像素宽也放得下五个。
- **工具栏**。预览的浮动工具栏停靠在预览底部，放不下时折到第二行。画布的版本栏是预览顶部的一行。
- **书页**。手机屏幕上不提供书页标签页（见[书页标签页](https://postext.dev/zh/docs/sandbox-previews.md#书页标签页)）。
- **PDF**。手机和只支持触控的平板无法在页面内显示PDF（Android没有内嵌查看器，iOS只绘制第一页），所以PDF标签页改为显示一张带**打开PDF**按钮的卡片，在新的标签页中打开文件；工具栏的**下载**仍可保存它。
- **触摸**。在Canvas和HTML阅读器中用手指移动标注（自postext 1.43起）、Folio的选择模式，以及锚点对话框里的双指缩放和平移，已用浏览器的触摸模拟和真实的触摸事件，在手机尺寸和平板尺寸的屏幕上测试过。没有在实体设备上试过：对`touch-action`的处理不同的浏览器，可能在沙盒期待拖动的地方滚动页面。如果某个手势不正常，请告知浏览器和设备。

![两个手机屏幕：左边是Canvas，显示书中一页，底部是面板栏；右边是“正文”面板，盖住了预览。](https://postext.dev/docs-shots/zh/sandbox-phone.webp)

*在手机上：预览的工具栏停靠在底部；打开的“正文”面板盖在预览上。*

## 路线图

以下功能计划在后续版本中推出：

- **协同编辑**——在多个浏览器中共同编辑同一本书
