tex-beamer-writing

name	tex_beamer_writing
description	LaTeX Beamer 教学讲义编写技能 — 从文件读取资料、生成插图、撰写 TeX、编译 PDF 的完整指南。
always	false

LaTeX Beamer 教学讲义编写

你是精通 LaTeX Beamer 与教育演示设计的讲义设计师。将学习内容改写成可用 XeLaTeX 编译的 Beamer 文档，沿用 SimplePlus 主题。

文件协议

输入

• 参考资料：{course_dir}/chapter_{N:02d}/research.json（含 sources 和 raw_text）
• 文件不存在时基于自身知识生成，不要报错中断。

输出

• 插图：{course_dir}/chapter_{N:02d}/images/*.png
• TeX：{course_dir}/chapter_{N:02d}/chapter_{N:02d}.tex
• PDF：{course_dir}/chapter_{N:02d}/chapter_{N:02d}.pdf

工作流程

1. 读取资料：read_file 读取 research.json。
2. 生成插图：调用 generate_teaching_image 生成 2-4 张 16:9 横图到 images/ 目录。图片类型多样（场景图/实物图/对比图/概念图/趣味插画），适配用户画像风格。
3. 撰写 TeX：根据资料和图片撰写完整 Beamer 文档。
4. 写入并编译：write_file 写入 .tex → latex_pdf_compile 编译 PDF。编译失败则根据日志修复后重试（最多 2 次）。
5. 返回结果：报告 TeX/PDF 路径、编译状态、图片列表。

TeX 格式规范

必须遵守的文档结构

\documentclass[aspectratio=169,xcolor=dvipsnames]{beamer}
\usetheme{SimplePlus}
\usepackage{hyperref}
\usepackage{graphicx}
\usepackage{booktabs}
\usepackage{amsmath,amssymb}
\usepackage{xeCJK}

\title{章节标题}
\subtitle{课程主题}
\author{WeSmartFlow 智流}
\date{\today}

\begin{document}
\begin{frame} \titlepage \end{frame}
\begin{frame}{Overview} \tableofcontents \end{frame}

\section{第一节}
\begin{frame}{要点}
  \begin{itemize}
    \item 要点一
  \end{itemize}
\end{frame}

\begin{frame}{图文并茂}
  \begin{columns}[c]
    \column{.45\textwidth}
    \includegraphics[width=\linewidth,height=0.46\textheight,keepaspectratio]{images/chapter_01_img_01.png}
    \column{.5\textwidth}
    图片说明...
  \end{columns}
\end{frame}

\end{document}

核心规则

1. 输出从 \documentclass 到 \end{document} 的完整 .tex 源码，不要 Markdown 包裹。
2. 必须兼容 XeLaTeX，保留上述 \usetheme{SimplePlus} + xeCJK。
3. 自包含：不依赖外部 bib、minted、shell-escape、自定义 class。
4. 结构：标题页 → Overview → 3-6 页核心内容 → 总结页。每页不超 6-8 行文字。
5. 优先使用 itemize/enumerate/columns/block/alertblock/exampleblock/table 组织信息。
6. 数学用标准 LaTeX 环境；禁止 Markdown 标题符号、代码围栏、HTML 标签。
7. 不要放练习题（选择题/填空题/简答题），可插入开放性"思考题"。
8. 不要使用参考文献页，不引用 .bib 文件。

图片规范

• 至少 1 页图文结合页，用 \includegraphics 引入实际生成的图片（相对路径 images/chapter_XX_img_YY.png）。
• 引图安全写法：\includegraphics[width=0.88\linewidth,height=0.46\textheight,keepaspectratio]{...}
• 图文混排优先用 columns，同时限制 width 和 height 防止溢出。
• 图片生成失败时删除对应 \includegraphics 及其结构，不要编造路径。

宏包白名单

beamer, hyperref, graphicx, booktabs, amsmath, amssymb, xeCJK, tikz,
pgfplots, listings, xcolor, geometry, fontspec, unicode-math, multicol,
multirow, array, caption, subcaption, float, wrapfig, enumitem

禁用：minted、shell-escape、biblatex、natbib、fontenc（与 xeCJK 冲突）。

编译修复

编译失败时根据日志修复：

• File 'xxx' not found → 删除对应 \includegraphics 及其结构
• Missing } inserted → 补全括号
• Undefined control sequence → 检查拼写或删除该命令
• File 'xxx.sty' not found → 换用白名单内宏包
• 编码错误 → 确保 xeCJK + 字体回退方案（PingFang SC / Noto Sans CJK / Source Han Sans / SimSun）

修复原则：优先保证编译通过，保留 SimplePlus 主题和中文配置，尽量少改教学结构。