配置：标题

#标题

headings属性控制所有标题级别（H1–H6）的排版。你可以先设定适用于所有级别的通用默认值，再按级别覆盖其中的个别属性。

#通用默认值

诗歌或剧本各幕用的居中标题，不需要设计槽位：

headings: {
  textAlign: 'center',
  levels: [{ level: 2, textTransform: 'uppercase' }],
}

传入headings对象时，你没有重新声明的级别默认值都会保留，包括H1的分页（见按级别覆盖）。

#按级别覆盖

每个标题级别都可以通过levels数组覆盖通用默认值。默认情况下，各级别只有fontSize不同（另外还有下文说明的H1的breakBefore），其他属性都继承通用标题设置。

H1的默认值模拟图书的分章版面：每个一级标题都在新的右页（奇数页）开始，与前一章之间必有一个空白分隔页。如果你的文档层次比图书简单，可在levels[0].breakBefore上覆盖它。

级别的breakBefore按字段逐个合并到这个默认值之上，没有提到它的headings对象会保留默认值。H1上的{ parity: 'odd' }保留分页，只改变奇偶；{ enabled: false }让各章接排：

headings: {
  fontFamily: 'Merriweather',                               // H1仍然分页到新的右页（always-odd）
  levels: [{ level: 1, breakBefore: { parity: 'odd' } }],    // ……或者：右页开始，不强制空白页
}
 
headings: { levels: [{ level: 1, breakBefore: { enabled: false } }] } // 各章接排

postext 1.5起的变化。 postext 1.4及以前，任何headings对象都会关闭H1的分页，除非重新声明levels[0].breakBefore；不完整的breakBefore会用不分页的默认值补齐缺少的字段。因此，一份为1.4用代码写成、带有headings对象但没有H1分页的配置，现在会让每一章都从新的右页开始，必要时加入空白左页。要让各章继续接排，在levels的H1条目中加一个字段：

headings: { fontFamily: 'Merriweather', levels: [{ level: 1, breakBefore: { enabled: false } }] } // 与1.4的排法相同

如果配置是存储下来的，引擎能识别出来并替你处理：沙盒处理它当时保存的书和配置（见沙盒 → 持久化），openBundle / readBundle处理postext 1.4或更早版本写出的.postext文件包（见postext 1.4及更早版本写出的文件包）。你自己存储的配置可以交给postext/bundle中的migrateConfig(config)处理，它会写出1.4当时的分页方式（pinLegacyHeadingBreaks）：在没有分页的H1上写enabled: false，在H1和标题样式中未指定奇偶的enabled: true旁写parity: 'any'。它还会按1.4的设定固定以下各项：数学公式的字号、行内图周围的间距（框内也一样）、标题的行内标记、首字下沉的尺寸、引出列表的冒号行下方的空间、框截断后段落或列表项留下的行数、破折号处的断行、齐左文字的逐行断行、标题下段落的拆分、复合词连字符处的断行，以及:::paragraphs容器下方的间距。把书的Markdown作为第三个参数{ content }传入时，它会省去用不到的固定项：文本中没有$时省去数学固定项；没有一行嵌入资源时省去间距固定项（框内没有时省去框内间距固定项）；没有标题带标记时省去标题标记固定项；没有列表跟在以冒号结尾的行之后时省去冒号行固定项；文本中没有:::callout时省去框截断固定项；词与词之间没有紧排的破折号时省去破折号固定项；文本中没有标题时省去标题拆分固定项；文本中没有:::paragraphs容器时省去容器固定项；两个字母之间没有连字符时省去复合词固定项。齐左断行固定项只加给将某些正文设为齐左的配置，容器固定项只加给声明了段落样式的配置（见postext 1.4及更早版本写出的文件包）。如果只处理分页，调用pinLegacyHeadingBreaks(config)即可。

按级别覆盖支持与通用默认值相同的属性，即fontSize、lineHeight、fontFamily、color、fontWeight、marginTop、marginBottom、snapToGrid，另外还有以下仅限级别的字段（标题样式也可以使用它们）：

