---
name: latex-submission-pipeline
description: "Use when building a LaTeX manuscript submission pipeline with templates, latexmk, BibTeX/Biber, chktex, latexindent, CI PDF builds, compile debugging, and submission zip packaging."
allowed-tools: [Read, Write, Edit, Bash, Grep, Glob]
---

# LaTeX Submission Pipeline（LaTeX 投稿工程链）

## 适用

当用户需要：
- 套用期刊/会议 LaTeX 模板（ACM/IEEE/NeurIPS 等）
- 解决编译错误、引用错误、字体缺失、图片格式不兼容
- 接入 GitHub Actions 自动编译 PDF / 打包 submission zip
- 做格式化（latexindent）与 lint（chktex）

---

## 最小流程（从 0 到可提交）

### 1) 选择模板与约束

先记录目标 venue 的官方模板或格式要求：
- 页边距、双栏/单栏、匿名/非匿名、附录策略、页数限制

### 2) 本地可复现构建

推荐统一入口（任选其一）：
- `latexmk -pdf -interaction=nonstopmode -halt-on-error`
- 或在项目中提供 `scripts/build.ps1` / `scripts/build.sh`

### 3) 引用稳定（BibTeX/Biber）

元规则：
- `.bib` 是 source-of-truth
- 同一项目不要混用手工引用与 BibTeX（至少主文统一）

### 4) 图表导出与兼容性

对投稿系统最稳的组合：
- 矢量：`PDF`（matplotlib 导出）
- 栅格：`TIFF 600dpi`（显微/照片/heatmap 视情况）

### 5) Lint + Format（可选但强烈建议）

- Lint：`chktex`（常见 LaTeX 坑）
- Format：`latexindent`（减少 diff 噪声）

### 6) CI 自动编译（GitHub Actions）

模板：`templates/github-actions-latex.yml`（参考 `xu-cheng/latex-action`）

---

## 常见失败点（速查）

- 图像格式：EPS/PDF/PNG/TIFF 混用导致编译失败（优先统一 PDF）
- 字体：投稿要求嵌入字体（PDF 检查）
- Overfull box：大量警告影响排版质量（需要在关键位置修）
- 参考文献缺字段：DOI/年份/期刊名缺失造成审稿人观感差