laoyang/ouc_latex_template
1
0
Fork 0
Code Issues 1 Pull Requests Actions Packages Projects Releases Wiki Activity
50 Commits 1 Branch 0 Tags
main
Commit Graph
5 Commits
Author SHA1 Message Date
laoyang 3906bb49a4 清理代码库中的开发过程内容 
- 删除 WORKFLOW.md（开发流程文档，已移入记忆库）
- build.sh 去掉 WSL 相关说明
- 33 个源文件的注释：去掉踩坑记录、实测推导、原文件对比、工单号引用
- 保留技术参数、约束说明、命令含义

净删 399 行。全库 16/16 编译通过。
 2026-11-01 09:29:00 +08:00
laoyang 42c1394aec 答案卷抬头改为一行一项，修复长学院名重叠 #22 
## 用户诉求

「评分标准最开始不是有个表格吗，里面有开课学院什么的，如果学院名字太长，
就和后面课程名称重合在一起了。看看怎么解决。我建议一行一个信息，
因为这个又不怕长，如果太长，一行都放不下，就直接换行。」

## 现象（已复现并量化）

`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` 一个文件。
 2026-10-29 22:58:34 +08:00
laoyang 93b03c8a78 试卷字体统一为思源宋体 #20 
用户要求：「试卷的字体，需要改一下，全部都用思源宋体就可以了。」

pymupdf 提取两份成品 PDF 定位到四类需要统一的字体：

  试卷题型示例（6 页）            参考答案与评分标准示例（3 页）
  OUCSerif-Regular 203 中文        OUCSerif-Regular 333 中文
  TeXGyreTermes-Regular 133 西文   TeXGyreTermes-Regular 197 西文
  TeXGyreTermes-Bold 85 题号分值   OUCSans-Regular 37 黑体小标题
  OUCSerif-Bold 81 中文加粗         CMR10/CMMI10/CMSY10 49 数学公式
  OUCKai-Regular 25 卷头与成绩表    TeXGyreTermes-Bold 21 数字

一、西文与数字：Termes → 思源宋体（oucexam.sty / ouckey.sty）

先在包里用 \newfontfamily 登记 \OUCLatinSerif / \OUCLatinSerifBold
（四个档位全给，斜体指回 Regular —— 思源宋体没有真斜体），再把
\tnr / \tnrb / \sunfont 都 \let 过去。

⚠️ 只做这一步**不够**，这点踩了一轮：模板里大量文字根本没走 \tnr，
而是走 \setmainfont（默认西文族）——\textbf{learning outcome} 的裸西文、
页脚的页码与总页数、任何 \selectfont 之后的裸 ASCII。
第一轮只 \let 时，PDF 里仍残留 22 个 TeXGyreTermes span：
页脚 6 个页码 + 6 个总页数 + 第 4 页的 A./B./C./D. 与 learning outcome 等。
⇒ 必须连 \setmainfont / \setsansfont 一起指到 OUCSerif。

二、卷头与成绩表题号：霞鹜文楷 → 思源宋体（oucexam.sty）

\kh 与 \scoretable 用 \kaiti。包里 \let\kaiti\songti 一次性收口，
不动 ../fonts.tex 的 \def\kaiti —— 别的模板还要用楷体。

三、答案卷黑体小标题：思源黑体 → 思源宋体（ouckey.sty）

\heiti 共 37 处（卷头大标题与各节小标题）。同样 \let\heiti\songti。

四、数学公式：保持不动

$x$ / $\dfrac{1}{45}\sum f_i x_i$ 等 49 处仍走 Computer Modern。
思源宋体没有 MATH 表（实测只有 GSUB/GPOS），不能作数学字体；
强行塞进正文字体会破坏斜体变量、正体数字、运算符间距。用户已确认。

五、装订线虚线：连字符排字 → 用线画（oucexam.sty）

原卷那 6 段竖虚线是 18bp Times 连字符排出来的。换成思源宋体后连字符
每个宽 0.346 em（Termes 0.333），每串会长 4~7bp，破坏"复刻原卷长度"。
⇒ 改为几何画的短横线段，长度锁死。实测原卷（720dpi 逐笔画测量）：
  单个连字符笔画 长 4.40bp、粗 1.10bp、x 中心 51.60bp
  相邻笔画步距 6.00bp
