目录页改为自适应方框样式，并在 TeX Live 2023 下编译验证
把每一个一级标题放进独立的方框，方框高度与字号随章节数目自动计算，
方框自动均分铺满整页；文字左对齐，左侧只留少量缩进。
新增 \settocstyle{box|solid|bar} 三种方框样式（未知值告警并回退 box），
新增 \toctheme{red|blue} 两种配色（默认海大红，与各章节标题页同色）。
本分支已用 TeX Live 2023 亲自编译验证：0 错误、0 溢出、23 页，
目录页 4 个跳转链接正常，且与本仓库其他分支渲染一致。
This commit is contained in:
@@ -31,6 +31,64 @@
|
||||
3. 可以安装其他的IDE工具进行Tex文件的编写和修改，推荐使用<a href="https://code.visualstudio.com/" target="_blank">Visual Studio Code</a>。
|
||||
4. 编译时，请选择XeLaTex，有时候，可能需要连续编译两次，以得到正确的页码和图表编号。
|
||||
|
||||
# 分支与编译器版本
|
||||
|
||||
本仓库按 **TeX Live 年份**组织分支，规则很简单：**分支名是哪一年，就说明该分支可以用那一年的 TeX Live 直接编译通过**。
|
||||
|
||||
| 分支 | 对应 TeX Live | beamer 版本 | 说明 |
|
||||
|------|---------------|-------------|------|
|
||||
| `main` | 最新版 | 最新 | 始终指向最新的年份分支（当前等于 `2026`） |
|
||||
| `2026` | TeX Live 2026 | 3.77 | 无需改动源码即可编译通过 |
|
||||
| `2025` | TeX Live 2025 | 3.72 | 无需改动源码即可编译通过 |
|
||||
| `2024` | TeX Live 2024 | 3.71 | 无需改动源码即可编译通过（PDF 体积说明见下） |
|
||||
| `2023` | TeX Live 2023 | 3.69 | 适配 beamer 3.69 的 frametitle 变更，并修复 allcaps 选项 |
|
||||
| `2022` | TeX Live 2022 | 3.66 | 保留早期 beamer 的写法（旧版 frametitle 补丁） |
|
||||
|
||||
### 两点说明
|
||||
|
||||
**一、各分支的 PDF 都是用对应年份的 TeX Live 编译出来的。**
|
||||
也就是说，`2023` 分支里的 `slides.pdf` 出自 TeX Live 2023，
|
||||
`2026` 分支里的出自 TeX Live 2026，以此类推。功能上各分支内容一致，
|
||||
差别只在于适配各自 beamer 版本的源码写法。
|
||||
|
||||
**二、`2024` 分支的 PDF 体积明显偏大（约 9.7 MB，其他年份约 2.4 MB）。**
|
||||
这是 TeX Live 2024 的 `xdvipdfmx` 一度不做跨页图像去重导致的，
|
||||
从 TeX Live 2025 起恢复正常。**页面渲染内容与其他年份完全一致**，不影响使用。
|
||||
|
||||
## 我该用哪个分支
|
||||
|
||||
- **想用最新版本**：直接用 `main` 分支，并配合**最新版 TeX Live**。
|
||||
- **本机已经装了某个特定年份的 TeX Live**：切到**同名的那个分支**即可。
|
||||
|
||||
```bash
|
||||
# 例如本机是 TeX Live 2023，就用 2023 分支
|
||||
git clone -b 2023 https://code.yangyq.net/laoyang/ouc-slide-latex-template.git
|
||||
|
||||
# 已经克隆过的仓库，可以这样切换
|
||||
git checkout 2023
|
||||
```
|
||||
|
||||
简单说：**编译器是哪一年的，就用哪一年的分支**，不需要自己去改模板代码。
|
||||
|
||||
## 为什么要这样分
|
||||
|
||||
beamer 的内部实现会随 TeX Live 版本变化，而模板中对内部宏的补丁（`\patchcmd`）会因此失效。最典型的一次是：
|
||||
|
||||
- **beamer 3.69（TeX Live 2023）** 起，`\beamer@@frametitle` 改用 `\beamer@insertframetitlecontinuation`，使得面向旧版写法的补丁匹配失败，报 `Patching original frame title failed`。
|
||||
- 模板现已加入**版本自动判别**（依据 `\beamer@insertframetitlecontinuation` 是否存在，判断逻辑写在文件顶层），因此 `2023` 及之后的各年份分支**不需要再改动源码**。
|
||||
- `2022` 分支保留原始写法，只保证在 TeX Live 2022（beamer 3.66）下编译通过。
|
||||
|
||||
## 维护约定
|
||||
|
||||
每当有新的 TeX Live 年份发布时：
|
||||
|
||||
1. 在新版本的 TeX Live 下，用 **XeLaTeX 编译当前的 `main`**；
|
||||
2. 如果编译不通过，进行修复，注意保持向后兼容，不要破坏旧年份分支；
|
||||
3. 修复通过后，新建一个**以该年份命名**的分支并提交；
|
||||
4. 把该年份分支**快进合并到 `main`**，让 `main` 始终是最新版本。
|
||||
|
||||
> 附注：不同年份的 TeX Live 生成的 PDF 在体积上可能略有差异（例如 TeX Live 2024 的 xdvipdfmx 曾一度不做跨页图像去重，导致成品偏大约 4 倍），但**页面渲染内容是一致的**，不影响使用。
|
||||
|
||||
# 元素介绍
|
||||
## 基本信息
|
||||
Tex文件的开头，是基本信息部分，可以根据需要添加`\title`{标题}、`\subtitle`{子标题}、`\author`{作者}、`\date`{\today}、`\institute`{所属机构}。
|
||||
@@ -50,6 +108,74 @@ Tex文件的开头，是基本信息部分，可以根据需要添加`\title`{
|
||||
|
||||
首页和结尾页，使用的是基本信息中的数据，而目录页的内容，将根据`\section`进行填充。
|
||||
|
||||
## 目录页样式（自适应方框）
|
||||
|
||||
目录页默认使用**自适应方框**样式：每一个一级标题（`\section`）被放进一个独立的方框里，**方框的高度、以及方框内文字的字号，都会根据一级标题的数目自动计算**，并且方框会自动均分、铺满整个目录页。章节少时方框又高又大、字号醒目；章节多时方框自动变矮、字号自动缩小，不需要手工调任何一个数字。
|
||||
|
||||
方框内的文字**左对齐**，左侧只留一点点缩进，读起来更像一份正常的目录。
|
||||
|
||||
|
||||
|
||||
### 配色：默认海大红，蓝色可选
|
||||
|
||||
目录页默认使用**海大红**（`oucred`）——和各章节标题页的颜色保持一致。
|
||||
|
||||
这是因为目录页上「目录」二字本身是**海大蓝**的，如果目录项再用蓝色，整页就分不出层次。用海大红正好和章节标题页呼应。
|
||||
|
||||
如果就喜欢蓝色，改一行即可切回海大蓝：
|
||||
|
||||
```
|
||||
\toctheme{red} % 默认：海大红，与各章节标题页同色
|
||||
\toctheme{blue} % 海大蓝，与目录页标题「目录」同色
|
||||
```
|
||||
|
||||
|
||||
|
||||
### 三种方框样式
|
||||
|
||||
在导言区用一行命令即可切换，样式与配色可以自由组合：
|
||||
|
||||
```
|
||||
\settocstyle{box} % 默认：浅色底 + 圆角框 + 圆形序号
|
||||
\settocstyle{solid} % 实心色底 + 白色文字
|
||||
\settocstyle{bar} % 白底 + 左侧粗色条
|
||||
```
|
||||
|
||||
|
||||
|
||||
|
||||
章节较多时（下面这张是 9 个一级标题），方框和字号会自动压缩：
|
||||
|
||||
|
||||
|
||||
### 可调参数
|
||||
|
||||
所有参数都可以在导言区用 `\setlength` 覆盖，一般**不需要改**：
|
||||
|
||||
| 参数 | 默认值 | 含义 |
|
||||
|------|--------|------|
|
||||
| `\tocareamargin` | `52pt` | 目录区上下预留的高度（自动模式下从 `\textheight` 中扣除） |
|
||||
| `\tocareaheight` | `0pt` | 直接指定目录区高度；`0pt` 表示自动 |
|
||||
| `\tocboxgap` | `10pt` | 方框之间的理想间距（空间紧张时会自动压缩） |
|
||||
| `\tocboxgapmin` | `2pt` | 方框之间允许的最小间距 |
|
||||
| `\tocboxmaxheight` | `110pt` | 单个方框的最大高度 |
|
||||
| `\tocboxleftpad` | `2.5pt` | 方框内文字距左边框的距离（只留一点点） |
|
||||
| `\tocfontmax` | `26pt` | 方框内文字的最大字号 |
|
||||
| `\tocfontwarn` | `8pt` | 字号低于该值时会给出警告 |
|
||||
|
||||
例如，希望方框之间更紧凑一些：
|
||||
|
||||
```
|
||||
\setlength{\tocboxgap}{6pt}
|
||||
```
|
||||
|
||||
### 几点说明
|
||||
|
||||
1. **目录页需要连续编译两次**：章节数目是从上一次编译生成的 `.toc` 文件里读出来的。第一次编译时 `.toc` 还是空的，目录页会是空白，再编译一次即可正常。
|
||||
2. 方框的序号和标题是**超链接**，在 PDF 里点击会直接跳到对应章节。
|
||||
3. 一级标题**太多时（大约 9 个以上）**，方框和字号会变得偏小，编译日志里会有 `oucslide Warning` 提示。这种情况下建议合并章节，或者把目录页改回普通的列表样式。
|
||||
4. 如果确实想换回旧版那种简洁的列表目录，把 `\makeoutline` 里的 `\ouc@toc@body` 换回 `\tableofcontents[hideallsubsections]` 即可（旧的模板定义仍保留在 `beamerouterthemeOUCSlide.sty` 中）。
|
||||
|
||||
## 使用分节
|
||||
|
||||
本模板使用分节进行整体规划，章节共三级，对应的关键字分别是：
|
||||
|
||||
Reference in New Issue
Block a user