跳到主要内容
版本:0.4.1

页面布局

基础概念

要想使用 Typst 制作一个样式美观的 slides,正确理解 Typst 的页面模型是必须的,如果你不关心自定义页面样式,你可以选择跳过这部分,否则还是推荐看一遍这部分。

下面我们通过一个具体的例子来说明 Typst 的默认页面模型。

#let container = rect.with(height: 100%, width: 100%, inset: 0pt)
#let innerbox = rect.with(stroke: (dash: "dashed"))

#set text(size: 30pt)
#set page(
paper: "presentation-16-9",
header: container[#innerbox[Header]],
header-ascent: 30%,
footer: container[#innerbox[Footer]],
footer-descent: 30%,
)

#place(top + right)[Margin→]
#container[
#container[
#innerbox[Content]
]
]

image

我们需要区分以下概念:

  1. Model: Typst 拥有与 CSS Box Model 类似的模型,分为 Margin、Padding 和 Content,但其中 padding 并非 set page(..) 的属性,而是我们手动添加 #pad(..) 得到的。
  2. Margin: 页边距,分为上下左右四个方向,是 Typst 页面模型的核心,其他属性都会受到页边距的影响,尤其是 Header 和 Footer。Header 和 Footer 实际上是位于 Margin 内部。
  3. Header: Header 是页面顶部的内容,又分为 container 和 innerbox。我们可以注意到 header container 和 padding 的边缘并不贴合,而是也有一定的空隙,这个空隙实际上就是 header-ascent: 30%,而这里的百分比是相对于 margin-top 而言的。并且,我们注意到 header innerbox 实际上位于 header container 左下角,也即 innerbox 实际上默认有属性 #set align(left + bottom)
  4. Footer: Footer 是页面底部的内容,与 Header 类似,只不过方向相反。
  5. Place: place 函数可以实现绝对定位,在不影响父容器内其他元素的情况下,相对于父容器来定位,并且可以传入 alignmentdxdy,很适合用来放置一些修饰元素,例如 Logo 之类的图片。

因此,要将 Typst 应用到制作 slides 上,我们只需要设置

#set page(
margin: (x: 4em, y: 2em),
header: align(top)[Header],
footer: align(bottom)[Footer],
header-ascent: 0em,
footer-descent: 0em,
)

即可。但是我们还需要解决 header 如何占据整个页面宽度的问题,在这里我们使用 negative padding 实现,例如我们有

#let container = rect.with(stroke: (dash: "dashed"), height: 100%, width: 100%, inset: 0pt)
#let innerbox = rect.with(fill: rgb("#d0d0d0"))
#let margin = (x: 4em, y: 2em)

// negative padding for header and footer
#let negative-padding = pad.with(x: -margin.x, y: 0em)

#set text(size: 30pt)
#set page(
paper: "presentation-16-9",
margin: margin,
header: negative-padding[#container[#align(top)[#innerbox(width: 100%)[Header]]]],
header-ascent: 0em,
footer: negative-padding[#container[#align(bottom)[#innerbox(width: 100%)[Footer]]]],
footer-descent: 0em,
)

#place(top + right)[↑Margin→]
#container[
#container[
#innerbox[Content]
]
]

image

页面管理

由于 Typst 中使用 set page(..) 命令来修改页面参数,会导致创建一个新的页面,而不能修改当前页面,因此 Touying 选择维护一个 s.page-args 成员变量和一个 s.padding 成员变量,只在 Touying 自己创建新 slide 时才会自己应用这些参数,因此用户只需要关注 s.page-argss.padding 即可。

例如,上面的例子就可以改成

#(s.page-args += (
margin: (x: 4em, y: 2em),
header: align(top)[Header],
footer: align(bottom)[Footer],
header-ascent: 0em,
footer-descent: 0em,
))

Touying 会自动检测 margin.x 的值,并且判断如果 self.full-header == true,就会自动为 header 加入负填充。

同理,如果你对某个主题的 header 或 footer 样式不满意,你也可以通过

#(s.page-args.footer = [Custom Footer])

这样方式进行更换。不过需要注意的是,如果这样更换了页面参数,你需要将其放在 #let (slide, empty-slide) = utils.slides(s) 之前,否则就需要重新调用 #let (slide, empty-slide) = utils.slides(s)

警告

因此,你不应该自己使用 set page(..) 命令,而是应该修改 s 内部的 s.page-args 成员变量。

借助这种方式,我们也可以通过 s.page-args 实时查询当前页面的参数,这对一些需要获取页边距或当前页面背景颜色的函数很有用,例如 transparent-cover。这里就部分等价于 context get rule,而且实际上用起来会更方便。

为 slides 添加一个 Logo 是及其普遍,但是又及其多变的一个需求。其中的难点在于,所需要的 Logo 大小和位置往往因人而异。因此,Touying 的主题大部分都不包含 Logo 的配置选项。但借助本章节提到的页面布局的概念,我们知道可以在 header 或 footer 中使用 place 函数来放置 Logo 图片。

例如,我们决定给 metropolis 主题加入 GitHub 的图标,我们可以这样实现:

#import "@preview/touying:0.4.1": *
#import "@preview/octique:0.1.0": *

#let s = themes.metropolis.register(aspect-ratio: "16-9")
#(s.page-args.header = self => {
// display the original header
utils.call-or-display(self, s.page-args.header)
// place logo to top-right
place(top + right, dx: -0.5em, dy: 0.3em)[
#octique("mark-github", color: rgb("#fafafa"), width: 1.5em, height: 1.5em)
]
})
#let (init, slide) = utils.methods(s)
#show: init

#slide(title: [Title])[
Logo example.
]

image

其中 utils.call-or-display(self, body) 可以用于显示 body 为 content 或 body 为形如 self => content 形式的回调函数。

页面分栏

如果你需要将页面分为两栏或三栏,你可以使用 Touying slide 函数默认提供的 compose 功能,最简单的示例如下:

#slide[
First column.
][
Second column.
]

image

如果你需要更改分栏的方式,可以修改 slidecomposer 参数,其中默认的参数是 utils.side-by-side.with(columns: auto, gutter: 1em),如果我们要让左边那一栏占据剩余宽度,可以使用

#slide(composer: (1fr, auto))[
First column.
][
Second column.
]

image