返回资讯中心
外部精选
软件工程
#开发者实时流

Typst 单文件可同时生成动画 HTML 演示与 PDF

来源标题:Animated HTML presentations from a single Typst file

Typst 新工具 typstage 能用同一个 .typ 文件同时输出带步骤动画的 HTML 演示和 PDF 讲义。每张幻灯片由 Typst 排版后以 SVG 写入 HTML,浏览器中的版式与 PDF 一致。官方称这不同于逐页静态 PDF 和布局交给浏览器的 HTML 导出,项目提供可直接在线查看的示例演示与讲义。

Hacker News 最新matesz2026/11/15 · 2 天前30 分钟阅读

以下正文由 AI 翻译自 Hacker News 最新(原文版权归原站所有),可能存在偏差,重要内容请以原文为准。

从一个 Typst 文件生成带动画的 HTML 演示文稿。

同一份源文件,既能生成带动画的 HTML 演讲,也能生成幻灯集和讲义的 PDF。

typst compile deck.typ deck.html --format html --features html # 带动画的演讲 typst compile deck.typ deck.pdf # 幻灯片和讲义 typst watch deck.typ deck.html --format html --features html # 在 :3000 上实时预览

无需安装任何东西即可试用:示例演示文稿和讲义,既有浏览器演示版,也有可打印的 PDF。它们是按照人们可能真正会做的演讲来写的,而不是功能演示——一节学校课程、一晚的滚动部署、John Snow 的霍乱地图、一个分四波讲完的费米问题。每一份都附有源码链接。

从 Typst 到演示文稿的常规做法是生成 PDF,每一步占一页,什么都不会动。Typst 自带的 HTML 导出则走另一条路,把排版交给浏览器,而这恰恰丢掉了 Typst 最擅长的事情。

typstage 走的是第三条路。每一张幻灯片都由 Typst 排版,并以 SVG 写入 HTML,因此浏览器中呈现的就是 Typst 排好的样子,精确到位,与 PDF 显示的布局完全一致。只有在这之后,才会有东西动起来:该动的地方在源码中声明,一个小的运行时用 Web Animations API 让它动起来。

下面这个文件按原样即可用上面两条命令编译。

#import "@preview/typstage:0.2.0": * #show: presentation.with( title: [勾股定理], author: [A. Schulz], transition: "slide", ) = 重新排列证明 == 正方形中的四个三角形 #side-by-side( card(title: [准备工作])[ 该三角形的四个副本正好放入一个边长为 $a + b$ 的正方形中。 stagger[

  • 内部正方形的边长为 $c$
  • 重新排列后,同样的四个副本留下 $a^2 + b^2$ ) #v(1fr) #callout(title: [记住])[ 剩余的面积不会改变。改变的只是它的形状。 == 命题 #align(center, morph(<pythagoras>, $a^2 + b^2$)) == #place(center + horizon, morph(<pythagoras>, text(size: 2.6em)[$a^2 + b^2 = c^2$]))

= 开启一张章节幻灯片,== 开启一张幻灯片;一个后面什么都没有的裸 == 是一张没有标题栏、也没有页眉的幻灯片。stagger 逐条显示列表项,而在两张幻灯片上使用同一个 morph(<pythagoras>) 会让公式从一处飞到另一处,途中逐渐变大。任何东西都不带步骤编号:at 默认是 auto,表示下一个空闲步骤,因此连续的显示会自动编号。名称可以是标签或字符串:morph(<pythagoras>, …) 和 morph("pythagoras", …) 是一回事。

对于一张只需逐步展开的幻灯片,完全不需要包装:

== 一张逐步展开的幻灯片 先是这个。 #pause 然后是那个。

slide-level: 改变切分层级:设置 slide-level: 3 后,= 和 == 都是章节幻灯片,=== 才是幻灯片,因此一个学期的内容可以放进一个文件,过渡幻灯片会自动分出来。info().levels 和 info().outline 会把结构交还给你,供你制作自己的议程。

内置的 contents() 会把该结构变成一张带链接的议程,在 HTML 和 PDF 中都是如此。用 layout: "1x2" 实现均衡分栏,或用 layout: "1x2-fill" 先填满第一栏再流入第二栏。较长的议程可以用包含式的、从 1 开始的 from: 和 to: 范围拆分到多张幻灯片上:

== 目录 1 #contents(layout: "1x2-fill", from: 1, to: 8) == 目录 2 #contents(layout: "1x2-fill", from: 9, to: 16)

number 和 title 参数会替换完整的编号单元格和链接标题单元格,因此可以整体控制它们的排版和外观。使用 number: none 可以完全去掉编号单元格。

章节幻灯片标题默认不带编号:presentation.with(section-numbering: "1.") 会给它加上编号,传入一个函数则可以自定义前缀。

每张章节幻灯片都带有一个返回目录的链接;presentation.with(section-back: [返回议程]) 可以换一种措辞,section-back: none 会去掉它,传入一个函数则会收到目录幻灯片的位置和编号,以及它所在的章节。

幻灯片也可以作为参数传入,presentation(title-slide(…), section([…]), slide([标题])[…]),适用于生成而非手写的演示文稿。

无需安装。导入它,Typst 会在首次编译时自动获取该包:

#import "@preview/typstage:0.2.0": *

如果要修改这个包本身,把它克隆到本地包路径下。放在那里的克隆会优先于已发布的版本被找到,因此同样一个

git clone https://github.com/Loewe1000/typstage
~/Library/Application\ Support/typst/packages/preview/typstage/0.2.0

在 Linux 上该路径是 ~/.local/share/typst/packages/preview/…,在 Windows 上是 %APPDATA%\typst\packages\preview\…。构建脚本对它自己也做同样的事,因此 build-site.sh 完全不需要克隆。

需要 Typst 0.15。HTML 目标还需要 --features html;除此之外别无他求,不需要 Node,不需要打包工具。

所有这些都在手册(docs/content.typ,见下文)中有完整的文档和示例。

十二种幻灯片过渡(fade、slide、push、cover、uncover、zoom、blur、iris、wipe、flip、cube、none),可为整个演示文稿或单张幻灯片设置,每一种在向后翻页时都真正反向播放。入场动画(enter:)也是如此:向后翻页会再次撤销入场。十一种入场动画,其中一种不是淡入:enter: "draw" 会描绘元素上每一条描边路径,因此一个电路或一对坐标轴会逐线生成。文本仍用淡入——Typst 把字形排成填充形状,没有可供描边游走的轮廓——而对于无法描绘任何东西的元素,会明确提示,而不是悄悄淡入。easing: 指定元素运动所遵循的曲线,取自 Web Animations API 外加若干具名曲线;未知的名称会报错,而不是静默使用默认值。

#show: presentation.with(theme: themes.night) #show: presentation.with(theme: themes.lesson + (accent: blue)) #show: presentation.with(theme: themes.lesson, palette: palettes.dark)

主题是一个字典:颜色、字体、字号,以及少数几项各自对应的一个词

(原文较长,此处译出前 6000 字,完整内容请点「打开原文」。)

正文由 探How 从来源站点 RSS 同步,内容未经改写;遇到排版缺失或需要图片、视频时请以原文为准。

打开原文
去社区讨论 →