# 课程教学日历 —— 中国海洋大学课程教学日历（理论课程）

学校下发的**通用空白表**「附件3：中国海洋大学课程教学日历（理论课程）」的
XeLaTeX 模板。原文件是学校统一的 `.doc` 表（7 列 × 18 行的 16 周教学日历 +
课程考核说明 + 签字栏），本目录把它做成可直接编译的 LaTeX 版。

> **本模板不含任何真实课程数据。** 课程名、开课号、教师、学分、学时、
> 人数、学期、周次日期、章节名、作业编号**全部是虚构占位符**（`××××`、
> `000000000000`、`×`）。原 `.doc` 是一份**填过的实例**，本模板只复刻
> 它的版式，一个字段都没带过来 —— 见下面「真实数据零泄漏」。

> 与 [`试卷归档封面/`](../试卷归档封面/)、[`试卷归档目录/`](../试卷归档目录/)
> 的关系：三件同属教务处下发的表格套件（附件1 封面、附件2 归档目录、
> 附件3 教学日历），版式上都照原 `.doc` 1:1 还原，做法同一套
> （版心设成表格可见范围 + `caloutside` 环境放回表格外的段落），互不依赖。

## 文件

| 文件 | 说明 |
|---|---|
| `oucal.sty` | 版式包。A4、表宽 174.625mm、7 列、18 行显式行高，每项尺寸都附换算过程 |
| `课程教学日历.tex` | 正文入口（课程信息与 16 周内容写在这里） |
| `课程教学日历.pdf` | 成品样张 |

## 编译

```bash
xelatex 课程教学日历.tex
```

必须用 **XeLaTeX**（fontspec + xeCJK），pdflatex 编译不过。
自包含，不依赖任何图片。实测 **3 页**、零警告（无 Overfull / Underfull / 缺字）。

> ⚠️ 页数与原件不同：原件 2 页，本模板 3 页。原因见「原件的不一致之处」第 1 条 ——
> 原件第一周那一行的行距缺省（15.6pt），本模板统一按 23pt 排，多出 22pt，
> 正好把表格顶到第 3 页。这是**有意取舍**，不是 bug。

## 用法

### 课程信息

改 `.tex` 开头的宏：

```latex
\newcommand{\calcno}{附件3}                     % 附件编号
\newcommand{\calcname}{××××}                    % 课程名称
\newcommand{\calyear}{20××}                     % 学年
\newcommand{\calseason}{×}                      % 季学期（春/秋）
\newcommand{\caldept}{××××学院（系）}            % 开课单位
\newcommand{\calcodenum}{000000000000}          % 开课号（12 位）
\newcommand{\calteacher}{×××}                   % 任课教师
\newcommand{\calcredit}{×.×}                    % 课程学分
\newcommand{\calhour}{00}                       % 总学时
\newcommand{\calstudent}{000}                   % 学生人数
\newcommand{\calassess}{××考试}                  % 考核方式
```

签字栏的「年 月 日」**没有对应的宏**，因为那是手写填写的空位，
模板中保持印刷好的「年」「月」「日」三个字，中间留白给老师签日期。

### 教学日历表

每行格式：

```latex
\calcell{第一周} & \calcell{×月×日至×月×日} & \calcell{×} &
\calcell{课程基本情况介绍\par 引例\par 补充知识} & \calcell{多媒体讲课} & & \\
```

可用的单元格宏：

| 宏 | 用途 | 说明 |
|---|---|---|
| `\calcell{...}` | 左对齐格 | 正文常用 |
| `\calctr{...}` | 居中格 | 表头、第 11~16 周的周次列 |
| `\calhead{...}` | 表头（**不加粗**，见下） | 原件表头无 `w:b` |

## ⚠️ 改表之前必读：行高是写死的

`oucal.sty` §5 里 18 个 `row{n}={ht=...}` 是**按每行的实际行数**算出来的：

```
ht = (内容行数 − 1) × 23pt
```

原件所有表格段落都是 `w:line=460 exact`（23pt 固定行距），且每个单元格
多带一个空段落，所以**最少 2 行**。于是：

| 内容行数 | ht | 原件实测行高 |
|---|---|---|
| 2 行 | 46.00pt | 46.5pt |
| 3 行 | 69.00pt | 69.5pt |
| 4 行 | 92.00pt | 92.5pt |
| 5 行（表头） | 115.50pt | 115.5pt |

