跳到主要内容

常见问题

关于 Touying 的常见问题解答。

背景与颜色​

如何更改幻灯片的背景颜色？​

在主题设置中使用 config-page(fill: ...)：

#import "@preview/touying:0.6.3": *
#import themes.simple: *

#show: simple-theme.with(
  aspect-ratio: "16-9",
  config-page(fill: rgb("#f0f4f8")),
)

= Title

== First Slide

Hello, Touying!
Touying example output

对于单页幻灯片，也可以使用 config-common(fill: ...)：

#import "@preview/touying:0.6.3": *
#import themes.simple: *

#show: simple-theme.with(aspect-ratio: "16-9")

= Title

== First Slide

#slide(config: config-page(fill: gray))[
  Hello, Touying!
]
Touying example output

如何为幻灯片添加背景图片？​

将 image(...) 调用传递给 config-page(background: ...)：

#import "@preview/touying:0.6.3": *
#import themes.simple: *

#show: simple-theme.with(
  aspect-ratio: "16-9",
  config-page(
    background: rect(width: 100%, height: 100%, fill: gradient.linear(blue.lighten(80%), purple.lighten(80%))),
  ),
)

= Title

== Gradient Background Slide

Content appears over the background.
Touying example output

对于单页幻灯片，也可以使用 config-common(background: ...)：

#import "@preview/touying:0.6.3": *
#import themes.simple: *
#show: simple-theme.with(aspect-ratio: "16-9")

= Title

== Gradient Background Slide

#slide(config: config-page(background: rect(width: 100%, height: 100%, fill: gradient.linear(blue.lighten(80%), purple.lighten(80%)))))[
  Hello, Touying!
]
Touying example output

如果使用真实图片文件，可以这样写：

config-page(
  background: image("bg.png", width: 100%, height: 100%),
)

如何更改主题的主色？​

使用 config-colors(primary: ...)：

#import "@preview/touying:0.6.3": *
#import themes.metropolis: *

#show: metropolis-theme.with(
  aspect-ratio: "16-9",
  config-colors(primary: rgb("#d94f00")),
  config-info(title: [Custom Color], author: [Author]),
)

= Section

== Slide

The header now uses the custom primary color.
Touying example output

布局与分栏​

如何创建两栏布局？​

使用带 composer 参数的 slide 将内容分成多列：

#slide(composer: (1fr, 1fr))[
  == Left Column

  Some text on the left side.
][
  == Right Column

  Some text on the right side.
]
Touying example output

如需不等宽的列，可调整分数比例，例如 (2fr, 1fr)。

如何在幻灯片内使用 Typst 原生的 columns？​

可以直接在幻灯片内容中使用 Typst 内置的 columns 函数：

#slide[
  == Two Columns with `columns`

  #columns(2)[
    Left side content with some text to fill the column.

    #colbreak()

    Right side content on the other column.
  ]
]
Touying example output

如何将内容放置在绝对位置？​

使用 Typst 的 place 函数进行绝对定位：

#slide[
  Main slide content here.

  #place(bottom + right, dx: -1em, dy: -1em)[
    #rect(fill: blue.lighten(80%), inset: 0.5em)[Note]
  ]
]
Touying example output

如何让内容填满幻灯片的剩余高度或宽度？​

使用 utils.fit-to-height 或 utils.fit-to-width：

#slide[
  #utils.fit-to-width(1fr)[
    == This heading fills the slide width
  ]

  Some content below.
]
Touying example output

目录​

如何显示目录？​

用 components.adaptive-columns 包裹 Typst 内置的 outline：

#import "@preview/touying:0.6.3": *
#import themes.simple: *

#show: simple-theme.with(aspect-ratio: "16-9")

== Outline <touying:hidden>

#components.adaptive-columns(outline(title: none, indent: 1em))

= First Section

== Introduction

Hello, Touying!

= Second Section

== Details

More content here.
Touying example output

<touying:hidden> 标签可将目录幻灯片本身从目录中隐藏。

如何为目录中的章节添加编号？​

结合 numbly 包和 #set heading(numbering: ...)：

#import "@preview/touying:0.6.3": *
#import themes.simple: *
#import "@preview/numbly:0.1.0": numbly

#set heading(numbering: numbly("{1}.", default: "1.1"))

#show: simple-theme.with(aspect-ratio: "16-9")

== Outline <touying:hidden>

#components.adaptive-columns(outline(title: none, indent: 1em))

= First Section

== First Slide

= Second Section

== Second Slide
Touying example output

如何显示带进度高亮的目录？​

