Touying:高效幻灯片创作包在Typst中的应用指南
项目目录结构及介绍
Touying项目遵循清晰的目录结构来支持其功能与主题定制。以下是主要的目录和文件说明:
-
examples
: 包含示例文档,用于展示如何使用Touying创建不同风格的幻灯片,是新手入门的良好起点。 -
src
: 核心源代码所在目录,包含了Touying的主要逻辑实现,对于开发者想要深入理解或贡献代码非常关键。 -
themes
: 主题模板目录,每个子目录代表一个可用的主题样式,允许用户快速改变幻灯片的视觉效果。 -
.gitignore
: Git忽略文件,指定了不应被版本控制系统跟踪的文件类型或模式。 -
LICENSE
: 许可证文件,声明了项目的MIT许可证,这意味着您可以自由地使用、修改并重新分发此软件,需遵守许可证条款。 -
README.md
: 项目简介,包括安装指导、基本使用方法和项目特点等重要信息,是了解项目的第一站。 -
CHANGELOG.md
: 更新日志,记录了每次版本更新的内容,帮助用户了解新功能、修复的问题等变更信息。 -
lib
: 库文件夹,可能存放了一些Touying使用的内部库或辅助脚本。 -
typst.toml
: 配置文件,用于 Typst 编译设置,可能影响到Touying的行为或编译过程的特定配置。
项目的启动文件介绍
在Touying中,并没有直接定义一个“启动文件”,但您需要在Typst文档的开始部分引入Touying包和选择主题来“启动”您的幻灯片项目。以下是一个简化的示例,这可以视为“启动代码段”:
#import "@preview/touying:0.5.2": *
#import themes/simple: *
#show: simple-theme with(aspect-ratio: "16-9")
= 标题
== 第一章
Hello, Touying!
#pause
Hello, Typst!
这个代码导入了Touying包以及一个简单的主题,并展示了如何设置幻灯片的基本框架。
项目的配置文件介绍
-
全局配置:虽然没有特定命名的配置文件,Touying通过导入配置代码的方式进行设置,比如使用
#import "config.typ": *
来引入自定义配置,使得用户可以通过 Typst 的语法来自定义行为或覆盖默认值。 -
主题配置:每个主题可以在
themes
目录下的对应主题文件中进行微调,这些调整通常通过Touying提供的API来完成,而不需要单独的配置文件。用户可以通过在文档中指定主题和选项(如with(aspect-ratio: "16-9")
)来间接配置。
通过以上介绍,您可以着手于利用Touying创建丰富的Typst幻灯片,记得参考项目文档和例子以深入了解具体用法。