Tinymist Typst 0.13.10

新的介绍内容：

Tinymist Typst VS Code 扩展是为 Typst 用户设计的强大工具，旨在提升您在 VS Code 或 VS Codium 中的 Typst 项目开发效率。您可以在以下平台找到该扩展：

• GitHub Actions 提供夜间版本。
• Visual Studio Marketplace 提供稳定版本。
• Open VSX 提供稳定版本。

功能亮点：

请查看 Tinymist 功能列表，了解更多详细功能。

使用技巧：

使用模板初始化项目：

要初始化 Typst 项目，您可以：

• 使用命令 Typst init template (tinymist.initTemplate) 基于模板初始化新的 Typst 项目。
• 使用命令 Typst show template (tinymist.showTemplateGallery) 查看可用的 Typst 模板，并选择一个模板进行初始化。

如果您的模板仅包含一个文件，您还可以使用以下命令将模板内容插入到当前位置：

• 使用命令 Typst template in place (tinymist.initTemplateInPlace) 并输入模板标识符进行初始化。

配置 LSP 增强格式化器：

1. 打开设置。
2. 搜索 "Tinymist Formatter" 并修改其值。

• 使用 "formatterMode": "typstyle" 启用 typstyle。
• 使用 "formatterMode": "typstfmt" 启用 typstfmt。

提示：要启用保存时格式化，请为 typst 语言添加额外设置：

{
  "[typst]": {
    "editor.formatOnSave": true
  }
}

配置/使用 Tinymist 活动栏（侧边栏）：

如果您不喜欢活动栏，可以右键点击活动栏并取消选中 "Tinymist" 以隐藏它。

符号视图：

• 通过关键词、描述或手写体搜索符号。
• 查看按类别分组的符号。
• 点击符号将其插入到编辑器中。

工具视图：

• 模板库：显示可用的 Typst 模板以选择模板进行初始化。
• 文档摘要：显示当前文档的摘要。
• 符号：显示当前文档中的符号。
• 字体：显示当前文档中的字体。
• 性能分析：对当前文档进行性能分析。

包视图：

• 创建或打开一些本地 typst 包。
• 显示可用 typst 包列表并调用相关命令。

内容视图：

• 显示当前文档的缩略图内容，适用于创建幻灯片。

标签视图：

• 显示当前工作区中的标签。

大纲视图：

• 显示导出文档的大纲，将 typst 视为标记语言。
  • 这与 LSP 提供的文档大纲略有不同，后者显示文档的语法结构，将 typst 视为编程语言。

预览命令：

打开命令面板（Ctrl Shift P），然后输入 >Typst Preview:。

您还可以使用快捷键（Ctrl K V）。

主题感知模板（预览）：

简而言之，当您的文档处于用户编辑或预览任务的上下文中时，编译器会添加一个 sys.inputs 项。您可以使用它来配置您的模板：

#let preview-args = json.decode(sys.inputs.at("x-preview", default: "{}"))
// 正在预览文档。
#let is-preview = sys.inputs.has("x-preview")
// `dark` 或 `light`
#let preview-theme = preview-args.at("theme", default: "light")

有关详细信息，请查看预览的 sys.inputs。

配置字体搜索路径：

要配置字体搜索路径：

1. 打开设置。

• 文件 -> 首选项 -> 设置（Linux, Windows）。
• 代码 -> 首选项 -> 设置（Mac）。

1. 搜索 "Tinymist Font Paths" 以按顺序提供搜索字体的路径。
2. 搜索 "Tinymist System Fonts" 以禁用搜索系统字体，这对于可重复渲染您的 PDF 文档很有用。
3. 重新加载窗口或重启 vscode 编辑器以使设置生效。

注意： 您必须提供绝对路径。注意： 您可以在设置中使用 vscode 变量，详见 vscode-variables。

配置根目录路径：

要配置 Typst 编译器解析的根路径：

1. 打开设置。
2. 搜索 "Tinymist Root Path" 并修改其值。
3. 重新加载窗口或重启 vscode 编辑器以使设置生效。注意： 您必须提供绝对路径。