差的那 0.5pt 是边框线宽，由 tabularray 自己加。

**ht 是最小高度**（内容多了会顶高、少了不会压扁）。所以：

- **加长**某周的教学内容 → 折行数变多 → 该行会被内容顶高，`ht` 不用改，但整表会变长
- **缩短**某周的教学内容 → 折行数变少 → `ht` 就会留下空白，必须手动改小
- **改字号或列宽** → 全部折行数都可能变 → 18 个 `ht` 都要重新标定

重新标定的办法（不靠猜）：编译后导出 PDF，读第 1 页的横线：

```python
import pymupdf
d = pymupdf.open("课程教学日历.pdf")
ys = {}
for dr in d[0].get_drawings():
    r = dr["rect"]
    if abs(r.y1 - r.y0) < 2 and r.width > 20:      # 横线
        k = round(r.y0, 1)
        ys[k] = ys.get(k, 0) + r.width
rows = sorted(k for k, w in ys.items() if w > 300)  # 只留跨多列的
print([round(rows[i] - rows[i-1], 2) for i in range(1, len(rows))])
```

输出就是逐行行高，与上表对照即可。

## 版式参数

全部照原 `.doc` 换算，未做主观调整：

| 项目 | 值 | 来源 |
|---|---|---|
| 纸张 | A4 210×297mm | `pgSz` 11906×16838 twips |
| 页边距 | 上下 25.40mm、左右 31.75mm | `pgMar` 1440 / 1800 twips |
| 表宽 | 174.625mm | `tblW` 9900 twips |
| 表格缩进 | −13.97mm（**负**，比版心更靠左） | `tblInd` −792 twips |
| 表格可见左边界 | 15.875mm | 31.75 − 13.97 − 1.905（cellMar） |
| 列宽 | 15.875 / 25.559 / 18.150 / 47.078 / 24.095 / 21.590 / 22.278 mm | `gridCol` 900/1449/1029/2669/1366/1224/1263 twips |
| 单元格内边距 | 左右 1.905mm、上下 0 | `tblCellMar` 108 twips |
| 边框 | 0.5pt 实线 | `w:sz=4`（1/8pt 单位） |
| 行距 | **23.00pt 固定** | `w:line=460` `lineRule=exact` |
| 行高 | 全表无 `trHeight`，由内容撑开 | 实测 = 行数×23 + 0.5pt |
| 附件号/标题 | 14pt 粗 | `w:sz=28` + `w:b` |
| 学年学期行 | 12pt 粗 | `w:sz=24` + `w:b` |
| 正文/表格/签字栏 | 10.5pt | Normal 样式 `w:sz=21` |

### 列宽为什么是 `gridCol − 2×colsep − 线宽`

`wd = gridCol − 2×1.905mm − 0.1764mm`。tabularray 把边框线宽算进列宽里
（相邻竖线中心距 = `wd + 2×colsep + 线宽`）。按「竖线根数分摊」算每列会窄
0.154mm，整表窄 1.07mm —— 这点在 `试卷归档目录/` 里实测验证过，直接沿用。

### `totalwidth` 为什么是 174.80mm 而不是 174.625mm

Σwd + 内边距 + 8 条竖线 = 174.8013mm。若取 174.625 会报
`Table width is too small` —— tabularray 的盒子还要多占约 0.4945pt
（左竖线画在边界内侧、右竖线外缘又占半个线宽）。

## 实测校验

用 pymupdf 读两版 PDF（原件由 WPS COM 导出，136 个文字 span + 21 条横线 + 8 条竖线），
逐位对比：

### 竖线（8 条，单位 mm）

| # | 原件 | 本模板 | Δ |
|---|---|---|---|
| 1 | 15.875 | 15.875 | 0.000 |
| 2 | 31.750 | 31.750 | 0.000 |
| 3 | 57.309 | 57.309 | 0.000 |
| 4 | 75.458 | 75.454 | −0.004 |
| 5 | 122.560 | 122.556 | −0.004 |
| 6 | 146.629 | 146.625 | −0.004 |
| 7 | 168.218 | 168.214 | −0.004 |
| 8 | 190.500 | 190.500 | 0.000 |