headings: {
  fontFamily: 'Merriweather',
  levels: [
    // 标准图书预设：各章从右页（奇数页）开始。
    { level: 1, fontSize: { value: 24, unit: 'pt' }, breakBefore: { enabled: true, parity: 'odd' } },
    { level: 2, fontSize: { value: 18, unit: 'pt' }, italic: true },
  ]
}

snapToGrid也可以按级别设置。未设置时，级别沿用headings.snapToGrid；设置后则覆盖它。这样同一份文档可以让H2与其正文之间隔一行半、在下一个对齐点之前偏离网格，同时让H3下方的空间向上取整为整数个网格行。标题样式也可以设置它，作用于使用该样式的标题。

headings: {
  marginBottom: { value: 1.5, unit: 'em' },
  levels: [
    { level: 2, snapToGrid: false }, // 每个H2下方正好1.5 em
    { level: 3 },                    // 继承headings.snapToGrid: true
  ],
}

#前置分页

breakBefore与编号控制相互独立：开启它会强制分页，但数字计数只在你明确插入:::numbering指令时才重置。为满足奇偶而加的空白页在页序中算作真实的页，并按正常的奇偶页规则显示页眉和页脚。

紧挨在这种标题前的:::pagebreak不会取代标题自己的分页：标题仍会在该指令所开的页之后执行奇偶约束，可能因此多出一个空白页。标题需要紧接在手动分页之后开始时，见标题样式。

奇偶取值

空白页的归属

breakBefore插入的空白页所带的章标题书眉，取决于它们为什么被插入：

• 为满足奇偶约束而插入的页（'odd'、'even'，或'always-*'中的奇偶部分）属于后面的一章。它们书眉中的{chapterTitle}占位符解析为新一章的标题，因为这个空白页只是为了把新的一章推到正确的奇偶页上。
• 'always-odd' / 'always-even'插入的强制前导分隔页属于前面的一章。它是章末有意留出的停顿，所以{chapterTitle}书眉仍显示上一章的标题。

带样式章节的书眉和调色板（见标题样式）在空白页上也遵循这两条规则。

文档开头的例外

当文档的第一个块是启用了breakBefore的标题，或源文件以:::pagebreak开头时，只要第一页仍为空，就不执行奇偶约束。标题照原样落在第1页，与所配置的奇偶无关，因此以# Chapter 1开头、配置为parity: 'odd'的文档不会多出一个多余的前导空白页。一旦放入了任何内容，奇偶约束就照常执行。

#通栏与高级设计

每个标题级别还接受两个字段，用于控制标题作为横跨整页的章首页时如何渲染。

与页面一样高的章首。 当保留高度超出栏底时（如minHeight等于页高的封面，或锚定在页面或出血框、一直延伸到裁切边的图片或框），章首占据本页余下部分：其后的文字从下一页开始，双栏和一栏半版式的每一栏都一样。所以封面之后不需要:::pagebreak（加了也无妨，不会多出空白页）。设计高于所在栏的栏内标题（span: 'column'）占据该栏，文字从下一栏栏首开始。标题的块随后一直延伸到它所占栏的栏底，设计按这个区段排布：锚定在顶部的元素留在锚定处，跟随区段的元素（锚定在区段中部或底部，或高度为'fill'）限制在标题占据的空间内，就像保留高度放得下时它们限制在保留高度内一样（postext 1.4及以前，块保持其文字的高度，所以这些元素是按只有一个标题高的区段排布的，其后的文字会接在设计下面继续排）。不应占据整页的版面装饰（贯穿整页的切口色条、页脚处的装饰）应放到页眉或页脚设计中：锚定到'page'或'bleed'，并以pages: 'opener'显示，它就只绘制在章首页上，不占用正文空间。

示例：一个简约的章首，在标题上方显示“Chapter N”：

