跳到主要内容

章 3 · 篇 II · 工艺

Postext配置

什么是Postext配置,以及参考的二十个页面各讲哪一组设置

更新于 2026-11-103分钟enescadefritptzhjaar

简单来说

本页是参考的入口,这份参考列出控制页面外观的所有设置。所有选择都放在一组设置里:页面大小、栏数、字体、字号、标题、框、颜色等等。每项设置都有合理的默认值,你只需写出想改的那几项。整份参考分为二十个页面。本页的列表链接到每一节,可以直接跳到需要的部分。

Postext的每一项版面决定都由同一个配置对象控制。

PostextConfig控制页面尺寸、分栏方式、正文排印、标题样式、文档语言(locale)等。所有属性都是可选的:Postext自带一套合理的默认值,参照的是传统书籍排版。你只需写出想改的部分。

import { buildDocument } from 'postext';
 
const document = buildDocument(content, {
  page: { sizePreset: '21x28', dpi: 300 },
  layout: { layoutType: 'double', gutterWidth: { value: 0.5, unit: 'cm' } },
  bodyText: { fontFamily: 'EB Garamond', fontSize: { value: 9, unit: 'pt' } }, // 9 pt覆盖默认的8 pt
  headings: { fontFamily: 'Open Sans' },
});

引擎如何处理这份配置,概览见架构一页。

#内容一览

这份参考分为二十个页面。下面每一组是一个页面,后面列出它包含的各节。

页面与版式

  • 页面:尺寸、页边距、基线网格、裁切线、页码编号、装订。
  • 版式:栏数、栏间距、栏线、竖排。
  • 模切:dieCuts,穿过一张或多张纸页的孔、圆角和异形书,文字避开每个孔。指南是特种油墨与模切,其中也介绍专色油墨的工艺(finish)和模切线(print.dieLine)。

页眉与页脚

  • 页眉与页脚:每页的文本、线条、方框和图像元素,支持占位符、奇偶页、页面角色和定位。

正文

断词与语言

  • 断词:断词模式、不断开的词、齐左排的文字。
  • 文档语言:顶层的locale,决定断词的后备语言、内置资源类型、表格和拆开的标注框接续处印的文字、写入无障碍PDF的语言标签,以及由它决定的数字(numerals)和文本方向(direction);另见Postext排版所支持的语言与文字。从右到左书籍的说明见阿拉伯文排版。
  • 语言与文字:Postext能排的文字体系,以及分别讲解它们的页面。
  • 阿拉伯文:阿拉伯文的字形、kashida、元音符号与数字。

标题

  • 标题:共享默认值以及H1–H6各自的覆盖设置。

孤行与各栏齐底

列表与数学公式

注释与引用

  • 脚注:footnotes,用[^id]引用的注放在哪里、怎样编号、是什么样子。
  • 行号:lineNumbers,在诗歌或正文的页边每隔五行印一个行号;哪些行计数,从哪里重新计数,行号放在哪一侧。
  • 交叉引用:crossRefs,:ref的编号或页码前后印出的文字,以及它的默认样式。
  • 引用:citations,引用格式,以及引用和参考文献的样子。
  • 印刷版中的链接:links,印刷页面怎样交代链接的网址:不加、括号里的网址,或带网址和二维码的注释。
  • 目录::::toc排出的内容,包括条目排印、前导符、页码、作者行、篇条目。
  • 索引::::index排出的内容,包括条目排印、缩进、页码分隔符与页码范围、字母分组、排序语言。

东亚排版

  • 东亚排版:cjk,涵盖中文、日文和韩文的地区惯例与断行、两端对齐时行内空白的分配、标点宽度与悬挂、汉字与拉丁字母之间的空白、字符网格、竖排中的直立数字,以及着重号、注音、双行夹注和汉文训读记号。完整指南见中文排版和日文排版。

资源与表格

  • 资源类型:图、表及自定义类型的分类编号。
  • 表格样式(含命名表格样式)与题注样式:表格资源及其题注的排印与装饰。
  • 图示样式:把嵌入的SVG图示改成单一油墨的颜色,用于专色印刷。
  • 乐谱样式:scoreStyle 和 scoreStyles,所有乐谱的谱表大小、音乐字体、间距和小节号。
  • 视频样式:videoStyle,印在视频封面上的播放标记和二维码,以及HTML阅读器和EPUB中播放器提供的功能。

