/
本页目录
页面格式
.pageformat 文档 ↗ 函数用于配置页面格式。它的所有参数都是可选的，如果留空不设置，它们会根据文档类型将默认值委托给底层渲染器。
对 .pageformat 的多次调用会相互叠加，后一次的调用会覆盖先前的调用。
| 参数 | 说明 | 接受值 | 支持的文档 |
|---|---|---|---|
side | 将格式限制为仅左侧（verso）或右侧（recto）页面。请参阅限定范围格式化。 | left、right | paged |
pages | 通过从 1 开始的包含性范围，将格式限制在特定页面。请参阅限定范围格式化。可与 side 组合。 | 范围，例如 2..5 | paged |
size | 纸张格式的名称。 | A0..A10、B0..B5、letter、legal、ledger | paged、slides |
width | 页面宽度。如果同时设置了 size，此值会覆盖其宽度。 | Size，例如 300px、15cm、5.8in | plain、paged、slides、docs |
height | 页面高度。如果同时设置了 size，此值会覆盖其高度。 | Size，例如 300px、15cm、5.8in | paged、slides |
orientation | 是否应交换纸张格式（size）的宽与高。对于 plain 和 paged 文档默认为 portrait，对于 slides 默认为 landscape。 | portrait、landscape | paged、slides |
margin | 页面边框与内容区域之间的空白。 | Sizes，例如 1cm、15mm 30px、2in 1in 3in 2in | plain、paged、slides |
bordertop、borderright、borderbottom、borderleft | 内容区域每一侧边框的粗细。 | Size | plain、paged、slides |
bordercolor | 内容区域周围边框的颜色。 | Color | plain、paged、slides |
background | 每个页面的背景颜色。 | Color | plain、paged、slides、docs |
columns | 每个页面的栏数。如果设置为 2 或更高，文档将拥有多栏布局 。 | 正整数 | plain、paged、slides |
alignment | 水平内容与文本对齐。 | start（在 slides 中为默认）、center、end、justify（在 plain 和 paged 中为默认） | plain、paged、slides、docs |
内容区域
每个页面由一个显示主要内容的内容区域，以及一个可能承载页面页边距内容 （例如页码 ）的空白页边距区域组成。
页边距
margin 参数影响页边距区域的大小，从而缩小内容区域的面积。
示例 1
.pageformat margin:{4cm}
边框
bordertop、borderright、borderbottom、borderleft 与 bordercolor 参数允许在 paged 与 slides 文档中，对每页内容区域周围的边框进行自定义。
- 如果你至少指定了一侧，边框就会应用到指定的那些侧。如果你没有指定颜色，则使用默认的文本前景色。
- 如果你没有指定任何一侧，但指定了颜色，边框就会应用到所有侧，并使用默认粗细。
示例 2
.pageformat bordertop:{1px} borderbottom:{4px}
限定范围格式化
在 paged 文档中，side 与 pages 参数将一种格式限制在特定页面。
按页侧格式化
side 参数将一种格式限制为仅左侧（verso）或右侧（recto）页面。例如，这对于书籍风格布局中的镜像页边距非常有用。
示例 3
.pageformat size:{A4}
.pageformat side:{left} margin:{2cm 3cm 2cm 1cm}
.pageformat side:{right} margin:{2cm 1cm 2cm 3cm}
按范围格式化
pages 参数将一种格式限制在一个从 1 开始的、包含性的页面索引范围内。例如，这对于为文档的前几页应用不同的样式很有用。
.pageformat pages:{2..5} margin:{3cm}side 与 pages 也可以组合，以在范围内针对特定的页侧：
.pageformat side:{left} pages:{1..3} bordercolor:{green}