Touying：重新定义幻灯片创作的Typst开源工具

2026-03-17 02:19:13作者：咎竹峻Karen

一、项目核心价值：为何选择Touying构建演示文稿？

在数字演示领域，创作者常面临"设计与效率不可兼得"的困境——专业排版软件操作复杂，而快速工具又难以实现个性化需求。Touying作为基于Typst的幻灯片创作包，通过标记式语法+模块化设计的创新组合，为这一矛盾提供了优雅的解决方案。

📌 核心概念：Typst包管理机制
类比：如同乐高积木系统，Touying将幻灯片功能拆解为独立模块（布局引擎、主题系统、动画模块等），用户可按需组合，既保持创作灵活性又确保结构一致性。技术定义上，这是通过Typst的#import语法实现的模块化组件系统，核心代码位于「模块路径」：src/core/。

项目适用场景分析

应用场景	Touying优势	传统工具局限
学术报告	原生支持LaTeX公式与代码高亮	PowerPoint公式编辑繁琐
技术演示	代码块与可视化图表无缝集成	Keynote缺乏编程友好支持
快速原型	纯文本编辑，版本控制友好	图形化工具难以追踪修改历史
企业宣讲	主题统一与品牌定制能力	通用模板修改成本高

新手常见问题：Q：Touying与Typst原生文档有何区别？A：Touying在Typst基础上封装了幻灯片专用组件（如#slide块、#pause动画），并提供完整主题系统，而原生Typst需手动实现这些功能。

二、功能模块解析：Touying的技术架构与核心组件

2.1 引擎架构：幻灯片渲染的核心动力

Touying的引擎系统由「模块路径」：src/与lib.typ共同构成，包含三大核心模块：

布局引擎（src/layout.typ）：处理幻灯片的空间分配，支持16:9/4:3等比例自适应，通过#composer函数实现复杂分栏布局
内容解析器（src/parser.typ）：将Markdown式标题自动转换为幻灯片结构，支持== 二级标题自动分页
渲染器（src/render.typ）：负责最终视觉呈现，处理字体渲染、颜色系统与动画效果

图1：Touying核心功能模块关系图，展示了从内容输入到最终渲染的完整流程

2.2 定制系统：主题与样式的灵活控制

主题系统是Touying的特色功能，通过「模块路径」：themes/实现风格统一与快速切换。每个主题包含：

基础样式：定义字体、颜色方案与间距规则
布局模板：预设标题页、内容页、引用页等页面类型
组件样式：按钮、代码块、列表等UI元素的视觉定义

📌 核心概念：主题继承机制
类比：如同CSS的样式继承，Touying主题可基于基础主题（如simple）进行增量修改，而非完全重写。技术实现上通过Typst的with()语法实现配置覆盖。

新手常见问题：Q：如何创建自定义主题？A：建议复制现有主题（如themes/simple.typ）作为基础，修改theme()函数内的参数，或通过#set命令局部调整样式。

2.3 动画引擎：让演示更具表现力

Touying的动画系统（「模块路径」：src/animation.typ）支持多种过渡效果，从简单的元素渐显到复杂的路径动画。核心特性包括：

片段动画：通过#pause实现内容分步骤展示
路径动画：使用#move函数定义元素运动轨迹
状态切换：通过#switch实现元素状态变化

图2：使用Touying动画系统实现的状态机演示，展示对象状态转换过程

2.4 数据可视化：无缝集成图表能力

Touying通过「模块路径」：src/charts.typ提供数据可视化支持，特点包括：

内置柱状图、折线图等基础图表
支持从CSV文件导入数据
可与动画系统结合实现动态数据展示

新手常见问题：Q：图表样式能否自定义？A：是的，可通过chart-style参数调整颜色、字体和网格线等视觉属性。

三、实战应用指南：从安装到创建第一个幻灯片

3.1 环境准备：如何快速搭建开发环境？

需求场景：首次使用Touying创建技术演示文稿
解决方案：通过Typst包管理器安装，配合VSCode插件获得实时预览