**最大 |Δ| = 0.004mm。**

### 纵向锚点（基线 y，单位 pt）

| 锚点 | 原件 | 本模板 | Δ |
|---|---|---|---|
| 「附件3：」 | 92.69 | 92.69 | **0.00** |
| 标题 | 123.89 | 123.89 | **0.00** |
| 「学年 学期」 | 150.41 | 150.42 | +0.01 |
| 课程信息第 1 行 | 191.81 | 191.82 | +0.01 |
| 课程信息第 2 行 | 214.85 | 214.82 | −0.03 |
| 表格顶线 | 242.60 | 242.60 | **0.00** |
| 「院（系）负责人签字」x | 321.00 | 320.99 | −0.01 |
| 签字栏「年」x | 355.08 | 355.09 | +0.01 |
| 签字栏「月」x | 376.08 | 376.09 | +0.01 |
| 签字栏「日」x | 397.08 | 397.10 | +0.02 |

### 行高（21 条横线，单位 pt）

17/18 行 **Δ ≤ 0.4pt**；唯一例外是第 2 行（第一周）多 22.0pt，
原因见「原件的不一致之处」第 1 条。

### 字号

导出 PDF 读 span 的 `size`：**14.00 / 12.00 / 10.50** 三档，与 Word 的
28/24/21（半磅）÷2 逐位相同。

## 五个坑（改之前先看）

### 1. `\fontsize` 必须用 `bp`，不能用默认的 `pt`

Word 的 pt 是 PostScript point（1/72 英寸），TeX 默认的 pt 是 TeX point
（1/72.27 英寸），**大 0.36%**。写 `\fontsize{10.5}{23}` 实测排出来 10.45、
23pt 的 `\baselineskip` 实测 22.9167。必须写 `10.5bp` / `23bp`。

这条与 `试卷归档目录/` 的坑 1 是同一个。

### 2. Word 的「固定行距」在 TeX 里不是 `\fontsize` 的第二参数

原件的 `w:line=460 exact` 意思是**每一行都占满 23pt，首行也不例外**
（既不算字体的 ascent，也不算 descent，硬压成 23）。而 TeX 的
`\fontsize{10.5bp}{23bp}` 只设了 `\baselineskip = 23pt`：

| n 行格子 | Word | TeX 裸排 |
|---|---|---|
| 1 行 | 23.00pt | 11.00pt（ascent + descent） |
| 5 行 | 115.00pt | 99.00 + 约 8pt = 107pt |

初版没有处理这一条，编译出来表头只有 102.2pt（应 115.5），第七列第 5 行
「节」直接压到表格底线以下。

**试过但都不行的三个方案**：

| 方案 | 实测结果 |
|---|---|
| `rowsep=6.6pt`（单元格上下 padding） | 1 行格 23.0 ✓、2 行格 **39.3** ✗（斜率 16.4 而非 23） |
| `\rule[-4.35pt]{0pt}{23pt}` 段首段尾各一 | 表头 150pt ✗（`\lineskip` 介入，每行多 1pt，首行基线跑到框外） |
| `\vrule height 18.65pt depth 4.35pt` | 与 `\rule` 同 |

原因是 **xeCJK 的 `\CJKglue` 与 `\lineskip`** 会介入自动折行，行间距不是
线性的，没法用单一 padding 同时满足 1/2/4/5 行。

**最终用的**：直接给 `row{n}={ht=...}`，把「行高」这件事从盒模型手里拿走。
`ht` 是最小值，配上内容刚好 = 目标值，结果确定、可复现。

### 3. `\linespread` 必须在 `\fontsize` **之后**调用

`\fontsize` 会重设 `\baselineskip`，把先前设的系数覆盖掉；反之
`\linespread` 改的是系数，对已生成的 `\baselineskip` 立即生效。

```latex
\linespread{0.67826}\calfontC          % ❌ 无效，行距还是 23pt
\calfontC\linespread{0.67826}\selectfont   % ✅ 15.6pt
```

（本包最终没用这条 —— 见「原件的不一致之处」第 1 条。但改行距时会踩。）

### 4. `\SetCell[c=7]{c}` 里的 `c` 是自然宽度，不折行

跨列的格必须显式给宽，否则整句不折行、直接冲出表外报 Overfull：

