# 沙盒：版面设计面板与检查面板 > 版面设计面板的分组、页面、搜索与摘要，以及检查面板中按类别分组的实时警告 - HTML版本: https://postext.dev/zh/docs/sandbox-design-checks - 最后更新: 2026-10-16 - 阅读时间: 25分钟 - 其他语言: [en](https://postext.dev/en/docs/sandbox-design-checks.md), [es](https://postext.dev/es/docs/sandbox-design-checks.md), [ca](https://postext.dev/ca/docs/sandbox-design-checks.md), [de](https://postext.dev/de/docs/sandbox-design-checks.md), [fr](https://postext.dev/fr/docs/sandbox-design-checks.md), [it](https://postext.dev/it/docs/sandbox-design-checks.md), [pt](https://postext.dev/pt/docs/sandbox-design-checks.md), [ja](https://postext.dev/ja/docs/sandbox-design-checks.md), [ar](https://postext.dev/ar/docs/sandbox-design-checks.md) ## 简单来说 本页介绍沙盒的两个面板。版面设计面板放着书的每一项设置，比如页面大小、字体和颜色，分成若干组，还有一个搜索框。检查面板列出你工作时Postext发现的问题，比如缺了一张图片，或者某一行太松。每个问题都标明位置，点一下就会跳过去。 ## 版面设计面板 一个基于表单的`PostextConfig`编辑器，有五百多个字段。 **概览**。打开版面设计面板时，首先显示概览： - 一张**本书**卡片，附有页面的实时示意图。示意图按真实比例绘制，显示页边距、栏以及页面和油墨的颜色；页边距为对称设置时画成跨页。竖排的书，文字行从右侧起自上而下画出，各栏画成上下叠置的几层。旁边列出成品尺寸、栏式、书写体系、正文字体和字号，以及调色板。书写体系一行写出文档语言，方向和装订边可以选择时也一并写出（*竖排 · 右侧装订 · 中文（繁體）*，*从右到左 · 右侧装订 · العربية*）；点击它会打开**书写体系**。 - 十三个**设置组**的列表。每组附有一句话的说明，以及你在该组中改动过的分区数量。 **每组一页**。打开一组时，该组的各个分区显示为单独的一页。只构建这一组，因此即使是大部头的书，面板也能保持流畅。 - 面包屑导航（**版面设计 › 组名**）可以返回概览。 - 页面标题下方的标签可以跳到页面上的各个分区。 - 底部的**下一组**链接打开后面的一组。 - 打开一组时，焦点移到页面标题；返回时，焦点回到该组所在的行。 - 当前打开的组在会话之间保留。 各组按浏览顺序排列如下： - **页面与栏** - *页面*：字段分为**尺寸**、**页边距**、**纸张**和**编号**几组。 - **尺寸**：尺寸预设写明各自的用途：*口袋书*11 × 17、*小说、叙事类*12 × 19、*随笔、手册*17 × 24和*教材、杂志*21 × 28，报纸开本*大报*37.5 × 59.7、*柏林版*31.5 × 47、*小报*28 × 43和*紧凑版*29.7 × 42（postext 1.18起），或者*自定义*。**排版分辨率（每英寸像素）**（`page.dpi`）也在这里：它是排版所用的像素数，不是图片的分辨率，不过没有自身分辨率的位图就以这么多ppi印刷。 - **页边距**：每个页边距都与页面示意图关联。指向或聚焦某个页边距字段时，示意图上对应的页边距会着色。**对称**开关把左/右页边距变为对页的内侧/外侧页边距。 - **纸张**：页面背景色。 - **编号**：页码格式和起始页码。 - *栏*：版式从图示卡片中选择：*单栏*（小说、随笔）、*双栏*（教材、杂志、工具书）、*一栏半*（一个主栏加一个窄侧栏，用于注释和小图）或*多栏*（三到八个等宽的栏，用于报纸和杂志，栏数在**栏数**中设定；postext 1.18起）。这一分区还有栏间距、侧栏、**缩小放不下的图**（`layout.fitFiguresToPage`）、**位图分辨率**（`layout.bitmapResolution`：*页面dpi*；*来自文件*，它也会读取此前上传的图片的分辨率；或*固定*，另设ppi）、**缩小浮动图片**及其**最小比例**（`layout.floatShrink`）、**浮动体置于引用页顶**（`layout.floatsAtCitingPage`）及**引用页顶浮动体的最大占比**（`layout.maxTopFraction`）、**浮动体排在通栏标题下方，从第一栏起**（`layout.floatsUnderOpener`，postext 1.25起默认开启：紧跟在跨多栏标题后面的浮动体占据第一栏的栏首）、**行内图周围的间距**（`layout.inlineResourceGap`）、**框内图周围的间距**（`layout.inlineResourceGapInBoxes`）、**框断开处段落的行数**（`layout.boxChildSplitMinLines`）、**正文中的分栏，以及可拆分的分栏组**（`layout.flowColumns`，postext 1.25起默认开启：框外的`:::columns`组把其中的块排成若干栏，放不下的组接到下一栏或下一页）和**收尾浮动体紧贴正文**（`layout.hugClosingFloats`）。 - *文字绕排*：**文字绕排间距**、**旁边正文最小宽度**、**旁边最少行数**和**绕排宽度**（`layout.wrap`），即正文绕排的图片和框的默认值。 - **书写体系**。页面开头是“页面与栏”中的那张示意图。它的跨页标有页码：左侧装订的书为2 | 3，右侧装订的书为3 | 2，奇数页在左边；题注会说明书是否右侧装订、文字行是否竖排。 - *语言和方向*： - **文档语言**，中文列为中文（简体）、中文（繁體）和中文（香港），阿拉伯文列为العربية、العربية (مصر)和العربية (المغرب)（地区决定数字等地区默认值）。列表中没有的语言标签（`es-ES`、`zh-TW`、`sv`）显示为一个额外选项，以它所对应的语言命名。更改语言时，如果内置的图和表类型仍是前一种语言的名称，就会随之改名（西班牙文的书改成中文后印出图和表，而不是*Figura*和*Tabla*）；你改过名的类型保留原名。 - **文字方向**：*自动*（写明它解析成什么，阿拉伯文为从右到左）、*从左到右*或*从右到左*（`direction`）。 - **书写方向**，从图示卡片中选择：*横排*，或*竖排*，即文字行自上而下、从右到左排列（`layout.writingMode`）。 - **装订边**：*自动*（写明它解析成什么，竖排或从右到左的书以及从右往左读的漫画书为右边）、*左边*或*右边*（`page.binding`）。 - **数字**：*自动*（写明语言给出的数字：阿拉伯文为٠ ١ ٢ ٣，马格里布地区的阿拉伯文和其他所有语言为0 1 2 3）、*欧洲数字*、*阿拉伯-印度数字*或*波斯数字*（`numerals`）。 - **中文默认设置**：**查看…**列出把书设置为中文时会改变哪些设置。选择*简体*或*繁體*以及方向：新的繁体书默认竖排，新的简体书默认横排，已经是中文的书保持原来的方向。每一行显示设置的当前值和改后的值：文档语言（同一书写系统的中文标签，例如`zh-TW`，会保留）；书写方向及其对应的装订边；正文和标题使用SC、TC或HK版本的Noto Serif和Noto Sans（标题一行还会列出各级标题和标题样式自行设定的字体，勾选后这些也改用中文字体）；首行缩进2 em；标题后缩进；段间无空白；两端对齐；不断词；图或圖以及表按章编号（`{h1}-{n}`）；题注排成图1-1　标题（编号前无内容，编号后一个全角空格）；章编号为第一章（`第{1:一}章`，标题前一个全角空格）；编号列表为一、 （一） 1. （1） ①。只列出有差别的项。你自己改过的设置默认不勾选，标为*你的设置*，除非你勾选它，否则保持不变；语言和方向始终会应用，断词也是如此，因为中文文档会自动关闭断词（除非你在断词语言中指定了某种拉丁语言并为它打开了断词）。**应用**一步完成所有勾选的修改；确认信息旁边的**撤销**在同一本书中撤回这一步：它改过的每项设置都回到原来的值，即使此后你改动了同组的其他设置；此后你又改过的设置则保持你留下的样子，确认信息会说明这一点。打开另一本书后，撤销不再可用。 - **阿拉伯语默认设置**（阿拉伯文文档中显示）：**查看…**列出把书设置为阿拉伯文时会改变哪些设置。先选择字体：*古典*，正文和标题都用Amiri；或*现代*，正文用Noto Naskh Arabic，标题用Noto Kufi Arabic。各行依次是：书原本设为从左到右时，方向改回*自动*（始终应用）；装订边改回*自动*（右边）；两种字体；用没有阿拉伯字母的字体排的设计文本（页眉、页码、篇章页和标题设计）改用标题字体，以免PDF印出空框；行距1.75 em；两端对齐；不断词；书指定了其他数字时改用所在地区的数字；شكل和جدول按章编号；题注排成شكل ١-١: العنوان；章编号为الفصل الأول（`الفصل {1:ordinal}`，标题前加冒号）；编号列表为١- أ- (١)；脚注每页重新编号；编号都使用文档的数字。勾选、*你的设置*、**应用**和**撤销**与中文默认设置相同。 - **日语默认设置**（日文文档中显示）：**查看…**列出把书设置为日文时会改变哪些设置。先选择书的类型：*竖排 縦組*，即按字符网格排、右侧装订的文库本或单行本小说；或*横排 横組*，即左侧装订的技术书。各行依次是：文档语言和书写方向（始终应用）；装订边改回*自动*；正文和标题用Noto Serif JP和Noto Sans JP（用没有假名的字体排的设计文本也改用它们）；行距1.75 em；竖排页面在这一字号下能容纳的字符网格（每行最多52字）；缩进一个字，段间不加空白；两端对齐、不断词；中文排版设置改回*自动*，让日文设置生效；図和表，题注排成図1-1　…；章编号为第一章（竖排）或第1章（横排）；占三行和两行的标题（行取り）及其缩进；日文列表编号；中文注释设置改回*自动*；在切口竖排页码时改用汉字页码。**应用**和**撤销**与中文默认设置相同。日文书的编辑器工具栏会增加**注音**和**纵中横**两个按钮。见[日文排版](https://postext.dev/zh/docs/japanese-layout.md#在沙盒和排版食谱中)。 - *东亚排版*（`cjk`）：最上面是**地区规范**（中国大陆、台湾、香港、日本），其后的字段分为九组：**行首行尾**（**断行规则**：无、基本、GB、严格、日文最严格、日文严格、日文宽松；**字间断行**；**书名断行最少字数**、`cjk.titleMinChars`；**带圈数字**：按汉字排或按西文字母排；**设计文字采用中日文规则**；**行首行尾括号减半**；**段首括号**：①、③或顶格；**标点悬挂**）、**标点宽度**（**标点宽度**：开明式、全角、行末半角、半角；**相邻标点挤压**）、**间距**（**汉字与拉丁字母之间的空白**；**？！后空格**）、**竖排文字**（**纵中横数字**：关闭，或最多2、3、4位数字，`cjk.uprightDigits`）、**标注**（**中日文强调**：`*…*`印成着重号还是斜体；**着重号形状**、**着重号填充**和**着重号位置**；**书名（:book）**：括号、波浪线或不加标记，以及所用的**书名号**，《》〈〉或『』「」；**标记颜色**）、**注音**（注音文字的字体、字号、颜色和位置，**注音伸出**、**注音对齐**和**注音中的小假名**）、**割注**（注文的字号、颜色以及前后括号）、**汉文训点**（记号的字号、颜色以及返点的位置）和**字符网格**（每行字数、每页行数、屏幕上显示的网格，以及“字 × 行”读数和网格所决定的页边距）。每个*自动*都跟随文档语言，并写明它解析成什么。在语言不是中文、日文或韩文，而且没有设置其中任何一项的文档中，这一分区只显示一行说明和一个**显示这些设置**按钮；搜索时，任何文档都会显示这些字段。[中文排版](https://postext.dev/zh/docs/chinese-layout.md)和[日文排版](https://postext.dev/zh/docs/japanese-layout.md)解释这些设置的作用；配置键见[东亚排版](https://postext.dev/zh/docs/configuration-east-asian.md#东亚排版)、[竖排](https://postext.dev/zh/docs/configuration-page-layout.md#竖排)、[竖排中的数字](https://postext.dev/zh/docs/configuration-east-asian.md#竖排中的数字)和[装订边](https://postext.dev/zh/docs/configuration-page-layout.md#装订)。 - **颜色** - *调色板*：供每个颜色选择器复用的命名颜色。修改某一项会更新所有引用它的地方。 - *对比度*（`contrast`）：**检查对比度**、**等级**（AA或AAA）、**检查对象**（*自动*、*屏幕*、*印刷*、*屏幕和印刷*），以及**反白字**下的字号：有墨底色上的浅色文字小于这些字号时会被报告。改动它们不会重新排任何一页。见[对比度检查](https://postext.dev/zh/docs/configuration-fonts-colors-viewers.md#对比度检查配置)。 - *颜色旁的对比度*：页面把某个颜色字段的颜色用作文字颜色或文字的底色时，该字段显示这种颜色在页面上的最低对比度，达到等级时带一个对勾，未达到时带一个警告标记。打开该字段，会列出与它搭配的每种颜色（*文字，底色 #ffffff*、*底色，文字 #1a1a1a*）、最小字号，以及屏幕上的对比度，为印刷设置的书还有纸上的对比度。拖动选择器时数字随之变化，不必等页面重新排好。只用于线条或边框的颜色不显示对比度。 - **字体排印** - *正文*：开头是一份按实际大小排出的**字样**，用当前的字体、字号、行距和颜色，以文档的语言排出：中文书以本书所用的简体或繁体字形显示《紅樓夢》的开头，`*…*`加着重号，文字行竖排时自上而下排列。字样的断行由浏览器决定，页面上的断行由Postext决定。字段分为以下几组： - **字体**：字体、字号、行距，以及常规和粗体的字重。 - **段落**：对齐方式（正文两端对齐时，附有断词、两端对齐的限度和**两端对齐时最大字距**（`bodyText.maxJustifyTracking`）；不两端对齐时，附有**齐左文字断词**及其断词区、**最优断行**和**齐左文字最优断行**（`bodyText.optimalRagged`）；正文两端对齐时，**齐左文字最优断行**跟在**最优断行**后面，供齐左的段落样式和标注框使用；**跨栏断词**（`bodyText.hyphenateAcrossColumns`）在正文两端对齐时位于断词之下，在正文齐左时位于**齐左文字最优断行**之下，且只在该项打开时出现；**复合词断词**（`bodyText.hyphenation.compounds`）与断词语言放在一起）、**破折号后断行**（`bodyText.breakAfterDashes`）、**连字符后断行**（`bodyText.breakAfterHyphens`）、**在下一行重复连字符**（`bodyText.repeatHyphen`）、**强制换行**（`bodyText.hardLineBreaks`）、**制表位**（`bodyText.tabStops`：一组制表位，每个都有位置、对齐、前导符、前导符间隙和小数点字符）及**默认制表位间隔**（`bodyText.tabInterval`）、缩进和段间距。 - **颜色**：正文、粗体和斜体的颜色。 - **语言**：文档语言，用该语言本身写出名称。它在**书写体系**中设置；点击这一行会打开那一组。 - **孤行与短行**（可折叠）：包括**分级孤字罚分**（`bodyText.gradedRuntPenalty`）、**收紧以拉回孤字**（`bodyText.tightenRunts`）、**最大收紧字距**（`bodyText.maxRuntTracking`），以及**冒号与列表不分离**及其**冒号下方的空间**（`bodyText.colonListRoom`）：以冒号结尾的行下方需要多少空间才能与列表留在一起，可以是第一个列表项所需的空间，也可以像postext 1.4及以前那样只需一行。 - **引文**（可折叠）：`>`引文的颜色、**引文用斜体**、**引文缩进**和**引文首行缩进**（`bodyText.blockquote`）。 - **诗歌**（可折叠）：**无分隔符的诗**（*逐行*，或*按半句（1.22）*）、**每个空格的缩进**、**转行**（*悬挂*或*靠右*）及其**转行缩进**或**转行标记**、**诗节间距**、**短诗节不拆分**和**先收紧再转行**（`bodyText.verse`，逐行排的`:::verse`诗的默认值）。 - **交叉引用**（可折叠）。 - *段落样式*（`paragraphStyles`）：供`:::paragraphs{style="…"}`容器使用的命名样式。你可以添加、删除和重命名id，然后设置字体、字号、行距、颜色、粗体和斜体文字的颜色、常规和粗体字重、**斜体**和**小型大写字母**开关、对齐方式、断词、每一行的左缩进、首行缩进和悬挂缩进（从左缩进处量起）、段间距、外边距、**对齐网格**（`paragraphStyles[].snapToGrid`）、**大小写**（`textTransform`，大写）、**行号**（`paragraphStyles[].lineNumbers`：*跟随文档*、*计入*或*不计入*）、**制表位**和**默认制表位间隔**（`paragraphStyles[].tabStops`、`tabInterval`），设置方式与正文相同，以及**首字下沉**（`paragraphStyles[].dropCap`）：它跨越和下沉的行数、放大的字母个数、字体、字重、斜体、字号、颜色和间隙，**开头标点**（*随首字放大*、*悬在外侧*、*放在第一行*），**引导词**（无、若干个词或第一行，排成小型大写字母或大写字母），**短段落**如何处理（*保留空间*、*缩小首字*、*不用首字下沉*），以及用于条目式目录的**每一段**（见[首字下沉](https://postext.dev/zh/docs/configuration-text.md#首字下沉)）。未设置的字段继承正文。在各样式之上，**容器下方的间距**（`bodyText.paragraphContainerSpacing`）决定容器下方的空白如何与其后的块相接：*折叠*，或*相加（1.4）*。 - *行内标签*（`chipStyles`）：供行内`:chip[text]{style="…"}`使用的命名样式。配置中没有任何样式时，显示内置的`chip`样式。你可以添加、删除和重命名id，然后设置： - **文字**：字体、字号、颜色、粗体和斜体。每一项在你设置之前都继承周围的文字。 - **框**：填充色、轮廓粗细和颜色、圆角半径、水平和垂直内边距（可以用**上内边距**和**下内边距**分别设置，使大写字母在圆形标签中居中），以及与相邻词之间的最小间隙。 - *代码*（`codeStyle`）：**代码围栏**和**缩进代码**（怎样识别代码清单）；**代码字体**、字号、行距、**对齐网格**、颜色和**制表符宽度**；**框**（跨栏方式、底色、边框、圆角半径、内边距、上下间距）；**过长的行**（**比框更宽的行**：*折行*、*缩小*及其**最小字号**，或*截断*；**续行缩进**和**续行标记**）；**行号与突出显示的行**（**标注行号**、行号颜色和行号后的间距、围栏所突出显示的行的底色）；**跨栏与跨页**的拆分（保持完整、每侧保留的行数、重复标题、“续”标记）；**语法着色**（*内置*或*无*，以及每种记号的颜色和样式，可用调色板颜色）；以及用代码字体排的**行内代码**及其底色。见[代码清单](https://postext.dev/zh/docs/configuration-styles.md#代码清单)。 - *公式*（`math`），带**独立公式后缩进**（`math.indentAfterDisplay`）和**与引出行不分离**（`math.keepWithLeadIn`）。 - *脚注*（`footnotes`）：**位置**（栏底或章末）、章末时的**在栏中的位置**、**编号**（按章或连续）、注文的字号、行距、颜色、对齐方式和悬挂缩进、注文上方和注文之间的间距，以及**分隔线**（长度、粗细、颜色）。见[脚注](https://postext.dev/zh/docs/configuration-notes-references.md#脚注)。 - *行号*（`lineNumbers`）：**标注行号**、**计数对象**（*诗行*或*所有行*）、**间隔**、**标注第一行**、**重新计数**（从不，或每章、每节、每页、每首诗）及**起始行号**、**位置**（外侧页边或内侧页边、左侧、右侧、行首一侧、行尾一侧、侧栏）、**多栏时**（外侧两边、栏间、每栏旁边）、**与正文的距离**、**对齐**，以及行号的字体、字号、字重、斜体、颜色和**编号格式**。见[行号](https://postext.dev/zh/docs/configuration-notes-references.md#行号)。 - **标题与目录** - *标题*：通用默认值，加上H1–H6各级的设置。其中包括： - 大小写、**字距**（`levels[].letterSpacing`，负值表示收紧）、对齐方式（齐左、两端对齐、居中或齐右）、前置分页及奇偶页，以及跨度； - **标题后回到网格**开关（`headings.snapToGrid`，默认打开：标题下方的正文回到基线网格上），以及各级的**本级标题后回到网格**（`levels[].snapToGrid`），为该级覆盖上述设置； - **标题中的行内标记**开关（`headings.inlineMarks`，默认打开）：标题像段落一样排出其中写的斜体、粗体、上下标、小型大写字母和链接；关闭时，被标记的词按标题自身的样式印出； - 各级的**隐藏（结构性）**（`levels[].hidden`）：标题不印任何内容，也不占空间，但仍然分页、编号，并为目录、书眉和PDF书签提供条目； - 各级的**标题后的首字下沉**（`levels[].dropCap`）：该级标题后的第一段以首字下沉开头，字段与段落样式的相同； - 高级的各级版面设计槽位编辑器，带最小章首高度；标题版面设计中的每个元素都有一个**预留空间**开关（关闭时，它只绘制，不增加标题所预留的高度）； - 各栏齐底的调节手段及其各自的上限，以及**收尾标注框**（`balancing.closingBox`）：结束一个短栏的标注框何时移到栏底——最先、在其他手段之后，或从不。 - *标题样式*（`headingStyles`）：在标题行上用`{style="…"}`应用的命名样式。你可以添加、删除和重命名id，每种样式可以： - 选择标题是否编号、是否列入目录，并给它一个自己的编号模板； - 关闭**用于书眉**（`runningChapter`），供在章内作为H1排出的图版或地图使用，这样书眉仍显示被它打断的那一章； - 覆盖标题的字体排印（包括字距）、分页和跨度、**本级标题后回到网格**和**隐藏（结构性）**，并选择**标题后的首字下沉**：*同所属级别*、*自定*（字段与段落样式的相同）或*无*； - 为这一部分设置自己的书眉，可以从文档的书眉出发修改； - 设置其页边距和栏式（包括侧栏的作用和位置，与*栏*中相同，以及它自己的*缩小放不下的图*）； - 设置正文样式、列表覆盖设置和调色板颜色。 - *目录*（`toc`）：`:::toc`列出的标题级别，以及每一级条目的字体排印。它还涵盖不编号的条目、页码、引导点、从标题属性读取的副标题行，以及带有自己版面设计槽位的篇的行。其中的**分组**一组设置让目录的每一组与其条目排在一起（`toc.groups`）：**每组与其条目排在一起**、**组首**（部分行或某一级标题）、比一栏还高的组被拆开时的**与组首同栏的条目数**，以及**在组的延续处重复组首**和它的**续接标记**。修改后预览会立即重排目录。 - **列表** - *项目符号列表*，带**顶部对齐网格**（`unorderedLists.snapTopToGrid`），它把列表上方的空白向上取整，使第一项落在基线网格上。 - *编号列表*：每一级编号后分隔符的字体、字重、斜体、颜色和间隙；**顶部对齐网格**（`orderedLists.snapTopToGrid`），与项目符号列表相同；以及**编号栏**（`orderedLists.numberWidth`）：列表项文字从哪里开始，按它所在的一组列表中最宽的编号（*按组*），或按本章中同一级最宽的编号（*按级*），或按该项自己的编号（*按列表项*），这时每项文字与自己的编号只隔设定的间距。**编号对齐**（`orderedLists.numberAlign`）决定编号靠正文一侧、末端对齐（*靠正文*），还是靠编号栏起始一侧、起点对齐（*靠列首*）。 - **图与表** - *编号与位置*（`resourceTypes`）：对每种资源类型设置： - 名称和简称； - 带`{n}`和`{h1}`…`{h6}`占位符的编号模板、计数格式和重置级别，以及题注前缀，并带有“Fig. 1.7”式的实时预览； - **位置**组：该类型的默认位置、跨度（栏、页或侧栏）、**跨栏数**（该类型的单栏浮动对象在多栏页面上横跨的相邻栏数；等于页面的栏数时即为通页）和旋转、宽度比例、比所在位置窄的资源的对齐方式（因宽度而变窄的浮动体和嵌入，以及比栏窄的图片），以及题注在图旁的开关； - 可折叠的**题注样式覆盖**，只替换你为该类型设置的题注字段（位置、底色条、颜色、字体），其余继承。 - *题注*（`captionStyle`）：字体、字号、对齐方式，以及位于资源上方还是下方的**位置**。可以加一条**底色条**，带颜色和内边距；标签和说明的样式分别设置。**注释**组设置资源注释的字号、颜色、倾斜、对齐方式和间隙。 - *表格*（`tableStyle`）： - 表体和表头的字体排印，包括表头的**字距**（`headerLetterSpacing`）和**大小写**（`headerTextTransform`），以及填充色； - 边框，带一种**线条**模式：全网格、仅横线、外框、无，或**三线表（booktabs）**（表格上下各一条粗线，表头下一条细线，跨栏表头下两端缩短的短线）。选择三线表时显示各条线的宽度、跨栏表头下的线及其缩进、**分组线**，以及*超过页高的表*下延续到下一页的部分的收尾线，并隐藏边框宽度和圆角半径； - 外框的**圆角半径**； - 单元格内边距； - *超过页高的表*下的**表放不下时**（`overflow`）和**同样用于排在正文中的表**（`splitInline`，postext 1.25起默认开启：排在`here`、放不进本栏剩余空间的表在行与行之间切开，在下一栏接续）； - *表体单元格*下的**斑马纹行**（`bodyAlternateBackgroundEnabled`），每隔一行表体填充**交替行颜色**（`bodyAlternateBackground`），该颜色在开关打开时显示。 - *表格样式*（`tableStyles`）：命名的表格样式。你可以添加、删除和重命名id（重命名时，使用该id的表会一并更新），然后设置*表格*中的任何字段。每个控件在你设置之前显示从*表格*继承的值。 - *图示*（`diagramStyle`）：**单色**开关，把SVG图示重新着色为同一种油墨的不同浓淡，用于单色印刷；另有一个油墨颜色选择器，默认为调色板的主色；以及**在SVG文字中嵌入字体**（`inlineFonts`，默认开启），让每个SVG的文字都用书的字体排出（见[配置 › SVG文字中的字体](https://postext.dev/zh/docs/configuration-resources.md#svg文字中的字体)）。 - *视频样式*（`videoStyle`）：印在视频封面上的**播放标记**（形状、位置、大小、离边距离、颜色和背景不透明度）和**二维码**（位置、大小、离边距离、纠错级别、留白、颜色和圆角半径）；**输出**：封面是否链接到视频，以及HTML查看器显示播放器还是封面；还有每个视频起始所用的**播放器**开关。其中的**与其他视频同时播放**：开启时，播放一个视频文件不会停下其他视频，一页上的无声循环片段可以一起播放；关闭时，播放它会暂停其他视频。它在HTML查看器和Folio中生效。 - **标注框** - *标注框样式*（`calloutStyles`）：供`:::callout{type="…"}`使用的命名样式。你可以添加、复制、删除和重命名id，然后设置： - 默认标题、跨度、位置和宽度，以及**跨栏数**：在多栏页面上，浮动的标注框（位置为*自动*、*顶部*或*底部*，跨度为栏）横跨的相邻栏数。`:::callout`的`columns`属性可以覆盖它； - 背景、边框、圆角半径和内边距，以及一条边缘**色条**； - **图标**：可以是一个文字字符，也可以是从资源面板中选取的SVG/位图。它可以放在行内，也可以作为角标，并可设置所在的角以及非正方形图案的宽度。 - **标签页**组（`calloutStyles[].label`）：字体、字号、字重、颜色、填充色、圆角、高度、内边距、偏移和内缩，标签页旁的图标资源，以及沿顶边的一条线； - 标题的字体排印，包括字距、缩进和**标题行距**（`titleStyle.lineHeight`）； - 继承文档正文的正文和列表覆盖设置。其中包括正文的粗体和**斜体颜色**、常规和粗体字重、**斜体**和**小型大写字母**开关、**制表位**和**默认制表位间隔**（`body.tabStops`、`body.tabInterval`），以及项目符号的大小和字重。 - 框内`:::columns`组的栏间距； - **对齐网格**开关（`calloutStyles[].snapToGrid`，默认打开；关闭时，叠放的标注框保留精确的下外边距）； - 标记栏、固定锚点、不拆分和拆分最少行数，以及浮动体屏障控件； - **栏末的侧边框**选项（`sideAtColumnEnd`），用于其后文字不在同一栏继续的侧边框：放在围栏之前的文字旁边，或放在围栏之后的文字旁边； - **拆分的标注框**组：在每个续接部分重复标题并加后缀（`repeatTitle`、`continuedSuffix`），以及在每个未完部分下方加一个续接标记，带文字、对齐方式和斜体（`continuesMarkerEnabled`、`continuesMarker`、`continuesMarkerAlign`、`continuesMarkerItalic`）。这些文字默认使用文档语言。 - **页眉与页脚** - *页眉与页脚*：每个槽位中的文字、线条、框和图像元素。 - **文字元素**：垂直对齐，在自身框内的**文字对齐**（`align`：齐左、居中或齐右，在框比文字宽时可以看出；或者两端对齐，把每段除最后一行外各行的空格拉开以填满框，打开**断词**时还会在音节处拆开单词来填满一行）、行距、字距（负值用于收紧展示性标题）、大小写、自适应、填充或固定的宽度和高度，以及最大宽度。**行内标记**（`inlineMarks`）在元素文字中排出`**bold**`、`*italic*`等行内标记；轮廓用来描出字母的外形：**轮廓粗细**、**轮廓颜色**和**空心字**（`stroke`）。 - **线条**：水平或垂直。 - **占位符**，从引擎的允许列表中选取：页码、总页数、全书总页数、标题、副标题、作者、出版日期、章标题和章号、篇标题和篇号，以及表示章属性的`{attr.key}`。页眉和页脚还可以使用页面顶部的章标题和章号`{chapterTitleAtTop}` / `{chapterNumberAtTop}`（见[页面顶部的章](https://postext.dev/zh/docs/configuration-headers-footers.md#页面顶部所属的章)），以及导词`{firstMark.h2}` / `{lastMark.h2}`（点号后面是标题级别或段落样式id；见[导词](https://postext.dev/zh/docs/configuration-headers-footers.md#检索词首标记与尾标记)）。 - **槽位在哪里出现**：奇偶页，以及**页面**过滤：全部、正文页、章首页、篇分隔页或空白页。 - **位置**：溢出方式，以及锚定到容器、某个同级元素，或者锚定到**页面** / **出血**边框以做出通到页边的色带；页眉和页脚元素还可以锚定到**外侧页边距**（`'outer'`），即远离书脊的那一侧页边距。 - 文字元素的**书写方向**：*横排*，或*竖排，行从右到左*（`writingMode`），用于竖排书中沿切口排列的书眉。页眉编辑器中的**切口书眉（竖排）**会添加两个竖排元素：章标题在版心上端往下四个字处，页码在版心下端往上五个字处，都用正文字号的80 %，锚定到外侧页边距（见[竖排文字元素](https://postext.dev/zh/docs/configuration-headers-footers.md#竖排文本元素)）。 - **首字下沉**组（行数、字体、字重、字号、颜色和间隙）以及段落缩进。带首字下沉的文字无论**溢出**如何设置都会换行；不设字号时，下沉字母的顶端与第一行大写字母的顶端齐平。 - 其他每个版面设计槽位都提供同样的文字控件。 - **篇** - *篇*（`parts`）： - **篇名页**（`parts.page`）：关闭后不另起一页，篇的编号、标题和颜色直接从下一段内容开始生效。它也会隐藏下面的设置。 - `:::part`开始的那一页的奇偶，以及篇之后可选的分页及其奇偶； - 篇名页的页边距。它们继承页面页边距，并使用同样的对称内侧/外侧标签。 - 一个依照页面成品框排版的**篇首版面设计**槽位。它的占位符选择器增加了标题一组：当前标题，以及以阿拉伯数字、罗马数字或字母形式表示的编号。 - 篇内各块的**正文样式**。它继承正文和列表颜色，并包括列表覆盖设置（编号格式和偏移、外边距、悬挂缩进，以及任务列表的字段）。 - **导出** - *印前准备*（`print`和`page.cutLines`），分为四组： - **裁切标记与出血**：裁切线、出血，标记的长度、偏移和粗细，以及它们在屏幕上的颜色。 - **PDF/X与颜色**：**PDF标准**（*无（普通PDF）*、*PDF/X-1a:2003*、*PDF/X-4*）；**输出特性文件**，从十五个免费特性文件中选择（默认FOGRA39，PSO v3条件用FOGRA51和FOGRA52，另有GRACoL、SWOP和新闻纸）；**上传ICC特性文件**，用于印厂给你的特性文件，带有它的**印刷条件**（PDF/X输出意图所写的注册名称）和一个移除它的按钮；**渲染意图**、**黑场补偿**、**图片转换为CMYK**（PDF/X-1a总是转换，所以此时隐藏）和**总墨量上限（%）**。 - **黑色**：**灰色和黑色只用K**、**100%黑叠印**、**大面积用复合黑**，以及复合黑的C/M/Y/K配方和区域从多大起改用复合黑。 - **印前检查**：**在检查中进行印前检查**，最低和严重的图像分辨率，最细线宽，多色文字被标出的字号阈值，安全区，方框应出血的距离，以及**检查置入PDF的字体**。 见[配置 › 印刷输出](https://postext.dev/zh/docs/configuration-fonts-colors-viewers.md#印刷输出配置)。 - *PDF*：书签、无障碍（带标签的）PDF和强制色彩空间。CMYK用*印前准备*中的特性文件分色。 - *网页阅读器（HTML）*：`htmlViewer`设置。 - **Folio** - *书页视图（3D）*（`folio`），分为五组：**视角**（倾斜角和转角）、**纸张**（纸种、克重、松厚度及由此得出的纸厚、表面处理、纹理及其强度、纸色、透印）、**装订**（装订方式、封面、封面材料和颜色、书脊图片；*折叠（报纸）*方式把对折一次的纸张一张套一张叠起来，不加任何固定，就像报纸；它和*骑马钉*一样没有可以印字的书脊，所以书脊图片隐藏）、**台面**（桌面材质及其色调）和**光照**（环境光、曝光、阴影）。换一种纸种时，你没有改过的字段会填入该纸种的数值，改过的字段保留你的值。采用报纸开本时，你没有选过的纸种和装订方式显示为*新闻纸*和*折叠（报纸）*。书脊图片从资源面板的位图和SVG中选择。见[书页标签页](https://postext.dev/zh/docs/sandbox-previews.md#书页标签页)。 - **高级** - *屏幕辅助*（`debug`）：**基线网格**（`page.baselineGrid`）放在这里，而不在*页面*之下，此外还有其他检查版面用的叠加显示。 - *警告*：检查面板报告哪些问题，以及它们的阈值。 - *配置中的正文*（`checks.contentInConfig`）：**提示设计中存放的正文**、占位符之外的**允许的词数**和**允许的字数**，以及每行一个的**允许的短语**。修改它们不会重新排任何一页。见[正文检查](https://postext.dev/zh/docs/configuration-fonts-colors-viewers.md#正文检查配置)。 **查找设置**。标题栏下方的工具栏对所有组都有效： - **搜索设置…**按标签、帮助文字和选项名称过滤所有分区中的所有字段。它忽略重音符号，并匹配词首：*marg*能找到*上页边距*和*Margen superior*，*h3*会打开*标题 › H3*。结果按设置组分组。匹配的分区自动展开，不匹配的行和分区被隐藏，命中的文字会高亮。按Escape先清除搜索，再离开输入框。 - **已更改**只显示值与默认值不同的字段。 **帮助文字**。每个字段都有一段简短的说明。屏幕阅读器把它读作字段的描述；在屏幕上它默认隐藏，用该行的**?**按钮（*“…”是什么？*）打开。标题栏中的**显示全部说明**开关一次打开所有说明，这一选择会被记住。 **已更改的值**。面板遵循一致的**覆盖模型**： - 分区标题带一个徽标，显示其中已更改字段的数量，嵌套的组也计算在内。 - 分区标题只在包含更改时才显示重置按钮（需要确认）。 - 已更改的字段在标签旁有一个圆点（读作*已更改*），并有自己的小重置按钮。 - 保存或导出的永远只是更改过的子树。默认值会被剔除，所以原始状态的沙盒保存的是一份空配置。 - 重置*页面*不影响基线网格，因为网格在*高级*中编辑。 **控件：** - 选项用下拉菜单表示，每个选项可以带一行说明；选项很少时用分段按钮。 - 开/关设置用开关表示。 - 数字带 − / + 步进按钮。方向键逐级调整数值，按住Shift时步长为十倍，按住Alt时为十分之一。 - 长度带单位选择器，切换单位时会换算数值（cm、mm、in、pt、px、em、rem）。 - 颜色是一个按钮，显示色块和数值。 - 字体选择器可以用方向键浏览。 控件会根据上下文变化。栏间距只在多栏版式中出现；两端对齐设置只在文字两端对齐时出现（齐左文字改为显示**齐左文字断词**；段落样式或标注框在两端对齐或打开了齐左断词时显示它的断词开关）；侧栏百分比只在一栏半版式中出现。修改会立即反映在视口预览中。每个配置选项及其默认值的完整参考，见[配置](https://postext.dev/zh/docs/configuration.md)页面。 面板标题栏还提供**重置**（需要确认；只在版面设计与当前示例书的版面设计不同时显示，它恢复该示例书的版面设计，包括字体）、**导出**和**导入**。见[导出与导入](https://postext.dev/zh/docs/sandbox-books-saving.md#导出与导入)。 ## 检查面板 实时诊断，根据正文、版面设计、图和上一次构建重新计算。计数与活动栏按钮上的徽标一致。警告按类别分组，按处理的轻重缓急排序：先是会破坏输出的问题，然后是标记问题，最后是通常条目众多的细微排版问题。每组都可以折叠，并显示其数量： - **字体**：缺少字族，自定义字族中缺少或重复的字重/样式文件，以及*字族中的字体栈*：`fontFamily`设置中写了一个CSS字体栈（文字用其中第一个字族排出；条目写明该设置的路径） - **图与表**：`::resource` / `:ref`中未知的资源id（也包括正文所用的图的题注、注释或单元格中的，以及作为表格单元格图像的）、重复的资源id、引用了不存在的资源类型、位图渲染尺寸明显大于其像素尺寸、表格的样式id不对应任何表格样式、表格网格不规整（合并单元格所覆盖的单元格缺失，或某一行有空洞：在表格编辑器中重新合并这些单元格）、文件在存储中缺失或无法解码的图像（显示为占位图），文字指定的字体族没有可嵌入字体文件的SVG（*SVG中缺少字体*：图片用后备字体排这段文字），或字体超出2 MB上限的SVG（*SVG字体过大，无法嵌入*），以及没有封面的视频、没有正式发布地址的视频文件（印刷版没有二维码和链接）和不指向任何视频的YouTube或Vimeo地址，以及为放进所在页的空间而缩小的浮动图片（*图片已缩小以放下*：条目给出比例；即使按最小比例仍超出版心时，还给出超出的毫米数），以及未能按要求让正文绕排的图片或框（*绕排的图片或框*：旁边行宽太窄、太矮排不下旁边的行、已移到下一栏，或在竖排中） - **文字与标记**： - 标题层级跳跃（例如H1 → H3），以及中间没有正文的连续标题； - 无效或未闭合的`$…$` / `$$…$$`公式； - 未知的指令名称（解析器认识的名称都接受：`pagebreak`、`columnbreak`、`space`、`numbering`、`toc`、`callout`、`paragraphs`、`part`和`columns`）、无效的编号或奇偶属性，以及超出0–20行范围的`:::space{lines=N}`； - 到文档末尾仍未闭合的`:::`容器围栏（点击它会让编辑器聚焦到开头那一行）； - 样式未配置的`:::paragraphs{style="…"}`、`:::callout{type="…"}`、`:chip[…]{style="…"}`或标题`{style="…"}`； - 被当作文字印出的`::resource`行——格式错误，或紧贴在段落下方、中间没有空行； - *全角标记*：用中文或日文输入法输入的标记（`：：：`、`＃`、`［＾…］`、`｛…｝`、`＊＊…＊＊`），会被当作文字印出；条目会给出应输入的ASCII形式； - *属性键未被读取*：用非ASCII字符写的属性键（`作者=曹雪芹`），解析器会忽略它； - *代码围栏未闭合*：一个```` ``` ````或`~~~`围栏没有结束围栏，其后的全部文字都按代码排版（`unclosedCodeBlock`；点击它会让编辑器聚焦到该围栏）； - *竖排文字中的制表符*：竖排文字中的`:tab`，它排成词间空格，因为制表位只用于横排文字（`tabInVerticalText`）； - *前置元数据被忽略*：除第一章外，某一章以前置元数据块开头（只有第一章的前置元数据属于整本书）； - *未知的分栏走向*：`:::columns{flow=…}`既不是`snake`也不是`parallel`，该组采用默认值（`columnsFlowUnknown`）； - *未知的页面模板*、*槽位没有对应的框*、*空框*和*模板页只写了三个冒号*：模板不在`pageTemplates`中的`::::page`，指定的名称不是该页模板中任何框的`slot`，在这一页上什么也没收到的模板框（`optional`框不报告），以及带有`template=`却只写了三个冒号的`:::page`（`templateUnknown`、`slotUnknown`、`slotEmpty`、`pageFenceLength`；见[模板页](https://postext.dev/zh/docs/composed-pages.md#警告)）。 - **版面设计**： - 不在引擎允许列表中的页眉和页脚占位符名称（`{attr.…}`和篇的占位符是允许的），以及所需文档元数据缺失的占位符； - 版面设计元素之间的循环锚定，或锚定到不存在的元素。这一检查和占位符检查覆盖每个版面设计槽位：书眉、篇首页、篇名页之后的空白左页、目录中篇的行、每一级标题的版面设计，以及每种标题样式的版面设计和其所在部分的书眉。来自标题样式的条目会写出样式名，如`{style="index"} header · #rh → #missing`；来自空白左页或目录中篇的行的条目会写出其设置，如`toc.parts.design · #row → #missing`； - 裁剪溢出方式总会截断的文字元素； - *版式文字被截断*：放不进自身宽度、以省略号结尾，或墨迹超出框而被裁掉的版式文字（`designTextTruncated`）。条目写明所在位置和元素，并给出完整文字；点击会打开被截断的那一页，如果是章标题或前置元数据中的字段，还会在编辑器中选中它。一章每页都被截断的书眉只列一次； - *标题版面设计被截断*：标题的版面设计高出页面所能容纳的高度——章首页的文字排到了页面底边以外，或栏内版面设计的文字排到了栏底以外（例如小屏幕页面上的一段较长导语）。标题会占用所在页或栏的剩余部分，因此其后的正文从下一页或下一栏开始，但版面设计超出的那部分会丢失；点击条目会聚焦到该标题； - *侧栏超出范围*：一栏半版式的侧栏被引擎限制了宽度，以给主栏留出空间； - *栏数超出范围*：`multiple`版式的栏数不是3到8之间的整数，被引擎限定； - *未知的编号格式*：列表、页码或资源类型使用了引擎不认识的编号格式，此时以阿拉伯数字编号； - *未知设置*：标题、某一级标题、某种标题样式或某个制表位中没有的键（例如拼错的`letterSpacng`），引擎会忽略它；有相近的设置时，条目会给出建议。 - *竖排文字不标行号*：在竖排文档中打开了行号，而竖排文档不标行号。 最后这四项与*字族中的字体栈*一样，来自配置而不是正文：条目写出设置的路径，点击它不会移动编辑器。 - **对比度**： - *对比度不足*：某种文字颜色与它所在的底色相比，低于它的字号和字重在本书等级（`contrast.level`）下要求的对比度。条目引出这段文字，给出两种颜色、字号，以及屏幕上的对比度，为印刷设置的书还给出在其输出特性文件的纸张上的对比度。一对颜色只列一次，并注明这样排的有多少处； - *反白字过细，不宜印刷*：为印刷设置的书中，有墨底色上的浅色文字小于**颜色→对比度→反白字**所设的字号。 每个条目写明首次出现的页；点击它会打开那一页，并在编辑器中选中这段文字。 - **排版**： - 松散行（词间距被拉开，超过所配置的阈值）； - *两端对齐的行未撑满*：两端对齐段落里的一行没有撑满，因为撑满行长会把词间空格拉到正常宽度的3倍以上；条目引出这一行并给出本来需要的倍数，点击即选中该行； - *CJK行排不满*：一行中文、日文或韩文没有排满行长，因为排满会使字符间的扩展超过上限； - *标记挤到下一行*和*注音挤到下一行*：着重号、专名号和书名号线，或者注音，需要比段落现有的更大的行间空隙；条目会以em为单位给出这两个数值； - 溢出所在栏的标注框； - *行内标签碰到相邻行*：某个行内标签的框碰到了上一行或下一行的行内标签（以pt为单位给出重叠量）；上下都没有行内标签的高标签不会被标出； - 奇偶连锁； - *行号压在侧栏框上*：侧栏中的行号（`lineNumbers.position: 'side'`）落在该栏的框、图注或插图上；两者都照原位印出； - *首字下沉未按设置排出*：段落的行数少于首字下沉的行数（条目说明是保留了空间、缩小了首字还是去掉了首字），段落在过短的栏中于首字最后一行之前断开，段落的第一个字母与下一个字母相连（阿拉伯文），段落位于竖排文字中，或段落不以字母开头（`dropCap`）； - *代码行宽于其框*：代码清单中有比框更宽的行，按**代码→过长的行**的设置折行、缩小（条目给出所用字号）或截断（`codeOverflow`）； - *分栏过窄*：`:::columns`组的栏窄于其文字的6 em（`columnsTooNarrow`）； - *框内放不下文字*：模板页某个框的内容超出框底，而这个框没有可以接续的`next`框，分页输出会裁掉多出的部分；条目给出框名、所属模板、页码和被裁掉的高度（mm）（`frameOverflow`；见[模板页](https://postext.dev/zh/docs/composed-pages.md#frameoverflow)）； - *侧栏框或侧栏图排在正文结束之后*：侧栏框或侧栏中的图排在没有正文的页面上，因为所在章的正文结束时它还在等侧栏的空位；条目给出页码（`afterText`）； - *未排入任何页面*：排版结束时仍在等空位的框或浮动体，不在任何页面上（`unplaced`）； - *短列表跨栏拆分*：只有几项的列表排在了两栏或两页中；**正文→短列表跨栏拆分**设为*警告*时列出，设为*避免*时只列出没有哪一栏放得下整个列表的情况（`shortListSplit`）； - *目录分组跨栏拆分*：设为排在一起的目录分组占了两栏或更多栏，原因是它比一栏还高，或它所在的栏太短；点击该行会打开目录所在页并选中`:::toc`这一行（`tocGroupSplit`）； - *章首页上有浮动体*：图、表或浮动标注框排在一章或一篇的首页上；**分栏→章首页上的浮动体**设为*警告*时列出（`openerFloat`）； - *该语言没有断词模式*：文档语言（其断词语言，否则为`locale`）没有随附的断词模式，因此文字按美式英语的模式断词。关闭断词后这条警告会消失。 - **印前检查**，仅在书设为付印时出现（设了PDF/X标准、CMYK PDF或裁切标记），严重问题排在前面： - *图像分辨率过低*：图片在印刷尺寸下低于最低分辨率（低于严重阈值时为严重），按文件实有的像素计算； - *声明的像素与文件不符*：位图声明的宽度和高度与文件的不一致（声明的更多时为警告）； - *RGB图片*：导出时分色为CMYK，或者在不转换图片的PDF/X-4中保留为RGB； - *线条过细*、*多色小字*、*总墨量超出上限*（以CMYK定义的颜色、复合黑配方）； - *文字进入安全区*和*止于裁切线内侧附近*（应当出血的方框或图片）； - *置入PDF中有未嵌入的字体*、*置入PDF中含RGB*和*置入PDF中含透明*（在PDF/X-1a中为严重），来自每张图的印刷母版。 每个条目都写明所在页；点击它会在查看器中打开那一页。 - **浏览器**：存储不可用（缺少IndexedDB） 每个条目显示一个图标、一个标题、一行详情，适用时还显示所在的章和源码行（多章的书中显示为*第2章 · 第12行*）。点击带有源码位置的条目，会切换到那一章，并让编辑器聚焦到该处。没有问题时，面板显示**没有问题**。哪些检查会运行，在**版面设计 → 高级 → 警告**中设置。