管理本地包：

1. 使用 Typst: Create Typst Local Package 命令创建本地包。
2. 使用 Typst: Open Typst Local Package 命令打开本地包。
3. 在活动栏的 "PACKAGE" 视图中查看和管理可用本地包列表。

编译 PDF：

此扩展可以编译到 PDF，但目前没有 PDF 查看器。要在工作时查看输出，请安装 PDF 查看器扩展，例如 vscode-pdf。

要找到编译 PDF 的方法：

• 点击文档顶部的代码 len Export PDF，或者使用命令 Typst Show PDF ...，以将当前文档显示为 PDF。
• 使用命令 Typst Export PDF 将当前文档导出为 PDF。
• 在文档开始处有代码镜头按钮，可以将您的文档导出为 PDF 或其他格式。

要配置 PDF 的编译时间：

1. 打开设置。
2. 搜索 "Tinymist Export PDF"。
3. 更改 "Export PDF" 设置。

• onSave 在保存 Typst 文件后生成 PDF。
• onType 在您输入时实时生成 PDF 文件。
• never 禁用 PDF 编译。
• onDocumentHasTitle 在文档有标题时生成 PDF，并在您保存时生成。

要配置 PDF 的保存位置：

1. 打开设置。
2. 搜索 "Tinymist Output Path"。
3. 更改 "Output Path" 设置。这是存储工件的路径模式，您可以使用 $root 或 $dir 或 $name 进行魔术配置。

• 例如 $root/$dir/$name（默认）用于 $root/path/to/main.pdf。
• 例如 $root/target/$dir/$name 用于 $root/target/path/to/main.pdf。
• 例如 $root/target/foo 用于 $root/target/foo.pdf。这将确保输出始终输出到 target/foo.pdf。

注意： 输出路径应替换为绝对路径。

导出到其他格式：

您还可以通过 lsp 将文档导出为各种其他格式。目前支持以下格式：

• 官方 svg、png 和 pdf。
• 非官方 html、md（typlite）和 txt。
• 查询结果（导出为 json、yaml 或 txt），以及 pdfpc（通过 typst query --selector ，用于 Touying）。

请查看文档：导出文档以获取更多信息。

处理多文件项目：

您可以通过命令固定主文件。

• 使用命令 Typst Pin Main (tinymist.pinMainToCurrent) 将当前文件设置为主文件。
• 使用命令 Typst Unpin Main (tinymist.unpinMain) 取消设置主文件。

[!NOTE]

tinymist.pinMain 是一个有状态命令，tinymist 在会话之间（关闭和打开编辑器）不会记住它。

传递额外 CLI 参数：

有一个全局配置 tinymist.typstExtraArgs 用于向 tinymist LSP 传递额外参数，就像您通常使用 typst-cli CLI 一样。例如，您可以将其设置为 ["--input=awa=1", "--input=abaaba=2", "main.typ"] 来配置 sys.inputs 和编译器的入口，这相当于让 LSP 像 typst-cli 一样运行以下命令：

typst watch --input=awa=1 --input=abaaba=2 main.typ

支持的参数：

• 入口文件：数组中的最后一个字符串将被视为入口文件。
  • 这用于指定编译器的默认入口文件，可能会被其他设置覆盖。
• --input：添加一个通过 sys.inputs 可见的字符串键值对。
• --font-path（环境变量：TYPST_FONT_PATHS），字体路径，可能会被 tinymist.fontPaths 覆盖。
• --ignore-system-fonts：确保不会搜索系统字体，可能会被 tinymist.systemFonts 覆盖。
• --creation-timestamp（环境变量：SOURCE_DATE_EPOCH）：文档的创建日期格式化为 UNIX 时间戳。
• --cert（环境变量：TYPST_CERT）：网络访问的 CA 证书文件路径，尤其是用于下载 typst 包。

注意： 将入口固定为 main.typ 可能有助于多文件项目，但您可能会在不相关文件中丢失诊断和自动完成。

注意： 参数的优先级非常低，可能会被其他设置覆盖。

贡献：

您可以向 GitHub 提交问题或创建 PR。