```latex
\SetCell[c=7]{c}                       % ❌ Overfull 197.8pt too wide
\SetCell[c=7]{m,wd=170.638mm}          % ✅
```

`wd = 表宽 − 2×colsep − 取整余量 = 174.625 − 3.810 − 0.177 = 170.638mm`。

### 5. `\leftskip` 与 `geometry` 的左边距会**叠加**，不是覆盖

本包把版心设成表格可见范围（`left=15.787mm`），表格外的段落要靠
`\leftskip` 放回原版心的 31.75mm。但 `\leftskip = 15.875mm` 排出来是
**31.662mm**（15.787 + 15.875），而不是 31.75mm。

必须取 `\leftskip = 31.75 − 15.787 = 15.963mm`。差 0.088mm 看着小，
但它让所有「按原版心再做负缩进」的段落全部错位 —— 初版
【开课单位】一行实测偏右 16.3pt。

### 6.（附）负的 `\vspace*` 在 `\par` 处会被丢弃

想压掉两段之间 2.11pt 的余差，写 `\vspace*{-2.11pt}` 或
`\calskip{-0.734mm}` 都无效（TeX 在 `\par` 处丢弃负的垂直胶，
不能"压缩"已存在的间距）。

**正解**：让两行落在**同一段落**里，用 `\newline` 换行，`\baselineskip`
就直接生效：

```latex
【开课单位】…\newline
【课程学分】…\par
```

注意 `\newline` 之后的行是"段中行"，**不吃 `\parindent`**，只认 `\leftskip`，
所以要在段落开头把 `\leftskip` 整体前移。

## 原件的不一致之处

### 1. 第一周（第 2 行）的行距是 15.6pt，其余 17 行是 23pt

原 `.doc` 里只有这一行的段落没写 `w:spacing`，随 `docGrid`
（`linePitch=312` twips = 15.6pt）排。于是该行高 47.3pt，而同为 3 行的
第五周（第 6 行）是 69.5pt —— 同样内容量，差 22.2pt。

**本模板不复制这个不一致**，全表统一 23pt。后果是该行比原件高 22.0pt，
表格总高 1132.3pt（原件 1114.2pt），最终排出 **3 页**（原件 2 页）。

要压回 2 页的话：把第一周那一行的 3 个段落合并成自动折行（`\par` 分段
不行，`\linespread` 只对段内行生效），再把 `row{2}` 的 `ht` 改成 24.30pt。
但那等于把疏漏重新引入，故未采用。

### 2. 周次列的对齐前 10 行、后 6 行不一致

原件第 1~10 周（第一周~第十周）是 `jc=left`，第 11~16 周是 `jc=center`：

| 周次 | 原件 x | 本模板 x |
|---|---|---|
| 第一周~第十周 | 50.40pt | 50.65pt |
| 第十一周~第十六周 | 51.72pt | 51.75pt |

差 1.32pt，肉眼几乎看不出，但确实是原件的行为。**本模板照抄这个不一致**
（`.tex` 里前 10 行用 `\calcell`、后 6 行用 `\calctr`），因为改成统一反而
会与原件对不上。若你想统一，把后 6 行的 `\calctr` 全换 `\calcell` 即可。

### 3. 表头第 6、7 格是「2 个段落又各自折行」

原件里这两格各是 2 个段落，但 PDF 显示 4 行与 5 行 —— 说明每个段落
在格内**又自动折行**了一次。本模板把整句写进一格交给自动折行，
实测折行数与原稿一致（c6 折 4 行、c7 折 5 行），表头行高 115.5pt
= 5×23pt 就是这么来的。

### 4. 表头**不加粗**

视觉上表头显得醒目，但原 `.doc` 的表头格只有 `jc=center`，**没有 `<w:b/>`**。
本模板照抄，不加粗。`\calhead` 保留了 `\bfseries` 的能力，想加粗自己去打开。

### 5. 签字栏的「年 月 日」是手写填空位，不要填年份

原件第 2 页底部两段：

| 段落 | 定位方式 | 起点 x |
|---|---|---|
| 「院（系）负责人签字：」 | `w:ind firstLine=4515`（79.64mm） | 321.00 |
| 「×××× 年　月　日」 | **无** `ind`，靠空格顶位 | 331.44 |

