Touying：用Typst打造高效幻灯片的开源解决方案

在现代演示场景中，幻灯片工具往往陷入两难：要么像传统GUI工具那样操作繁琐、格式调整耗时，要么像纯代码方案那样学习曲线陡峭。Touying作为基于Typst的幻灯片创作包，正是为解决这一痛点而生。它将Typst的简洁语法与专业演示需求深度融合，让开发者无需在排版美学与开发效率间妥协。无论是学术报告、技术分享还是产品演示，Touying都能帮助初级开发者以代码方式快速生成具有专业质感的幻灯片，同时保留完整的自定义能力。

价值定位：重新定义幻灯片创作流程

当你需要在30分钟内从无到有完成一份包含数学公式、代码高亮和动态效果的技术演示文稿时，Touying的价值即刻显现。传统工作流中，你可能需要在文本编辑器、公式工具和演示软件间反复切换，而Touying通过单一Typst文件实现全流程管理，就像用Markdown写文档一样自然，却能产出媲美专业设计的演示效果。

告别格式困扰：代码驱动的排版革命

Touying采用"内容即代码"的理念，将幻灯片创作转化为结构化的文本编写过程。你无需拖拽元素或调整像素，只需通过简洁的标记语法定义标题层级、内容块和布局关系。这种方式不仅消除了格式不一致问题，还让版本控制和团队协作变得前所未有的简单——就像管理代码仓库一样管理你的演示文稿。

平衡易用性与专业性：为初级开发者定制的工具链

不同于专业排版系统陡峭的学习曲线，Touying通过预设主题和简化API降低入门门槛。新手可以直接使用内置模板快速上手，而开发者则能通过深入配置实现高度定制。这种分层设计确保不同水平用户都能找到适合自己的工作方式，就像相机的"自动模式"与"手动模式"，既满足即时需求，又保留专业探索空间。

核心能力：让幻灯片创作如代码般优雅

当你需要为技术分享构建包含复杂图表和动态效果的幻灯片时，Touying的核心功能将成为你的得力助手。它不仅提供基础的幻灯片组织能力，更将Typst的排版优势与演示场景深度结合，创造出传统工具难以实现的表达效果。

构建结构化演示：标题驱动的幻灯片生成

Touying采用"标题即幻灯片"的智能拆分机制，自动将文档结构转换为演示逻辑。通过简单的Markdown风格标题标记（= 一级标题、== 二级标题），系统会自动生成对应幻灯片，省去手动创建页面的重复劳动。这种方式就像写文章一样自然，却能实时预览演示效果，大幅提升创作流畅度。

呈现动态内容：从静态到交互的体验升级

技术演示往往需要展示过程而非仅仅结果，Touying的动态能力让复杂概念变得直观。通过#pause指令创建内容逐步显示效果，使用#waypoint实现元素动画，甚至能与Fletcher等动画库集成构建状态流程图。这些功能就像为幻灯片注入生命，让你的演示从静态展示转变为沉浸式体验。

融合学术与技术表达：专业内容的自然载体

对于包含数学公式、代码片段的技术演示，Touying展现出独特优势。它原生支持Typst的数学排版能力，公式渲染效果媲美LaTeX；代码块自动应用语法高亮，支持多种编程语言；配合Cetz绘图库还能直接在幻灯片中生成矢量图表。这些特性使Touying成为技术和学术演示的理想选择，让专业内容表达无需依赖外部工具。

实践指南：从零开始的幻灯片创作之旅

当你首次接触Touying并需要快速完成一份演示文稿时，遵循以下步骤可以让你在最短时间内掌握核心工作流。这个过程就像搭建积木，从基础框架到内容填充，逐步构建出完整的演示作品。

环境准备：5分钟完成项目初始化

1. 安装Typst环境：通过Typst官方网站下载适合你系统的安装包，或使用VS Code插件"Typst Preview"获得集成开发体验
2. 获取Touying项目：执行git clone https://gitcode.com/gh_mirrors/to/touying克隆仓库
3. 查看示例文件：进入examples目录，选择任意.typ文件作为学习模板，推荐从simple.typ开始

基础创作：3步构建你的第一份幻灯片

1. 创建主文件：新建presentation.typ，导入Touying核心模块和主题

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

2. 添加内容结构：使用标题层级定义幻灯片

   = 演示主题：Touying入门
   == 项目介绍
   这是我的第一份Touying幻灯片
   #pause
   它支持渐进式内容展示
   
   == 核心特性
   - 代码驱动的创作流程
   - 丰富的主题选择
   - 原生数学公式支持
   

3. 预览与导出：通过Typst预览功能实时查看效果，完成后导出为PDF

主题应用：一键切换演示风格

Touying提供多种预设主题满足不同场景需求，通过简单配置即可全局应用：

主题名称	适用场景	特点
simple	技术文档、快速演示	简洁无装饰，突出内容
metropolis	学术会议、正式报告	现代简约，专业感强
aqua	教学、培训	清新配色，亲和力高
university	学位答辩、学术讲座	庄重正式，符合学术规范

应用主题只需修改导入语句：#import themes/metropolis: *，然后通过with()语法调整参数，如aspect-ratio: "4-3"设置传统屏幕比例，font-size: 18pt调整全局字体大小。

进阶技巧：打造专业级演示体验

当你熟悉基础操作并需要提升演示效果时，这些进阶技巧将帮助你实现更复杂的布局和交互效果。就像掌握基础摄影后学习光影运用，这些功能能让你的幻灯片从"可用"提升至"专业"水平。

定制专属主题：从修改到应用的完整流程

1. 复制基础主题：在themes目录下复制现有主题文件（如simple.typ），重命名为my-theme.typ
2. 修改核心样式：调整颜色变量、字体设置和布局参数

   // 自定义颜色方案
   #let primary-color = rgb("#2c3e50")
   #let accent-color = rgb("#3498db")
   
   // 调整标题样式
   #let heading-style = (font: "Inter", weight: 700)
   

3. 局部覆盖样式：在幻灯片中使用#style指令临时修改特定元素样式
4. 保存并应用：通过#import themes/my-theme: *应用自定义主题

实现复杂布局：多栏与定位技巧

Touying基于Typst的布局系统提供强大的空间管理能力：

• 使用#compose创建多栏布局：

  #compose(
    left: [左侧内容],
    right: [右侧内容]
  )
  

• 通过网格系统精确定位元素：

  #grid(
    columns: (1fr, 2fr),
    [小列内容], [大列内容]
  )
  

• 结合#place和#align实现绝对定位，创建复杂视觉效果

集成外部工具：扩展幻灯片能力边界

Touying通过插件系统与其他Typst包无缝集成，扩展功能范围：

• Cetz绘图：导入@preview/cetz创建矢量图表和流程图
• Fletcher动画：添加@preview/fletcher实现状态转换动画
• Mitex公式：通过@preview/mitex获得更多LaTeX兼容语法
• Codly代码块：使用@preview/codly实现高级代码高亮和行号显示

这些集成让Touying不仅是演示工具，更成为连接各类专业内容创作的平台，满足从简单汇报到复杂技术展示的全场景需求。