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
9c959c0a2f2e29498b27a7834001f965df19d5d2
Commit Graph
10 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 f87d763602 重写全部 README，只保留使用说明 
17 个 README 统一改成使用说明书，去掉来源、踩坑、需求过程等内容。

只保留：
- 怎么编译、跑几遍
- 文件结构
- 要改哪些参数（逐项列出宏名与含义）
- 用到的命令（表格）
- 版式参数

删除：
- 原文件来源、抽取过程
- 踩坑记录、最小复现、实测数据
- 用户需求、工单号、历史沿革
- 改造前后对比

行数 4185 → 2261。

全库 16/16 编译通过。
 2026-11-01 08:52:54 +08:00
laoyang 5d59aa1853 科技报告字体调整：西文改 Cochineal、标题统一鸿蒙、代码换等宽 #19 
用户反馈「标题一会儿黑体一会儿什么体的」。pymupdf 提取旧 PDF 定位到
三处字体分裂，逐条修掉。

一、西文从鸿蒙换成 Cochineal（cls/font.cls）

旧版 \setmainfont / \setsansfont / \setmonofont 三处全是鸿蒙。中文换成
思源宋体之后，正文就成了「中文衬线 + 西文无衬线」：同一行里英文数字比
汉字细、像陷进去，读起来割裂。

Cochineal 是 Minion 风格的衬线体（OFL 1.1，fonts/cochineal/ 已在库内），
与思源宋体灰度接近；度量与 Termes 只差 1.9%，不推着断行变。

\setsansfont 保持鸿蒙 —— 标题靠 \hm 切到 OUCHM 族，西文 sans 位仍是鸿蒙，
标题的中西文因此都是鸿蒙，与正文区分得开。

二、\hm 重定义为中西文一起切（cls/font.cls，本次核心）

这是「字体一会儿一个样」的真正来源。fonts.tex 里的 \hm 是
    \def\hm{\CJKfamily{OUCHM}}
纯 xeCJK 中文字族切换，管不到阿拉伯数字和拉丁字母。而标题、封面主标题、
摘要标题都用 \hm 表示「这是鸿蒙」，于是凡是标题里夹了西文就还是西文字体：

  · 章节编号 "1." "3.1" → 走 \setmainfont → 旧版是鸿蒙粗，改 Cochineal 后
    变成衬线粗，与中文鸿蒙粗并排
  · "这是一个很好用的 LaTex 模板" 里的 LaTex → 走 \setmainfont
  · 目录条目编号是数字、标题是中文 → 同一条目录两种字体

修法：本模板内把 \hm 重定义为 \hmlatin\CJKfamily{OUCHM}，中西文一起切。
一次在源头解决，不在每个调用点补 \hmlatin —— 后者必然漏（封面、摘要、
目录标题、页眉、文本框标题各漏一次，本次实测漏了 4 处）。

不改 ../fonts.tex 的 \hm：幻灯片和简历也在用，它们没有这个问题，全局改
会外溢。

三、目录条目与页码归零（cls/title.cls）

\cftsecfont 等三条只管条目文字，页码走 \cft*pagefont，不显式清掉的话
目录里页码比标题还粗、最抢眼。两组共 6 条一起设 \normalfont。
不塞 \bfseries：加粗与否是各条目录自己的事，硬加会让二三级也变粗。

四、代码等宽位换 Latin Modern Mono（cls/font.cls）

旧版 \setmonofont 也是鸿蒙 —— 它不是等宽字体，代码里 i/l/1、m/w 宽度
不一，竖向对不齐、缩进看着是歪的。lmmono 是 TeX Live 自带，无需额外
字体文件。

⚠️ 这里不能用 Extension + UprightFont=*-regular：lm 系列文件名本身是
"lmmono10-regular.otf" 已带 -regular，再拼会变成 lmmono10-regular-regular
然后报 cannot be found。给完整文件名、不给 Extension。粗体用
lmmonolt10-bold（同族等宽，换粗体不错位），没有 lmmonobq 这个变体。

五、内容块保留 3 个 Underfull（cls/boxes.cls，只加注释不改代码）

第 208/214/220 行的 \verb|Illuminate\Foundation\Http\Kernel| 是 35 字符
不可断串，在内容块 371pt 内宽里塞不下。试过无效的：\emergencystretch
2em/10em（不是额度不够，是这行没有足够可拉伸 glue）、\sloppy（badness
从 1231 升到 3590，更差）。有效但不采用：\seqsplit（归零但任意字符处
断行，代码路径被切两段）、窄体 lmmonoltcond（归零但压缩可读性）。