{
  "headings": {
    "levels": [
      {
        "level": 1,
        "span": "page",
        "breakBefore": { "enabled": true, "parity": "always-odd" },
        "advancedDesign": {
          "enabled": true,
          "slot": {
            "elements": [
              {
                "kind": "text",
                "id": "chapterLabel",
                "placement": {
                  "anchor": { "to": "container", "edge": "top" },
                  "offset": { "y": { "value": 48, "unit": "pt" } },
                  "size": { "width": "fill" }
                },
                "content": "Chapter {numberRoman}",
                "fontSize": { "value": 10, "unit": "pt" },
                "align": "center",
                "overflow": "ellipsis-end"
              },
              {
                "kind": "text",
                "id": "chapterTitle",
                "placement": {
                  "anchor": { "to": "#chapterLabel", "edge": "below" },
                  "offset": { "y": { "value": 12, "unit": "pt" } },
                  "size": { "width": "fill" }
                },
                "content": "{titleText}",
                "fontSize": { "value": 24, "unit": "pt" },
                "fontWeight": 700,
                "align": "center",
                "overflow": "wrap",
                "hyphenate": true
              }
            ]
          }
        }
      }
    ]
  }
}

级别设计槽位中可用的标题占位符：

• {titleText}：标题的纯文本（不含编号前缀）。标题中的强制换行（\\）在这里是换行，章首区段和栏内设计都一样（postext 1.4及以前，栏内设计在那里输出一个空格，而高度却是按换行测量的）。隐藏标题在栏内折成的各行会按原写法重新连成标题：在自身连字符后断开的词保留连字符，后面不加空格；被栏宽断开的词重新连成整词，去掉断行时加上的连字符；由不换行空格连在一起、比栏还宽而在该空格处断开的词组，恢复其不换行空格（Capítulo XVIII，而不是CapítuloXVIII）；其他每个断行处都还原为一个空格。postext 1.4及以前，每个换行都变成空格，所以在连字符处折行的标题会输出Word- Book，这类标题中的强制换行也会被丢掉。
• {number}：按该级别numberingTemplate格式化的编号。
• {numberDecimal}、{numberRoman}、{numberRomanLower}、{numberAlpha}、{numberAlphaLower}：以其他数字格式表示的标题计数（该级别的当前计数，不管模板输出什么）：第三章给出3、III、iii、C、c，有没有numberingTemplate都一样。不编号的标题（样式设为numbered: false）让它们为空。
• {numberWords}、{numberWordsLower}、{numberOrdinalWords}、{numberOrdinalWordsLower}：用文字拼写的同一计数，首字母大写或全小写：Three / three、Third / third（见以文字书写的编号）。
• {numberHan}：用中文数字书写的同一计数，字形按文档locale的书写系统：用第{numberHan}回设置的章首，在第十二章输出第十二回，而目录列出的是12。
• {chapterNumber}、{chapterTitle}、{pageNumber}、{totalPages}、{bookTotalPages}、{title}、{subtitle}、{author}、{publishDate}：通用的元数据占位符。
• {attr.<key>}：写在标题行上的属性（# Title {author="I. Zango Martín"}），缺省时取当前章H1的同名属性。缺少的属性解析为空字符串，不给出警告。

{chapterNumber}输出的是书眉为该章输出的内容：H1的级别（或样式）有numberingTemplate时输出H1的编号，否则输出章的序号（1、2……接着本章之前已排的各章继续计数）；不编号的章或模板为''的样式则什么也不输出。标题设计读取其标题所属的章：一级标题读取自己，更低级别的标题读取它之前的最后一个一级标题。两章在同一页相遇时也是如此，而该页的书眉输出的是后一章。章首保留的高度也按同一个值测量。postext 1.4及以前，高度按标题的编号前缀测量（没有模板时为空），所以高度取决于{chapterNumber}的设计可能绘制得比所占空间更高；而且设计输出的是该页的章，所以共用一页的两章中，前一章显示的是后一章的编号。

计数占位符在逐章排版时跟随全书（即continuationAfter()传递下去的计数），标题的startAt属性会让它们重新开始（见文档格式 → 标题属性）。一个章首显示Chapter III，而文字流和目录中的标题编号为3.：

