319 lines
12 KiB
Markdown
319 lines
12 KiB
Markdown
# 成绩构成说明 — 中国海洋大学《成绩构成说明》（LaTeX 版）
|
||
|
||
把任课教师手写的「成绩构成说明」做成 LaTeX 模板。原件是一份填过的
|
||
`.doc` 实例（两段话 + 标题，无表格、无签字栏），本模板在**保留其信息
|
||
内容**的前提下重新组织，并补齐归档必需项。
|
||
|
||
> **本模板不含原件任何真实数据。** 课程名、学年、学期、教师姓名、
|
||
> 所有比例、日期一律 `××××` / `20××` / `×` 占位，已 grep 验证零命中。
|
||
|
||
## 目录
|
||
|
||
- [文件](#文件)
|
||
- [编译](#编译)
|
||
- [改内容](#改内容)
|
||
- [相对于原件的改动](#相对于原件的改动)
|
||
- [比例自洽校验](#比例自洽校验)
|
||
- [版式参数](#版式参数)
|
||
- [五个坑](#五个坑)
|
||
- [真实数据零泄漏](#真实数据零泄漏)
|
||
- [字体](#字体)
|
||
|
||
## 文件
|
||
|
||
| 文件 | 说明 |
|
||
| :-- | :-- |
|
||
| `成绩构成说明.tex` | 主文件。填表只改第 1 节（10 个宏） |
|
||
| `oucgrade.sty` | 版式包。页面/字体/表格/签字栏，附换算注释 |
|
||
| `成绩构成说明.pdf` | 成品样张（1 页） |
|
||
|
||
## 编译
|
||
|
||
```bash
|
||
xelatex 成绩构成说明.tex
|
||
```
|
||
|
||
**单页，跑一遍即可**（无交叉引用，不需要 bibtex）。
|
||
|
||
⚠️ 必须在**本目录**下编译，不要从仓库根调用 —— `fonts.tex` 用的是
|
||
相对路径 `../fonts/`。
|
||
|
||
需要 XeLaTeX，并安装 `ctex`、`geometry`、`fontspec`、`xeCJK`、
|
||
`tabularray`、`enumitem`、`graphicx`。实测环境：TeX Live 2022。
|
||
|
||
## 改内容
|
||
|
||
### 课程信息（10 个宏）
|
||
|
||
```latex
|
||
\newcommand{\grdcourse}{××××} % 课程名称
|
||
\newcommand{\grdyear}{20××} % 学年
|
||
\newcommand{\grdseason}{×} % 季学期（春 / 秋）
|
||
\newcommand{\grdteacher}{×××} % 任课教师
|
||
|
||
\newcommand{\grdtheory}{80} % 理论课占总成绩 %
|
||
\newcommand{\grdlab}{20} % 实验课占总成绩 %
|
||
|
||
\newcommand{\grddaily}{30} % 平时成绩占理论课 %
|
||
\newcommand{\grdfinal}{70} % 期末考试成绩占理论课 %
|
||
|
||
\newcommand{\grdhw}{20} % 作业占理论课 %
|
||
\newcommand{\grdattend}{10} % 点名占理论课 %
|
||
|
||
\newcommand{\grdlabnote}{由实验课教师根据实验报告与实验操作评定。}
|
||
```
|
||
|
||
**只填数字，不要带 `%` 号**，百分号由模板加。
|
||
|
||
### 「占本类」与「占总成绩」是两回事
|
||
|
||
这是本模板最要紧的一个设计，见下节。
|
||
|
||
### 改写正文
|
||
|
||
- 总述：`\grdpara{...}`
|
||
- 分节：`\grdsec{一、成绩构成}`
|
||
- 列表：`\begin{grdlist} \grditem{项}{：说明} \end{grdlist}`
|
||
- 表格单元格：`\grdth{}`（表头）/ `\grdtd{}`（表身）
|
||
|
||
## 相对于原件的改动
|
||
|
||
原件全文只有这些内容：
|
||
|
||
```
|
||
成绩构成说明
|
||
数字逻辑 2025学年 秋季学期 期末考试
|
||
理论课成绩占总成绩的80%。理论课成绩包括平时成绩、期末考试成绩。
|
||
平时成绩占30%（作业占20%，点名占10%），期末考试成绩占70%。
|
||
实验成绩占总成绩的20%。由实验课老师提供。
|
||
```
|
||
|
||
它的问题有四个，逐个解决：
|
||
|
||
### 1. 三层百分数混用不同基准，读者要心算三轮
|
||
|
||
| 句子 | 百分数 | **基准实际是** | 折总成绩 |
|
||
| :-- | --: | :-- | --: |
|
||
| 理论课占总成绩的 80% | 80% | 总成绩 | 80% |
|
||
| 平时成绩占 30% | 30% | **理论课** | 24% |
|
||
| 作业占 20% | 20% | **理论课** | 16% |
|
||
| 期末考试成绩占 70% | 70% | **理论课** | 56% |
|
||
|
||
「平时占 30%」看着像占总成绩三成，实际上只占 **24%**。教务抽查时
|
||
这里最常被挑错，学生也容易误读。
|
||
|
||
**改法**：表格左右并置「占本类」与「占总成绩」两列，后者由
|
||
`\grdcalc{理论课\%}{分项\%}` 自动算出，不给心算留余地。
|
||
|
||
### 2. 层级关系埋在句子里
|
||
|
||
「平时成绩占30%（作业占20%，点名占10%）」—— 括号里的两个数加起来
|
||
才是括号外的数，这种嵌套在一个句子里读起来要来回扫。
|
||
|
||
**改法**：改成 6 列表格，一级项目跨行合并，层级一眼可见。
|
||
|
||
### 3. 没有说明「怎么算」
|
||
|
||
原件说了比例，没说作业怎么平均、缺交怎么扣、点名缺几次记零。
|
||
这些是学生真正会问的，也是申诉时的依据。
|
||
|
||
**改法**：新增「二、分项说明」一节，用列表逐项写清（文字留占位，
|
||
任课教师按自己课程的规则填）。
|
||
|
||
### 4. 没有签字栏
|
||
|
||
**这是用户明确要求补的。** 没有任课教师签字的成绩构成说明，在教务
|
||
归档时不被认作有效文件。
|
||
|
||
**改法**：右下角落款，含签字线与「20×× 年 月 日」。
|
||
|
||
### 另外新增（可关闭）
|
||
|
||
「三、成绩评定与异议」一节 —— 说明总成绩如何取整、异议如何在几个
|
||
工作日内提出。原件没有，但归档材料有这一节更完整。
|
||
|
||
不要的话把 `.tex` 里这个开关改成 0：
|
||
|
||
```latex
|
||
\def\grdwithini{0} % 1=印这一节，0=不印
|
||
```
|
||
|
||
⚠️ 关掉后正文变短，签字栏会往上移。若想让它仍贴底部，把 `oucgrade.sty`
|
||
里签字块前的 `\par\vspace{3mm}` 调大即可（见[坑 3](#坑-3签字栏被挤到第-2-页)）。
|
||
|
||
## 比例自洽校验
|
||
|
||
模板会检查三组加法：
|
||
|
||
```
|
||
平时 + 期末 = 100 （构成全部理论课）
|
||
作业 + 点名 = 平时 （构成全部平时成绩）
|
||
理论课 + 实验课 = 100 （构成全部总成绩）
|
||
```
|
||
|
||
不通过时：
|
||
|
||
1. `.log` 里打出
|
||
`*** oucgrade: 比例不自洽 --- 作业+点名 应构成全部平时成绩: 实际 25+10, 应为 30 ***`
|
||
2. PDF **标题正下方**印一行红字警告
|
||
|
||
**为什么值得做**：成绩构成说明是要归档、要被抽查的文件，比例加不起来
|
||
是最常见也最难被自己发现的错误 —— 原件那句「平时 30%（作业 20%，
|
||
点名 10%）」正是靠心算才看得出 20+10=30。
|
||
|
||
**已做负面测试**：把 `\grdhw` 从 20 改成 25 重编，log 报
|
||
`实际 25+10, 应为 30`，PDF 第 1 页顶部出现警告；改回 20 后警告消失。
|
||
|
||
⚠️ 警告印在**开头**不是文末。文末的提示会被签字栏挤到第 2 页，
|
||
而第 2 页通常没人翻 —— 等于没提示。
|
||
|
||
## 版式参数
|
||
|
||
### 页面
|
||
|
||
| 项 | 值 | 来源 |
|
||
| :-- | --: | :-- |
|
||
| 纸张 | A4 210×297mm | `pgSz 11906×16838` twips |
|
||
| 上下边距 | 25.40mm | `pgMar top/bottom 1440` |
|
||
| 左右边距 | 31.75mm | `pgMar left/right 1800` |
|
||
| 版心 | 146.50 × 246.20mm | 210−2×31.75 / 297−2×25.40 |
|
||
| 页脚距 | 17.51mm | `pgMar footer 992` |
|
||
|
||
换算：`mm = twips / 1440 × 25.4`，`pt = twips / 20`。
|
||
|
||
### 字号
|
||
|
||
| 用途 | 原件 (w:sz) | 本模板 | 实测输出 |
|
||
| :-- | --: | --: | --: |
|
||
| 大标题 | 36 半磅 = 18pt | `18bp` | 18.00 |
|
||
| 副标题 | 24 = 12pt | `12bp` | 12.00 |
|
||
| 正文 | 28 = 14pt | `14bp` | 14.00 |
|
||
| 表格/签字 | — | `12bp` | 12.00 |
|
||
|
||
⚠️ **必须写 `bp` 不能写 `pt`**。Word 的 pt 是 PostScript pt（1/72 in），
|
||
TeX 默认 pt 是 1/72.27 in，差 0.36%。写 `14pt` 实测输出 14.05。
|
||
|
||
### 行距
|
||
|
||
| 用途 | 值 | 说明 |
|
||
| :-- | --: | :-- |
|
||
| 正文 | 21.5bp | 14pt 的 1.54 倍 |
|
||
| 表格/签字 | 17bp | 12pt 的 1.42 倍 |
|
||
|
||
原件 `docGrid linePitch=312` = 15.6pt，对 14pt 字只有 1.11 倍，太挤。
|
||
本模板用 21.5bp（1.54 倍）—— 这是**有意的改善**，不是复刻。
|
||
21.5 是为压到一页反复试出来的值，可读下限约 1.4 倍，还有余量。
|
||
|
||
### 表格列宽
|
||
|
||
6 列，Σ wd = 123.64mm：
|
||
|
||
| 列 | 宽 | 内容 |
|
||
| :-- | --: | :-- |
|
||
| 项目 | 22.00mm | 理论课 / 实验课 |
|
||
| 占本类 | 14.00mm | 80% |
|
||
| 细分项目 | 26.00mm | 平时成绩 / 期末 |
|
||
| 占本类 | 14.00mm | 30% |
|
||
| 占总成绩 | 17.00mm | 24% |
|
||
| 评定依据 | 30.28mm | 作业 + 出勤 |
|
||
|
||
**Σwd 为什么是 123.64 而不是 146.50**：`Q[wd=...]` 是内容区宽度，
|
||
不含 `colsep`。每列实际占位 = `wd + 2×colsep`，6 列共多占
|
||
`6×2×1.905 = 22.86mm`。所以
|
||
`Σwd = 146.50 − 22.86 = 123.64mm`。
|
||
|
||
## 五个坑
|
||
|
||
### 坑 1：`.tex` 里写带 `@` 的宏名
|
||
|
||
`.tex` 文档中 `@` 的 catcode 是 12（其他），不是 11（字母）。写
|
||
`\grd@chk` 会被解析成 `\grd` + `@chk`，报
|
||
`! LaTeX Error: Missing \begin{document}`，并且**连累后面所有内容**
|
||
（报一串 Undefined control sequence）。
|
||
|
||
**规矩**：带 `@` 的内部宏一律定义在 `.sty` 里，`.tex` 只调用不带 `@`
|
||
的公开接口（如 `\grdcheck`）。
|
||
|
||
### 坑 2：tabularray 的 `hline{}` 里不能用带 `@` 的宏
|
||
|
||
```latex
|
||
hline{1,Z}={\grd@rulev} % ✗ 报 \l__tblr_v_tl ->\grd @rulev
|
||
hline{1,Z}={0.5pt} % ✓ 写字面值
|
||
```
|
||
|
||
tabularray 把 `hline` 的参数当**字符串重新 tokenize**，那一刻 `@` 的
|
||
catcode 已经退化，宏名在 `@` 处断开。
|
||
|
||
**规矩**：`hline` / `vline` 的线宽写字面值，别用宏包一层。
|
||
|
||
### 坑 3：签字栏被挤到第 2 页
|
||
|
||
试过四种写法，只有最后一种同时满足「一页」+「不出界」：
|
||
|
||
| 写法 | 结果 |
|
||
| :-- | :-- |
|
||
| `\par\vspace{4mm}` + minipage | ✗ 翻页（minipage 紧跟 `\par` 是合法断页点） |
|
||
| `\vfill` 顶到底部 | ✗ 不翻页但**出界**：年月日 y=774.9，版心底只有 771.6 |
|
||
| `\vfill` + 块内 `\vspace*{5mm}` | ✗ 又翻页（`\vfill` 与块高之和超出剩余空间时，TeX 不接受压缩 `\vfill`，只能整块搬迁） |
|
||
| `\par\vspace{3mm}` + minipage | ✓ 一页，内容底 769.8，余 1.8pt |
|
||
|
||
**结论**：不要指望竖直胶帮你「自动贴底」。单页文档里最稳的是
|
||
**固定间距 + 实测校准** —— 改正文后重编一次，看内容底距 771.6 还有多少。
|
||
|
||
### 坑 4：minipage 内部用 `\hfill` 做右对齐
|
||
|
||
```latex
|
||
\begin{minipage}{76mm}
|
||
任课教师（签字）：\rule{40mm}{0.4pt}\par % 行尾没有 \parfillskip 弹性
|
||
\end{minipage}
|
||
```
|
||
|
||
minipage 里的行末会被拉伸到满宽，12pt 的字出现夸张字距 ——
|
||
实测「任」「课」「教」「师」被拉到 **34.8pt 一字**。
|
||
|
||
**正解**：minipage 内 `\raggedright`，`\hfill` 只放在外面：
|
||
|
||
```latex
|
||
\noindent\makebox[\textwidth][r]{\begin{minipage}{76mm}\raggedright ...\end{minipage}}
|
||
```
|
||
|
||
### 坑 5：列表引导符「·」缺字
|
||
|
||
本库 OUC Serif 子集里**没有** `·`(U+00B7) 和 `•`(U+2022)，
|
||
用它们会报 `Missing character: There is no · (U+00B7)`，印出来是空白。
|
||
|
||
实测该字体有 `●`(U+25CF) 与 `○`(U+25CB)，且 `fonts.tex` 已把这两个
|
||
码位归入 CJK 字符类，可直接用。本模板用缩小 0.6 倍的 `●` 作引导符。
|
||
|
||
## 真实数据零泄漏
|
||
|
||
原件是**填过的实例**（真实课程名、学年、教师姓名、全部比例）。
|
||
本模板把这些逐项换成占位符。
|
||
|
||
已 grep 确认以下关键词在 `oucgrade.sty` 与 `成绩构成说明.tex` 中
|
||
**零命中**（含注释）：
|
||
|
||
```
|
||
数字逻辑 2025 秋季 杨永全 80% 30% 20% 10% 70%
|
||
```
|
||
|
||
注意：`80`/`20`/`30` 这些纯数字作为**默认占位值**是存在的（宏定义里），
|
||
但它们不代表原件真实比例，替换时改掉即可。真正需要保证零命中的是
|
||
课程名、年份、教师名这类可识别的信息。
|
||
|
||
## 字体
|
||
|
||
全部来自仓库公共字体包 `../fonts.tex`（唯一允许声明字体的地方）：
|
||
|
||
| 用途 | 字体 | 授权 |
|
||
| :-- | :-- | :-- |
|
||
| 正文宋体 | OUC Serif（思源宋体 GB2312 子集） | SIL OFL 1.1 |
|
||
| 标题楷体 | OUC Kai（霞鹜文楷子集） | SIL OFL 1.1 |
|
||
| 分节黑体 | OUC Sans（思源黑体子集） | SIL OFL 1.1 |
|
||
| 西文 | TeX Gyre Termes | GUST Font License |
|
||
|
||
⚠️ 原件标题用的是**方正楷体_GB2312**，那是商业字体，本库不含也不能分发。
|
||
改用霞鹜文楷（同属楷书形态，开源可商用）。这是**有意的替换**，不是遗漏。
|
||
|
||
⚠️ 不要用 `\setCJKmainfont` 直接指定系统字体（SimSun / SimHei 等）——
|
||
换到 Linux / macOS 就编不出来。全部走 `../fonts.tex`。 |