Typst快速入门教程
Typst 是可用于出版的可编程标记语言,拥有变量、函数与包管理等现代编程语言的特性,注重于科学写作 (science writing),定位与 LaTeX 相似。
- 语法简洁:上手难度跟 Markdown 相当,文本源码阅读性高,不会像 LaTeX 一样充斥着反斜杠与花括号。
- 编译速度快:Typst 使用 Rust 语言编写,即 typ(esetting+ru)st,目标运行平台是WASM,即浏览器本地离线运行;也可以编译成命令行工具,采用一种增量编译算法和一种有约束的版面缓存方案,文档长度基本不会影响编译速度,且编译速度与常见 Markdown 渲染引擎渲染速度相当。
- 环境搭建简单:不需要像 LaTeX 一样折腾几个 G 的开发环境,原生支持中日韩等非拉丁语言,无论是官方 Web App 在线编辑,还是使用 VS Code 安装插件本地开发,都是即开即用。
- 现代编程语言:Typst 是可用于出版的可编程标记语言,拥有变量、函数、包管理与错误检查等现代编程语言的特性,同时也提供了闭包等特性,便于进行函数式编程。以及包括了 [标记模式]、{脚本模式} 与 数学模式 数学模式 数学模式 等多种模式的作用域,并且它们可以不限深度地、交互地嵌套。并且通过 包管理,你不再需要像 TexLive 一样在本地安装一大堆并不必要的宏包,而是按需自动从云端下载。
在线使用
适用场景:快速,免安装,多人协作。
打开官网 typst.app,注册账号。新建文档即可。
本地安装
VS Code(推荐)
适用场景:深度自定义,离线使用,顾及隐私。(补全体验也比官方好亿点点哦)
点击左侧扩展图标,搜索 Tinymist
插件并安装
WARNING
不要安装 Typst LSP 插件和 Typst Preview 插件,这两个插件已废弃,功能已经整合到Tinymist
插件中。
如果之前安装了这两个插件请卸载,否则会导致冲突。
如果你需要代码格式化功能,点击左下角齿轮图标,选择设置,搜索 tinymist formatter
,将其设置为 typstyle
,如下图所示。
……
typst 会自动扫描到系统中安装的字体,使用 typst fonts
命令可以列出所有可用的字体。
Vim
命令行
下载 Typst 二进制并解压。
根据官网文档在命令行中编译文件。
本地使用
本地
mkdir helloworld
cd helloworld
touch main.typ
内容如下
Hello World 你好世界
#[
#set text(font: ("IBM Plex Serif", "Noto Sans CJK SC"), lang: "zh", region: "cn")
Hello World 你好世界
]
#show regex("\p{sc=Hani}+"): set text(size: 0.8em)
Hello World 你好世界
#set par(first-line-indent: 2em)
#let indent = h(2em)
= 一级标题
#indent 豫章故郡,洪都新府。星分翼轸,地接衡庐。襟三江而带五湖,控蛮荆而引瓯越。物华天宝,龙光射牛斗之墟;人杰地灵,徐孺下陈蕃之榻。雄州雾列,俊采星驰。
台隍枕夷夏之交,宾主尽东南之美。都督阎公之雅望,棨戟遥临;宇文新州之懿范,襜帷暂驻。
十旬休假,胜友如云;千里逢迎,高朋满座。腾蛟起凤,孟学士之词宗;紫电青霜,王将军之武库。家君作宰,路出名区;童子何知,躬逢胜饯。
== 二级标题
#indent 时维九月,序属三秋。潦水尽而寒潭清,烟光凝而暮山紫。俨骖騑于上路,访风景于崇阿。临帝子之长洲,得天人之旧馆。
层峦耸翠,上出重霄;飞阁流丹,下临无地。鹤汀凫渚,穷岛屿之萦回;桂殿兰宫,即冈峦之体势。
点击编辑框中的Preview,显示效果如下
参考资料
Typst 中文社区导航-快速开始
typst.app docs 英文
typst.app docs 中文
typst 常见问题
The Raindrop-Blue Book (Typst中文教程)
Typst 中文资源列表
可以查看 Awesome Typst 中文版 中文版,以及浏览 第三方包。
中国大学论文:
- pkuthss-typst: 北京大学学位论文模板
- BUAA-typst: 北京航空航天大学学位论文模板
- bupt-typst: 北京邮电大学本科学士学位论文模板
- HUST-typst-template: 用于华科毕业设计(本科)的 typst 模板。
- SHU-Bachelor-Thesis-Typst: 上海大学本科毕业论文 typst 模板 (开发ing)
- sysu-thesis-typst: 中山大学学位论文 Typst 模板
- ZJGSU-typst-template: 浙江工商大学毕业设计(本科)的 typst 模板。
- CQUPTypst: 一个 Typest 模板,但是大专
- zjut-report-typst: 浙江工业大学一些实验报告的 Typst 模板
- HIT-Thesis-Typst: 适用于哈尔滨工业大学学位论文的 Typst 模板
- nju-thesis-typst: 南京大学学位论文 Typst 模板,使用 Typst 包管理、闭包等现代编程语言特性开发,一个更方便编辑和拓展的模板
- nuist-thesis-typst: 南京信息工程大学本科生毕业论文/设计 Typst 模板,分叉自 nju-thesis-typst
- SEU-Typst-Template: 东南大学本科毕业设计与学位论文模板
中文简历:
- uniquecv-typst: 一个使用 Typst 编写的简历模板,基于 uniquecv
- typst-cv-miku: 简历模板,有多种版本,包括中文
- awesomeCV-Typst: 一份参考
Awesome-CV
的简历模版,支持多语言简历管理 - Chinese-Resume-in-Typst: 使用 Typst 编写的中文简历, 语法简洁, 样式美观, 开箱即用, 可选是否显示照片
- neet-cv: 作者自用后开源的一份使用 typst 自制的中文简历模板,具有简单的使用方法,其中有部分参考
wondercv
,开箱即用,简洁美观
幻灯片: