
Typst 单文件可同时生成动画 HTML 演示与 PDF
来源标题:Animated HTML presentations from a single Typst file
Typst 新工具 typstage 能用同一个 .typ 文件同时输出带步骤动画的 HTML 演示和 PDF 讲义。每张幻灯片由 Typst 排版后以 SVG 写入 HTML,浏览器中的版式与 PDF 一致。官方称这不同于逐页静态 PDF 和布局交给浏览器的 HTML 导出,项目提供可直接在线查看的示例演示与讲义。
以下正文由 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 同步,内容未经改写;遇到排版缺失或需要图片、视频时请以原文为准。