/latex-submission-pipeline

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/年份/期刊名缺失造成审稿人观感差