autotex手册

autotex是一个在Linux上运行的持续运行TeX和LaTeX的程序。例如，当

autotex testfile.tex

在bash（或zsh）中运行时，pdfTeX只运行一次。这个程序是用Rust编写的。

安装

可以使用cargo进行安装。

使用Cargo

git clone https://github.com/e0328eric/autotex.git
cd autotex
cargo install --path .

用法

运行TeX引擎

使用--engine或-e选项指定TeX引擎。例如，如果您想使用plain TeX，可以在包含要编译文件的文件夹中键入以下内容

autotex -e tex testfile.tex
autotex --engine tex testfile.tex
autotex -e plaintex testfile.tex
autotex --engine plaintex testfile.tex

然后TeX运行并生成testfile.dvi。

选项--engine可以获取pdftex、xetex、luatex、tex、plaintex、pdflatex、xelatex、lualatex和latex。

使用这些选项的另一种方法是使用特定引擎的选项。以下表格显示了每个引擎的标志。

例如，以下参数是等效的

autotex --engine xelatex testfile.tex
autotex -e xelatex testfile.tex
autotex -xL testfile.tex
autotex -Lx testfile.tex

如果没有这样的选项

autotex testfile.tex

则默认运行pdfTeX。

持续编译

选项-c

许多人可能希望持续运行TeX引擎。这意味着如果编译的文件被修改，TeX引擎就会运行。有一个选项可以满足您的需求。如果您像以下这样运行autotex

autotex -c testfile.tex

然后TeX引擎运行（在这个例子中，没有引擎选项，因此运行pdfTeX）并autotex等待testfile.tex文件被修改。如果这个文件被修改，那么TeX引擎会再次运行。

如果你想用LuaLaTeX来做这件事，那么可以这样运行：

autotex -e lualatex -c testfile.tex

正如我们所预期的。请注意，选项没有顺序。所以

autotex -c -e lualatex testfile.tex
autotex -ce lualatex testfile.tex
autotex -ec lualatex testfile.tex
autotex -lLc testfile.tex
autotex -clL testfile.tex

与上一个例子运行完全相同。

查看PDF

如果启用了选项-v，那么打开一个PDF查看器，以便我们可以查看从TeX文件编译的PDF。因此，例如，命令

autotex -vcpL testfile.tex

表示连续编译pdflatex并查看其PDF文件。

v0.2.0升级部分

autotex配置

autotex可以通过yaml文件进行配置。它必须放置在~/.config/autotex中，并且必须以config.yaml命名。示例配置如下

engine:
  main: pdflatex
pdf: zathura

一般来说，命令autotex FILENAME默认运行pdftex。然而，如果配置文件如上所示，则默认运行pdflatex。pdf部分提供了默认的PDF查看器。默认的PDF查看器是xdg-open。