laoyang
42c1394aec
## 用户诉求
「评分标准最开始不是有个表格吗，里面有开课学院什么的，如果学院名字太长，
就和后面课程名称重合在一起了。看看怎么解决。我建议一行一个信息，
因为这个又不怕长，如果太长，一行都放不下，就直接换行。」
## 现象（已复现并量化）
`dept` 填超长值后，pymupdf 读出：
开课学院：(70.87~123.37) 值：(123.37~406.87)
而第二格「课程名称」本该从 216.0 开始 ⇒ **重叠 190.87bp**，
把「课程名称 / 试卷类型」整个压住。
⚠️ **编译完全不报错，也没有 Overfull**（rc=0 over=0）。
`\makebox` 内容溢出盒外时 TeX 不认为是坏行。这类 bug 只能靠
量 span 坐标发现，看日志发现不了。
## 根因
`\ouckey@inforow` 用三个 `\makebox[0.3333\linewidth][l]` 并排。
`\makebox` 是**不可断盒子**：
- 内容比盒宽短 → 左对齐（正常）
- 内容比盒宽长 → **直接溢出盒外，压到右边一格**（就是 bug）
- 盒内中文**不能换行**（LR 模式，不做段落断行）
⇒ 三格布局对短字段友好，对长字段必然重叠。
## 改动一：一行一项
\newcommand{\ouckey@inforow}[2]{%
\ouckey@ifempty{#2}{}{%
{\fontsize{10.5bp}{15bp}\selectfont
\par\noindent\textbf{#1：}#2\par}}}
调用点从「三参数一组」改成「两参数一行」，共 9 项：
课程名称 / 开课学院 / 学生学院 / 年级专业 / 试卷类型 / 考试方式 /
任课教师 / 命题人 / 满分。顺序按"读者关心程度"排。
行距收紧到 15bp（`\Fivhao` 基线距是 16bp）—— 抬头是查阅信息，
不需要正文行距；9 行省约 52bp，将近 3 行正文。
## 改动二：附带修掉一个旧版就有的判空 bug
**旧实现**：
\newcommand{\ouckey@ifempty}[1]{%
\if\relax\detokenize{#1}\relax ... }
调用 `\ouckey@ifempty{\ouckey@dept}{空}{非空}`。
`\detokenize` **不展开参数**，看到的是字符串 `\ouckey@dept`（宏名），
永远非空 ⇒ 判空永远失败。
后果：`dept = {}` 时抬头印出孤立的「开课学院：」，后面没有值。
这是旧版就有的 bug（三格布局下不明显），改成一行一项后暴露。
**修法**：在 `\define@key` 里就规范化空值，新增
\newcommand{\ouckey@setkey}[2]{%
\if\relax\detokenize{#2}\relax \def#1{}\else \def#1{#2}\fi}
13 个 key 全改走它。
⚠️ 试过「先 `\edef` 展开再 `\detokenize`」的写法，报
`! Incomplete \iffalse` —— `\if...\else...\fi` 被 `\expandafter`
链打散，TeX 匹配 `\fi` 时错位。这类宏层展开的修补太脆，放弃。
⚠️ `\ouckey@setkey` 必须定义在 `\define@key` **之前**，否则 undefined。
## 验证
### 三个场景
| 场景 | 结果 |
|---|---|
| 正常（学院名 12 字） | 9 项齐全，无重叠，无越界 |
| 长（含括号说明，约 40 字） | 单行排到 x=406.90，无重叠（下面没有格子可压） |
| 极长（约 70 字） | **自动换行成两行**，第二行缩进对齐，右缘正好 524.40 |
| 留空（dept/college/major 全空） | 三项**整项不印**，不留空行 |
### 编译
试卷题型示例 6 页 err=0 over=0
参考答案与评分标准 4 页 err=0 over=0
全库 `bash build.sh all` → **13/13 通过，0 失败**。
### 页数变化
答案卷 3 页 → 4 页。抬头从 3 行变 9 行，是「一行一项」的必然代价。
**已向用户确认，接受 4 页**（第 4 页只有说明文字末尾 2 行 + 签字行）。
## 示例文件未改
`参考答案与评分标准示例.tex` 测试后已还原，`git diff` 为空。
只改 `ouckey.sty` 一个文件。
ouc_latex_template
中国海洋大学各类文件 LaTeX 模板。本仓库是本项目唯一的模板维护库，各模板按文档类别分目录存放，互不依赖、可单独编译。
目录
| 目录 | 内容 | 编译入口 |
|---|---|---|
试卷/ |
期末考试试卷、参考答案及评分标准两套模板 | 试卷题型示例.tex、参考答案与评分标准示例.tex |
试卷归档封面/ |
信息科学与工程学部试卷归档封面（理论课） | 试卷归档封面.tex |
试卷归档目录/ |
信息科学与工程学部试卷归档目录（理论课，12 项核对清单） | 试卷归档目录.tex |
年度考核登记表/ |
教职工年度考核登记表 | 年度考核登记表.tex |
劳务发放说明表/ |
劳务发放说明表 | 劳务发放说明表.tex |
特殊事项说明表/ |
报销用特殊事项说明表（事项描述 + 三级签字审批） | 特殊事项说明表.tex |
课程执行大纲/ |
本科课程教学执行大纲 | 课程执行大纲.tex |
课程教学日历/ |
学校通用版课程教学日历（理论课程）（附件3，16 周日历表） | 课程教学日历.tex |
成绩构成说明/ |
成绩构成说明（理论课/实验课比例分解表 + 教师签字栏） | 成绩构成说明.tex |
幻灯片/ |
演示文稿（beamer 主题，海大配色） | slides.tex |
科技报告/ |
科技报告、实验讲义、说明文档 | report.tex |
简历/ |
个人简历（中文，A4 两栏式，含圆形头像与分区条目） | 简历.tex |
编译
全部模板都必须用 XeLaTeX（fontspec + xeCJK），pdflatex 编译不过：
cd 幻灯片
xelatex slides.tex
xelatex slides.tex # 跑两遍，第二遍才能取到正确的目录、交叉引用与总页数
目录名含中文不影响编译（已实测 12 个模板目录在中文目录下零报错编译通过）。
说明
- 字体单一来源：全库字体集中在根目录
fonts/，由fonts.tex统一加载。十二个模板通过\input{../fonts.tex}取字体，不自带字体、不依赖系统字体——换机器（Windows / macOS / Linux / Overleaf）编译结果一致。 - 全部开源可商用：无方正、无 SimSun / SimHei / KaiTi / FangSong、无 Times New Roman、无微软雅黑。用的是思源宋体/黑体、霞鹜文楷、朱雀仿宋、TeX Gyre Termes、Cochineal、鸿蒙 HarmonyOS Sans（各字体授权见
fonts/LICENSE，来源与字符集见fonts/README.md）。 - 每个子目录自包含：样式文件（
.sty/.cls）、图片都在各目录内，编译时不需要额外的宏包搜索路径；只有字体是共享的上层目录。 - 各目录的
README.md写明该模板的用法、可改参数、版式数据来源与书写注意事项，改之前先看。 - 示例内容全部虚构：为了让人一眼看出排版效果，模板里填的是一整套连贯的假想数据（虚构教师「张远航」、虚构课程《数字逻辑》2025 秋、虚构的论文 / 专利 / 项目 / 获奖），不是满篇
×。这些内容不含任何真人信息、不含真题，纯粹是为了让版式跑起来有真实感，使用时整体替换成自己的内容即可。- 跨模板虚构设定是统一的：教学日历、成绩构成说明、试卷归档封面、试卷都对应《数字逻辑》2025 秋学期；简历里的论文 / 专利 / 项目 / 获奖属于同一位虚构人物。
- 一眼可辨的假数据特征：DOI 统一
10.9999/…、专利号统一ZL209999…、软著登记号2024SR99999…、手机号138 0000 0000、邮箱用example.net。 - 少数必须留空让人手填的位置（签字、日期、评语栏）仍然是空白或
×，这类不能编——编了就分不清哪儿该改了。
字体
| 目录 | 字体 | 上游 | 授权 |
|---|---|---|---|
fonts/ouc-serif/ |
OUC Serif（宋体） | 思源宋体 SC 的 GB2312 子集 | SIL OFL 1.1 |
fonts/ouc-sans/ |
OUC Sans（黑体） | 思源黑体 SC 的 GB2312 子集 | SIL OFL 1.1 |
fonts/ouc-kai/ |
OUC Kai（楷体） | 霞鹜文楷的 GB2312 子集 | SIL OFL 1.1 |
fonts/zhuque-fangsong/ |
朱雀仿宋（仿宋） | 朱雀仿宋 | SIL OFL 1.1 |
fonts/tex-gyre-termes/ |
TeX Gyre Termes（西文，全库默认） | Times New Roman 度量兼容替代 | GUST Font License |
fonts/cochineal/ |
Cochineal（西文，仅 简历/ 用） |
Minion 风格，Michael Sharpe | SIL OFL 1.1 |
fonts/harmonyos-sans/ |
HarmonyOS Sans（幻灯片/科技报告） | 华为 | 华为官方允许免费商用 |
合计约 50 MB（改造前 141 MB，见 fonts/README.md 第五节）。
子集字体已按 OFL §3 改名（
Source/LXGW是上游的 Reserved Font Name，裁剪即构成修改版），并保留了 OFL 声明。 用本模板编译出的文档不受这些字体授权约束，版权归作者本人。
历史沿革
幻灯片/ 与 科技报告/ 此前分别维护在两个独立仓库（ouc-slide-latex-template、ouc-report-latex-template），2026-10 起并入本仓库统一维护，两个旧仓库不再更新。迁入时保留了原有目录结构、字体与图片资源，旧仓库的提交历史留在原仓库中。