结论：保留这 3 个，badness 1231 属轻微（10000 才是严重），渲染只是行末
留白略多。日志里看到它们属预期，不是回归。

六、report.tex 字体说明同步

第 52/58 行原文说「英文字体默认使用鸿蒙」，改后已不准确，重写为
Cochineal + Latin Modern Mono 的实际状况，并说明标题编号统一的原因。

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

  WSL / TeX Live 2025：rc=0，error 0，Overfull 0，Underfull 4，10 页
  Windows / TeX Live 2022：rc=0，error 0，Overfull 0，Underfull 4，10 页

pymupdf 提取字体分布，两侧完全一致：
  Cochineal-Roman 782   OUCSerif-Regular 143   LMMono10-Regular 98
  OUCKai-Regular 33     HarmonyOS_Sans_SC_Bold 22   HarmonyOS_Sans_Bold 14
  OUCSerif-Bold 8       FontAwesome 5   HarmonyOS_Sans_SC 3
  ZhuqueFangsong 2      OUCSans-Regular 2   CMSY10 1   CMEX10 1
  HarmonyOS_Sans 1

标题逐页核对（中西文双档均属鸿蒙）：
  p1 封面   HarmonyOS_Sans_SC_Bold「这是一个很好用的」+ HarmonyOS_Sans_Bold「LaTex」
  p2 目录   HarmonyOS_Sans_SC_Bold「目录」
  p5 摘要   HarmonyOS_Sans_SC_Bold + HarmonyOS_Sans_Bold「LaTex」
  p6 正文   HarmonyOS_Sans_Bold「1.」+ HarmonyOS_Sans_SC_Bold「准备工作」
  p10 正文  HarmonyOS_Sans_Bold「8.」+ HarmonyOS_Sans_SC_Bold「图标」

OUCSans-Regular 2 / ZhuqueFangsong-Regular 2 / HarmonyOS_Sans 1 三处少量
命中已逐个查清，都不是回归：
  · p6「黑体」「仿宋」—— 正文故意演示 \fzzdx / \fzfs 的示例文字
  · p8 每页同 bbox、45° 旋转、29.8pt —— 全页水印，设计如此
  · p10「HTTP/Console」—— 文本框标题走 fonttitle=\hm，改后已是
    HarmonyOS_Sans + HarmonyOS_Sans_SC，中西文都属鸿蒙

涉及文件：
  科技报告/cls/font.cls    默认族、\hm 重定义、等宽位
  科技报告/cls/title.cls   目录条目与页码归零
  科技报告/cls/boxes.cls   仅补 Underfull 记录注释，代码未改
  科技报告/report.tex      字体说明文字同步
 2026-10-29 15:47:33 +08:00
laoyang 7cd542a11f 克隆地址改回真实 code 地址 #17 
上一轮脱敏时把 clone 地址一并换成了 example.org 占位，属过度处理。
code.yangyq.net/laoyang/ouc_latex_template.git 是当前项目的真实地址，
是「用户从哪 clone」的功能信息，不是隐私，改回。

真名「杨永全」与个人账号「dryangyq」的清除不回退。

slides.tex 脚注里的 URL 需转义下划线（ouc\_latex\_template），否则
报 Missing $ inserted；README 是 markdown 不用转义。

验证：slides 重编 0 error / 30 页，PDF 脚注为真实地址、无 example.org 残留。
 2026-10-29 08:35:25 +08:00
laoyang e70339fcf6 全库脱敏：清除真实姓名、个人账号与私有域名 #17 
开源前排查，发现三处真实个人信息残留，全部清除：

1. 真名「杨永全」→ 中性署名「中国海洋大学 LaTeX 模板库」
   幻灯片/ 下 6 个 sty 文件头的「%% 作者：杨永全」。

2. 个人账号 dryangyq → 占位地址
   幻灯片/slides.tex 第 66 行脚注里的 github/gitee/gitlab 三个
   dryangyq 仓库地址，改为 example.org 占位并注明开源后替换。

3. 个人域名 yangyq.net + 私有 Gitea 账号 laoyang → 占位地址
   幻灯片/README.md 与科技报告/README.md 的 clone 地址
   code.yangyq.net/laoyang/... 改为 example.org 占位。

另重编幻灯片/slides.pdf：旧 PDF 的脚注里还印着 dryangyq 与
yangyq.net 的 URL（源码改了但成品没重编），逐字提取确认后覆盖。

验证：
- 全库源码（.tex/.sty/.cls/.md）grep 杨永全 / dryangyq / yangyq /
  yongquan / 永全 全部零命中