使用 components.progressive-outline 高亮当前章节：

#import "@preview/touying:0.6.3": *
#import themes.dewdrop: *

#show: dewdrop-theme.with(aspect-ratio: "16-9")

= First Section

== Outline

#components.progressive-outline()

= Second Section

== Slide
Touying example output

参考文献与引用​

如何将引用显示为脚注？​

将 bibliography(...) 值传递给 config-common(show-bibliography-as-footnote: ...)：

#import "@preview/touying:0.6.3": *
#import themes.simple: *

#let bib = bytes(
  "@book{knuth,
    title={The Art of Computer Programming},
    author={Donald E. Knuth},
    year={1968},
    publisher={Addison-Wesley},
  }",
)

#show: simple-theme.with(
  aspect-ratio: "16-9",
  config-common(show-bibliography-as-footnote: bibliography(bib)),
)

= Citations

== Footnote Example

This is a famous book. @knuth
Touying example output

如何在末尾添加参考文献幻灯片？​

使用 magic.bibliography(...) 显示参考文献幻灯片：

#import "@preview/touying:0.6.3": *
#import themes.simple: *

#let bib = bytes(
  "@book{knuth,
    title={The Art of Computer Programming},
    author={Donald E. Knuth},
    year={1968},
    publisher={Addison-Wesley},
  }",
)

#show: simple-theme.with(
  aspect-ratio: "16-9",
  config-common(show-bibliography-as-footnote: bibliography(bib)),
)

= Intro

== Slide

Some cited content. @knuth

== References

#magic.bibliography(title: none)
Touying example output

演讲者备注​

如何为幻灯片添加演讲者备注？​

在幻灯片的任意位置使用 #speaker-note[...] 函数：

#slide[
  == My Slide

  Visible content here.

  #speaker-note[
    - Remind the audience of the previous topic.
    - Emphasize the key takeaway.
    - Time check: should be at 10 min mark.
  ]
]
Touying example output

演讲者备注默认不会出现在幻灯片输出中。

如何在第二屏幕上显示演讲者备注？​

使用 config-common(show-notes-on-second-screen: right) 在幻灯片旁边显示备注：

#show: simple-theme.with(
  aspect-ratio: "16-9",
  config-common(show-notes-on-second-screen: right),
)

此功能与 pdfpc 和 pympress 等演示工具兼容。

如何将 Touying 与 pdfpc 配合使用？​

用 typst compile slides.typ 将幻灯片导出为 PDF，然后运行：

pdfpc slides.pdf

pdfpc 会自动读取 Touying 嵌入的备注元数据。详细信息请参阅 pdfpc 集成指南。

如何将 Touying 与 pympress 配合使用？​

导出为 PDF 后用 pympress 打开：

pympress slides.pdf

pympress 同样支持读取嵌入的演讲者备注。详细信息请参阅 pympress 集成指南。

幻灯片编号与附录​

如何在页脚显示幻灯片编号？​

使用 utils.slide-counter.display() 显示当前编号，utils.last-slide-number 显示总数：

#import "@preview/touying:0.6.3": *
#import themes.simple: *

#show: simple-theme.with(
  aspect-ratio: "16-9",
  config-page(
    footer: context [
      #utils.slide-counter.display() / #utils.last-slide-number
    ],
  ),
)

= Section

== First Slide

The footer shows the slide number.

== Second Slide

Still counting.
Touying example output

如何将幻灯片编号格式化为"1 / 10"？​

将 utils.slide-counter.display() 与 utils.last-slide-number 组合：

#import "@preview/touying:0.6.3": *
#import themes.default: *

#show: default-theme.with(
  aspect-ratio: "16-9",
  config-page(
    footer: context align(right)[
      Slide #utils.slide-counter.display() of #utils.last-slide-number
    ],
  ),
)

= Section

== First Slide

Custom numbering format in the footer.
Touying example output

如何将幻灯片标记为不计数？​

在标题上添加 <touying:unnumbered> 标签：

= Title Slide <touying:unnumbered>

== Welcome

This slide is not counted.

== Normal Slide

This slide is counted.
Touying example output

如何使用附录以不影响幻灯片总数？​

在主要内容之后使用 #show: appendix。此后的幻灯片不会递增幻灯片计数器：

#import "@preview/touying:0.6.3": *
#import themes.simple: *

#show: simple-theme.with(aspect-ratio: "16-9")

= Main Content

== Introduction

This is slide 1.

== Results

This is slide 2.

#show: appendix

= Appendix

== Extra Material

