跳到主要内容

章 6 · 篇 II · 工艺

中文排版

Postext怎样排横排和竖排的中文:地区、断行、标点宽度、字间两端对齐、字符网格、右翻书、纵中横、着重号等标记、注音、双行夹注、中文数字和字体

更新于 2026-10-1923分钟enescadefritptzhjaar

简单来说

本页说明Postext怎样排中文。中文可以横排,也可以竖排成从右往左读的一列列文字。中国大陆、台湾和香港的标点和断行规则略有不同,Postext分别遵循各地的规则。本页还介绍竖排文字里的数字、字旁的注音、小字夹注以及该用的字体。最后给出两套完整的示例配置,并列出尚未解决的问题。

中文页面是由方形字格组成的网格,填满它的规则取决于书在哪里印刷。

Postext用同一份Markdown源文件和同一套配置,既能横排中文,也能竖排中文。同一个引擎可以把大陆小说的标点放在GB/T 15834规定的位置,把台湾版的标点放在台湾教育部手册规定的位置;按各地区的规则断行,调整每个标点内部的空白,把两端对齐的行在字与字之间撑开,在竖排中让短数字直立,并让书从右边翻开、跨页从右往左排。本页说明引擎做了什么、由哪些设置控制。配置参考列出了每个键及其默认值,文档格式介绍了相关标记。

这些规则依据W3C的《中文排版需求》(Requirements for Chinese Text Layout,clreq)及其所引用的国家标准,下文按章节号引用clreq。参考资料列在本页末尾。

一份书稿,每种文字:用 Postext 做日文、中文和阿拉伯文版本,手工做或借助 AI在 YouTube 上观看 (在新标签页中打开) · 按下播放后才会从 YouTube 加载播放器。

#字格、网格与地区

一个汉字占一个1 em宽、1 em高的方格,每个全角标点也是如此:半个字宽是字形,半个字宽是空白。密排时,字符不仅沿行对齐,也沿页面上下对齐。因此中文版心以字数和行数来规定,而不是毫米:正文字号、每行字数、每页行数、行间距,以及双栏时的栏间距(clreq §7.1.1)。字号10.5 pt、每行28字时,行宽294 pt,全书每一行两端对齐的文字都结束在同一个字格上。

横排页面的行从左到右、自上而下排列,像西文书一样在左侧装订。竖排页面的字自上而下、行从右边缘向左推进;书在右侧装订,所以第一页是左页,跨页从右往左读(clreq §7.1.1.1)。

横排与竖排的中文页面两组跨页。横排书在左侧装订:第2页在左,第3页在右,文字从左到右成行,行自上而下堆叠。竖排书在右侧装订:第2页在右,第3页在左,文字自上而下成列,列从右边缘向左推进。横排,左侧装订此開卷第一回也作书脊23下一页行从左到右竖排,右侧装订此開卷第一回也作者自云因书脊32下一页列从右开始
同一段文字,横排时在左侧装订,竖排时在右侧装订。

#先看地区,再看字形

简体字和繁体字只是写法不同。排版规则取决于印刷地:在北京印刷的繁体古籍遵循大陆标准,台湾小说遵循台湾的标准。clreq建议软件“以‘地区’而非‘繁简’区分排版规则”(§1.2),Postext从文档语言config.locale中同时读出这两项:

  • 字形(script)决定内置用词:图题用图或圖,续表题注后用(续)或(續),索引中用见或見,以及标题模板写出的数字。zh、zh-Hans、zh-CN和zh-SG是简体;zh-Hant、zh-TW、zh-HK和zh-MO是繁体。
  • 地区(region)决定cjk键的排版默认值。CN、SG和MY按大陆处理,TW是台湾,HK和MO是香港;没有地区的标签跟随其字形:zh-Hant按台湾处理,zh和zh-Hans按大陆处理。cjk.region可以覆盖它。

请写出完整的标签:zh-Hans或zh-Hant,知道地区时再加上地区(zh-Hans-CN、zh-Hant-TW、zh-Hant-HK)。同一个标签会声明在HTML(文档的lang)和PDF(/Lang)中,浏览器和PDF阅读器据此选用该地区的字形:Unicode只给“骨”一个码位,大陆字体和台湾字体的写法却不同。中文文档默认关闭断词,除非你为其中的拉丁单词打开它。

这个语言也是文字成形所用的语言。中文字体在不同语言下给出不同的字形:Noto Serif SC的数字在中文下宽0.47 em,在它没有专门字形的语言下宽0.55 em。排版在每个上下文上都按文档的语言测量,所以一本中文书在中文页面上、在显示它的英文页面上和在排版工作线程里断行都相同;Canvas按它绘制,HTML和EPUB声明它,PDF用它对应的OpenType语言系统成形(zh-Hans、zh-CN和zh-SG对应ZHS,zh-Hant和zh-TW对应ZHT,zh-HK对应ZHH);其他语言的一段文字要写明语言(:ltr[…]加lang=en),并按那种语言测量。这是bodyText.shapingLanguage: 'document',postext 1.30起的默认值。设为'host'时(1.30之前保存的书保持这个值),排版按宿主页面的语言测量,一本中文书在中文页面上是一种断行,在显示它的英文页面上或在排版工作线程里可能是另一种。

