laoyang
5d59aa1853
用户反馈「标题一会儿黑体一会儿什么体的」。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 字体说明文字同步
中国海洋大学科技报告 LaTeX 模板
一个基于 ctexart 的科技报告模板，可用于撰写科技报告、实验讲义、教程、说明文档等。
本目录原为独立仓库
ouc-report-latex-template，2026-10 起并入ouc_latex_template统一维护，旧仓库不再更新。
特性
- 中英文字体一体化：英文默认使用鸿蒙字体（HarmonyOS Sans），中文使用仓库公共字体包（宋体 / 宋体粗 / 楷体 / 仿宋 / 黑体），字体文件在仓库根
../fonts/目录，编译时自动调用，无须安装任何字体； - 模块化文档类：
report.cls按功能拆分为cls/下的多个模块（全局设定、字体、页面布局、标题、页眉页脚、信息框、代码块等），便于按需修改； - 三种信息框：
titledbox（带标题）、notebox（提示）、importantbox（重要），基于 tcolorbox 实现； - 代码排版：基于 listings 预设了多种样式，支持行内命令
shellbox/invertedshellbox展示 shell 命令及输出； - 自动水印：默认以「单位 + 部门」作为全页水印，可在
input/setting.tex中调整文字、透明度与大小； - 图表与引用：tabularx 表格、图片插入、自动编号与交叉引用、目录 / 图目录 / 表目录；
- 图标支持：通过 fontawesome 可直接使用
\faHeart等图标命令（详见根目录fontawesome.pdf）。
环境要求
- TeX 发行版：TeX Live 2022 及以上（必须使用 XeLaTeX 编译）；
- 无需额外安装字体或其他依赖，使用
scheme-full或包含常用宏包的发行版即可。
使用方法
-
本目录是
ouc_latex_template仓库的科技报告/子目录，克隆主仓库即可：git clone https://code.yangyq.net/laoyang/ouc_latex_template.git cd ouc_latex_template/科技报告 -
在
input/info.tex中填写标题、副标题、作者、单位、部门等信息； -
在
report.tex中撰写正文（或按\input方式组织章节文件）； -
使用 XeLaTeX 编译两遍（第一遍生成目录与交叉引用信息，第二遍写入正文）：
xelatex report.tex xelatex report.tex -
临时切换字体可使用命令：
\fzss（宋体）、\fzxbs（宋体粗）、\fzkai（楷体）、\fzfs（仿宋）、\fzzdx（黑体）、\hm（鸿蒙字体）。命令名沿用旧版（fz 取自原方正系列），实际用的是随仓库分发的开源字体，对应关系见cls/font.cls的注释。
署名与联系方式（二次分发前请修改）
模板里有两处「作者 / 联系方式」信息，性质不同，别改错地方：
| 想改什么 | 改哪个文件的哪里 | 说明 |
|---|---|---|
| 模板维护者的联系方式 | report.cls 顶部的 Maintainer: 一行 |
目前是占位符 someone@example.com。它只出现在注释里，不参与排版，改成什么都不会影响编译结果 —— 你要把这份模板再分发出去，就换成你自己的。 |
| 报告本身的作者 / 单位 / 部门 | input/info.tex 里的 \theauthor、\theaffiliation、\thedept |
会印在封面上；单位与部门还会成为全页水印（水印的文字、透明度、大小在 input/setting.tex 里调）。 |
也就是说：
report.cls顶部那行与你的报告内容无关；报告里显示的作者信息一律在input/info.tex。
TeX Live 版本兼容性
同一份源码在下列 TeX Live 版本下均可直接编译（XeLaTeX），不需要切分支、不需要改代码：
| TeX Live | 状态 |
|---|---|
| 2022 | 已验证通过（基线） |
| 2023 | 已验证通过 |
| 2024 | 已验证通过 |
| 2025 | 已验证通过 |
| 2026 | 已验证通过 |
本目录原为独立仓库
ouc-report-latex-template，曾按 TeX Live 年份维护多套分支。 2026-10 并入ouc_latex_template后只保留main一份源码（已实测各年份通用）， 旧仓库的分支不再更新。
目录结构
.
├── report.cls # 文档类（模块化加载 cls/ 下各子模块）
├── cls/ # 功能模块：全局设定、字体、页面、标题、信息框、代码块等
├── input/ # 文档内容：封面、目录、摘要、信息与整体设置
├── figs/ # 图片资源
├── (字体在仓库根 fonts/) # 不再自备字体，详见 ../fonts/README.md
├── fontawesome.pdf # fontawesome 图标使用手册
└── report.tex # 主文件（XeLaTeX 编译入口）
关于 report.pdf
仓库内的 report.pdf 是成品样张，用于预览效果。封面的日期取自 \today，
所以每次编译都会变；用不同年份的 TeX Live 编译，PDF 体积也可能略有差异，
但页面渲染内容一致。以 report.tex 源码为准。