This slide is in the appendix and does not increment the main counter.
Touying example output

动画与动态内容​

如何使用 #pause 逐步展示内容？​

在 #slide 内的内容块之间放置 #pause：

#slide[
  First point.

  #pause

  Second point revealed on click.

  #pause

  Third point revealed on second click.
]
Touying example output

如何仅在特定子幻灯片上显示内容？​

使用 #only("...") 在特定子幻灯片上显示内容，或用 #uncover("...") 显示内容同时保留其占位空间：

#slide[
  #only("1")[Shown on subslide 1 only.]
  #only("2-")[Shown from subslide 2 onward.]
  #uncover("3-")[Revealed on subslide 3, space reserved before.]
]
Touying example output

为什么 #pause 在 context 表达式内不起作用？​

#pause 使用元数据注入机制，在 context { ... } 块内无法正常工作。请改用回调式 slide 来访问 self.subslide：

#slide(self => {
  let (uncover, only) = utils.methods(self)
  [First content.]
  linebreak()
  uncover("2-")[Revealed on subslide 2.]
  linebreak()
  only("3")[Only on subslide 3.]
})
Touying example output

如何在 CeTZ 绘图中使用 #pause？​

使用 touying-reducer 包裹 CeTZ canvas，使 Touying 能够为其添加动画：

#import "@preview/cetz:0.3.4"

#let cetz-canvas = touying-reducer.with(
  reduce: cetz.canvas,
  cover: cetz.draw.hide.with(bounds: true),
)

#slide[
  #cetz-canvas({
    import cetz.draw: *
    rect((0, 0), (4, 3))
    (pause,)
    circle((2, 1.5), radius: 1)
  })
]

如何在 Fletcher 图表中使用 #pause？​

使用 touying-reducer 包裹 Fletcher 图表：

#import "@preview/fletcher:0.5.7" as fletcher: diagram, node, edge

#let fletcher-diagram = touying-reducer.with(
  reduce: fletcher.diagram,
  cover: fletcher.hide,
)

#slide[
  #fletcher-diagram(
    node((0, 0), [A]),
    edge("->"),
    (pause,),
    node((1, 0), [B]),
  )
]

如何在子幻灯片间展示替换内容？​

使用 #alternatives 在不同版本的内容之间切换：

#slide[
  The answer is: #alternatives[42][*forty-two*][_the ultimate answer_].
]
Touying example output

如何开启讲义模式（禁用动画）？​

在主题设置中使用 config-common(handout: true)：

#show: simple-theme.with(
  aspect-ratio: "16-9",
  config-common(handout: true),
)

在讲义模式下，每张幻灯片只输出最后一个子幻灯片。

字体与文本​

如何更改演示文稿的字体？​

在主题设置之前或之后使用 #set text(...) 规则：

#import "@preview/touying:0.6.3": *
#import themes.metropolis: *

#show: metropolis-theme.with(
  aspect-ratio: "16-9",
  config-info(title: [Custom Font]),
)

#set text(font: "New Computer Modern", size: 22pt)

= Section

== Slide

Text now uses the custom font.
Touying example output

对于数学公式，还需设置数学字体：

#show math.equation: set text(font: "New Computer Modern Math")

如何全局更改字体大小？​

全局设置 text(size: ...)：

#show: simple-theme.with(aspect-ratio: "16-9")

#set text(size: 22pt)

大多数主题有自己的默认字号，你的 set 规则会覆盖它。

如何对段落文本进行两端对齐？​

使用 #set par(justify: true)：

#set par(justify: true)

#slide[
  == Justified Text

  #lorem(40)
]
Touying example output

标题与章节​

如何禁用自动章节幻灯片？​

设置 config-common(new-section-slide-fn: none)：

#import "@preview/touying:0.6.3": *
#import themes.metropolis: *

#show: metropolis-theme.with(
  aspect-ratio: "16-9",
  config-common(new-section-slide-fn: none),
  config-info(title: [No Auto Sections]),
)

= Section

== Slide

No automatic section slide was created for the `= Section` heading.
Touying example output

如何完全隐藏一张幻灯片？​

在幻灯片标题上添加 <touying:hidden> 标签：

== Visible Slide

This slide appears in the output.

== Hidden Slide <touying:hidden>

This slide is hidden and does not appear in the output or outline.

== Another Visible Slide

Back to normal.
Touying example output

如何将幻灯片从目录中排除但仍然显示？​

使用 <touying:unoutlined> 标签：

== Outline <touying:hidden>

#components.adaptive-columns(outline(title: none, indent: 1em))

