CSUBeamer 是一套面向中南大学场景的 Beamer 模板。这一版定位为公开可发布的 v1.1.0。项目保留现有品牌语言，不做无参考的视觉重设计，当前目标是把默认路线、深浅色路线和主要导航路线打磨到稳定可用，让新用户按一条最短路径就能在 5 分钟内做出第一份演示稿。
项目的唯一公共入口仍然是 \usetheme[...]。封面风格、色彩、亮度、导航和 logo 位置都从这一处进入，没有第二套并行配置 API。
如果只想最快做出第一份稿子，直接改 main.tex。编译器用 XeLaTeX，输出默认落在 build/，不会再把 PDF 长期留在仓库根目录。
% !TeX program = xelatex
\documentclass[aspectratio=169,fontset=fandol]{ctexbeamer}
\usetheme[formal,blue,light,miniframes]{csubeamer}
\title{报告标题}
\subtitle{副标题}
\author{Bill Billion}
\institute{中南大学~~学院名}
\date{2026 年 3 月}
\begin{document}
\maketitle
\begin{frame}{目录}
\tableofcontents[hideallsubsections]
\end{frame}
\section{第一节}
\begin{frame}{这一页要讲什么}
把正文写在这里。
\end{frame}
\makebottom
\end{document}本地最短命令是下面这两行：
make main
open build/main.pdf如果不用 make，也可以直接运行 latexmk -xelatex -halt-on-error -interaction=nonstopmode -file-line-error -outdir=build main.tex。
仓库里保留了五份公开示例。它们各自负责一条清晰路径，不再让一个示例同时承担所有功能说明。
| 文件 | 适合场景 | 说明 |
|---|---|---|
main.tex |
第一次使用模板 | 默认最小路径，只保留封面、目录、正文和结束页。 |
report.tex |
组会、开题、中期答辩 | 学术汇报骨架，展示表格、图表、结构图和 infolines。 |
dark.tex |
夜间汇报、大屏播放 | 展示 dark 现在是完整页面语义，不只是深色导航条。 |
custom.tex |
想在现有主题上继续定制 | 展示 custom 骨架和 \setbeamertemplate 覆写方式。 |
english.tex |
英文汇报 | 展示 beamer 文档类下的英文工作流。 |
这一版把“完全支持”和“实验支持”明确分开。完全支持的交叉组合已经纳入编译、日志和渲染检查。实验支持导航还保留，但目前只做轻量 smoke check，不再对外承诺与默认路线同级稳定。
| 维度 | 完全支持 | 实验支持 |
|---|---|---|
| 封面风格 | formal / academic / minimal |
custom 作为可运行骨架提供，不算矩阵主路线 |
| 色系 | blue / red |
无 |
| 亮度 | light / dark |
无 |
| 导航 | miniframes / infolines / default / sidebar |
smoothbars / split / shadow / tree / smoothtree |
完全支持矩阵等价于 3 x 2 x 2 x 4。检查时会固定导出封面页、目录页、普通内容页和结束页快照，用来确认标题可见、正文完整、页脚不贴边、导航不重叠、logo 不裁切。
可选项仍然通过 \usetheme[...] 组合。常用写法如下：
\usetheme[formal,blue,light,miniframes]{csubeamer}
\usetheme[academic,red,dark,infolines]{csubeamer}
\usetheme[custom,blue,light,sidebar]{csubeamer}| 类别 | 取值 | 说明 |
|---|---|---|
| 封面 | formal / academic / minimal / custom |
custom 现在是可运行骨架，不再输出空白页。 |
| 色系 | blue / red |
默认 blue。 |
| 亮度 | light / dark |
dark 会切换整页正文、标题、Block、目录和页脚语义。 |
| 语言 | zh / en |
ctexbeamer 默认走中文，beamer 可显式加 en。 |
| 导航 | miniframes / infolines / default / sidebar 等 |
公开稳定路线优先使用完全支持的四种。 |
| Logo 位置 | topright / bottomright |
bottomright 走独立安全区叠加，不再挤占页脚。 |
兼容别名 maxplus、max、min、my 仍然保留，对应 formal、academic、minimal、custom。
custom 的定位不是“你自己从空白页开始搭建”，而是“先给一套最小可运行骨架，再按 Beamer 原生方式覆盖”。对用户文档来说，推荐在自己的 .tex 里用 \setbeamertemplate 覆写；如果你在维护主题包本身，可以继续用 \defbeamertemplate* 定义模板。
\usetheme[custom,blue,light,sidebar]{csubeamer}
\setbeamertemplate{csutitlegraphic}{%
% 自定义标题页图形槽位
}
\setbeamertemplate{bottom page}{%
% 自定义结束页
}这种方式更稳，因为颜色、导航、页脚和深浅色逻辑仍由主入口接管，自定义只集中在页面模板本身，后续升级也更容易合并。
\csubadge、\csuwordmark、\csuvertical、\csusealstack、\csumotto 这些命令名没有变化。底层资源解析现在是“PDF 优先，缺失时回退 PNG”，这样在支持矢量资源的环境里会优先得到更干净的渲染。
默认构建出口固定为 build/。如果只想编译公开示例，可以直接运行下面的命令：
make examples如果要跑完整检查，可以运行：
make check这条命令会做三层检查。第一层编译公开示例、完全支持矩阵和实验导航 smoke 文档。第二层扫描日志，默认拦截 LaTeX Error、Annotation out of page boundary、明显的 Overfull 和 Underfull。第三层把关键页导出成 PNG，结果统一写到 build/check/snapshots/，汇总写到 build/check/summary.txt。
| 问题 | 说明 |
|---|---|
dark 为什么和旧版看起来不一样 |
因为它现在是完整页面模式，正文、标题、Block、目录和页脚会一起切换。 |
custom 还能不能完全重写 |
可以。它现在先给最小骨架，再通过原生模板接口覆盖。 |
sidebar 适合什么时候用 |
适合课程汇报、项目路演、分节明显的讲稿。正文特别密、表格特别宽的页不建议优先选它。 |
| 为什么仓库根目录没有示例 PDF 了 | 因为产物已经收口到 build/，新用户不会在多个 PDF 之间混淆当前结果。 |
| 英文汇报该从哪里开始 | 直接看 english.tex，它走的是 beamer 文档类和英文元数据。 |
| 路径 | 作用 | 备注 |
|---|---|---|
beamerthemecsubeamer.sty |
主题主入口 | 负责选项分派。 |
beamercolorthemecsubeamer.sty |
颜色主题 | 管理 blue/red 和 light/dark 语义色。 |
beamerfontthemecsubeamer.sty |
字体主题 | 管理标题、正文和结构字体。 |
beamerinnerthemecsubeamer.sty |
内部主题 | 管理封面分派、列表、Block、目录和代码块。 |
beamerouterthemecsubeamer.sty |
外部主题 | 管理导航、标题栏、页脚和 logo 安全区。 |
csuvi.sty |
视觉识别库 | 提供颜色定义和 logo 命令。 |
csucover.sty |
封面模板库 | 提供标题页、结束页和分节页模板。 |
scripts/check.sh |
回归检查脚本 | 编译、日志和快照检查都在这里。 |
宏包与主题文件的许可说明见 LICENSE.txt。assets/csu/ 目录中的校徽、校名和相关视觉资源版权归中南大学所有，使用时需要遵守学校的视觉识别要求。