样式与篇

  • 段落样式:供:::paragraphs容器使用的命名样式,如参考文献、术语表、注释。
  • 行内标签样式:chipStyles,行内:chip[…]的命名样式,如词库里的词框、键帽、标签。
  • 字符样式:characterStyles,写作:span[…]{style="id"}的一段文字的命名样式:字体、字号、颜色、字距、大写,以及与之配套的高亮样式。
  • 高亮样式:markStyles,行内:mark[…]的命名样式,即衬在高亮短语下面、可以跨行的色带,以及短语下方或穿过短语的线。
  • 代码清单:codeStyle,即```清单的字体、框、制表符宽度、过长的行、行号和记号颜色,语法着色及其高亮器接口,以及用代码字体排的行内代码。
  • 篇::::part容器生成的篇名页,包括奇偶页、版心、篇名页的设计、正文的字体排印。
  • 标题样式:供{style="…"}标题使用的命名样式,如不编号的章、带独立书眉的前辅文,以及页面几何和配色。
  • 章样式:chapterStyles,章在其前置元数据(chapterStyle:)中指名即可使用的一整套设计(页面、排版、颜色、书眉);也可以在一篇的:::part{style="…"}中指定,让这一篇的所有章使用。

标注框

  • 标注框样式:供:::callout容器使用的带框注释、提示和学习目标。

练习设置

  • 练习样式:exerciseStyles,即:::exercise块的题号样子、题目要求的字体、选项序号、填空处、书写区、方格、除法竖式和答案颜色。全书设置:exercises,即教师用书、答案印在哪里、打乱顺序的随机种子和屏幕版本。指南见练习。

漫画设置

  • 漫画:comics,包括漫画页的画框和格间距、分格样式、嵌字、对白框样式和角色表。指南见漫画。

模板页设置

  • 页面模板:pageTemplates,包括模板页的框、组和装饰,模板之间的继承,以及奇偶页变体。标注样式:labelStyles,即放在图片锚点上的标注的外观。框的外观:frameLooks,即模板页的一段内容用look="…"采用的有名称的颜色组合。模板可能出现的所有问题见页面模板警告。

字体、颜色与输出

  • 单位与颜色 + 调色板:Dimension、ColorValue、命名颜色。
  • 自定义字体:在Google Fonts之外声明用户上传的字体族。
  • 数字样式:figureStyle按文本样式选用旧式数字、等高数字、等宽数字或比例数字,取自字体的OpenType特性。
  • HTML阅读器:HTML后端的目标栏宽与断行。
  • Canvas查看器:canvasViewer,沙盒Canvas标签页中并排两页之间、以及上下两排之间的间距。
  • PDF生成(配置):PDF后端的书签大纲、无障碍(带标签的)输出、强制色彩空间。
  • 印刷输出(配置):print,包括PDF/X-1a和PDF/X-4、ICC输出特性文件、黑色(只用K的灰色、叠印、复合黑)、以CMYK定义的颜色、印前检查和印刷预览。
  • 对比度检查(配置):contrast,按WCAG AA或AAA检查文字与底色的对比度,既按屏幕计算,也按输出特性文件的纸张计算;还检查细得不宜印刷的反白字。
  • 正文检查(配置):checks.contentInConfig,找出设计中直接存放书的正文、而不是占位符的文字,并可为书名和出版社设置允许的短语。
  • 书页视图(配置):3D书本视图的纸种、装订、台面和光照。
  • 调试:编辑器中的可视化叠加层,以及写作时的警告。

以编程方式使用

PDF文件

  • 生成PDF:postext-pdf,字体提供函数、中日韩字体、工作线程和可付印的文件。

HTML、3D书本、EPUB与SCORM

  • 集成HTML阅读器与生成PDF:端到端的完整做法。
  • 3D书本(postext-folio):把排好的文档显示成一本摊开在桌上的印刷书,读者可以翻页。
  • EPUB电子书:由同一份排版生成固定版式和流式版式的EPUB 3文件,并用EPUBCheck检查。
  • SCORM包:把章和节做成供学习管理系统使用的SCO,其中的练习会报告得分。

.postext文件包