- 全库 PDF 成品用 pymupdf 提取渲染文本，上述关键词零命中
- 幻灯片重编 30 页、0 error

未处理（遗留，需另决策）：git 历史 27 个 commit 的作者签名是
「laoyang <i@yangyq.net>」，含个人域名邮箱。若推到公开平台需
git filter-repo 重写历史（改全部 SHA + force push），属破坏性操作，
本单不做。
 2026-10-29 08:17:08 +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 c69f4461dc 科技报告配色统一为幻灯片同一套海大标准色 #5 
改前用的是 xcolor 通用色，跟海大无关：notebox 用 NavyBlue、importantbox
用 Orange、代码关键字纯蓝 rgb(0,0,1)、注释纯绿、代码标题 violet、水印纯灰。
同一个学校两个模板的「蓝」和「红」不是一回事。

新增 cls/color.cls 作为唯一配色入口：
- 10 个基色与 幻灯片/theme/beamercolorthemeOUCSlide.sty 逐值相同
  （前 7 个是官方 2021 版 VI 标准色，后 3 个是幻灯片补充的第三色）
- 8 个语义词别名（oucprimary / oucaccent / oucinfo / oucalert /
  ouccaption / oucrule / ouclink / oucmuted），按语义引用而非色名，
  将来调色只改一行
- 代码配色从标准色派生：关键字→海大蓝、注释→苍松绿、
  字符串→海大红、类型→海大天蓝、边框→专银

各文件改为引用语义色，不再硬写 RGB：
- boxes.cls：notebox NavyBlue→oucinfo，importantbox Orange→oucalert
- code.cls：删掉本地 5 个 definecolor；bashstyle NavyBlue→oucblue；
  bashoutputstyle black!10→codecolorbg + 专银线；行号 gray→oucmuted；
  代码标题 violet→ouccaption
- hyperref.cls：硬写 black→ouclink
- setting.tex：水印纯灰→海大蓝 4%（原 Lightness 会强制切 gray 模型覆盖颜色，已去掉）
- report.cls：加 \input{cls/color.cls}，必须有在 boxes/code 之前

有意保持中性的两处（已在注释里说明理由）：
- shellbox / invertedshellbox：终端反白块语义就该是黑底，
  换成蓝会变成「强调块」抢正文注意力
- 页眉线：彩色页眉线会跟正文海大蓝标题抢视觉层级，仍 0.5pt 黑

验证：错误 0，10 页，Overfull 0，Underfull 保持既有 2 条；
PDF 逐 span 提取文字色只剩 #004098 / #C81528 / #000000，
矢量填充与描边全部落在标准色内，无 NavyBlue / Orange / violet 残留。
 2026-10-26 22:50:19 +08:00
laoyang 62649ef6d6 科技报告封面加校徽：补入 logo 素材与 cover.tex 改动 #4 
上一提交只带进了 logos/README.md，图片与 cover.tex 因暂存顺序问题漏掉，
此处补齐。改动内容与前次提交说明相同：
- 新增 10 张官方 VI 校徽 PNG（横式 4 + 方形 6）
- cover.tex 加 \coverlogo，tikz current page 锚点定位在纸边
  内 20mm，宽 38mm，overlay 不占正文流
- report.pdf 重编，封面含校徽，10 页

验证：错误 0，10 页，Overfull 0，Underfull 保持既有 2 条。
 2026-10-26 22:49:39 +08:00
laoyang 168f4bae5d 科技报告封面加中国海洋大学校徽（官方 VI 横式四色版）#4 
位置：首页左上角，距纸左/纸顶各 20mm，宽 38mm。

用 tikz 的 current page 锚点相对【纸边】定位，而非相对正文框：
- overlay 使 logo 不占正文流，封面下方原有排版位置零变化
  （实测首条横线仍在 41.97mm，改动前后一致）
- 锚点绑在纸边，以后改 cls/geometry.cls 的边距不会让 logo 走位

参数依据：
- 距边 20mm：版心左边距 27mm，logo 再外伸 7mm「挂在页眉区」，
  同时留足 A4 印刷裁切余量（一般 10~12mm）
- 宽 38mm：官方横版比例 3.97，高约 9.6mm；logo 下沿距首条横线
  实测 12.32mm，疏密合适，不再额外加空

新增 logos/ 目录：官方 2021 版 VI 素材，10 张（横式 4 + 方形 6），
含 README 说明每张的适用场合与禁止改动的注意事项。

验证：错误 0，10 页，Overfull 0，Underfull 保持既有 2 条。
 2026-10-26 22:49:32 +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