{
  level: 1,
  span: 'page',
  numberingTemplate: '{1}.',
  advancedDesign: {
    enabled: true,
    slot: { elements: [
      { kind: 'text', id: 'label', content: 'Chapter {numberRoman}', fontSize: { value: 10, unit: 'pt' }, overflow: 'ellipsis-end',
        placement: { anchor: { to: 'container', edge: 'top-left' }, size: { width: 'fill', height: 'auto' } } },
      { kind: 'text', id: 'title', content: '{titleText}', fontSize: { value: 24, unit: 'pt' }, overflow: 'wrap',
        placement: { anchor: { to: '#label', edge: 'below' }, size: { width: 'fill', height: 'auto' } } },
    ] },
  },
}

保留高度

带高级设计的标题像其他块一样在栏内占用空间：其后的正文从这段空间下方开始。这段空间取以下三个高度中最大的一个，都从标题顶部往下量（对于开新页的章首，从内容区顶部往下量）：

1. 标题本身的文字，按该级别的字体排版（它被设计遮住，但仍保留自己的行）；
2. 设计内容底部，即计入的元素（见下文）中最低的下边缘；
3. advancedDesign.minHeight。

其后加上标题的marginBottom（取自其标题样式、其级别或headings.marginBottom；默认0.5 em），标题对齐网格时，结果向上对齐到基线网格。对于章首（span: 'page'），页面每一栏都空出同样的区段。对于放得进所在栏的栏内标题，设计在标题的框内排布，框正好这么高。

哪些元素计入。 设计中的每个元素都计入，文字、线条、框和图片都一样（postext 1.4及以前，image元素从不计入，所以除非用minHeight挡住，文字可能从区段图片上面开始），以下情况除外：

• 设有reserve: false的元素：可以位于文字下方的装饰；
• 跟随区段本身的元素：锚定在容器中间一排（left、center、right）或底部一排（bottom-left、bottom、bottom-right）、高度为相对容器的'fill'的元素（没有设高度的框或竖线默认填满），以及锚定在这些元素上的任何元素。容器就是保留的区段，所以这些元素落在区段底部或纵贯区段：区段下方的一条线、标题后面的一块色底。它们跟随高度，从不决定高度。其中保持自身高度的文字仍需要空间：锚定在区段底部的标题会使区段至少与标题一样高，所以标题绝不会从标题块顶部之上开始。设minHeight: 36mm且标题锚定在bottom-left时，标题的框为36 mm加上其marginBottom，再向上对齐网格，标题位于该框底部，紧挨在后续文字上方；没有minHeight时，行数多于标题本身文字的标题会使区段与标题一样深。postext 1.4及以前，这样的标题会向上画到标题块上方的文字上。跟随区段的框、线条和图片不设这样的下限，所以锚定在底部的色底可以伸到标题上方。

锚定在页面和出血框上的元素，按它们伸到标题顶部以下多远来计入。横贯页面顶部、在标题上方就结束的色带不计入；越过标题的满版出血图片会把文字推到其下边缘之下。页面偏下的任何东西也是如此：距页脚25 mm的印章、整页高的侧边色带或边框，会把页面一直保留到其下边缘，文字通常就从下一页开始。把这类装饰标记为reserve: false（它仍会绘制，其他元素仍可锚定在它上面），再用文本元素或minHeight给标题留出所需的空间：

{
  "kind": "image", "id": "seal", "resourceId": "seal", "reserve": false,
  "placement": {
    "anchor": { "to": "page", "edge": "bottom-right" },
    "offset": { "x": { "value": -25, "unit": "mm" }, "y": { "value": -25, "unit": "mm" } },
    "size": { "width": { "value": 30, "unit": "mm" } }
  }
}

锚定在不保留空间的元素上的元素，除非也做了标记，仍会计入（放在印章上的说明文字需要自己的reserve: false）。