新增 \ouc@dashseg{起点y}{笔画数}，六段坐标与笔画数逐段照抄原卷
（含原卷被白底遮断成 13+3 两截的那一段）。
⚠️ \newcommand 必须定义在 \ouc@dobindstrip 外面，否则每次 shipout
重新定义，第二页起报 already defined。
⚠️ y 坐标不能写 \dimexpr#1bp+\i*6bp —— TikZ 坐标解析器不认小数 +
\dimexpr 组合，报 Illegal unit of measure。要先 \pgfmathsetmacro。

六、直引号归入 CJK（ouckey.sty）

答案卷正文用 ASCII 直引号 "" 表示中文引号（32 处）。U+0022 在
Basic Latin，xeCJK 判为西文 ⇒ 引号走 \setmainfont，与两侧汉字不同字体，
并挤压出 Overfull（第 88 行 +8.07pt）。
\xeCJKDeclareCharClass{CJK}{"0022} 归位后解决。
⚠️ 不在 fonts.tex 里改：那里全库共用，会让正文真正的英文引号（代码
   片段 "hello world"）也变全角。

七、Overfull 的修法：改源码断行，不调参数（ouckey.sty 留有完整记录）

换字体后 \keyitem{3}{4} 那段 Overfull 2.61pt，实际压出版心
（最右 527.01bp，版心止于 524.41）。试过并确认**全部无效**的五种：
  · \emergencystretch 1.5em —— 本行没有弹性胶可拉，无从施展
  · \tolerance 3000 —— 不是不满意断点，是没有更早的合法断点
  · PunctStyle=kaiming —— 能消 Overfull，但标点悬挂探出版心 6.5bp
  · PunctStyle=quanjiao —— 同样探出 8bp
    （xeCJK 这几个 PunctStyle 做的是"标点悬挂"不是"标点压缩"，
      指望它消 Overfull 必翻车）
  · \rightskip 0pt plus 6bp（含 \AtBeginDocument 版）—— 6bp 远小于
    需要的 150bp，TeX 仍选"撑破"这个解
正解：第 124 行句号「。」后加 \\。分项给分的答案本来就该一句一行，
读者靠句号扫分点 —— 既解决排版，又让内容结构更清楚。

验证（两套环境各跑，逐项同数）

  WSL / TeX Live 2025    试卷 rc=0 err=0 over=0 6页
                         答案卷 rc=0 err=0 over=0 3页
  Windows / TeX Live 2022 试卷 rc=0 err=0 over=0 6页
                         答案卷 rc=0 err=0 over=0 3页

pymupdf 提取字体分布：

  试卷题型示例      OUCSerif-Regular 291 + OUCSerif-Bold 70
                    → 非宋体文字字体：无
  参考答案示例      OUCSerif-Regular 235 + OUCSerif-Bold 53
                    + CMR10/CMMI10/CMSY10/CMMI7/CMEX10（数学，保留）
                    → 非宋体文字字体：无

几何核对（逐 span 比对，均与基线一致或更优）：
  · 成绩表 17 栏逐字符坐标与基线**完全相同**（硬编码坐标，不受字体影响）
  · 装订线 96 笔全部绘出：x 49.40~53.60（宽 4.40bp）、步距 6.00bp，
    六段位置与原卷实测一致
  · 三页最右墨迹均为 524.41bp，与版心严丝合缝，无越界
  · 试卷 6 页最右最大 523.33bp（第 4 页 \mtpair 的 44% 栏宽设计，
    基线同位置同样数值，非本次引入）

涉及文件：
  试卷/oucexam.sty                 默认族、西文字族、\kaiti、装订线虚线
  试卷/ouckey.sty                  默认族、西文字族、\heiti、直引号、踩坑记录
  试卷/参考答案与评分标准示例.tex  第 124 行句号后加断行
 2026-10-29 21:29:15 +08:00
laoyang 8aa979739a 字体统一：建公共字体目录，全部改用开源可商用字体 (#6) 
七个模板原先分两套做法：幻灯片/fonts（49MB 鸿蒙 18 个字重）与
科技报告/font（92MB，含 5 款方正商业字体），其余模板直接调系统
SimSun/SimHei/KaiTi/FangSong/Times New Roman。换机器就编不出来，
方正系列也不允许随仓库分发。

统一到仓库根的 fonts/ + fonts.tex：
- OUC Serif（思源宋体 SC 子集）   —— 宋体
- OUC Sans（思源黑体 SC 子集）    —— 黑体
- OUC Kai（霞鹜文楷子集）          —— 楷体
- Zhuque Fangsong（朱雀仿宋）      —— 仿宋
- TeX Gyre Termes                  —— 西文 Times 等价（度量逐字相同）
- HarmonyOS Sans                   —— 幻灯片/科技报告原有字体

fonts.tex 是唯一允许声明字体的地方，7 个模板全部 \input 它。
字体体积 141MB -> 49MB（去掉重复），全库共用一套最小集合。

几处踩过的坑（均已写进源码注释）：
- \newCJKfontfamily 与 ctex 默认 fontset 冲突会中断编译，改用
  \setCJKfamilyfont + \def
- \newfontfamily 缺粗体档会让 \bfseries 静默失效，四档必须全给
- UprightFont= 与主参数不能同时给，否则文件名被拼两次
- Path= 相对编译时工作目录，不是相对 .sty
- ×/□/○ 等符号按 Unicode 区段被判成西文，需 \xeCJKDeclareCharClass
- 中文斜体的 ItalicFont 与主字体不在同一目录，须在 ItalicFeatures
  里单独写 Path/Extension（否则报 OUCKai-Regular cannot be found）

顺带：
- 科技报告 report.tex 的字体演示正文改为新字体名（原文写着方正系列）
- 试卷归档封面新模板并入本库
- 科技报告 shell 命令框底色改海大蓝（#5 遗留）

验证（7 个模板 8 个 PDF 全量重编 + 逐行 A/B 对照）：
- 错误 0，缺字 0
- 幻灯片 362 行逐行完全一致，零漂移
- 年度考核登记表 / 劳务发放说明表 / 试卷题型示例 / 参考答案 文本完全一致
- 课程执行大纲 仅 2 处断字连字符差异（throughout、processing），
  1 条 6.39pt Overfull 已论证不可见（距纸张右边缘仍有 20.7mm）
- 科技报告 内嵌字体方正归零，只剩 OUC Serif/Sans/Kai + Zhuque
- 全库正文 857 个非 ASCII 字符，四款中文字体（含粗体）覆盖 100%
 2026-10-27 00:43:14 +08:00
laoyang 1f807e9cce 所有模板目录改为中文名，并入幻灯片与科技报告两个仓库（#3） 
目录改名（git mv 保留历史，包名不变）：
  exam/   -> 试卷/
  form/   -> 年度考核登记表/
  form2/  -> 劳务发放说明表/
  course/ -> 课程执行大纲/

改名即可编译：实测 6 个模板在含中文的目录下 XeLaTeX 均零报错，
PDF 逐页文本与改名前的版本完全一致（0 页差异，仅元数据时间戳变化）。

并入两个此前独立维护的仓库：
  ouc-slide-latex-template  -> 幻灯片/
  ouc-report-latex-template -> 科技报告/
带入了 theme/ fonts/ logos/ figs/ cls/ input/ 与 fontawesome.pdf，
字体随模板附带（无须在系统安装）。中间文件一律不入库。

同步修正的文档：根 README 目录表改为中文名并说明统一维护；
四个子 README 的标题；ouclw.sty 注释里对 form/ 的交叉引用；
幻灯片与科技报告 README 里「从旧仓库 clone」「按年份切分支」等已失效的说明
（并入后只有 main 一个分支，各年份 TeX Live 通用）。

两个迁入模板的 PDF 保留源仓库原版（逐字节一致），未重新编译：
源 PDF 出自 TeX Live 2026，本机为 2022，重新编译会让结尾页装饰层定位
产生细微偏移，保留原版以保证样张与原来完全一致。
 2026-10-26 18:31:04 +08:00