latex-compile
GitHub用于编译TeX项目,优先使用Tectonic处理简单项目,复杂情况自动回退至TeX Live或MacTeX。支持指定编译器、引擎及输出目录,并集成SyncTeX同步功能。若无可用环境则路由至安装工具。
Trigger Scenarios
Install
npx skills add fanfan-de/anybox --skill latex-compile -g -y
SKILL.md
Frontmatter
{
"name": "latex-compile",
"description": "Compile a TeX project from Codex, trying bundled Tectonic for simple projects and falling back to detected TeX Live or MacTeX when needed."
}
LaTeX Compile
Use this skill when the user asks to build, render, regenerate, or compile a .tex file.
Run from the plugin root:
python3 scripts/compile_latex.py /absolute/path/to/main.tex
Default auto mode uses Tectonic first only when the project looks simple enough not to need a full TeX Live toolchain. It falls back to TeX Live or MacTeX when Tectonic fails or when the project uses bibliography, shell-escape, index/glossary, or explicit non-Tectonic engine features.
Common options:
python3 scripts/compile_latex.py /absolute/path/to/main.tex --compiler tectonic
python3 scripts/compile_latex.py /absolute/path/to/main.tex --compiler texlive
python3 scripts/compile_latex.py /absolute/path/to/main.tex --engine xelatex
python3 scripts/compile_latex.py /absolute/path/to/main.tex --output-directory /absolute/path/to/build
python3 scripts/compile_latex.py /absolute/path/to/main.tex --json
Behavior
- Detects bundled or PATH Tectonic and existing TeX Live or MacTeX.
- Honors a leading
% !TEX root = ...directive when present. - Uses
latexmkfor TeX Live builds when available. - Enables SyncTeX with
-synctex=1for TeX Live builds. - Does not install TeX.
If neither Tectonic nor a usable TeX installation is found, stop and route to latex-doctor or texlive-runtime-installer.
Version History
- 08dc189 Current 2026-07-05 19:02


