12 KiB
成绩构成说明 — 中国海洋大学《成绩构成说明》（LaTeX 版）
把任课教师手写的「成绩构成说明」做成 LaTeX 模板。原件是一份填过的
.doc 实例（两段话 + 标题，无表格、无签字栏），本模板在保留其信息
内容的前提下重新组织，并补齐归档必需项。
本模板不含原件任何真实数据。 课程名、学年、学期、教师姓名、 所有比例、日期一律
××××/20××/×占位，已 grep 验证零命中。
目录
文件
| 文件 | 说明 |
|---|---|
成绩构成说明.tex |
主文件。填表只改第 1 节（10 个宏） |
oucgrade.sty |
版式包。页面/字体/表格/签字栏，附换算注释 |
成绩构成说明.pdf |
成品样张（1 页） |
编译
xelatex 成绩构成说明.tex
单页，跑一遍即可（无交叉引用，不需要 bibtex）。
⚠️ 必须在本目录下编译，不要从仓库根调用 —— fonts.tex 用的是
相对路径 ../fonts/。
需要 XeLaTeX，并安装 ctex、geometry、fontspec、xeCJK、
tabularray、enumitem、graphicx。实测环境：TeX Live 2022。
改内容
课程信息（10 个宏）
\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：
\def\grdwithini{0} % 1=印这一节，0=不印
⚠️ 关掉后正文变短，签字栏会往上移。若想让它仍贴底部，把 oucgrade.sty
里签字块前的 \par\vspace{3mm} 调大即可（见坑 3）。
比例自洽校验
模板会检查三组加法：
平时 + 期末 = 100 （构成全部理论课）
作业 + 点名 = 平时 （构成全部平时成绩）
理论课 + 实验课 = 100 （构成全部总成绩）
不通过时：
.log里打出*** oucgrade: 比例不自洽 --- 作业+点名 应构成全部平时成绩: 实际 25+10, 应为 30 ***- 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{} 里不能用带 @ 的宏
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 做右对齐
\begin{minipage}{76mm}
任课教师（签字）：\rule{40mm}{0.4pt}\par % 行尾没有 \parfillskip 弹性
\end{minipage}
minipage 里的行末会被拉伸到满宽，12pt 的字出现夸张字距 —— 实测「任」「课」「教」「师」被拉到 34.8pt 一字。
正解：minipage 内 \raggedright，\hfill 只放在外面：
\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。