Tectonic排版引擎与AucTeX集成配置指南-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_00615/article/details/148548560

Tectonic排版引擎与AucTeX集成配置指南

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

前言

Tectonic是一款现代化的TeX/LaTeX排版引擎，它基于XeTeX构建，提供了更简单的使用方式和更现代化的功能。对于使用Emacs编辑LaTeX文档的用户来说，AucTeX是最强大的LaTeX编辑环境之一。本文将详细介绍如何在Emacs中配置AucTeX以使用Tectonic作为排版引擎。

准备工作

在开始配置前，请确保已满足以下条件：

已安装Tectonic排版引擎
已安装GNU Emacs编辑器
已安装AucTeX Emacs包

技术提示：本文配置基于Tectonic V2命令行界面，使用tectonic -X标志或nextonic命令别名。

基础配置

加载AucTeX包

首先需要在Emacs配置文件中加载AucTeX包：

(require 'latex)

设置TeX引擎

我们需要修改TeX-engine-alist变量，告诉AucTeX使用Tectonic作为默认引擎：

(setq TeX-engine-alist '((default
                          "Tectonic"
                          "tectonic -X compile -f plain %T"
                          "tectonic -X watch"
                          nil)))

参数说明：

第一个元素是AucTeX识别的符号
第二个元素是TeX发行版名称
第三个元素是编译plain TeX文档的命令
第四个元素是编译LaTeX文档的命令（假设使用Tectonic项目）
第五个元素保留为nil，暂不配置ConTeXt文档编译

优化命令样式

修改LaTeX-command-style以避免AucTeX添加Tectonic不支持的额外选项：

(setq LaTeX-command-style '(("" "%(latex)")))

关键参数设置

设置以下关键参数确保AucTeX与Tectonic正常协作：

(setq TeX-process-asynchronous t
      TeX-check-TeX nil
      TeX-engine 'default)

参数说明：

TeX-process-asynchronous设为t，使Tectonic的watch模式不会阻塞Emacs
TeX-check-TeX设为nil，避免AucTeX检查传统TeX发行版
TeX-engine设为default，确保使用我们配置的Tectonic引擎

命令列表调整

修改TeX-command-list以使用适当的命令：

(let ((tex-list (assoc "TeX" TeX-command-list))
      (latex-list (assoc "LaTeX" TeX-command-list)))
  (setf (cadr tex-list) "%(tex)"
        (cadr latex-list) "%l"))

高级配置技巧

非项目模式编译LaTeX

对于不在Tectonic项目中的单个LaTeX文件，可以通过以下方式编译：

执行M-x TeX-command-master
选择"Other"选项
输入编译命令：tectonic -X compile -f latex 文件名.tex

注意：这种方式对多文件LaTeX文档的支持有限，建议使用Tectonic项目模式。

实时PDF预览配置

在Tectonic项目中，PDF输出通常位于构建目录而非源文件目录，这会导致AucTeX的预览功能失效。可以通过以下配置解决：

(add-hook 'after-change-major-mode-hook
          (lambda ()
            (when-let ((project (project-current))
                       (proot (project-root project)))
              (when (file-exists-p (expand-file-name "Tectonic.toml" proot))
                (setq-local TeX-output-dir (expand-file-name "build/index" proot))))))

配置说明：