页面设置和PDF渲染器

页面设置适用于整个打印格式:字体、颜色、页边距、信头、页码,以及将格式转换为 PDF 的引擎。要查看这些设置,请点击画布的空白区域,或按 Esc 直到没有选中任何内容。

适用于 Frappe v16 及更高版本。

排版

设置 作用
字体 来自 Google Fonts 的任意字体,例如 Inter、Roboto 或 Lora。开始输入即可搜索。默认使用系统字体。
字体大小 基础文本大小,以像素为单位。默认为 14。字段和区块可以设置自己的大小。

样式

设置 作用
标签 所有字段标签的颜色。
值 所有字段值的颜色。
标签后加冒号 在每个标签后添加冒号,如 Invoice No: ACC-SINV-0001。要从某个字段中移除冒号,请打开该字段的隐藏冒号。

颜色必须是十六进制代码,例如 #1f2937。

间距(毫米)

页边距设置页面四周的空间,即上、右、下、左,单位为毫米。默认每边为 15。如果纸张上有预印的信头,请将上边距调大。

文档

设置 作用
PDF 渲染器 生成 PDF 的引擎:Chromium 或 Typst(快速)。详见下文。
信头 与此格式一起保存的信头。保留为无信头则不打印信头。参见信头。
页码 打印“第 1 页,共 3 页”的位置:隐藏、左上、顶部居中、右上、左下、底部居中或右下。

自定义 CSS

适用于整个格式的 CSS。用它来编写同时作用于多个部分的规则:

.print-format-doc .section-label {
    color: #1f4e79;
    text-transform: uppercase;
    letter-spacing: 0.05em;
}

有用的类:

类 元素
.print-format-doc 整个文档
.section 一个区块
.section-label 区块标题
.field .label 字段的标签
.field .value 字段的值
.child-table .table th 表头单元格
.child-table .table td 表格单元格

注意:在此处使用了自定义 CSS 的格式无法使用 Typst 渲染器。

选择 PDF 渲染器

两种渲染器从同一设计生成相同的布局。区别在于速度以及它们能处理的内容。

Chromium Typst(快速)
速度 正常 快得多,适合批量打印
自定义 HTML 区块 支持 不支持,请使用 Typst 区块
自定义 CSS 支持 仅支持简单的字段样式
条形码 所有格式 仅支持二维码
来自网址的图片 支持 不支持,请上传图片
状态 默认 实验性

Chromium 是默认选项,能处理编辑器支持的所有内容。除非你需要更快的速度,否则请选择它。

Typst(快速)是实验性的。当格式使用了 Typst 无法渲染的内容时,它会被置灰。将鼠标悬停在PDF 渲染器旁边的信息图标上可查看列表。你可能会看到:

原因 处理方法
样式框中有自定义 CSS 移除页面的自定义 CSS。
HTML 区块 移除自定义 HTML区块,或将其改写为 Typst 区块。
不是二维码的条形码 将条形码的格式改为QR,或将其移除。
从网址加载的图片 改为上传图片,而不是使用 URL。
包含 HTML 内容的信头 使用图片信头。
包含 HTML 内容的信头页脚 使用图片页脚,或不用页脚。
带有自定义 CSS 的信头 移除信头中的 CSS。
不是十六进制代码的颜色 将列出的颜色改为诸如 #1f2937 之类的代码。
字段上的自定义 CSS 移除所列字段的自定义 CSS。Typst 在那里仅支持少数简单样式,例如粗体以及上边框或下边框。
字段模板区块 移除该区块。

如果在选中 Typst 时添加了 Typst 无法渲染的内容,编辑器会切换回 Chromium 并告知原因。

使用 Typst 时,还要检查 PDF 预览中的分页符和空字段,因为 Typst 尚未以相同方式处理所有布局设置。

  • 节、列和页面
  • 块
  • PDF 生成