Typst_begin
[!AI_SUMMARY]-
Typst 是一款轻量级的标记语言排版系统，可以用来替代 LaTeX 或 Word 等工具。
- 基本使用： Typst 提供了在线编辑器和本地编辑器，支持实时渲染和模板使用。
- 环境配置： 在 VScode + Ubuntu 环境下，完成安装 Typst 插件和 typst-cli 工具，并进行模板导入。
- 参考文档： 文章提供了 Typst 官方文档、教程和相关资源的链接。
本文将分为 使用学习 与 环境配置 两个部分。
使用学习 ¶
基本介绍 ¶
[!INTRODUCTION]
Typst 是为科学写作而诞生的基于标记的排版系统。它被设计之初就是作为一种替代品，用于替代像 LaTeX 这样的高级工具，又或者是像 Word 和 Google Docs 这样的简单工具。我们对 Typst 的目标是构建一个功能强大的排版工具，并且让用户可以愉快地使用它。
相比于 LaTeX，typst 最大的特点就是轻量，这也导致了 typst 支持较为频繁地实时渲染。
这是我刚接触 typst 使用其写的一个简单介绍 pdf，你可以在这里了解到更多 typst 的特点
基本使用 ¶
学习一个东西最好的办法就是阅读他的官方文档。
当然，有时候官方文档会较为晦涩；又或者过于详细，而我们不需要知道那么多。
在最开始，我们可以在 typst 的官方网站直接使用它，也就是人们常说的 开箱即用。
注册登入，看到下面的界面：
对于教程，如果您不喜英文，可以看看其他人做的中文教程。
点击 Empty document ，设置一个名字（这里使用 test 作为测试名
在左侧简单输入几个字符作为测试，待加载完成（√ 处可以看见加载的动图）后右侧就出现了文字：很简单，左侧编辑，右侧看效果。
当然，这只是写文本，我们需要在样式上优化，这需要读者自行阅读教程，不是我三言两语讲的完的。
完成后，点击右上角的下载图标即可下载 pdf。
模板使用 ¶
很多时候我们并不想要所有的样式都自己写，这个时候 模板 就很重要了，我们可以在 主页面左下角的星球图标 typst universe 的 templates 看到许多模板。点进一个作为示例：
点击图片我们可以预览样式，右侧的 create project in app 可以将模板导入到我们的主页面中
点击右侧需要修改的部分就会自动定位到左侧对应的编辑部分，然后修改即可；左侧图标第一个是文件夹。注意，对于图片等考虑 路径 的编辑还请仔细阅读文档相关部分，了解 路径 这一概念。
环境配置 ¶
相比于在线，我更加喜欢在本地环境编辑。下面是在 VScode + Ubuntu 上编辑 typst 的配置说明
注：我使用了 wsl:ubuntu 22.04；关于 vscode 安装不多说明，网上一大堆。
vscode 配置 ¶
安装下面的插件：
- Typst LSP
- Typst Preview
- Typst Companion
这些插件我自己自定义过快捷键，就不讲解如何使用了，一搜一大堆。
typst-cli 安装 ¶
安装 typst-cli 是为了让我们能够像 git clone 一样能够拉取编辑材料至本地使用。注意我们上方模板使用 部分的截图中有这么一行 typst init @preview/bloated-neurips:0.2.1 ，这就是在 typst-cli 中使用的。
# 如果没有安装过curl和cargo这两个工具，请自行搜索
# 安装 Rust 环境并激活，之前安装过则不需要执行下面这两行
curl --proto '=https' --tlsv1.2 -sSf [https://sh.rustup.rs](https://sh.rustup.rs/) | sh -s -- -y
source $HOME/.cargo/env
# 安装 Typst CLI
cargo install --git [https://github.com/typst/typst.git](https://github.com/typst/typst.git) typst-cli
# 键入检查是否安装成功
typst
# or
typst --version
过程中出现问题 failed to run custom build command for openssl-sys v0.9.60 可以尝试以下几个命令，来自 StackOverflow；您可以逐一尝试，我也不记得我是在尝试哪一个过后成功的了。🥲
sudo apt install pkg-config
sudo apt-get install libudev-dev
sudo apt install libssl-dev
sudo apt install librust-openssl-sys-dev
sudo apt install pkg-config
sudo dnf install perl
sudo apt-get install build-essential
模板导入 ¶
在命令行 (CLI) 中进入到合适位置，键入
可以看到左侧已经可以出现了文件夹了，可以直接使用了，先预览看看（插件使用自查）
如果出现红色报错等情况，对于模板而言很可能就是 路径 问题，时而需要自己修改；对于我们自己写路径，相对路径是最好的，因为不知道什么时候我们可能就将文件夹修改了位置。
推荐宏包 ¶
- mitex
- 支持渲染 latex 语法。
- tex2typst Web App 可以将 latex 数学公式转为 typst 数学公式（有一点 bug）
参考文档 ¶
- https://typst.app/
- https://typst.app/docs/tutorial/
- https://typst-doc-cn.github.io/docs/tutorial/
- https://typst.app/universe/package/bloated-neurips
- https://github.com/howardlau1999/sysu-thesis-typst
- https://stackoverflow.com/questions/65553557/why-rust-is-failing-to-build-command-for-openssl-sys-v0-9-60-even-after-local-in