如果你正在用 LuaLaTeX 排一本想让人一眼记住的文档，页面边饰就是最省力的装饰手段：不用另外找图片、不用处理版权和分辨率，只靠排版时现场算出来的花纹，就能让每一页的边缘都长出不一样的植物形态。Florilegium 正是为这个需求准备的工具，它把花卉边饰的生成过程写进文档本身，编译一次，每一页都会得到一幅独立又风格统一的边框图案。
Florilegium 是什么：给 LuaLaTeX 文档做页面边饰的工具
Florilegium 的核心思路很直接：边饰不是贴上去的图片，而是排版引擎在出 PDF 的过程中用 Lua 程序实时画出来的线条。花瓣、叶片和藤茎的形状都由参数曲线定义，程序在每一页上随机组合这些元素，于是同一份文档里没有两页是完全相同的，但整体气质保持一致。这种做法特别适合对排版质感有要求、又不想在正文里插入大量外部素材的作者。
它只面向 LuaLaTeX 文档用户。也就是说，你的文档需要用 LuaLaTeX 编译，边饰代码与文档源码放在同一个工程里，编译结果直接就是带边饰的 PDF，不需要后期再用别的工具拼贴或加框。对于已经习惯 LaTeX 写作流程的人来说，接入成本就是多引入一份示例代码并调好几个参数。
页面边饰能长成什么样：花卉构图与配色特点
Florilegium 的边饰走的是植物主题路线：花朵、叶子和蜿蜒的茎沿着页边生长，构图疏密有致，不会把版心挤得喘不过气。配色上采用代尔夫特蓝的单色系，蓝白搭配自带一种瓷器般的清爽感，放在学术文集、作品集、纪念册这类文档里都不抢正文的风头。
除了整页边框，它还有一个很适合章节开头的玩法：装饰性首字母。程序可以读取 OpenType 字体的字母轮廓，让藤蔓沿着字母的外形缠绕生长，章节第一个大写字母立刻就有了插画感。这个功能对书稿、散文集、展览图录的开篇效果提升很明显，而且同样不需要任何外部图片。
项目还提供生长过程的动态演示：同一套绘制逻辑可以按步骤重放，生成展示边饰如何一笔一笔长出来的动画。这对教学、分享和作品展示都很有用，读者能直观理解边饰不是一张贴图，而是一段有逻辑的生成过程。
版本选择：三种示例文档怎么选
项目提供的不是一个安装包，而是几份可以直接编译的示例文档，选哪份取决于你的页面是不是规整的固定版式。下表按使用场景做了区分，第一次上手建议先从手工构图跑通，再试自动生长。
| 示例文档 | 适合场景 | 注意点 |
|---|---|---|
| 手工构图示例 | 版式固定、页数不多、想精确控制每一处花纹位置 | 针对 A4 纸张和 68 毫米边距调校，换版式要重新调参数 |
| 自动生长示例 | 正文长短不一、希望边饰自动填满页面剩余空白 | 会读取页面布局和末页正文下方的空余区域，复杂模板需先验证 |
| 展示示例 | 只想先看效果、做演示或向别人介绍这个工具 | 以呈现绘制过程为主，不建议直接当作正式文档模板 |
三份示例共用同一套 Lua 绘制代码，区别只在布局策略。所以先跑通任意一份，再切换到另一份，学习成本很低，不需要重新理解整套机制。
安装与首次编译步骤
Florilegium 不需要传统意义上的安装，它的使用过程就是把代码放进你的 LaTeX 工程并编译。下面是第一次上手的完整顺序：
- 确认本机已经装好 TeX 发行版，并且可以用 LuaLaTeX 正常编译一份空白文档，这是后续一切的前提。
- 获取项目代码，把示例文档和 Lua 绘制代码放进你的文档工程目录，保持示例里的相对位置关系不变。
- 先编译手工构图示例，确认能顺利输出带边饰的 PDF，这一步验证的是环境和文件组织是否正确。
- 把你自己的正文内容逐步替换进示例文档，先换一两页验证，再整篇替换，避免一次性改动太多导致难以定位问题。
- 需要自动生长效果时，切换到自动生长示例，观察边饰如何填充正文下方的空白，再决定是否用在正式文档里。
- 想尝试装饰性首字母时，在章节开头调用项目提供的首字母命令，并确认所用字体能够提供可读取的字母轮廓。
- 最后通读整份 PDF，逐页检查边饰与正文、页码、页眉页脚之间有没有重叠或过挤的地方，再定稿输出。
页面边饰必改的 4 项设置
示例代码开箱就能跑，但直接用在自己的文档里通常有四处必须按实际情况调整，不改就容易出现边饰压字、风格不搭的问题。
- 随机种子：种子决定每一页花纹的具体形态。正式出版前要固定一个你满意的种子，否则每次编译结果都会变化，校对过的页面可能在下一次编译时面目全非。
- 纸张尺寸与边距：手工构图是按 A4 和 68 毫米边距调校的。如果你的文档是其他纸张或边距，必须同步改动这两个参数，否则边饰可能跑出页外或挤进版心。
- 配色与线条浓度：代尔夫特蓝是默认风格，但花纹密度和颜色深浅会影响阅读感受。正式文档建议先打一版样张，在纸上看一眼再定，不要只在屏幕上判断。
- 生长模式开关：手工构图与自动生长是两种布局策略，选错会出现边饰与正文空白不匹配的情况。版式固定选手工，页面长短变化大选自动生长，两者不要混用在同一份文档里。
使用注意事项
- 它只适用于 LuaLaTeX 编译链路，用其他排版引擎编译同一份源码是跑不出边饰的，换引擎前要先确认工具链。
- 自动生长模式依赖程序自身的布局规则，对复杂分栏、异形版式或 heavily 定制的模板，务必先拿样张验证，不要直接用于定稿。
- 装饰性首字母依赖 OpenType 字体的轮廓信息，换字体后要重新检查字母边缘是否完整，个别字体可能读不出理想的轮廓。
- 边饰是程序生成的，每次改动种子、边距或纸张尺寸都会改变全篇外观，定稿前请冻结这三项参数并保留最后一次编译的工程快照。
- 动态演示的生成需要走项目提供的额外构建流程，与静态 PDF 的编译流程不同，时间预算要分开算。
- 项目定位是实验性较强的排版工具，追求极致稳定或需要覆盖大量版式模板的出版流程，建议先在小册子或单章上试点，再决定是否全书采用。
适用人群与同类做法对比
Florilegium 最适合三类人：一是排版爱好者和 LaTeX 深度用户，想在文档里加入程序化装饰；二是做书稿、作品集、纪念册的作者，需要统一又有变化的页面风格；三是排版教学或演示的讲者，可以用生长动画讲清楚程序化绘图是怎么回事。
与直接插入边框图片的做法相比，它的优势是不依赖外部素材、每页都有变化、改参数就能全局换风格；代价是需要 LuaLaTeX 环境，而且版式自由度受程序规则约束。与通用装饰宏包相比，它的风格更集中、辨识度更高，但通用性和模板覆盖面不如成熟的装饰库广。如果你要的只是一个固定不变的简单线框，用图片或通用宏包反而更快；如果你要的是每页都不同、又浑然一体的植物边饰，Florilegium 就是更对路的选择。
关注公众号，回复 florilegium 获取下载链接
关注「软件教程管家」
回复软件名即取即下：网盘下载链接 + 提取码，一步直达，不用再跳转。
本站资源仅供个人学习交流，请勿用于商业用途。软件与资料版权归原作者所有；如有侵权，请通过公众号「软件教程管家」联系我们，我们将在 24 小时内下架处理。查看免责声明 ›