= Section

== Normal Slide

Appears in the outline.

== Interstitial Slide <touying:unoutlined>

This slide shows but is not listed in the outline.

== Another Normal Slide

Also appears in the outline.
Touying example output

如何控制哪个标题级别创建新幻灯片？​

使用 config-common(slide-level: ...)，默认值因主题而异：

#import "@preview/touying:0.6.3": *
#import themes.simple: *

#show: simple-theme.with(
  aspect-ratio: "16-9",
  config-common(slide-level: 2),
)

= Section

This text is part of the section slide.

== Subsection Slide

Each `==` heading creates a new slide.

=== Sub-subheading

Sub-subheadings do not create new slides.
Touying example output

如何添加自定义页眉或页脚？​

使用 config-page(header: ..., footer: ...)：

#import "@preview/touying:0.6.3": *
#import themes.default: *

#show: default-theme.with(
  aspect-ratio: "16-9",
  config-page(
    header: text(gray)[My Custom Header],
    footer: context align(right, text(gray)[
      Slide #utils.slide-counter.display()
    ]),
  ),
)

= Section

== Slide

Slide with a custom header and footer.
Touying example output

其他问题​

如何设置演示文稿的标题、作者和日期？​

使用 config-info(...)：

#import "@preview/touying:0.6.3": *
#import themes.metropolis: *

#show: metropolis-theme.with(
  aspect-ratio: "16-9",
  config-info(
    title: [My Presentation],
    subtitle: [A Subtitle],
    author: [Jane Doe],
    date: datetime.today(),
    institution: [My University],
  ),
)

#title-slide()

= Introduction

== First Slide

Content here.
Touying example output

如何为单张幻灯片覆盖配置？​

使用 touying-set-config 包裹需要更改的内容：

#slide[
  Normal slide.
]

#touying-set-config(config-page(fill: rgb("#fff3cd")))[
  #slide[
    This slide has a yellow background.
  ]
]

#slide[
  Back to normal.
]
Touying example output

如何编译 Touying 演示文稿？​

Touying 是一个纯 Typst 包，无需额外的构建步骤：

typst compile slides.typ

编辑时进行实时预览：

typst watch slides.typ

或者使用 Typst Preview VS Code 扩展进行即时编辑器内预览。

如何创建多文件演示文稿？​

从主入口文件导入 lib.typ，并用 include 引入各章节：

// main.typ
#import "@preview/touying:0.6.3": *
#import themes.simple: *

#show: simple-theme.with(aspect-ratio: "16-9")

#include "intro.typ"
#include "methods.typ"
#include "results.typ"

每个被引入的文件正常使用标题即可，无需在每个文件中重复导入。

#show: simple-theme 和 #show: simple-theme.with(...) 有什么区别？​

  • #show: simple-theme 使用所有默认值。
  • #show: simple-theme.with(...) 允许你传入配置参数：
// 最简形式——使用默认值
#show: simple-theme

// 带配置
#show: simple-theme.with(
  aspect-ratio: "16-9",
  config-info(title: [My Talk]),
  config-colors(primary: blue),
)

如何更改宽高比？​

将 aspect-ratio: 传递给主题函数。有效值为 "16-9"（大多数主题的默认值）和 "4-3"：

#show: simple-theme.with(aspect-ratio: "4-3")

如何在页眉或页脚中显示当前章节名称？​

使用 utils.display-current-heading(...) 或 utils.display-current-short-heading(...)：

#import "@preview/touying:0.6.3": *
#import themes.default: *

#show: default-theme.with(
  aspect-ratio: "16-9",
  config-page(
    header: context text(gray)[
      #utils.display-current-heading(level: 1)
    ],
  ),
)

= My Section

== Slide

The header shows the current section name.
Touying example output

如何将 Touying 与 pinit 包配合使用？​

正常导入两个包并在幻灯片中使用 #pin/#pinit-highlight：

#import "@preview/touying:0.6.3": *
#import "@preview/pinit:0.2.2": *
#import themes.simple: *

#show: simple-theme.with(aspect-ratio: "16-9")

#slide[
  A #pin(1)key term#pin(2) to highlight.

  #pinit-highlight(1, 2)
]

如需带动画的 pin 展示效果，请使用回调式 slide，以便 #pause 与 pinit 正确交互。

如何在子幻灯片间冻结计数器（图表、公式）？​

使用 config-common(frozen-counters: true) 防止计数器在子幻灯片之间递增：

#show: simple-theme.with(
  config-common(frozen-counters: true),
)