Postext文档
目录
共三篇:Postext是什么、如何构建;它自动完成的排版工艺;以及配合它使用的工具。
篇 I · 基础
篇 II · 工艺
- 3配置阅读时间: 3分钟什么是Postext配置,以及参考的二十个页面各讲哪一组设置
- 3.1页面与版式阅读时间: 22分钟页面尺寸、页边距和基线网格,页码的编排,以及分栏和栏间距
- 3.2页眉与页脚阅读时间: 21分钟页眉和页脚里印什么、放在哪里:带占位符的文字、线条、方框、图像和矢量路径,可以按奇偶页分别设置,每个元素的位置也可以单独指定
- 3.3正文阅读时间: 20分钟正文的字体排印:字体、字号与行距、颜色、缩进、引用块、诗歌、制表位和首字下沉
- 3.4断词与语言阅读时间: 17分钟断词模式与例外词、非两端对齐文字的断词、文档语言及其数字和文字方向,以及Postext能排哪些文字
- 3.5标题阅读时间: 22分钟标题的默认值、各级覆盖、标题前分页、通栏的章首页,以及以文字书写的编号
- 3.6孤行与各栏齐底阅读时间: 15分钟换栏时不让行和块被拆散的规则,以及让各栏底部平齐的各种调整手段
- 3.7列表与数学公式阅读时间: 12分钟无序列表和有序列表的标记、缩进与嵌套,任务列表,以及数学公式的大小、颜色和间距
- 3.8注释与引用阅读时间: 19分钟脚注、行号、交叉引用、文献引用、目录和书末索引
- 3.9东亚排版阅读时间: 24分钟cjk设置:中文、日文和韩文的断行、标点宽度、间距、字符网格、注音与各种标记
- 3.10资源与表格阅读时间: 31分钟资源类型及其编号,表格样式与题注样式,单色图示和印在纸上的视频
- 3.11样式与篇阅读时间: 34分钟段落、行内标签、高亮、代码清单和标题的命名样式,以及每一篇开头的篇名页
- 3.12标注框阅读时间: 19分钟怎样为:::callout标注框定义命名样式:边框、底色、色条、标题、图标、框外标记和标签页签;逐角设定圆角、逐边设定边框、与框相连的页签等框形;怎样给命题编号;框内文字怎样排;框跨页拆分时怎样处理;怎样在框内绘制设计
- 3.13练习设置阅读时间: 12分钟练习样式(exerciseStyles)和全书的练习设置(exercises):题号的样子、题目要求的字体、选项的序号和勾选记号、填空处、判断题的答案、连线、词库、书写区、方格、竖式除法、难度记号、图标、答案的颜色、答案印在哪里、教师用书和屏幕版本
- 3.14漫画设置阅读时间: 6分钟comics属性的各项设置:漫画页的画框和格间距、分格样式、嵌字、对白框样式和角色表
- 3.15模板页设置阅读时间: 10分钟模板页所用的页面模板:框、组、重复一组框的网格、模块、装饰与连接线、继承与奇偶页变体、图片锚点上的标注样式,以及模板可能给出的警告
- 3.16字体、颜色与输出阅读时间: 29分钟单位、颜色和调色板,自定义字体,HTML阅读器,PDF与印刷输出,Folio书页查看器,以及调试用的叠加层
- 3.17以编程方式使用阅读时间: 22分钟用代码调用Postext:buildDocument及其报告的警告、默认值、字体、缓存,以及Web Worker
- 3.18PDF文件阅读时间: 25分钟用代码调用postext-pdf:安装、API、浏览器和Node中的字体提供函数、中日韩字体、资源字节、竖排文字、工作线程和可付印的文件
- 3.19HTML、3D书本、EPUB、SCORM阅读时间: 12分钟把排好的书放进网页,用postext-folio做成3D书本,用postext-epub做成固定版式或流式版式的EPUB 3,用postext-scorm做成供LMS使用的SCORM包
- 3.20.postext文件包阅读时间: 20分钟怎样用代码打开、排版、渲染和创建.postext文件,怎样制作双语文件包,旧版本写出的文件怎样读取,以及底层API
- 4断词与两端对齐阅读时间: 29分钟Postext怎样用Knuth-Plass算法断行、把文字排成两端对齐并控制词间距
- 5文档格式阅读时间: 11分钟Postext能解析哪些Markdown写法(前置元数据、标题、列表和代码块),哪些写法会被忽略,以及写源文档时要遵守的规则
- 5.1指令阅读时间: 24分钟:::指令一览:容器、分栏、换用纸张、分页、编号、留白、诗歌、目录与索引、换行,以及漫画页的标记
- 5.2行内格式与数学公式阅读时间: 21分钟写在一行之内的标记:强调、链接、行内标签、小型大写字母、制表符、竖排文字、中日文专用标记、文字方向,以及LaTeX公式
- 5.3注释与引用阅读时间: 10分钟脚注、交叉引用与锚点、引用与参考文献,以及用来编制书末索引的标记
- 5.4图片与表格阅读时间: 29分钟正文中的资源:引用与嵌入、编号、位置与浮动体落在哪里、文字绕排、位图尺寸、安全区、漫画锚点和题注中的符号
- 5.5视频阅读时间: 6分钟视频资源:YouTube、Vimeo、你自己的文件和HLS流,各种输出显示什么,视频的字段、封面与网址,播放器,VDT与资源包,以及在Folio页面上播放的视频
- 6中文排版阅读时间: 23分钟Postext怎样排横排和竖排的中文:地区、断行、标点宽度、字间两端对齐、字符网格、右翻书、纵中横、着重号等标记、注音、双行夹注、中文数字和字体
- 7阿拉伯文排版阅读时间: 21分钟Postext如何排阿拉伯文:文字方向与双向算法、右侧装订、不拆开也不加字距的连写词、卡希达两端对齐、元音符号、强调、数字与编号样式、序数词、脚注、古典诗歌、目录、索引、引用和字体
- 8日文排版阅读时间: 25分钟Postext如何排日文横排与竖排:日本地区、禁则、约物间距、段首括号、竖排字形、振假名、傍点与傍线、汉文训读、编号、行取り标题、注释、五十音索引、引用、字体以及青空文库源文本
- 9漫画阅读时间: 26分钟Postext怎样用Markdown排漫画和日本漫画:用切分树分格的漫画页;围绕安全区裁切的分格画面;由脚本生成的嵌字(对白、心声、耳语、喊叫、广播、旁白框、拟声词);对白框样式;画面上的说话人锚点;正文中的漫画条;双页跨页;从右到左阅读和竖排嵌字;翻译;以及Canvas、PDF、HTML和EPUB输出
- 10乐谱记谱阅读时间: 12 分钟Postext 如何在书中排乐谱:以 ABC、MusicXML、MEI 或 Humdrum 文本写成的记谱,按栏宽刻制并分成可跨栏跨页延续的谱行;作为资源编号的谱例;乐谱样式;各种输出;以及音乐出版社如何把乐谱带进来
- 11练习阅读时间: 16分钟Postext怎样排教科书和练习册里的练习::::exercise块,从选择题到竖式除法的十二种题型,写在Markdown里的答案,题号,紧跟在题后、倒印、放在章末或书末的答案,教师用书,检查项,在HTML和EPUB中可以直接作答的练习,测验用的作答限制,以及在SCORM包中把结果发送给LMS
- 12模板页阅读时间: 28分钟怎样用Markdown写模板页:以四个冒号开头的页面块指明所用的模板;框和slot属性把内容分到模板的各个框;重复的槽位与模块;内容与模板对不上或盖住另一个框时会给出警告
- 12.1带标注的插图阅读时间: 6分钟在图上放文字的插图:资源锚点上的标注,插图自己的替代文本、题注和注释,标注的排法,离开所指之点、用引线连回的标注,图例和行内符号,以及标注的警告
- 13特种油墨与模切阅读时间: 14 分钟第五色油墨,以及作为带工艺的专色来定义的金属油墨、荧光油墨、烫金、不透明白和上光油;模切:穿过一张或多张纸页的孔、圆角和异形书,PDF中的模切线,印前检查,以及各种视图如何显示它们
篇 III · 实践
- 14参与贡献阅读时间: 4分钟如何加入Postext社区并为项目做贡献
- 15沙盒阅读时间: 23分钟沙盒的界面:活动栏,正文、书库、章节、资源和字体面板,以及手机上的布局
- 15.1版面设计与检查面板阅读时间: 27分钟版面设计面板的分组、页面、搜索与摘要,以及检查面板中按类别分组的实时警告
- 15.2模板页阅读时间: 15分钟在页面上直接编辑页面模板和框;连接线与形状;引线、指示线与图例;网格、模块及模块库;重组框;重叠检查与字形页签;用样式库整理框样式;在书的每个版本中检查模板页;把书中的文字移进Markdown;一键修正框
- 15.3预览阅读时间: 10分钟主视口中的Canvas、PDF、书页、HTML、EPUB 3和SCORM标签页:各自显示什么,能做什么
- 15.4书、Word文件与保存阅读时间: 30分钟书与章、编辑漫画页、导入和导出Word文档,以及沙盒怎样保存、导出和导入你的作品
- 15.5智能体、嵌入与预设阅读时间: 9分钟AI智能体可用的WebMCP工具;怎样把PostextSandbox组件嵌入你自己的应用,它有哪些属性、需要哪些CSS;以及预设文件包的格式
- 16模板页做的书阅读时间: 18分钟以一本由模板页组成的小学课本为例,在沙盒里走一遍全过程:做页面模板,用Markdown填入文字,给地图加标注,翻译这一页,处理放不下的文字,在页面上和正文里选择内容,再用连接线画一棵树,在地图上加带指示线和图例的注释,排一页照片卡片,并为一套书建一个模块库
- 17迁移到模板页阅读时间: 11分钟有些书把各页的文字存放在标题样式里。本页讲怎样把这样的书迁移到页面模板和Markdown:可以用沙盒的助手“把文字移到Markdown”,也可以手工迁移;说明迁移之后要检查什么;还讲怎样用连接线代替画在图片里的线,用网格和模块代替一个个单独画出的框
- 18InDesign阅读时间: 8分钟把InDesign书籍带进Postext的两种方式:照搬文档内容的IDML导入器,和推断版式规则的智能体技能;各自适合什么情况,以及IDML导出器怎样把书交回InDesign
- 19技能阅读时间: 7分钟在Claude Code、Codex或任意智能体中安装postext-port技能,让它把PDF、Word、PowerPoint、EPUB、InDesign或HTML源文件转换成沿用原版面的Postext项目
- 20命令行阅读时间: 10分钟适用于macOS、Linux和Windows的单个独立可执行文件。它能把.postext图书、图书文件夹或零散的Markdown文件转成PDF、HTML、EPUB、页面图像和Word文档,还能打包文件包、检查图书,并为脚本和智能体输出JSON,还可通过Python和Rust包在代码中使用
- 21WebMCP阅读时间: 9分钟浏览器里的AI智能体借助沙盒的64个WebMCP工具能做什么:查看页面、修改任何设置、编辑文字、添加图片、表格和字体、运行检查、导出文件,以及每个工具怎样调用,附真实的参数和回答