原件是被填过的实例，年份位印着 4 个半角数字（x=331.44~352.50）。
**本模板不写年份** —— 空白模板应该留白给老师手写。所以直接从「年」开始排：

```latex
\hspace*{93.517mm}\calfontC 年\hspace*{10.55pt}月\hspace*{10.55pt}日\par
```

三个字的实测锚点（10.45pt 宋体），本模板与原件逐字对齐：

| 字 | 原件 x | 本模板 x | Δ |
|---|---|---|---|
| 年 | 355.08 | 355.09 | +0.01 |
| 月 | 376.08 | 376.09 | +0.01 |
| 日 | 397.08 | 397.10 | +0.02 |

`\hspace*{93.517mm}` 的来历：目标 x = 355.09pt = 125.23mm，
`caloutside` 环境的 `\leftskip` 是 15.963mm，geometry 左边距 15.787mm，
两者叠加后排版起点在 31.75mm 处，故
`125.23 − 31.75 = 93.48mm`。取 93.48mm 实测落在 354.98（偏左 0.10pt），
加 0.037mm 微调到 **93.517mm**，实测 355.09（偏右 0.01pt）。

⚠️ 三字之间的空档是 **10.55pt**，不是 21pt。因为中文字形本身占 10.5pt，
「年」起点到「月」起点 = 字形宽 10.5 + 空档 10.55 ≈ 21.0pt。

#### ❌ 曾经踩的坑：用负 `\hspace` 塞年份占位符 → 三字重叠

第一版模板里有 `\calgrade`（`20××`）占位，写法是：

```latex
\hspace*{92.604mm}\calfontC \calgrade~年\hspace{-8.35mm}月\hspace{3.34mm}日
```

实测：「月」落在 376.08，但 `20×× 年` 一直延伸到 x=399.74，
「月」正好压在「年」上 —— **三个字叠成一个墨团**。

原因：**负 `\hspace` 只能压缩它后面盒子之间的间距，不能把已经排出去的
字符收回来**。减少间距减到负数 = 重叠，而不是"往回挪"。

最终解法不是修排版技巧，而是**去掉年份占位符** —— 那本来就不该有。
现在这一行只有三个中文字，不存在宽度变化，位置永远稳定。

### 6. `\calgrade` 已删除

曾经有过 `\newcommand{\calgrade}{20××}`，后因「签字栏不该印年份」而删除。
如果你需要**预填**年份（比如批量生成带年份的表），自己加回来：

```latex
\hspace*{81.52mm}{\calfontC\makebox[34.0pt][r]{2026}年}%
\hspace*{10.55pt}\calfontC 月\hspace*{10.55pt}日\par
```

要点：年份必须放进**定宽 `\makebox`**，让盒宽吸收内容长度变化，
否则换 `2026` 与 `20××` 时「月」「日」会跟着漂移。

实测该写法落到：年 354.95 / 月 375.96 / 日 396.97（目标 355.08 / 376.08 / 397.08）。

## 真实数据零泄漏

原 `.doc` 是一份**填过的实例**（真实课程名、开课号、教师姓名、人数、
年份、16 周真实日期与章节名）。本模板把每一个字段都换成了占位符。

已 grep 确认以下关键词在 `oucal.sty` 与 `课程教学日历.tex` 中**零命中**：

```
数字逻辑   080502101231   杨永全   2021   2022   逻辑代数
卡诺图     触发器         时序线路  组合线路   信息科学与工程学部   闭卷考试
```

内容里的「××××基础」「×××设计」等也都是通用占位（原件的真实章节名是
「逻辑代数基础」「组合线路设计」等，已全部抽象掉）。**替换成你自己课程的
内容时，注意不要把这些真实信息再写回模板提交。**

## 字体

全部取自仓库根目录的 [`fonts/`](../fonts/)，通过 [`fonts.tex`](../fonts.tex) 声明：

| 用途 | 字体 | 授权 |
|---|---|---|
| 正文宋体 | OUC Serif（思源宋体 SC 子集） | OFL 1.1 |
| 西文/数字 | TeX Gyre Termes（Times 度量兼容） | GUST Font License |

原件用的是「宋体 + Times New Roman」。换开源等价字体后**字宽逐字相同**，
所以列宽、折行数、行高都不受影响 —— 这一点已由上面的行高实测表验证。