# 教材

中国海洋大学 教材 LaTeX 模板。

版式从《软件需求工程导论》（sre 仓库）的成品书抽取而来，
保留其全部排版特性，正文内容为占位示例。

## 编译

```bash
cd 教材
xelatex 教材.tex              # 无参考文献时，单次即可
```

有参考文献时（本模板默认就有）走完整流程：

```bash
xelatex 教材.tex
bibtex 教材
xelatex 教材.tex
xelatex 教材.tex
```

或仓库根：`bash build.sh 教材`（已自动处理 bibtex）

## 文件

| 文件 | 作用 |
|---|---|
| `ouctextbook.sty` | 版式配置（编号层级、封面色、宏包、断行） |
| `elegantbook.cls` | **本地化过的**文档类（改过字体，见下） |
| `教材.tex` | 示例正文 |
| `reference.bib` | 参考文献库（内容是虚构条目） |
| `README.md` | 本文件 |

## ⚠️ 唯一的结构性差异：本模板带一份 cls

仓库其他模板只需 `\input{../fonts.tex}`。本模板还需要一份
**改过字体的 `elegantbook.cls`**，原因如下。

### elegantbook 的三档中文字体，全都不通用

| 选项 | 实际字体 | 问题 |
|---|---|---|
| `founder`（默认） | FZShuSong-Z01 / FZHei-B01 / FZKai-Z03 / FZFangSong-Z02 | **方正商业字体，不能分发** |
| `ctexfont` | 系统字体（Windows=SimSun/SimHei，macOS=PingFang） | 同一份源码三个平台三种样子 |
| `nofont` | 不设，交给用户 | 不配置就直接报错 |

### 但只写 nofont 还不够

`elegantbook.cls` 自身还硬编码了两处西文字体：

```latex
\setmainfont{TeXGyreTermesX}[...]   % 西文衬线
\setsansfont{texgyreheros}[...]     % 西文无衬线
```

这两款在精简版 TeX Live 和很多机器上都没有，会直接报

```
! Package fontspec Error: The font "texgyreheros-regular" cannot be found
```

而且是 9 个错误连发（类的每个字体档位都失败一次）。

**实测：在 `\documentclass` 之后用 `\setsansfont` 覆盖无效** ——
类加载时字体族已经注册失败，后面的重新指定救不回来。

### 所以 cls 必须本地化

模板目录里的 `elegantbook.cls` 相对上游改了三处，都带
「本地化」注释，便于将来对比上游版本：

| 位置 | 改动 | 原因 |
|---|---|---|
| 第 176 行附近 | `TeXGyreTermesX` → `texgyretermes`，加 `Path=../fonts/tex-gyre-termes/` | 用仓库自带字体 |
| 第 184 行附近 | `texgyreheros` → `OUCSans`，加 `Path=../fonts/ouc-sans/` | 仓库没有 Hero |
| `\maketitle` 内 | `example-image` → `\ouc@coverblank` | 无封面图时不插占位图 |

### 中文依赖链

`nofont` 模式下 elegantbook **不定义** `\songti` / `\heiti` / `\kaishu` /
`\fangsong`，但它的 `\cbfseries`、章节标题都依赖 `\heiti`。

这层依赖由 `../fonts.tex` 补上——那里已用 `\def` 定义这四个命令。
**若哪天 fonts.tex 改了这几个命令的名字，本模板的章节标题会立刻失去中文字体。**

## ⚠️ 封面：三个坑

### 1. 不写 `\cover{}` 会插一张 "Image" 占位图

elegantbook 在 `\maketitle` 里：

```latex
\ifcsname @cover\endcsname
  \includegraphics[width=\linewidth]{\@cover}
\else
  \includegraphics[width=\linewidth]{example-image}   ← mwe 宏包的灰底占位图
\fi
```

首页顶着 "Image" 两个大字。本地化版本已把 `else` 分支换成空盒子。

### 2. 空盒子的宽度不能是 0

第一版把占位改成 `\rule{0pt}{0pt}`（0 宽），结果**冒出 5pt Overfull**，
且只出现在 `\maketitle` 那一行，怎么调 `\hspace`、`minipage` 宽度都去不掉。