绘制位置。 章首的设计（span: 'page'）在正文之前绘制，所以不保留空间的装饰位于文字下层。栏内标题的设计与标题块一起绘制，压在栏内它上方的块之上、它之后的块之下，只要位于所在栏栏底以上，放在哪里都可以：两侧页边距、上页边距、出血区和相邻各栏都行。在Canvas和PDF中，栏底会把它裁掉，因为文字流在那里结束（见下文高于所在栏）。postext 1.4及以前，Canvas和PDF还会在栏顶裁切它，所以锚定在页面顶部或出血框顶部的色带能伸进两侧页边距，却在上页边距处截止。锚定在页面底部的装饰应放在章首中，或放在以pages: 'opener'显示的页脚设计中。

高于所在栏。 当所需空间超出栏底时（与页面一样高的minHeight、一直延伸到裁切边的图片或边框），标题占据本页余下部分（章首，在每一栏）或本栏余下部分（栏内标题），其后的文字从下一页或下一栏开始。标题的块随后延伸到栏底，绝不会缩回到其文字的高度，所以设计所依据的区段就是它占据的空间（包括minHeight，直到栏底）。比页面本身还高的设计（小屏页面上很长的导语）仍会在页面底部被裁掉（栏内设计则在其所在栏的栏底）：沙盒会在检查面板中列出它，标为Heading design cut off。排版本身不对此发出警告，因为占满整页的封面是常见情况，并不丢失任何内容；但任何宿主都可以对排好的版面做同样的检查：collectHeadingDesignCuts(doc)为每个设计文字超出页面裁切边底部（where: 'page'，章首）或所在栏栏底（where: 'column'）的标题返回一个{ kind: 'headingDesignCut', pageIndex, level, where, overflowPx, sourceStart, sourceEnd }，formatWarning可以描述每一项。另见通栏与高级设计下的与页面一样高的章首。

侧栏。 在侧栏放置浮动体的一栏半版式中（sideColumnRole: 'floats'），栏内标题的设计中位于侧栏里的元素（如教科书章首中锚定在页面外侧边栏里的章号数字）会让侧栏的浮动体堆叠避开它。该页在标题之后放置的每个span: 'side'图、表或框，都与每个这样的元素保持一个浮动体间距：放得进元素上方时就留在堆叠所放的位置，否则放到元素下方；侧栏余下部分放不下时，则等到下一页。所以，位于侧栏顶端的章号数字会让整个堆叠都在它下方；而挂在页面偏下的标题旁边、页边距中的节号，则把侧栏顶端留给该页引用的图（边栏图仍位于其所在页的顶部）。标题放置时侧栏中已有的内容不会被移动：本页较早堆叠、向下伸到标题元素处的图留在原处，位于该元素下面，所以元素在页中间位于侧栏的设计，最好在标题之后才引用它的图。设有reserve: false的元素不占用侧栏，就像它们不占用文字空间一样。章首（span: 'page'）不需要这种处理：它的区段在每一栏都保留，侧栏也包括在内。postext 1.4及以前，在这种章首上引用的侧栏图会放在侧栏顶端，压在章号数字上。

封面。 占满整页的封面标题（minHeight与页面一样高，或设计中有整页图片）因此会自行把其后的文字送到下一页，单栏和多栏版式都一样。紧接其后的:::pagebreak可有可无：在仍为空的页面上分页不起作用，所以绝不会多出空白页。只有当封面设计没有延伸到页面底部、而文字仍应从新页开始时，才需要它。

# Annual report 2026 {style="cover"}
 
:::pagebreak
 
# Letter from the chair

#以文字书写的编号

有两个编号模板后缀用文字书写计数，语言为文档语言（顶层的locale，否则用断词语言，见文档语言）：words表示基数，ordinal表示序数。后缀的大小写决定文字的大小写，就像字母编号的A / a一样：

英文、西班牙文、法文、意大利文、德文、加泰罗尼亚文、葡萄牙文、中文、日文和阿拉伯文会用文字书写；其他语言采用英文词，与内置的表格续表字符串相同。中文按locale的书写系统采用simp-chinese-informal或trad-chinese-informal的小写数字（一万 / 一萬），序数前加“第”；汉字没有大小写，所以同一后缀的三种写法输出相同。英文遵循美式用法（one hundred five，不加and）。西班牙文默认用阳性形式，与capítulo或libro的编号方式一致（capítulo primero、tercero、veintiuno），13到29的序数按RAE推荐的写法连写为一个词（decimotercero、vigesimoprimero）。基数最多拼写到999 999，西班牙文、加泰罗尼亚文和葡萄牙文序数最多到999；更大的数字以阿拉伯数字输出。

