关于 latex-setup
latex-setup 面向需要配置或排查 LaTeX 编译环境的研究人员。它会检查项目依赖与已安装工具，并据此指导安装、编译和验证。
主要功能
- 01检测 TeX 工具和文献处理器
- 02提取文档类与宏包需求
- 03查找官方会议模板
- 04仅安装缺失组件
- 05提供编译与验证步骤
适用场景
- 01为研究论文配置 LaTeX
- 02排查缺失宏包或字体错误
- 03配置 BibTeX 或 Biber 编译
安装
复制下面的命令，在终端中运行。
$
npx skills add https:/安装后在 Claude Code 中输入/latex-setup确认已加载。
详细介绍
LaTeX 环境设置
你正在帮助研究人员设置或修复 LaTeX 编译环境。不要硬编码软件包列表——请检测实际需要的内容并安装。
步骤 1：检测当前状态
在安装任何内容之前：
-
检查已安装的 TeX 发行版：
which pdflatex && pdflatex --version which xelatex && xelatex --version which lualatex && lualatex --version -
检查文献处理器：
which biber && biber --version which bibtex && bibtex --version -
检查软件包管理器：
which tlmgr && tlmgr --version
步骤 2：分析项目
阅读主 .tex 文件以确定需求：
- 文档类：
\documentclass{article}、\documentclass{IEEEtran}等。 - 文献系统：
\usepackage{biblatex}→ 需要biber\usepackage{natbib}或\bibliographystyle{...}→ 需要bibtex
- 所需软件包：提取所有
\usepackage{...}声明 - 特殊需求：TikZ、minted（需要 pygments）、algorithm2e 等。
步骤 3：检测会议模板
如果用户提到了某个会议，请搜索其官方模板：
- 从会议官方网站下载（不要使用第三方镜像）
- 检查模板是否指定了所需的 TeX 发行版或文档类
- 留意会议专属的编译说明
常见会议及其要求：
| 会议 | 文档类 | 文献系统 | 备注 |
|---|---|---|---|
| CVPR/ECCV | 自定义类文件 | bibtex | 通常在模板中提供 |
| NeurIPS | neurips_20XX.sty | natbib + bibtex | 样式文件每年都会更新 |
| ICLR | iclr20XX_conference.sty | natbib + bibtex | OpenReview 格式 |
| ACL/EMNLP | acl.cls | bibtex | ACL Anthology 格式 |
| IEEE | IEEEtran.cls | bibtex | 特定的分栏格式 |
| Springer | llncs.cls | bibtex 或 biblatex | 视系列而定 |
步骤 4：安装缺少的组件
根据分析结果，仅安装缺少的组件：
在 Ubuntu/Debian 上
# Base installation (if nothing installed)
sudo apt install texlive-base texlive-latex-recommended
# Common extras
sudo apt install texlive-latex-extra # most \usepackage needs
sudo apt install texlive-fonts-recommended texlive-fonts-extra
sudo apt install texlive-bibtex-extra biber # if biblatex used
sudo apt install texlive-science # algorithm2e, etc.
在 macOS 上
# Full installation (recommended)
brew install --cask mactex
# Minimal
brew install --cask basictex
sudo tlmgr update --self
sudo tlmgr install <package-name>
通过 tlmgr 安装单个软件包
# If specific packages are missing
sudo tlmgr install <package-name>
步骤 5：配置编译
设置正确的编译流程：
对于 bibtex 项目
pdflatex main.tex
bibtex main
pdflatex main.tex
pdflatex main.tex
对于 biblatex/biber 项目
pdflatex main.tex
biber main
pdflatex main.tex
pdflatex main.tex
常见编译问题
- 缺少 .bib 文件：检查
\bibliography{...}路径是否正确 - 引用未定义：运行 bibtex/biber + pdflatex 两次
- 缺少软件包：通过 tlmgr 安装，而不是使用 apt（apt 软件包粒度较粗）
- 字体错误：安装 texlive-fonts-extra
- TikZ 外部化错误：确保已启用 write18
步骤 6：验证设置
配置完成后：
- 运行完整的编译流程
- 检查 PDF 是否能正确打开
- 验证文献条目是否显示
- 检查 .log 文件中是否仍有警告
输出格式
请提供：
- 当前状态：已安装和缺少的内容
- 项目需求：从 .tex 文件中检测到的内容
- 安装命令：仅列出所需命令，并根据操作系统区分
- 编译命令：适用于此项目的准确流程
- 验证：确认编译成功
评论
支持 Markdown