根因：0 宽空盒让 `\linewidth` 在 titlepage 里的计算与 `\textwidth` 差了 5pt，
后续并排的 `\parbox` + 两个 `minipage` 就超了。

✅ 正解给占位盒一个满宽：

```latex
\newcommand{\ouc@coverblank}{\rule{0pt}{0pt}\hspace{\linewidth}\rule{0pt}{0pt}}
```

实测 0 Overfull。

### 3. 要真封面就写 `\cover{文件}`

把图片放进本目录，导言区加 `\cover{cover.jpg}` 即可，走插图分支。

## 版式参数

```
页面    A4 210 × 297 mm
边距    上下 25.4mm，左右 20mm
headheight 2.17cm，headsep 4mm，footskip 12mm
字号    10pt（比仓库其他模板的 12pt 小，原教材如此）
行距    1.2 倍（elegantbook 默认）
封面色  RGB(32, 178, 170) 青绿
```

## 标题编号

```
章  1
节  1.1
小节 1.1.1
小小节 1.1.1.1        ← secnumdepth=3，编号最多到这里
第 5 级  （1）（2）（3）  ← 不进编号体系，随小节重置
```

第 5 级为什么要单独处理：`secnumdepth=4` 会排出 `3.1.1.1.1` 这种过长编号，
教材里很难看。改用带括号的序号，与正文行文习惯一致。

## 章的标准结构

原教材 13 章全部遵循，做模板时保留：

```latex
\chapter{标题}
导语（3~5 段，概述本章问题、结构、与相邻章的关系）
\section{...}
\section{本章小结}      % 用 \oucsummary
\section{习题}          % 用 \oucexercises
```

两个小节做成了命令，避免各章写法不一致。

## 字体（全部来自仓库，无商业字体）

| 用途 | 字体 | 来源目录 |
|---|---|---|
| 中文正文 | OUC Serif | `../fonts/ouc-serif/` |
| 中文黑体 | OUC Sans | `../fonts/ouc-sans/` |
| 中文楷体（代斜体） | OUC Kai | `../fonts/ouc-kai/` |
| 中文仿宋 | Zhuque Fangsong | `../fonts/zhuque-fangsong/` |
| 西文正文 | TeX Gyre Termes | `../fonts/tex-gyre-termes/` |
| 西文无衬线 | OUC Sans | `../fonts/ouc-sans/` |

PDF 内嵌字体实测：
```
OUCSerif-Regular / OUCSerif-Bold / OUCKai-Regular
TeXGyreTermes-Regular / -Bold / -Italic
LMMono10-Regular        ← \texttt 用的等宽，TeX Live 自带
```

⚠️ `LMMono10` 是 Computer Modern 等宽字体，用于 `\texttt{}`（代码、DOI）。
仓库 fonts.tex **没有配等宽字体**，elegantbook 也没有。它由 TeX Live
自带，WSL 和 Windows 两端都有，所以跨平台一致，不算问题。
要换成别的等宽字体，在导言区加 `\setmonofont{...}`。

## 验证

```
8 页   error 0   Overfull 0   Underfull 0
字体全部来自 ../fonts/，无商业字体、无系统字体
全库 16/16 通过
```

⚠️ Windows 端本机未能编译（TeX Live 写字体缓存被安全策略拦截），
但模板只依赖 TeX Live 标准宏包与发行版自带字体，不涉及平台特有资源。
原教材本身就是在 Windows + TeX Live 2022 上编译的。

## 与原教材的差异

| 项 | 原教材 | 本模板 | 原因 |
|---|---|---|---|
| 封面图 | cover.jpg | 无（纯色带） | 模板不附图片 |
| 字体 | 方正四大字体 | 仓库开源字体 | 商业字体不能分发（#17 的规矩） |
| 西文无衬线 | texgyreheros | OUC Sans | 仓库没有 Hero |
| 正文 | 13 章 265 页 | 1 章示例 | 只抽骨架 |

## 已知问题

`\texttt{}` 用的是 Computer Modern 等宽（LMMono10），与正文西文
Termes 风格不搭。成因是仓库未统一配置等宽字体，见上文字体表。
目前仅 2 处用到（示例里的 `booktabs` 和一条 DOI），不影响观感。