Documentation
README
LaTeX 工具
路径与写入
- 当前目录为
LATEX_TOOL_ROOT,只读。 - 模板和脚本从本目录读取;论文项目只写入
PROJECT_ROOT。 - 官方模板、题目附件和 Skill 文件保持只读;先复制,再填充。
- 默认不覆盖已有输出目录。
- 初始化生成
latex-project.json,记录主入口、竞赛配置、模板来源、版本、哈希与资源绑定;不要手工删除或伪造。
环境诊断
开始初始化和写作前,按官方模板选择引擎与参考文献后端并执行:
python "<SKILL_ROOT>/tools/latex/scripts/latex_paper.py" doctor `
--engine xelatex `
--bibliography-backend biber `
--need-pandoc
仅生成 LaTeX/PDF 时省略 --need-pandoc。诊断会检查 latexmk、所选引擎、BibTeX/Biber、pypdf、pdfimages、pdftoppm,需要生成 Word 时再检查 Pandoc。任一必需项缺失都先报告阻塞,不要写完整论文后才发现无法编译或校验。
模板优先级
- 用户提供的当届官方 LaTeX 模板项目。
- 从目标竞赛官方网站取得的当届 LaTeX 模板项目。
assets/templates/cumcm/或assets/templates/mcm-icm/构建基线。
内置模板只在没有官方 LaTeX 模板时使用,不替代当届官方规则。复制官方模板目录时保留其 .cls、.sty、.bst、字体和图片资源,不重写导言区或文档类。
初始化
This is the opening of the README. Read the full README on GitHub.