Postext
简单来说
Postext是一款免费的开源软件,用来给书籍、杂志和报告排版。你用几种简单的标记写好文字,Postext就把它排成完整的页面,就像印好的书一样。它遵循印刷行业几百年来的排版规则,让文字更好读。排好的页面可以放在网站或应用里,也可以导出成能直接付印的PDF。它适合作者、出版人、设计师和开发者使用。
文字稿
旁白的全部内容,以及画面上出现的内容说明。
- 0:00
画面全片竖排,文字自上而下、自右向左读。深色画面右侧,一道金色细线下竖写着“毕昇 · 约1045”。一个个活字从上方落进字格,排成三列竖行,从右往左依次是“从毕昇的活字到今天,”“印刷术用了近千年,”“学会排好一页。”,最后一列为金色。背后,年份以巨大的空心数字从1045跳到2026,四周落下排版行话:避头尾、标点挤压、版心、孤字、栏距、天头、字格、中西间距、开明式、竖排、书眉、行长。镜头推进末尾竖排的句号,金色铺满画面。
旁白从毕昇的活字到今天,印刷术用了近千年,学会如何排好一页。
- 0:08
画面两列竖排标题:“网页学会了布局界面,”“却从未学会排好一页。”,第二列为红色。地址为example.com/longform/article的浏览器窗口里,是一篇三栏横排的中文文章,题为“为什么网页排不好一页”,按浏览器的方式逐行塞满。随着旁白,红色标记依次落在问题上,标签为:标点在行首、段末孤字、标点不挤压(引号和句号各占一整格)、中西文挤在一起(Postext和HTML前后不留空隙)、分栏失衡(第三栏只有两行)。旁边的代码块写着“column-count: 3;”,下面是“……仅此而已。”和一份逐项打叉的清单,列着同样五个问题。窗口闪烁失真,随即坍缩消失。
旁白网页学会了布局界面,却从未学会排好一页。所以网页上的中文长文依然粗糙:标点跑到行首,段末只剩一个孤字,标点不挤压,中西文挤在一起。
- 0:25
画面白光一闪,蓝、金、红三道条纹扫过,Postext标志和字标升起,下方是标语“为网页而生的可编程排版引擎”,“可编程”为金色。再下面一行是“开源 · MIT 许可 · v1.11.1 · 在浏览器中运行”。
旁白这就是Postext:为网页而生的可编程排版引擎。
- 0:32
画面从这里起,每一节的节标题都竖排在画面右缘,内容排在它的左边。第01/07节“01 · 内容输入”:“Markdown 只描述内容是什么。”Markdown文件03-why-postext.md逐字打出:一条部分指令{number="I" title="基础"}、带导语的标题“# 为什么是 Postext”、一段用:ref引用图fig-flow的中文、一行::resource和一个:::callout块,块里写着“改一个词:页面会自动重排。”。旁边的config.ts调用buildDocument,设置双栏版式、两端对齐和断词,下方写着“配置决定它们的样子。排版决策从不写进正文。”
旁白你用语义化的Markdown写作,它只描述内容是什么,配置决定它的样子。
- 0:39
画面第02节“02 · PRETEXT 测量”:“测量文本,无需触碰 DOM。”标题“为什么是 Postext”、一段正文和一个提示框依次被扫描,尺寸线标出它们以pt为单位的高度;代码面板显示prepare(text, '25px Lora')和layout(prepared, width, 38),返回高度和行数。两条进度条比赛处理10,000段:“浏览器重排 · DOM”几乎不动,“PRETEXT · CANVAS 度量 + 算术”瞬间填满;计数器升到600×,配文“比 DOM 更快的文本测量,整本书随着输入实时重排。”和“基于 @chenglou/pretext”。
旁白每个段落都在不触碰DOM的情况下完成测量,速度最高快六百倍。这要归功于Pretext,是这个库让这一切成为可能。
- 0:50
画面第03节“03 · POSTEXT 决策”:“绘制任何像素之前,每一行都已就位。”一个七段圆环依次亮起:结构、测量、放置、浮动、精修、平衡、节奏,每段配一句说明,如“图片移到栏首或栏尾”“Knuth–Plass,杜绝寡行孤行”“对齐基线网格”。旁边,Postext指南中文竖排版的一页逐步组装:带标签的块飞入各栏,一张图移到位置上,旁注“:ref{id="fig-flow"} → 栏底”,章首色带落下,文字行出现,各栏齐平(“分栏齐平”)。圆环循环迭代1到3次,显示“3 次迭代后稳定”和一个对勾;一个标注框给出其中一行的位置:行 · 页 · 栏。
旁白接下来,由Postext做决定。七个步骤放置每一行、安排每一张图、平衡每一栏,循环往复,直到不再有任何变化。
- 1:03
画面第04节“04 · 虚拟文档”:“改一个词。只重排改变的部分。”注释写着“就像 React 的虚拟 DOM,只不过面向页面:VDT,虚拟文档树。”中文竖排指南的七页(p. 3至p. 9)排成一行,从右往左读。光标在p. 7标出一处编辑,该栏其余部分变成金色,一小块溢到p. 8,p. 8随后打勾;之前的页面标为“跳过”,之后的标为“未变”。三条要点说明这条规则,标题为renderToHtmlIndexed()的面板把文档树中改动的节点标为“已修补”。
旁白这一切都存在于一个虚拟文档中,就像React的虚拟DOM。改一个字,只会重排发生变化的部分。
- 1:13
画面“长文档?只绘制屏幕上可见的部分。”一列书页滚过一个标有VIEWPORT的金色框,框的上下各留200像素余量:框内的页面完整绘制,框外的只是虚线轮廓。一个大计数器显示59页中此刻已绘制的页数,下面是“当前已绘制的页数”和“IntersectionObserver · +200 px”;旁边写着“几何:每一页。像素:只画你看到的。”和“页面滚入视口时绘制,离开视口时释放。”
旁白而在一本长书里,只有屏幕上的页面才会被绘制。
- 1:20
画面第05节“05 · 中文排版规范”:“每一行,都守中文的规矩。”同一段中文先按“浏览器 · 塞满就换行”的方式排出,随着旁白,问题逐一标红:句号和逗号落在行首,引号和句号各占一整格,Postext和汉字之间没有空隙,最后一行只剩一个字。接着,“POSTEXT · 中文排版规范”把同一段重新排好,下方四个标签依次亮起:避头尾、标点挤压、中西间距、不留孤字,每条规则改动的地方都标成金色。最后,浏览器那一栏让位给同样的文字,改成竖排,下方写着“竖排:同样的规则”。
旁白浏览器断行只管把一行塞满,标点落在哪里都不管。Postext遵循中文排版规范:避头尾、标点挤压、中西文间距,绝不让段落以一个孤字收尾。横排竖排,都是一样的规则。
- 1:38
画面第06节“06 · 一次排版,五种输出”:“所见即所印。”在代码行const vdt = buildDocument(content, config);下方,中文竖排指南的一页分成五页。Canvas(renderToCanvas(),像素级精确的位图)配一个放大镜,显示像素网格;HTML(renderToHtml(),可选中、随尺寸自适应)给每个块加上边框和<h1>、<p>、<figure>等标签;PDF(renderToPdf(),可付印 · PDF/UA · CMYK)的四块分色版滑动对准套印,随后出现裁切标记和色标条;EPUB 3(renderToEpub(),电子书 · 固定版式或流式版式)把这一页放进电子阅读器,标为“固定版式”,随后屏幕收窄到手机大小,文字重新排布,标签换成“流式版式”;书页(postext-folio,能翻页的三维书)把这一页展开成一个对页,一张书页绕着书脊翻过去。
旁白一次排版,五种输出:canvas、HTML、可付印的PDF、固定或流式的EPUB 3,还有一本三维的书。所见即所印。
- 1:52
画面第07节,节标题和两句话竖排在右缘:“07 · 为什么需要开放标准”“LaTeX 为印刷树立了标杆。”“如今,出版发生在每一块屏幕上。”两张卡片:LaTeX(1984)一侧逐条打叉:为印刷页面而设计;构建依赖某台机器的字体与宏包;编译、等待、重复;网页上没有编辑级排版。Postext(2026)一侧逐条打勾:一次排版,输出网页、付印级 PDF 与 EPUB 3;一个可移植的 .postext 文件承载一切;边输入边实时重排;任何浏览器即可运行 · 无需服务器 · MIT。Postext卡片亮起。
旁白LaTeX为印刷树立了标杆,但如今,出版发生在每一块屏幕上。
- 1:59
画面“07 · 一个文件,整本书”:“一个开放的出版标准,走到 LaTeX 未及之处。”一个.postext文件图标展开成五部分:preset.json(配置与设计)、chapters/*.md(每章一个 Markdown 文件)、fonts/*.woff2(字体文件本身)、images/ · SVG(所有图片,全部内嵌)和resources(表格、图片与图注)。底部写着“一个普通的 ZIP:开放、有文档、MIT 许可。任何工具都能读写它。”
旁白Postext是一个开放标准,一个可移植的文件,有文档、采用MIT许可,任何工具都能读写。
- 2:09
画面“案例 · 由真实引擎排版”:一面由中文竖排指南书页组成的墙在透视中后退,计数器升到59页。文字:“10 章、3 篇、竖排,排版仅需不到一秒。”“Postext 指南中文竖排版的每一页,都在浏览器中计算完成,由 postext 1.11.1 为本片生成。无一手工摆放。”随后出现标签:教材、杂志、文学版本、展览图录。
旁白所以,数百页的书,零点几秒就能排好。
- 2:17
画面片尾:Postext标志和标语“为网页而生的可编程排版引擎”,网址postext.dev,一行终端命令打出“$ pnpm add postext”,页脚为“开源 · MIT · GITHUB.COM/DRNACHIO/POSTEXT”。
旁白Postext开源项目,网址postext.dev。
章 1 · 为什么选择Postext
书刊排版, 为Web计算
印刷排版用了五个世纪学会怎样排一页,浏览器学会的是怎样布局一个界面。Postext把前者带给后者。
CSS提供响应式布局:flexbox、grid、多栏。但它不能让各栏齐底,不能让标题和它的段落排在一起,不能避免段首孤行和段末孤行,也不能把图浮动到下一栏的栏首。这些都是书刊排版上的决定,经过几个世纪的印刷实践才打磨成型。
Postext填补了这个空缺。给它语义化的Markdown和一个配置对象,它借助@chenglou/pretext (在新标签页中打开)测量文字,速度比DOM快300–600倍;然后计算出完整的页面几何——每一行、每个浮动体和每条题注——再通过HTML、Canvas或可直接付印的PDF后端渲染出来。
输入Markdown
:::part{number="I" title="基础"
palette="band=#2b4acb"}
:::
# 为什么需要Postext {lead="印刷排版
用了五个世纪……"}
Postext是一个**开源排版引擎**,
把印刷排版的手艺带到网页上,
如:ref{id="fig-flow"}所示。
:::callout{type="try"}
改一个词,页面就会重新排版。
:::输出页面
数字一览
- 文字测量比DOM快这么多倍,所以整本书随着输入实时重排
- 300–600×文字测量比DOM快这么多倍,所以整本书随着输入实时重排
- 种输出共用一个版面:HTML、Canvas、可直接付印的PDF和EPUB 3
- 4种输出共用一个版面:HTML、Canvas、可直接付印的PDF和EPUB 3
- 带标签的无障碍PDF输出,含书签和CMYK颜色
- PDF/UA带标签的无障碍PDF输出,含书签和CMYK颜色
- 台服务器:引擎完全在浏览器中运行,采用MIT许可证
- 0台服务器:引擎完全在浏览器中运行,采用MIT许可证
章 2 · 功能
印刷排版师早就懂得的事
页面需要、而CSS从未打算替你决定的六件事,由引擎计算,每次结果都一样。
- 2.1
Knuth-Plass两端对齐
与TeX相同的最优断行算法,配合TeX断词模式和孤行控制——排出疏密均匀的文字块,没有空白“河流”,这是CSS无法表达的。
在文档中阅读 - 2.2
资源与交叉引用
图、SVG图示和表按印刷浮动体的方式浮动到栏或页面的顶部或底部;按类型编号,:ref交叉引用始终保持同步。
在文档中阅读 - 2.3
表与题注
表的表体和表头可以分别设置排版样式,可以跨页拆分并重复表头;题注遵循你的配置,编号并放在所描述的资源旁边。
在文档中阅读 - 2.4
单色图示
按明度把SVG图示重新着色为同一种油墨的不同色调,让每幅插图都与你的设计一致,可直接用于专色印刷。
在文档中阅读 - 2.5
LaTeX数学公式
用LaTeX写行内公式和独立公式,由引擎测量并排版,与正文一起落在基线网格上。
在文档中阅读 - 2.6
Web、可直接付印的PDF与EPUB
一个排版引擎,四种输出。同一组计算好的页面可以渲染为HTML、Canvas或可直接付印的PDF,支持书签、CMYK颜色,以及带标签的无障碍PDF/UA输出;还可以生成EPUB 3电子书,按页保留版面或采用流式版式。
在文档中阅读
Postext指南的每一页——封面、目录、篇名页,全部都算上——都在你阅读时由Postext在你的浏览器中排出。
作品展示
真正的书,在你的浏览器中排版
一本教材、一本杂志、一部带注释的史诗、一本展览图录、一部120回的中文古典小说、一部阿拉伯文的《一千零一夜》、一部竖排的日文小说、一部十种语言的漫画。任选一本在沙盒中打开,改一条规则,看每一页随之重排。
- 开源排版引擎Postext每一页都在你的浏览器中计算得出
Postext指南
内置指南:四篇21章,外加封面

Feduchi《生物化学》 · 第1章
一栏半版式的生物化学教材:主栏靠近书脊,外侧一栏放图、核心概念和练习

《深空》
双栏天文杂志,带出血的章首页、标注框和引文框

《堂吉诃德》 · 古斯塔夫·多雷插图
一栏半版式的文学版本,页边有旁注,配多雷的插图

《物理学》(OpenStax)
一栏半版式的教材,含例题、自测、表格和公式

《失乐园》 · 古斯塔夫·多雷插图
弥尔顿十二卷长诗的注释本:维里蒂的注释排在页脚,配多雷的五十幅插图。仅有英文版

《西班牙绘画》
单栏展览图录:条目和评述与整页图版相对

《信号2020》
欧洲环境署的双栏杂志,带摄影章首页、标注框、引文框和数据面板

《一千零一夜》 · ألف ليلة وليلة
阿拉伯文《一千零一夜》全本,布拉克本原文:一本右翻的埃及古典书籍,每页版心围以双线边框,各夜以数词标题,配萨尼·莫尔克的水彩画。仅有阿拉伯文版

《红楼梦》 · 紅樓夢
一百二十回的中国古典小说,配1884年的插图:1792年的繁体中文本竖排、右翻,同一文本的简体中文本,以及乔利翻译的前56回英译本

《心》 · こころ
夏目漱石1914年的长篇小说,日文原文:仿岩波书店初版竖排、右翻,配漱石亲手设计的封面、衬页和扉页,他的三幅画作,难字旁标注振假名。仅有日文版

Pepper&Carrot · 小辣椒的生日
David Revoy的网络漫画第8集,十种语言版本:原作无字画格,对白框和文字由引擎依各语种的官方译本排出。日文版对白竖排,与阿拉伯文版一样从右向左阅读、从右侧翻开
章 3 · 工作流程
三步得到出版级版面
内容写在Markdown里,设计写在配置对象里,调用一个函数就得到页面。
- 3.1
编写语义化Markdown
用增强Markdown撰写内容:标题、列表、表格、数学公式、标注框,以及指向图的:ref交叉引用。不用操心版面,只管内容。
- 3.2
配置排版规则
在PostextConfig对象中定义页面尺寸、分栏、字体排印、标题设计、书眉和浮动体位置——也可以在沙盒中可视化地设计。
- 3.3
渲染为HTML、Canvas或PDF
调用buildDocument,得到完整的版面几何,再用HTML、Canvas或可直接付印的PDF后端渲染。
API
一个函数,完全掌控
用你的内容和一个配置对象调用buildDocument,得到完整的页面几何:用renderPage把任意一页绘制成图片,或用renderToPdf把整本书排成可直接付印的PDF。
import { buildDocument, renderPage } from "postext";
import { renderToPdf } from "postext-pdf";
const doc = buildDocument(
{ markdown },
{
page: { sizePreset: "21x28" },
layout: { layoutType: "double" },
bodyText: {
fontSize: { value: 12, unit: "pt" },
textAlign: "justify",
hyphenation: { enabled: true, locale: "en-us" },
},
}
);
// 每一页都绘制成图片…
const cover = renderPage(doc.pages[0], doc);
cover.toBlob((png) => save(png, "cover.png"));
// …或把整本书输出为可直接付印的PDF
// fontProvider:按字体族和字重提供TTF字节(参见文档)
const pdf = await renderToPdf(doc, { fontProvider });章 4 · 开放格式
一个文件,整本书
.postext文件包含了文档在任何机器上重新排版所需的一切:一种开放、可编辑、任何人都能采用的格式。
多数出版格式会把一个项目拆得七零八落。LaTeX的构建依赖某一台机器上安装的字体和宏包,主流排版软件的原生文件链接着存放在文件之外的图片和字体。项目一挪地方,就会缺东西。我们自己用LaTeX时就碰到过这些限制。
.postext就是一个普通的ZIP压缩包,任何人都能打开、阅读和编辑:一个JSON清单、每章一个Markdown文件,以及字体文件和图片本身。沙盒可以导出它,postext-port智能体技能可以写出它,postext/bundle可以在任何程序中打开它,重新排出同样的页面。这种格式有完整的文档,采用MIT许可证,任何工具都可以读写。
- 4.1
preset.json配置. 页面、网格、字体、标题和段落样式、颜色和书眉,都是可读的JSON。
- 4.2
chapters/<lang>/*.md章. 每章一个Markdown文件:这里有22章,共2种语言。
- 4.3
fonts/*.woff2字体. 字体文件本身,而不只是字体名称:Lora、Fraunces、Geist、Bricolage Grotesque和Geist Mono的23个文件。
- 4.4
preset.json › resources资源. 正文引用的31个图和表的题注、编号、位置和表格内容。
- 4.5
resources/*.svg图片. 图稿本身,SVG或位图,包括每种语言的版本:43个文件。
试试看
打开指南,得到它的页面
沙盒的第一个示例,即Postext指南,就是一个.postext文件。在浏览器中打开它,把每一页都变成图片:它的字体、图和表都来自这个文件本身。
下载指南postext-guide.postext · 1387 KBimport { openBundle, loadBundleFonts, registerBundleImages,
buildBundle, renderPageToCanvas } from "postext";
// 沙盒中的指南:配置、各章、字体和图片
const file = await fetch("postext-guide.postext").then((r) => r.blob());
const book = await openBundle(file, { locale: "en" });
await loadBundleFonts(book); // 它自带的字体
await registerBundleImages(book); // 它自带的图
// 每一章的每一页,都绘制成图片
for (const doc of buildBundle(book))
for (const page of doc.pages) {
const canvas = document.createElement("canvas");
renderPageToCanvas(page, doc, canvas, { scale: 0.5 });
document.body.append(canvas);
}// 快速开始
import { buildDocument, renderPage } from "postext";
import { renderToPdf } from "postext-pdf";
const doc = buildDocument({
markdown: "# Hello World\n\nYour content here.",
});
// 第一页,绘制在Canvas上
document.body.append(renderPage(doc.pages[0], doc));
// 整个文档输出为PDF
const pdf = await renderToPdf(doc, { fontProvider });