Tectonic排版引擎入门：创建你的第一个文档

Tectonic排版引擎入门：创建你的第一个文档

tectonic A modernized, complete, self-contained TeX/LaTeX engine, powered by XeTeX and TeXLive. 项目地址: https://gitcode.com/gh_mirrors/te/tectonic

前言

Tectonic是一个现代化的TeX/LaTeX排版引擎，它重新设计了传统TeX工具的工作流程，提供了更简洁高效的文档编译体验。本文将带你快速上手Tectonic，从创建第一个文档到完成编译，让你感受这个现代排版工具的魅力。

环境准备

在开始之前，请确保你已经完成了Tectonic的安装。Tectonic支持多种操作系统平台，安装过程简单快捷。安装完成后，你可以通过命令行输入tectonic --version来验证安装是否成功。

创建新文档项目

Tectonic采用了类似Git和Cargo的多功能工具设计理念。要创建一个新文档项目，可以使用new子命令：

tectonic -X new myfirstdoc

这个命令会创建一个名为myfirstdoc的工作区目录，其中包含：

• Tectonic.toml：项目配置文件
• src目录：存放源文件的主目录

重要提示：-X参数表示使用Tectonic的V2接口，这是当前推荐的使用方式。

进入项目目录：

cd myfirstdoc

文档结构解析

新创建的项目包含以下关键部分：

1. Tectonic.toml：这是项目的配置文件，类似于Cargo.toml在Rust项目中的作用。它定义了文档的基本属性和构建配置。

2. src目录：这是存放LaTeX源文件的主要位置。默认情况下，这里会包含文档的主文件。

编译文档

编译文档非常简单，只需运行：

tectonic -X build

首次运行时，Tectonic会：

1. 下载必要的支持文件
2. 生成LaTeX格式文件
3. 缓存这些文件以供后续使用

这个过程可能需要1-2分钟，但后续编译会快很多，因为不需要重复下载。

编译完成后，生成的PDF文档位于：

build/default/default.pdf

Tectonic的优势特性

与传统TeX引擎相比，Tectonic提供了多项改进：

1. 静默模式：除非出错，否则不会输出冗余信息
2. 自动重运行：自动处理需要多次编译的情况
3. 简洁输出：默认不生成中间文件
4. 错误处理：遇到错误直接退出，不需要人工干预

缓存机制

Tectonic使用缓存来提高效率：

1. 缓存位置因操作系统而异
2. 可以通过TECTONIC_CACHE_DIR环境变量自定义缓存路径
3. 建议保持默认缓存位置，除非有特殊需求

处理现有文件

如果你已经有现成的TeX文件，可以直接编译：

tectonic -X compile existing-file.tex

这种方式适合快速验证单个文件，而不需要创建完整项目。

结语

通过本文，你已经学会了使用Tectonic创建和编译文档的基本流程。Tectonic的现代化设计大大简化了LaTeX文档的编译过程，让作者可以更专注于内容创作而非工具使用。下一步，你可以尝试编辑文档内容，探索Tectonic更多高级功能。

tectonic A modernized, complete, self-contained TeX/LaTeX engine, powered by XeTeX and TeXLive. 项目地址: https://gitcode.com/gh_mirrors/te/tectonic