# 克隆项目仓库
git clone https://gitcode.com/gh_mirrors/to/touying
cd touying

# Typst环境设置（需先安装Typst）
typst init --template=slides

📌 核心概念：Typst工作流
类比：类似LaTeX的编译流程，但Typst采用即时编译，修改后无需手动重新生成。技术上通过typst watch命令实现文件变化监听与自动更新。

3.2 快速上手：创建会议报告幻灯片

需求场景：20分钟内完成技术会议报告框架
解决方案：使用simple主题，通过标题自动分页功能快速构建结构

#import "@preview/touying:0.5.2": *
#import themes/simple: *

// 会议报告场景下的全局配置
#show: simple-theme with(
  aspect-ratio: "16-9",  // 宽屏显示适配
  footer: "2023技术研讨会 | 机密",  // 统一页脚
  logo: image("logo.png", width: 2cm)  // 添加公司Logo
)

= 项目进度汇报  // 自动生成标题页
// 封面页配置会自动应用主题默认样式

== 项目背景  // 自动创建新幻灯片
- 市场需求分析
- 技术选型过程
- 团队组成情况

== 核心功能演示  // 自动创建新幻灯片
#slide(columns: 2) [  // 双栏布局
  == 左侧代码
  ```rust
  fn main() {
    println!("Hello Touying!");
  }

== 右侧效果代码执行流程示意图 ]


[![Dewdrop主题内容页示例](https://raw.gitcode.com/gh_mirrors/to/touying/raw/8eb87b12eff9afc1137d585ceb81f4cff196316d/tests/themes/dewdrop/default/ref/7.png?utm_source=gitcode_repo_files)](https://gitcode.com/gh_mirrors/to/touying?utm_source=gitcode_repo_files)
*图3：使用Dewdrop主题的内容页面效果，展示多级标题与段落排版*

新手常见问题：Q：如何添加页码和导航？A：大多数主题已内置页码，可通过`theme(show-page-number: true)`强制启用，导航功能可通过`#navigation`组件添加。

## 四、进阶配置技巧：打造专业级演示文稿

### 4.1 主题定制：如何解决幻灯片比例适配问题？

**需求场景**：同一演示文稿需适配投影仪（4:3）和屏幕（16:9）两种显示设备  
**解决方案**：使用响应式设计与条件编译

```typst
// 定义比例切换变量
#let aspect-ratio = "16-9"  // 切换为"4-3"适配投影仪

#import themes/metropolis: *
#show: metropolis-theme with(
  aspect-ratio: aspect-ratio,
  // 根据比例动态调整字体大小
  font-size: if aspect-ratio == "16-9" { 18pt } else { 22pt },
)

// 条件显示适配内容
#if aspect-ratio == "4-3" [
  #note("投影仪模式：简化图表，增大字体")
]

4.2 动画控制：如何实现元素的精确时序控制？

需求场景：技术流程图需要按步骤展示节点关系
解决方案：使用时间线动画与组控制

#import "@preview/fletcher:0.3.0": *  // 导入动画库

#let animation = fletcher-animation(
  duration: 5s,
  steps: [
    // 步骤1：显示初始状态
    { nodes: [start], opacity: 1 },
    // 步骤2：显示处理过程
    { nodes: [process], opacity: 1, delay: 1s },
    // 步骤3：显示完成状态
    { nodes: [end], opacity: 1, delay: 2s },
  ]
)

#animation.render()

4.3 数据集成：如何将外部数据动态导入幻灯片？

需求场景：季度报告需展示最新销售数据，避免手动更新
解决方案：CSV数据导入与动态图表生成

#import "src/charts.typ": bar-chart

// 从外部文件导入数据
#let sales-data = csv("data/sales-q3.csv")

== Q3销售数据
#bar-chart(
  data: sales-data,
  x: "product",
  y: "revenue",
  title: "季度销售额对比",
  // 应用动画效果
  animate: true,
  duration: 2s
)

新手常见问题：Q：如何处理大型数据集的性能问题？A：可使用#cache命令缓存图表渲染结果，或通过sample函数对数据进行抽样处理。