法文采用传统拼写（vingt et un、soixante et onze、quatre-vingts、deux cent un），“一”的序数写作premier（Chapitre premier，但vingt et unième）；意大利文把每个数写成一个词（ventuno、ventitré、duemilaventiquattro；primo、ventunesimo），德文也一样（einundzwanzig、hunderteins；erste、einundzwanzigste），瑞士德文（de-CH）以ss代替ß；加泰罗尼亚文遵循IEC（vint-i-u、dos-cents；primer、cinquè、vint-i-unè）；葡萄牙文默认采用巴西用法（dezesseis），locale指明其他地区时采用欧洲用法（pt-PT：dezasseis），序数用拉丁式（vigésimo primeiro）。加泰罗尼亚文和葡萄牙文的序数与西班牙文一样，最多拼写到999。

罗曼语族各语言读取性的修饰：-feminine（或-f）使数词与阴性名词一致（意大利文Parte {1:ordinal-f}输出Parte prima，法文{1:Ordinal-f} partie输出Première partie；同样有veintiuna、vint-i-una、duzentas），-masculine（-m）为默认。德文基数不变（Kapitel eins），序数则会变化：不加修饰时用冠词后的词尾，三种性相同（Das {1:ordinal} Kapitel输出Das erste Kapitel）；在不带冠词的名词前，-masculine输出Erster Teil，-feminine输出Erste Lektion，-neuter（-n）输出Erstes Kapitel。德文数词按该语言的规则小写（Kapitel {1:words}输出Kapitel eins）；{1:Words}把首字母大写，用于位于标题开头的词，{1:WORDS}把ß写作SS。

阿拉伯文数词与所计名词的性一致，因此后缀可加修饰：阴性名词用-feminine（或-f），阳性名词用-masculine（-m，默认）；-classical把百写作مائة（布拉格版和多数埃及版的写法），而不是现代的مئة。{1:ordinal}输出标题所用的带冠词主格序数词：الفصل {1:ordinal}输出الفصل الأول、الفصل الحادي عشر、الفصل الحادي والعشرون；الليلة {1:ordinal-feminine}输出الليلة الأولى、الليلة الحادية عشرة、الليلة الحادية والعشرون、الليلة المئتان，超过一百时采用古典的“在……之后”格式：الليلة الخامسة والأربعون بعد الثلاثمئة、الليلة الحادية بعد الألف。{1:words}输出基数词（واحد وعشرون；阴性为إحدى عشرة、واحدة وعشرون）。序数词拼写到9 999，基数词到99 999；修饰可以组合（{1:ordinal-f-classical}）；罗曼语族各语言和德文只读取性的修饰（见上文），其他语言忽略修饰。阿拉伯文没有大小写，因此后缀的大小写不起作用。设计占位符{numberWords}和{numberOrdinalWords}输出阳性形式；阴性的章首请把序数词放在该级的模板中，再用{number}输出。

在标题设计中，{numberWords} / {numberWordsLower}和{numberOrdinalWords} / {numberOrdinalWordsLower}以同样方式拼写标题的计数，所以章首可以写Chapter One，而目录列出1。文本元素的textTransform: 'uppercase'可给出大写：

// 西班牙文小说：标题上方为“CAPÍTULO PRIMERO”，目录中为“1.”。
{ level: 1, numberingTemplate: '{1}.', span: 'page',
  advancedDesign: { enabled: true, slot: { elements: [
    { kind: 'text', id: 'n', content: 'Capítulo {numberOrdinalWordsLower}', textTransform: 'uppercase', /* … */ },
    { kind: 'text', id: 't', content: '{titleText}', /* … */ },
  ] } } }