mcpField
L
latex-build

latex-build

github.com/terrylica文档处理1232 次安装1 天前更新
代码仓库

关于 latex-build

用于编译和管理 LaTeX 文档构建的技能，适合处理单文件或多文件项目的作者与开发者。它围绕 latexmk 命令提供重复构建、文件监视、SyncTeX 和清理指引。

主要功能

  1. 01使用 latexmk 一次性编译 PDF
  2. 02监视模式自动重新构建
  3. 03SyncTeX 构建选项
  4. 04处理多文件依赖
  5. 05清理构建产物

适用场景

  1. 01将 LaTeX 文档编译为 PDF
  2. 02通过自动重建预览编辑结果
  3. 03清理辅助构建文件

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/terrylica/cc-skills --skill latex-build

安装后在 Claude Code 中输入/latex-build确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

references/
advanced-patterns.md
common-commands.md
configuration.md
evolution-log.md
multi-file-projects.md
troubleshooting.md

详细介绍

LaTeX 构建自动化

自我演进技能：此技能会在使用过程中不断改进。如果说明有误、参数发生变化，或需要采用变通方案，请立即修复此文件，不要拖延。仅针对真实且可复现的问题进行更新。

何时使用此技能

在以下情况下使用此技能：

  • 编译 LaTeX 文档
  • 设置实时预览和自动重新构建
  • 管理多文件项目
  • 排查构建失败问题
  • 清理构建产物
  • 自动化编译工作流

快速参考

为什么使用 latexmk？

业界标准构建工具：

  • 自动检测依赖项（参考文献、索引等）
  • 自动运行正确的次数（处理交叉引用）
  • 实时预览模式会监视文件更改
  • 与 Skim 配合，实现 SyncTeX 自动重新加载
  • 随 MacTeX 一同提供（无需单独安装）

基本用法

单次构建
latexmk -pdf document.tex
# Result: document.pdf created
实时预览（监视模式）
latexmk -pvc -pdf document.tex

# What happens:
# - Compiles document initially
# - Watches for file changes
# - Auto-recompiles when files change
# - Auto-reloads PDF in Skim viewer

**停止监视：**按 Ctrl+C

快速参考卡

# Build once
latexmk -pdf document.tex

# Live preview (watch mode)
latexmk -pvc -pdf document.tex

# Build with SyncTeX
latexmk -pdf -synctex=1 document.tex

# Clean artifacts
latexmk -c              # Keep PDF
latexmk -C              # Remove PDF too

# Force rebuild
latexmk -gg -pdf document.tex

# Non-interactive (for CI)
latexmk -pdf -interaction=nonstopmode document.tex

构建检查清单

  • 确认已安装 latexmk：which latexmk
  • 测试基本构建：latexmk -pdf document.tex
  • 启用 SyncTeX：添加 -synctex=1 标志
  • 测试实时预览：latexmk -pvc -pdf document.tex
  • 配置 Skim 自动重新加载
  • 为常见任务创建 Makefile（可选）
  • 为项目专属设置创建 .latexmkrc（可选）
  • 测试清理：latexmk -c 会移除构建产物

参考文档

详细信息请参阅：

官方文档：运行 man latexmk 或 latexmk -help 查看完整参考

另请参阅：

  • 使用 latex/setup 技能安装 LaTeX 并配置环境
  • 使用 latex/tables 技能通过 tabularray 创建表格

故障排查

问题原因解决方案
找不到 latexmk不在 PATH 中将 /Library/TeX/texbin 添加到 PATH
未定义控制序列缺少宏包检查 \usepackage 语句，确认已包含所需宏包
参考文献显示 ??需要多次运行latexmk 会自动处理；请确认没有错误
实时预览未更新Skim 自动重新加载已禁用Skim 偏好设置 → Sync → 检查文件更改
构建卡住nonstop 模式下出现输入提示使用 -interaction=nonstopmode 标志
PDF 未更新构建错误导致无法输出检查 .log 文件中的具体错误
SyncTeX 无法使用缺少 -synctex=1 标志在构建命令中添加 -synctex=1
辅助文件过多正常的构建产物运行 latexmk -c 清理（保留 PDF）

执行后回顾

此技能执行完毕后，在结束前检查：

  1. 命令是否成功？——如果没有，请修复导致失败的说明或错误表。
  2. 参数或输出是否发生变化？——如果底层工具的接口发生变化，请相应更新用法示例和参数表。
  3. 是否需要采用变通方案？——如果你不得不临时调整（使用不同标志、增加步骤），请更新此 SKILL.md，避免下次调用时重复采用相同的变通方案。

仅在问题真实且可复现时进行更新，不要臆测。

评论

支持 Markdown