默认值大陆(zh-Hans、zh-CN)台湾(zh-Hant、zh-TW)香港(zh-HK、zh-MO)
断行(lineBreak)gbbasicbasic
标点宽度(punctuationWidth)kaimingfullwidthfullwidth
相邻两个标点共占1.5 em(compressAdjacent)是否是
行首行尾的括号去掉空白(trimLineStart)是否是
横排时的、,。字格左下居中居中
竖排时的、,。字格右上居中居中
间隔号·半个字宽一个字宽一个字宽
打开hangingPunctuation后可悬挂的标点、,。.;:?!、,。.,横排时仅在'force'下、,。.,横排时仅在'force'下
:book[…](bookTitleMark)书名两侧加《》波浪线波浪线
中文字符上的*…*(emphasis)着重号着重号着重号
图、续表、见图、(续)、见圖、(續)、見圖、(續)、見
索引分组(index.groupBy)拼音首字母笔画数笔画数

最后两行跟随字形而不是地区。在北京印刷的繁体古籍(zh-Hant-CN)采用大陆的断行和标点,同时使用圖、(續)、見和笔画分组;标为香港的简体书(zh-Hans-HK)则使用图和拼音分组。

从postext 1.16起,日文文档有自己的地区japan:见日文排版。韩文文档也会关闭断词并使用CJK排版器,但还没有自己的规则:它按大陆中文的默认值排版,谚文段落保留字体自带的引号和破折号。

#中文章节的Markdown写法

中文和其他文字一样用Markdown书写。以下几条规则能让书写更顺手:

  • 可以在任意位置换行。 两个汉字之间的换行会被去掉,和CSS的处理一样,所以按80列自动换行的编辑器不会在正文里加进空格。两个标点之间的换行(”⏎“)由标点两侧之外的字符决定。在行内输入的空格会保留。
  • 用配置来缩进。 首行缩进两字写作bodyText.firstLineIndent: { value: 2, unit: 'em' };解析器会去掉段首的全角空格(U+3000)。
  • 标题也用配置来缩进。 像GB/T 9704那样空两字、回行顶格的标题写作headings.levels[n].firstLineIndent: { value: 2, unit: 'em' }(postext 1.24起)。写进numberingTemplate的全角空格会成为标题编号的一部分,也会印进目录和PDF书签。
  • 标记用半角输入。 中文输入法会打出:::、#、[^1]、{…}和**;它们会作为正文印出来,构建时每一行都会报fullwidthMarkup,并给出应输入的半角形式。属性值可以用“…”或「…」加引号,也可以用=;标题属性可以紧跟标题、不加空格:# 第一回{style="hui"}。键名必须是ASCII;中文键名(作者=曹雪芹)会被丢弃,并给出attributeKeyInvalid警告。
  • 强调和范围。 _和__可以用在两个汉字之间(中文_斜体_中文)。两个数字或两个中文词之间的~表示范围,按原样保留(3~5天、周一~周五)。
  • ID和文件名保留汉字:标题为第一回的章存为chapters/001-第一回.md。

中文标记、注音、双行夹注和字符方向的指令见下文和文档格式。

#横排

中文、日文或韩文字符多于词间空格的段落由CJK排版器排版。只有两个拉丁单词、数字或符号之间的空格才算词间空格:网页文字在拉丁单词和数字两侧加的空格(2026 年 9 月 28 日、安装 Node.js 和 Git)不算,这样的句子按去掉这些空格后的写法排。排版器把文字切成单元(每个字符一个,每个拉丁单词或数字一个,每个两字长的破折号或省略号一个),每个单元只测量一次,再逐行填满。这里没有什么需要Knuth–Plass这类最优搜索去权衡:两个字符之间几乎都可以断行,下面的规则去掉少数不能断的地方。引用中文书名的拉丁段落仍用Knuth–Plass,并可按同样的规则在其中的汉字旁断行。题注、表格单元格、脚注和标注框也按文档的级别断行。

#断行

避头尾规则规定哪些标点不能出现在行首、哪些不能出现在行尾。cjk.lineBreak从clreq §6.1.1的四个级别中选一个:

级别不能出现在行首不能出现在行尾
none无:台湾和香港的报纸可在任意位置断行。无。
basic点号、,;:。!?,后引号和后括号”’」』)〕]》〉,连接号~和单个—,间隔号·‧・,叠字符々,单位% ‰ ° ℃。前引号和前括号“‘「『(〔[《〈,货币符号¥ $ €。
gbbasic加上分隔号/(GB/T 15834—2011 §5.1.9)。basic加上分隔号。
strictgb加上占两字的标点—— ⸺ …… ⋯⋯。gb。

无论哪个级别,以下内容都不会被拆开:两字长的破折号——和省略号……,数字与其符号或单位(¥5,999、50%、120㎡、−3 ℃),拉丁单词,以及用全角数字写的数(12:30);脚注标记、:ref和上标总是跟前一个字符在一起;全角空格之前也不会断行。唯一的例外是比整行还宽的拉丁单词或网址:单词在音节处拆开,网址在其分隔处拆开。

书名不在第一个字之后、也不在最后一个字之前断开:在《…》和〈…〉之内(无论是直接输入的,还是加在:book[…]书名两侧的),只有书名两侧各留两个字时才断行,因此行尾不会出现《說而下一行以文》开头,两三个字的书名不会被拆开。cjk.titleMinChars设定这个字数(设为1时,凡级别允许之处都可断行)。若该行找不到别的断点,宁可在书名内部断开,也不超出版心。

带圈数字①到⑳(以及⑴、⒈、ⓐ、❶等同类符号)在中文里按汉字排:各占一格,前后不加中西文间距,也不置于行尾,因为它为其后的义项或条目编号(除none外的所有级别)。字典条目写作**①**天也,编号与正文之间不必加任何字符。cjk.circledNumbers: 'western'把它们按西文字母排,与postext 1.24及之前相同。

当下一个字符放不下时,排版器会先看它。如果它可以出现在行首,就移到下一行,并把本行两端对齐撑开。如果它不可以(逗号、后括号、前括号后面的字),这一行先尝试放弃标点空白把它挤进来,即clreq §6.2.2.3的“挤进”;只有挤掉这些空白仍放不下时,这一行才提前结束,把标点前面的字符和标点一起带到下一行。先挤进,是因为这样可以保持本行的字符不变;挤出是后备办法。

#标点宽度

全角标点是半个字宽的字形加半个字宽的空白,设置调整的是空白,从不改变字形(clreq §6.3.2)。空白在哪一侧取决于地区。大陆把点号放在字格的一角,空白跟在字形后面;台湾和香港把点号居中,两侧各留四分之一个字宽。在所有地区,前括号和前引号的空白都在字形之前,后括号和后引号的空白在字形之后。

点号在字格中的位置四排字格,甲 乙 丙 丁 四个字后面依次跟着句号、逗号、顿号和冒号。大陆横排把标点放在字格左下,大陆竖排放在字格右上。台湾和香港在两个方向上都把标点居中。横排大陆甲乙丙丁台湾和香港甲乙丙丁竖排大陆甲乙丙丁台湾和香港甲乙丙丁
字形占半个字格,放在哪一半由地区决定。

cjk.punctuationWidth决定标点保留多少空白:

样式行内行尾使用场合
fullwidth全角式所有标点占一个字宽。一个字宽。台湾和香港的书;大多数网页文字。
kaiming开明式。.?!占一个字宽;,、;:、括号、引号和间隔号占半个字宽。所有标点占半个字宽。大多数大陆图书;方正书版的默认设置。
lineEndHalf行末半角所有标点占一个字宽。所有标点占半个字宽。按字面理解的GB/T 15834—2011 §5.1.10。
halfwidth半角式所有标点占半个字宽。半个字宽。词典。

另有两项设置对任何样式的标点都起作用。打开compressAdjacent后,相邻的两个标点放弃它们之间的空白,因此。」、》(或,「占一个半字宽,而不是两个字宽。台湾和香港那样居中的。或,在后括号前保留整个字宽,所以。」在那里仍然占两个字宽;》(、」,和,「照样挤紧。打开trimLineStart后,位于行首的前括号放弃前半个字宽的空白,使括号的笔画与文字边缘对齐;位于行尾的后括号放弃后半个字宽的空白。这两项在大陆和香港默认打开,在台湾默认关闭,台湾的书让每个标点都保留在自己的字格里。

全角式与开明式标点曹雪芹著《红楼梦》(又名《石头记》)。这一行排了两次。全角式中每个标点占一个字宽,整行长19个字宽,每个标点空着的那一半用浅色标出。开明式中括号各占半个字宽,行末句号也占半个字宽,同一行长15.5个字宽。全角式曹雪芹著《红楼梦》(又名《石头记》)。19 字宽放弃的空白开明式曹雪芹著《红楼梦》(又名《石头记》)。15.5 字宽
同一行用全角式(19个字宽)和开明式(15.5个字宽)排出。

引号、省略号、破折号和间隔号与拉丁文字共用,拉丁字体把它们画得很窄。在中文语境中(两侧最近的字符都是中文),无论字体的步进宽度是多少,它们都占中文标点的字框:“和”各占一个字宽(开明式下为半个),……占两个字宽并居中,·在大陆占半个字宽、其他地区占一个字宽。破折号(——)印成一条贯通两个字宽的线,升到字符的中线高度。在拉丁单词旁边,这些标点保留字体的宽度,因此他说:He said “yes” and left.中的英文引号按英文排。在其他书写系统的句子里被提到时,例如英文版权页中的Cuts are marked …….,连用的省略号和破折号在中文或日文书里仍是文档自己的标点:这一对保持汉字文本的字形,其后的句点按句子的字形排(没有字母的词)。

书要用本地区的字体来排:大陆用Noto Serif SC或Source Han Serif SC,台湾用TC,香港用HK。版面根据地区而不是字体来决定标点哪一侧是空白,用大陆标签配繁体字体时,会把居中标点挤错一侧。

#标点悬挂

设为hangingPunctuation: 'allow'时,原本会落到下一行行首、又无法挤进本行的逗号或句号,可以悬挂在行尾之外(clreq §6.1.3)。'force'则只要这类标点位于行尾就悬挂。每行最多悬挂一个标点,且从不悬挂紧挨另一个标点的标点(。」)。在'allow'下,横排的台湾和香港文字不悬挂任何标点,因为居中的标点悬挂后看起来像被截断;'force'在那里也会悬挂。大多数中文书不悬挂标点;clreq建议在使用字符网格时悬挂。默认值是'none'。

#字间两端对齐

中文正文两端对齐,两端对齐的行在字与字之间撑开。不是段落最后一行的行,按clreq §6.2.2.4的顺序填满:

  1. 拉丁单词之间的空格,每处最多半个字宽。
  2. 汉字与拉丁文字之间的间距(见下一节),每处最多半个字宽。
  3. 所有字符间隙平均分配:两个汉字之间、字符与标点之间、汉字与拉丁单词之间。拉丁单词、数字或两字长标点的内部从不加宽,连接号(~、单个—)或分隔号的两侧也不加宽。

如果一行的字间需要超过半个字宽(设置了bodyText.maxJustifyTracking时,则是超过该值),就只加这么多,行尾不足行长;构建时报为cjkLooseLine内容警告,沙盒中称为CJK行未排满。通常是因为一个长拉丁单词或网址无法提上来。段落最后一行密排。断词与两端对齐有详细说明,包括CJK行在松散行高亮中怎样计算,以及各栏齐底时怎样把中文段落多排一行。

段落不会以只有一个字的行结束,无论这个字是单独一个还是带着收尾的标点(孤字,如後。)。上一行会让出最后一个字,连同必须跟它在一起的标点,并撑满行长;如果这样需要超过字距上限,这个字就单独留在最后一行。这项行为由bodyText.avoidRunts控制,默认打开,横排和竖排都适用;各栏齐底也从不产生这样的行。不两端对齐的段落同样让出这个字,有没有字符网格都一样,上一行因此少一个字。稿纸是例外:设置cjk.grid.fullLines后,这样的行每个格子都填满,段落可以以一个字结尾。

#汉字与拉丁文字之间的间距

cjk.latinSpacing在汉字与相邻的拉丁字母或数字之间加四分之一个字宽(clreq §6.3.3):1999年的iPhone 15售价为¥5,999。印出来时,1999之后、iPhone 15前后都有间距,而¥前面没有,因为它是符号。行首和行尾没有间距,拉丁单词与中文标点之间没有(用iPhone,),中文括号内侧也没有((iPhone))。作者在这类交界处输入的空格(很多网页文字都有)会被替换为汉字与拉丁文字之间的间距,所以用 iPhone 拍照和用iPhone拍照排出来一样。在两端对齐的行中,这一间距先增大到半个字宽,然后才在字符之间撑开;需要多挤进一个字的行会把它缩到八分之一个字宽。这一间距不是文字:复制、搜索和PDF提取的文本都按原样读出用iPhone拍照。设为0即关闭。西文单词的哪一侧加间距由cjk.latinSpacingEdge决定:中文保持'letters',即上面的规则;'western'则像日文那样,在西文单词的括号和符号旁边也加。

#字符网格

cjk.grid按中文的方式规定版心,即每行字数和每页行数:

cjk: { grid: { enabled: true, charsPerLine: 28, linesPerPage: 28, show: true } }

每栏宽为charsPerLine个正文字号的字宽,版心高为linesPerPage个正文行高。配置的page.margins作为最小值:版心在其留出的空间中居中,每边页边距各增加差值的一半。双栏时,栏间距取整为整数个字宽。超出可容纳数量的值会被减小并报告(cjkGridClamped);未设置的值取能容纳的最大数量。show在屏幕上画出网格(稿纸),每个字位一个方格;PDF不画网格,除非给renderToPdf传入characterGrid: true。

网格上的页面逐行排满,不做齐底:一栏如果短一截结束(比如某个标题要和正文一起转到下一页),就保持短栏,就像GB/T 9704的公文按22行计数那样。headings.balancing.enabled: true开启齐底,所用的手段都保持网格:在标题上方以及列表、行间公式和图下方增加的都是整数个网格行,headings.balancing.gridLines: 'off'可以把这些排除在外;段落只有在字间距不超过headings.balancing.maxTracking时才多排一行,而在默认值下,少一整个字的行从来做不到这一点。无论哪种情况,每个字都留在自己的格子里。见配置 › 各栏齐底。

avoidWidows和avoidOrphans两条规则也随网格而定。bodyText.avoidWidows在网格上默认关闭:段落可以只有一行排在页末,页面保持应有的行数。bodyText.avoidOrphans仍然开启:段落的最后一行不单独落在页首(段末孤行,clreq §7.1.2),上一页会让出一行与它同排。需要别的做法时,在配置里写明这两个键即可。

常见的书,五号(10.5 pt)字,行间距6 pt,行高16.5 pt:

  • 大32开,140 × 203 mm,28 × 28字:行长103.7 mm,版心高163 mm。
  • 16开,184 × 260 mm,双栏,每栏23字,小五(9 pt,行高13.5 pt),栏间距两个字。

clreq建议每行17到40字,横排最多48字,竖排最多55字,行间距为半个到一个字(clreq §7.1.1.5)。中文字号有名称:五号10.5 pt用于书籍正文,小五9 pt用于报纸和注释,小四12 pt,四号14 pt,三号16 pt,二号22 pt。Postext的字号以点为单位;号数字号请写成对应的点值。

#编号

所有编号设置都支持CSS Counter Styles中的中文数字样式:页码、有序列表、图表计数器、标题模板、篇以及PDF页面标签。simp-chinese-informal写作一、十二、一百零一;trad-chinese-informal相同,但用萬和億;cjk-decimal写作二〇二六;simp-chinese-formal和trad-chinese-formal是大写数字壹贰叁;circled-decimal是①;此外还有天干甲乙丙和地支子丑寅。在模板中,一表示文档所用字形的小写数字,所以一个模板可以同时用于两个版本:

headings: {
  levels: [{ level: 1, numberingTemplate: '第{1:一}回', numberSeparator: ' ' }],
},

这样得到第一回到第一百二十回,编号与标题之间是一个全角空格。回目对联在标题中用换行写出:# 甄士隱夢幻識通靈 \\ 賈雨村風塵懷閨秀。标题的版面设计会把{titleText}分两行印出,每行一半:章首页的色带,或者在级别或标题样式上设置的栏内advancedDesign(见通栏与高级设计)。在其他地方,上下两半用全角空格连起来:目录、书眉和PDF书签中是这样,没有版面设计、直接排在栏内的标题也是这样,连起来的标题在行长用尽处换行,往往断在后半句中间。汉字与数字或拉丁单词之间的换行(# 示例市出版协会关于举办 \\ 2026年中文排版实务培训班的通知)在栏内、目录和书眉中排成汉字与拉丁文字之间的间距,在PDF书签和文档标题中则直接相连。下面两个示例都没有版面设计,如果希望对联分两行排,请给标题加上设计。在中文文档中,{1:words}把数字写成中文(十二),{1:ordinal}加上第(第十二)。编号为:::part{number="卷三"}的篇,在需要数字的占位符中按3处理。

有序列表遵循GB/T 15834—2011的层级(一、 (一) 1. (1) ①),在数字前加prefix:

orderedLists: {
  levels: [
    { level: 1, numberFormat: 'simp-chinese-informal', separator: '、' },
    { level: 2, numberFormat: 'simp-chinese-informal', prefix: '(', separator: ')' },
    { level: 3, numberFormat: 'arabic', separator: '.' },
    { level: 4, numberFormat: 'arabic', prefix: '(', separator: ')' },
    { level: 5, numberFormat: 'circled-decimal', separator: '' },
  ],
},

内置的中文图、表类型按章编号,中间用连字符(图1-1、表3-2)。中文题注的标签与编号之间不加空格,编号与文字之间用全角空格:captionStyle: { labelNumberGap: '', labelSeparator: ' ' }得到图1-1 大观园图,:ref读作图1-1。PDF写入中文页面标签,因此阅读器的页码框在页面印着一、二、三的地方也显示一、二、三。

中文书的索引按拼音首字母(简体)或笔画数(繁体)分组,数据来自排序器本身(index.groupBy,默认'auto')。多音字归入排序器的常用读音;这类条目请用读音符合预期的汉字写一个sort键::index[重阳]{sort="崇阳"}。见索引。

#脚注

大陆出版的书,页下注一般用带圈数字,每页重新起算:每页的第一条注是①,正文中的注码和注文开头的编号都排在基线上。台湾和香港的书大多也这样排。

footnotes: { numberFormat: 'circled-decimal', numbering: 'page' },

使用circled-decimal时,注码默认排在行内(markerPosition: 'auto');markerSize: { value: 0.75, unit: 'em' }让它比正文小。超过50的编号没有带圈形式,写成阿拉伯数字。注的编号取决于它落在哪一页,所以按页编号的文档先按章编号排版,再按注文实际所在的位置重新编号并再排一次;带圈注码不论编号多少宽度都一样,第二次排版不会移动任何一行。numbering: 'column'每栏重新编号,适合逐栏排注的书。注码和上标一样随前一个字符,不会出现在行首;竖排时在自己的格子里直立。沙盒的中文默认设置会在改动列表中列出这几项。参见脚注。

#竖排

layout.writingMode: 'vertical-rl'把书竖排。上面介绍的全部排版规则原样适用,只是沿行向下而不是横向;变化的是周围的页面和每个字符的方向。

#转了四分之一圈的页面

竖排页面的版面相当于把横排页面顺时针转四分之一圈。它的行就是竖排文字的列,从右往左读;引擎对行做的一切(断行、两端对齐、浮动体、脚注、不拆分规则、齐底)都在这个转过的坐标系中进行。在纸面上:

  • 版面中的一栏是一栏(tier)。layoutType: 'double'得到上下叠放的两栏,从右上开始填,栏线是两栏之间的一条横线。章末不对各栏齐底(clreq §7.1.3.4)。
  • 文字流的顶端是纸面的右边缘:章首页是页面右侧的一条竖带,顶部浮动体位于右侧,底部浮动体位于左侧,脚注落在每栏的左端。
  • page.margins在纸面上沿用原来的名称。书眉、页码、裁切线和背景也仍然以纸面为准。
  • 标题样式可以设置自己的书写方向,因此竖排书后面可以接横排的附录或索引。

读取版面的宿主程序在竖排页面上能找到VDTPage.flow,以及在文字流和纸面之间换算的辅助函数(flowToPage、pageToFlow、flowRectToPage)。见配置参考中的竖排。

#右侧装订

page.binding默认为'auto',竖排书的auto就是右边缘。第1页仍是奇数页(recto),所以奇偶设置、:::pagebreak{parity="odd"}和页数的含义不变;变的是recto所在的一侧,即跨页的左页(clreq §7.1.3.3)。使用对称页边距时,奇数页的内侧页边距在右边。沙盒把跨页显示为3 | 2,第1页单独位于书脊左侧,HTML阅读器从右往左排列页面。PDF也请求阅读器这样显示(/Direction /R2L和/PageLayout /TwoPageRight);Acrobat和Foxit会照办,Chrome内置的阅读器不会。横排书也可以在右侧装订。见装订。

#每个字符的方向

哪些字符直立、哪些旋转,遵循Unicode的竖排方向属性(UAX #50),再加上clreq附录A中的中文惯例:

  • 汉字、假名、注音符号和全角字母直立,各占一个字宽。
  • 超过直立上限(见下一节)的拉丁单词和数字顺时针旋转四分之一圈,保留横排时的宽度。
  • 括号和引号使用竖排形式(﹁﹂﹃﹄︵︶)。在大陆文字中,“ ” ‘ ’显示为『』「」,符合GB/T 15834—2011 §5.2.3的规定。
  • 点号从不旋转,尽管UAX #50为日文旋转:;。大陆字体把、,。.放在字格右上,把!?:;放在字格右半(GB/T 15834—2011 §5.2.1);台湾和香港字体把它们居中。
  • 破折号、省略号和波浪号沿列向下;破折号是沿字符中轴的一条竖线。
  • Unicode设为直立的符号(× © ± § ℃ ①)独占一个字格,在数字中间也是如此:30×40是30、×和40,全部直立。

标点宽度、挤压、悬挂以及汉字与拉丁文字之间的间距,在竖排中的作用与横排相同:开明式的、占半个字格,」「占一个半,:;?!在所有地区都保留整个字格。

#直立的数字

短数字立在一个字格里比躺倒更好读:这就是纵中横(縱中橫,clreq §2.1.3)。cjk.uprightDigits规定这样的数字最多有几位:默认2,也可设为3或4,设为0则不直立。整个数字要么立在字格里,要么都不立,所以在默认设置下,2026年9月28日中的2026横躺,9直立,28并排立在一个字格里;A4、3.14和10,000连同字母和分隔符一起横躺。英文句子中的数字跟随句子横躺:在chapters 49 and 32中,两个数字都和周围的单词一起排;而紧挨汉字的数字直立(第 3 回、用iPhone 15拍攝),中文里的时间、比分和日期中的数字也直立,因为它们的冒号和连字符通向汉字(上午12:30开会、比分3:2)。有三个标记可以手动覆盖这项设置:

第:tcy[120]回,:upright[GDP]增長:sideways[12]倍。

:tcy[…]把文字排在一个直立字格中,太宽时压缩到一个字宽;:upright[…]让每个字符各占一个直立字格,用于逐个字母读的缩写;:sideways[…]把这段文字旋转。在横排中它们不起作用。文学作品通常用中文数字写数,用不着这些。

#图、表与题注

竖排书中的图和表直立。图在题注允许的范围内占满所在栏的高度,它在纸面上所占的宽度就是它在文字流中占用的空间;题注横排在图下方,表格的单元格也横排(clreq指出,题注、表格和页码通常保持横排,§2.1.1)。比所在栏高的表按行在各栏之间拆开。图在竖排文字中首次被引用的地方,placement.rotate会被忽略,并给出rotateIgnoredVertical警告。

#书眉与页码

书眉和页码以纸面为准,横排,这和大多数竖排书一样(clreq §7.2)。另有两种常见做法,可以把文字元素设为竖排(writingMode: 'vertical-rl'),并锚定在页面外侧页边距(anchor.to: 'outer')来实现:

  • 切口书眉:章名沿外侧页边距竖排,从版心顶端往下约四个字处开始;页码在距版心底端约五个字处结束,用中文数字,字号约为正文的80%。沙盒可以一步加上(页眉 › 切口书眉(竖排))。
  • 页码在外侧下角,按台湾竖排书的规定:右翻书的页脚中放一个横排元素,奇数页在左下,偶数页在右下。

模板见配置参考中的竖排文字元素。

#各输出中的竖排文字

Canvas自行绘制竖排页面,每个直立字符绕其字格中心转回来。要使用字体自带的竖排标点字形,浏览器宿主程序会为每个字体族加载一个打开OpenType vert特性的副本(loadVerticalAlternates);沙盒为竖排书的每个字体族都这样做,没有副本时,引擎自己旋转或移动标点。PDF通过第二个竖排模式(Identity-V)字体字典显示直立字符,它引用同一个嵌入文件并用vert成形,所以阅读器把一列作为一行来选择和复制,也不会重复嵌入;带标签的PDF声明WritingMode /TbRl。HTML把每一行设为带writing-mode: vertical-rl的盒子,数字用text-combine-upright排在一个字格中。三种输出中每个字符的位置与HarfBuzz竖排版面的差距都在百分之几个字宽之内。

#标记与注释

中文版本在行间加标记,而不是用斜体或下划线;用读音为汉字注音;在行内排评注。五个指令涵盖这些用法。每个指令都把文字留在段落中,所以搜索、目录、索引锚点和复制的文本都按原样读出这些字,只有字周围画出的东西取决于配置。

此事:dots[不可]輕忽。:name[賈寶玉]與:name[林黛玉]讀:book[西廂記]。
 
{滿紙|mǎn|zhǐ}荒唐言,:ruby[一把]{rt="yì bǎ"}辛酸淚!
 
寶玉:warichu[甲戌側批:此是第一首標題詩。]{open="〔" close="〕"}道:

#着重号

:dots[…]在横排时在每个字下方、竖排时在每个字右侧加一个着重号,标点上不加(clreq §5.3.1;GB/T 15834—2011 §4.12,竖排见§5.2.5)。style可选圆点、空心圆或芝麻点。在中文文档中,Markdown强调也有同样效果:那里的cjk.emphasis默认是'dots',所以*不可*印出着重号,因为中文字体没有斜体可用。同一段强调中的拉丁字母仍保留斜体。

#专名号与书名号

:name[…]在文字下方画专名号,竖排时在左侧。:book[…]按cjk.bookTitleMark的设置印书名号:书名两侧加《》,如现代大陆图书的写法(书名中的书名用〈〉);或者像古籍和台湾版那样在书名下加波浪线;或者什么都不加。因此同一份源文件可以同时用于现代大陆版和古籍版。两个专名或两个书名相接时,每条线在接合处各让出八分之一个字宽,所以:name[賈寶玉]:name[林黛玉]读起来是两个名字。

#注音:拼音与注音符号

:ruby[紅樓]{rt="hóng lóu"}在每个字上方注音;读音数与字数相同时,可以在字与字之间断行,group则在整个词上方注一个读音。当基字是汉字时,简写形式{紅樓|hóng|lóu}效果相同,所以拉丁正文中的{x|x>0}仍是文字。注音符号(注音)排成每个字右侧的一列,声调符号在该列旁边,其字迹有一半高于最后一个符号(clreq §5.5.3.3);拼音横排时在文字上方,竖排时在文字右侧。比基字宽的读音会加宽基字的字框;其中最多四分之一个注音字号的宽度可以伸到没有读音的相邻字上,不计入加宽。cjk.ruby设置注音的字体、字号(默认为正文的一半)、颜色和默认位置。

#双行夹注

:warichu[…]把注释在行内排成两行、字号减半的小字(双行夹注),这是古籍中评注的形式。上行至少占每段的一半,所以下行不比上行长,不能出现在行首的标点也从不出现在下行开头;如果符合这条规则的折法都落在一半之前(本名。),就取最近的一个,下行反而更长(上行本,下行名。)。长注释填满本行剩余部分后,接着排到下一行、下一栏或下一页,断点两侧至少各留两个字(cjk.warichu.minChars),括号只加在第一行之前和最后一行之后。竖排时先读右边的小列。cjk.warichu设置字号、颜色和默认括号。

#行距中的空间

行距从不改变:着重号、线和注音都在行与行之间的空隙中。段落的行间空隙容不下所加内容时,构建会发出警告:单侧有标记时小于半个字宽,两侧都有标记时小于八分之五个字宽(clreq §5.6.1),报为cjkMarksExceedLeading;注音比空隙高时报为rubyExceedsLeading。请给加了注释的段落设一个行距更大的段落样式。标记和注音在正文段落、标题、列表项、引文和标注框中绘制,也在题注、表格单元格和注释中绘制,其行间空隙按同样方式检查;书眉只印文字,不画这些标记。

#字体

Postext为每种样式只用一个字体族,缺字时不会退回到另一个字体族:Noto Serif TC不会向Noto Serif SC借字。字体必须覆盖书中印出的每个字符,包括标点。

  • 在浏览器和沙盒中,中文字体族来自Fontsource,每个字重约一百个文件,每个文件包含一部分字符,并用unicode-range声明;浏览器只加载文字用到的文件。沙盒的PDF标签页也是这样:它的字体提供函数读取字体族的样式表,把页面用到的切片交给renderToPdf,每个切片作为子集嵌入。Fontsource的命名子集并不完整(Noto Serif TC的chinese-traditional缺少全角的,!?),所以请使用编号切片。
  • 在文件包中,请提供按本书实际用字(包括标点和竖排字形)取子集的字体。从可变字体中为每个字重导出一个静态文件:pdf-lib嵌入的是可变字体的默认实例,所以粗体标题会以默认字重印出(variableFontDefaultInstance)。优先使用TrueType版本(Google Fonts、Fontsource),而不是CFF的.otf文件,postext-pdf会整个嵌入后者,每个字重最多25 MB(cffEmbeddedWhole)。取子集时保留排版特性(vert、vrt2)和竖排度量(vhea、vmtx):竖排标点来自它们。
  • 缺字印成字体的空框。renderToPdf按字体报告缺字(missingGlyph),沙盒在每次生成PDF后在检查面板中列出。
  • 地区字体。 Noto Serif SC、TC和HK用各自地区的字形画同一批码位,并把点号放在各自地区规定的位置。书的字体应与书的语言标签所标的地区一致。
  • 没有斜体。 中文字体没有斜体;浏览器和PDF会把字形倾斜。强调请用着重号、楷体(如LXGW WenKai)或粗体。

中文书的传统字体分工对应到字体族:宋体(Noto Serif)用于正文,黑体(Noto Sans)用于标题和标签,楷体用于引文、诗歌和序言,仿宋用于公文。配置参考中的中日韩字体给出了字体提供函数的代码。

#两套完整配置

#横排的大陆小说

一本大32开的书,Noto Serif SC 10.5 pt,每页28 × 28字,章按第一章编号,脚注用①并每页重新编号,开明式标点和GB断行来自语言标签:

import type { PostextConfig } from 'postext';
 
const pt = (value: number) => ({ value, unit: 'pt' as const });
const mm = (value: number) => ({ value, unit: 'mm' as const });
const ink = { hex: '#1a1a1a', model: 'hex' as const };
 
const config: PostextConfig = {
  locale: 'zh-Hans-CN',
  page: {
    sizePreset: 'custom', width: mm(140), height: mm(203),
    margins: { top: mm(18), bottom: mm(20), left: mm(16), right: mm(20), mirror: true },
  },
  layout: { layoutType: 'single' },
  bodyText: {
    fontFamily: 'Noto Serif SC', fontSize: pt(10.5), lineHeight: pt(16.5),
    textAlign: 'justify', firstLineIndent: { value: 2, unit: 'em' },
    color: ink, boldColor: ink, italicColor: ink,
  },
  headings: {
    fontFamily: 'Noto Sans SC', color: ink,
    levels: [
      { level: 1, fontSize: pt(16), numberingTemplate: '第{1:一}章', numberSeparator: ' ',
        breakBefore: { enabled: true, parity: 'any' } },
    ],
  },
  captionStyle: { labelNumberGap: '', labelSeparator: ' ' },
  footnotes: { numberFormat: 'circled-decimal', numbering: 'page' },
  cjk: { grid: { enabled: true, charsPerLine: 28, linesPerPage: 28 } },
  header: { elements: [] },
  footer: { elements: [
    { kind: 'text', id: 'folio', content: '{pageNumber}', fontFamily: 'Noto Serif SC', fontSize: pt(9),
      overflow: 'clip', color: ink, placement: { anchor: { to: 'container', edge: 'center' } } },
  ] },
};

cjk键只设置网格:地区、断行、标点宽度、挤压以及汉字与拉丁文字之间的间距都跟随zh-Hans-CN。各章可以从任一页开始,大多数大陆小说都是这样(另页起)。

#竖排、右侧装订的台湾小说

一本25開的书(148 × 210 mm),用Noto Serif TC,每列38字,章按第一回编号,带切口书眉和中文页码;台湾的居中全角标点和基本断行来自zh-Hant-TW,右侧装订来自书写方向:

const config: PostextConfig = {
  locale: 'zh-Hant-TW',
  page: {
    sizePreset: 'custom', width: mm(148), height: mm(210),
    margins: { top: mm(24), bottom: mm(18), left: mm(16), right: mm(22), mirror: true },
    pageNumbering: { format: 'trad-chinese-informal' },
  },
  layout: { layoutType: 'single', writingMode: 'vertical-rl' },
  bodyText: {
    fontFamily: 'Noto Serif TC', fontSize: pt(10.5), lineHeight: pt(18),
    textAlign: 'justify', firstLineIndent: { value: 2, unit: 'em' },
    color: ink, boldColor: ink, italicColor: ink,
  },
  headings: {
    fontFamily: 'Noto Serif TC', color: ink,
    levels: [
      { level: 1, fontSize: pt(14), numberingTemplate: '第{1:一}回', numberSeparator: ' ',
        breakBefore: { enabled: true, parity: 'odd' } },
    ],
  },
  cjk: { grid: { enabled: true, charsPerLine: 38 } },
  header: { elements: [
    { kind: 'text', id: 'head', content: '{chapterTitle}', writingMode: 'vertical-rl', pages: 'body',
      fontFamily: 'Noto Serif TC', fontSize: pt(8.4), overflow: 'clip', align: 'left', color: ink,
      placement: { anchor: { to: 'outer', edge: 'top' }, offset: { y: { value: 4, unit: 'em' } } } },
    { kind: 'text', id: 'folio', content: '{pageNumber}', writingMode: 'vertical-rl',
      fontFamily: 'Noto Serif TC', fontSize: pt(8.4), overflow: 'clip', align: 'left', color: ink,
      placement: { anchor: { to: 'outer', edge: 'bottom' }, offset: { y: { value: -5, unit: 'em' } } } },
  ] },
  footer: { elements: [] },
};

parity: 'odd'让每章从奇数页(recto)开始,在这本书里就是左手边的页面。没有设置linesPerPage,所以页面按宽度能容纳多少列就排多少列。切口书眉在奇数页沿左侧页边距、在偶数页沿右侧页边距竖排,第103页的{pageNumber}印作一百零三。

#在沙盒和排版食谱中

在沙盒中,版面设计 › 书写系统包含文档语言、书写方向、装订方式和所有cjk设置;中文默认设置 › 查看…可以一步把书设为中文排版,并先列出每一项改动(见沙盒)。用添加语言…给一本书加上的中文版本也会得到同样的改动,但书本身已经设定的项保持不变,书写方向也沿用原书(见沙盒:书、Word文件与保存)。展示书架上有《紅樓夢》(1792年程乙本)的三个版本:繁体竖排、右侧装订、简体横排,以及H. Bencraft Joly英译本的前56回。排版食谱在“中文排版”合集中收录了中文食谱,每个食谱是一页或一组跨页,附有排出它的脚本。

#已知限制

  • 韩文按大陆中文的默认值排版;它自己的规则(KLREQ)尚未实现。从postext 1.16起,日文遵循自己的规则(日文排版)。
  • 设计文字(书眉、章首页、标注框标题、篇名页)遵循正文的避头尾规则、标点宽度和中西文间距(cjk.composeDesignText,自postext 1.25起),但各行不齐:不在字间分配空白。
  • 每页只有一种书写方向。 竖排页面中的横排标注框、表头行在右侧的原生竖排表格,以及直立图旁边的题注都不支持。行内公式、行内标签和色块随竖排行一起横躺。
  • 行号:竖排文字不印行号;竖排的书打开lineNumbers也没有行号,并给出配置警告lineNumbersUnsupported。横排的书照常加行号(配置 › 行号)。
  • 文字绕排。 横排中,图片或框可以放在栏的一侧,正文排在旁边(见文字绕排);使用字格时,它占的宽度取整到整字,旁边的行仍在网格上。竖排不在图旁排正文:绕排的图片保持整条,并给出textWrap警告(资源类型的默认值则为wrapUnsupported)。
  • 制表符:含有制表符(:tab,或设有制表位的样式下的制表符字符)的横排段落逐行排:按文档的断行规则在字与字之间断开,但不做标点挤压,也不在字与字之间分配空白来两端对齐。竖排文字没有制表位:制表符是一个词间空格,:tab会引发内容警告tabInVerticalText。带注音或双行夹注的段落也把其中的制表符排成词间空格。见制表符与制表位。
  • 首字下沉:横排段落可以以一个字的首字下沉开头,由段落样式或标题级别设定(见首字下沉):它的字号按这个字本身的高度与正文的高度来定,缩短的行由排版器照常做标点挤压和两端对齐。竖排文字没有首字下沉:本应以首字下沉开头的段落不带首字排出,并引发内容警告dropCap。
  • 字号以点为单位。 没有号数或Q数单位。
  • 竖排度量。 每个直立字符都前进一个字宽;不使用比例竖排度量(vpal)和竖排字偶间距。
  • 注音和双行夹注:不支持双侧注音、自动注音和单行注释;设计文字中的注释和注音印成普通文字。
  • 字体:不在字体族之间回退,中文字体没有斜体,CFF字体整个嵌入。
  • 索引:多音字取排序器的常用读音,除非条目带sort键;不支持部首排序。
  • 代码清单:横排的代码清单用代码字体逐行排;在含汉字的等宽字体中,一个全角字符占两格,所以各列能对齐,制表符也把它算作两格。在竖排文字中,代码清单随竖排方向排,其中的拉丁文按竖排的惯例横躺,不带行号。行内代码中的汉字用周围正文的字体排(codeStyle.inline.otherScripts: 'text',默认值),因为很少有代码字体包含汉字。见代码清单。

#参考资料