跳到主要内容

Postext文档

目录

共三篇:Postext是什么、如何构建;它自动完成的排版工艺;以及配合它使用的工具。

篇 I · 基础

  1. 1简介阅读时间: 5分钟Postext是什么,为什么要做它,它解决什么问题
  2. 2架构阅读时间: 20分钟Postext排版引擎的技术架构:核心概念、文档树、垂直韵律、后端与性能
  3. 2.1排版流水线阅读时间: 19分钟放置遍及其轮次:引擎怎样放置行、浮动体、注释和栏,并反复运行直到版面稳定

篇 II · 工艺

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

篇 III · 实践

  1. 14参与贡献阅读时间: 4分钟如何加入Postext社区并为项目做贡献
  2. 15沙盒阅读时间: 23分钟沙盒的界面:活动栏,正文、书库、章节、资源和字体面板,以及手机上的布局
  3. 15.1版面设计与检查面板阅读时间: 27分钟版面设计面板的分组、页面、搜索与摘要,以及检查面板中按类别分组的实时警告
  4. 15.2模板页阅读时间: 15分钟在页面上直接编辑页面模板和框;连接线与形状;引线、指示线与图例;网格、模块及模块库;重组框;重叠检查与字形页签;用样式库整理框样式;在书的每个版本中检查模板页;把书中的文字移进Markdown;一键修正框
  5. 15.3预览阅读时间: 10分钟主视口中的Canvas、PDF、书页、HTML、EPUB 3和SCORM标签页:各自显示什么,能做什么
  6. 15.4书、Word文件与保存阅读时间: 30分钟书与章、编辑漫画页、导入和导出Word文档,以及沙盒怎样保存、导出和导入你的作品
  7. 15.5智能体、嵌入与预设阅读时间: 9分钟AI智能体可用的WebMCP工具;怎样把PostextSandbox组件嵌入你自己的应用,它有哪些属性、需要哪些CSS;以及预设文件包的格式
  8. 16模板页做的书阅读时间: 18分钟以一本由模板页组成的小学课本为例,在沙盒里走一遍全过程:做页面模板,用Markdown填入文字,给地图加标注,翻译这一页,处理放不下的文字,在页面上和正文里选择内容,再用连接线画一棵树,在地图上加带指示线和图例的注释,排一页照片卡片,并为一套书建一个模块库
  9. 17迁移到模板页阅读时间: 11分钟有些书把各页的文字存放在标题样式里。本页讲怎样把这样的书迁移到页面模板和Markdown:可以用沙盒的助手“把文字移到Markdown”,也可以手工迁移;说明迁移之后要检查什么;还讲怎样用连接线代替画在图片里的线,用网格和模块代替一个个单独画出的框
  10. 18InDesign阅读时间: 8分钟把InDesign书籍带进Postext的两种方式:照搬文档内容的IDML导入器,和推断版式规则的智能体技能;各自适合什么情况,以及IDML导出器怎样把书交回InDesign
  11. 19技能阅读时间: 7分钟在Claude Code、Codex或任意智能体中安装postext-port技能,让它把PDF、Word、PowerPoint、EPUB、InDesign或HTML源文件转换成沿用原版面的Postext项目
  12. 20命令行阅读时间: 10分钟适用于macOS、Linux和Windows的单个独立可执行文件。它能把.postext图书、图书文件夹或零散的Markdown文件转成PDF、HTML、EPUB、页面图像和Word文档,还能打包文件包、检查图书,并为脚本和智能体输出JSON,还可通过Python和Rust包在代码中使用
  13. 21WebMCP阅读时间: 9分钟浏览器里的AI智能体借助沙盒的64个WebMCP工具能做什么:查看页面、修改任何设置、编辑文字、添加图片、表格和字体、运行检查、导出文件,以及每个工具怎样调用,附真实的参数和回答