laoyang
a4bfcac82a
源：D:\Yongquan\code\sre =《软件需求工程导论》完整教材
（13 章 + 5 附录，78 万字节，265 页 PDF，elegantbook 文档类）
## 新增文件
教材/ouctextbook.sty 版式配置
教材/elegantbook.cls 本地化过的文档类（改过字体）
教材/教材.tex 示例正文（1 章 + 附录 + 参考文献）
教材/reference.bib 参考文献库（虚构条目）
教材/README.md 用法 + 踩坑记录
## 核心约束：字体的共用性
用户明确要求「注意字体的共用性」。原教材用 elegantbook 的
chinesefont=founder 档，加载方正四大字体：
FZShuSong-Z01 / FZHei-B01 / FZKai-Z03 / FZFangSong-Z02
这些是**商业字体，不能随仓库分发**（#17 定下的规矩）。
### elegantbook 三档字体全都不通用
| 选项 | 实际字体 | 问题 |
|---|---|---|
| founder（默认） | 方正四大字体 | 商业字体，换机器就废 |
| ctexfont | 系统字体（Win=SimSun，macOS=PingFang） | 三平台三种样子 |
| nofont | 不设 | 不配置就报错 |
### 只写 nofont 还不够 —— cls 自身还硬编码字体
elegantbook.cls 第 176/184 行：
\setmainfont{TeXGyreTermesX}[...]
\setsansfont{texgyreheros}[...]
这两款在精简 TeX Live 上都没有，报 9 个错误连发：
! Package fontspec Error: The font "texgyreheros-regular" cannot be found
**实测：在 \documentclass 之后用 \setsansfont 覆盖无效** ——
类加载时字体族已注册失败，后面重新指定救不回来。
⇒ 所以本模板必须带一份**本地化的 cls**，改三处（都留了"本地化"注释）：
| 位置 | 改动 |
|---|---|
| ~176 行 | TeXGyreTermesX → texgyretermes + Path=../fonts/tex-gyre-termes/ |
| ~184 行 | texgyreheros → OUCSans + Path=../fonts/ouc-sans/ |
| \maketitle | example-image → \ouc@coverblank |
这是本模板与仓库其他模板的**唯一结构性差异**：别的模板只要
\input{../fonts.tex}，本模板还要那份改过字体的 cls。
## 踩到的三个坑
### 1. 封面不写 \cover{} 会插一张 "Image" 占位图
cls 第 1288~1300 行：
\ifcsname @cover\endcsname ... \else
\includegraphics[width=\linewidth]{example-image} ← mwe 的灰底占位图
首页顶着 "Image" 两个大字。已把 else 分支换成空盒子。
### 2. 占位盒宽度不能是 0（这个坑耗了最久）
第一版 \rule{0pt}{0pt}（0 宽），立刻冒出：
Overfull \hbox (5.00002pt too wide) in paragraph at lines 44--44
试过全部无效，溢出量死钉在 5.00002pt 不动：
改 \hspace{2em} / \hspace{2.5em} 无效
改 minipage 的 0.67/0.27\linewidth 无效
改 tabular 列间距 @{}l@{} 无效
改 \colorbox 的 \makebox[\hsize] 无效
根因：0 宽空盒让 \linewidth 在 titlepage 里与 \textwidth 差 5pt，
后续并排的 \parbox{0.8\textwidth} + 两个 minipage 整体超宽。
✅ 正解：给占位盒满宽
\newcommand{\ouc@coverblank}{%
\rule{0pt}{0pt}\hspace{\linewidth}\rule{0pt}{0pt}}
实测 0 Overfull。
### 3. 封面色带改不动（一行 \colorlet 的位置问题）
cls 第 345 行 `\colorlet{coverlinecolor}{second}` 在**类加载末尾**执行，
把 coverlinecolor 绑到 second 色（black 模式下就是黑）。
⇒ 导言区写 \colorlet 会被覆盖，实测色带仍是纯黑。
必须用 \AtBeginDocument 排到它后面。
## build.sh 补了 bibtex 支持
原来只跑两遍 xelatex，教材的参考文献出不来。
新增：目录下有 .bib（排除 *-blx.bib 这种中间产物）就插一次 bibtex，
再补一遍 xelatex，最后跑统计那一遍。
## 验证
8 页 error 0 Overfull 0 Underfull 0
封面色带 RGB(32,178,170) 青绿，实测 fill=(0.125,0.698,0.667)
封面无 example-image 占位
字体（PDF 内嵌实测，全部来自仓库）：
OUCSerif-Regular / -Bold 中文正文
OUCKai-Regular 中文斜体（楷体代）
TeXGyreTermes-Regular/-Bold/-Italic 西文
LMMono10-Regular \texttt 等宽（TeX Live 自带）
→ **无方正、无 SimSun/SimHei、无 Times New Roman**
全库 16/16 通过（新增第 16 项，已加入 verify_all.sh）。
⚠️ Windows 端本机未能编译：TeX Live 写字体缓存
（C:\texlive\2022\texmf-var）被安全策略拦截，属环境限制非模板问题。
模板只依赖 TeX Live 标准宏包与发行版自带字体；原教材本身就是在
Windows + TeX Live 2022 上编出来的。
## .gitignore 补充
新增 *-blx.bib、*.run.xml（biblatex 中间产物）、*/.preview/（预览图）。
## 与原教材的差异
| 项 | 原教材 | 本模板 | 原因 |
|---|---|---|---|
| 封面图 | cover.jpg | 无（纯色带） | 模板不附图片 |
| 字体 | 方正四大字体 | 仓库开源字体 | 商业字体不能分发 |
| 西文无衬线 | texgyreheros | OUC Sans | 仓库没有 Hero |
| 正文 | 13 章 265 页 | 1 章示例 | 只抽骨架 |
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 起并入本仓库统一维护，两个旧仓库不再更新。迁入时保留了原有目录结构、字体与图片资源，旧仓库的提交历史留在原仓库中。