ouc_latex_template/课程执行大纲/README.md

课程执行大纲 —— 本科课程教学执行大纲、教学日历（LaTeX 模板）

中国海洋大学下发的《本科课程教学执行大纲》Word 模板的 XeLaTeX 复刻版。 内容全部虚构（课程名、课程代码、开课号、教师、教材、思政案例），只复刻版式。

文件	说明
课程执行大纲.tex	主文件。虚构课程的一份完整示例
ouccourse.sty	版式宏包。尺寸全部从原 docx 的 OOXML 量出
课程执行大纲.pdf	编译产物，5 页（与原 docx 一致）

编译

xelatex 课程执行大纲.tex        # 单次即可，无交叉引用

需要 ctex + geometry + fontspec + xeCJK + tabularray。 实测环境：TeX Live 2022 / tabularray 2022A。

换成一门真实的课

只改 课程执行大纲.tex 顶部的宏定义，不要动 ouccourse.sty。

\newcommand{\cfcourse}{信号与系统基础}      % 课程名
\newcommand{\cfyear}{2026}                  % 学年
\newcommand{\cfseason}{秋}                  % 季学期
\newcommand{\cfmode}{考试}                  % 考核方式：考试/考查/论文
\newcommand{\cfcode}{081203304517}          % 课程代码
\newcommand{\cfhour}{56}                    % 总课时
\newcommand{\cfcredit}{3.0}                 % 学分
\newcommand{\cfprac}{18}                    % 实践学时
\newcommand{\cfteacher}{×××}                % 任课教师
\newcommand{\cfteachno}{99663311}           % 开课号
\newcommand{\cfmajor}{电子信息工程}          % 面向专业
\newcommand{\cfattr}{专业核心必修课}         % 课程属性

正文各节直接用 \ccsec{}（一级标题）、\ccp{}（带 2 字首行缩进的正文）。

表 0 —— 成绩综合评分体系

\begin{ccscoretable}
成绩综合评分体系 & 比例\% \\      % 表头
1.课下作业、课堂讨论及平常表现 & 24 \\
2.实验成绩 & 20 \\
3.期末考试成绩 & 56 \\
总计 & 100 \\
\end{ccscoretable}

行数可以增减，行高自动（每行 7.834mm）。

表 1 —— 教学日历

\begin{cctable}
{\ccfang\ccszxi\bfseries 周次} & ... & {\ccszix 内容} & 2 & {\ccszix ...} & {\ccszix ...} \\
\end{cctable}

• 6 列，顺序固定：周次 / 内容顺序 / 主题 / 计划课时 / 教学内容及教学方式 / 思政点及支撑指标点情况
• 纵向合并周次段用 \SetCell[r=2]{c}（跨 2 行，r=N 即跨 N 行）
• 表尾「合计」行后有两个 \SetCell[c=6]{c} 的整行合并（任课老师签字 / 审核意见）
• 表内默认 9pt；表头用 \ccszxi（11pt）加粗；审核意见格内部钉死 10.5pt/12.6pt

版式数据来源（twips → mm）

原 docx 的 sectPr：

属性	twips	mm	说明
pgSz w	11910	210.08	WPS 存的"非标准 A4"，本包用标准 210
pgSz h	16840	297.04	同上，用 297
pgMar top	1420	25.05	上边距
pgMar bottom	280	4.94	下边距极小，原文件为塞进 5 页压出来的
pgMar left	1560	27.52	左边距
pgMar right	1300	22.93	右边距（左右不对称，照抄）
pgMar header/footer	720	12.70	无页眉页脚内容，仅占位

换算：mm = twips / 1440 × 25.4，pt = twips / 20。

表 0（成绩综合评分体系）

项目	twips	mm
gridCol	7479 + 1418	131.921 + 25.012
表宽	8897	156.93
tblCellMar left/right	108	1.905
trHeight（exact）	454	8.01（本包用 7.834，见坑 3）
边框 sz	4	0.5pt

tblLayout fixed、jc center、tblW 0 auto。全表 12pt 方正仿宋。

表 1（教学日历）

项目	twips	mm
gridCol	846,1134,1877,850,2835,1843	14.922, 20.002, 33.108, 14.993, 50.006, 32.508
表宽	9385	165.54（超版心 5.91）
trHeight R0（atLeast）	917	16.17
trHeight R14（atLeast）	1825	32.19
trHeight R15（atLeast）	1073	18.93（只是下限，实际被撑到 56mm）

16 行。R1~R13 无 trHeight，行高由内容决定。纵向合并 5 组（R1-R2、R3-R4、 R5-R6、R7-R8、R9-R10）；R14/R15 是 gridSpan=6 的整行合并。

六个必须知道的坑

1. 表宽 > 版心时，不要缩放列宽

docx 里表 1 是 165.54mm，版心只有 159.55mm。Word 允许表格超出、居中后压进左右页边距。

不要按 159.55/165.54 按比例缩列宽。 缩了之后长文字会提前折行，行高、页数全变。 正确做法：列宽照抄 gridCol，用 \leftskip 把整块左移。

\hsize=\cctblw \linewidth=\cctblw      % 让表内得下，不报 Overfull
\leftskip=-\cctblshift \rightskip=0pt   % 整块左移 5.29mm，落到 22.23mm

\hspace* 对 longtblr 生成的 \halign 盒子无效，会被吞掉，必须用 \leftskip。

2. wd= 是内容宽，不含竖线自身的宽度

tabularray 的 Q[...,wd=X] 里 X 是内容宽。每条 vline 自身还占 0.5pt = 0.17639mm。

表 1：6 列 7 条线，每列承担 7/6 条 ⇒ wd = gridCol − 2×colsep − 0.2058
表 0：2 列 3 条线，每列承担 1.5 条 ⇒ wd = gridCol − 2×colsep − 0.2646

漏算的后果很隐蔽：表看起来对，但总宽每列多 0.18mm，6 列就差出 1mm。

3. ht= 也含横线宽度预算

row{1-Z}={ht=8.01mm} 画出来是 8.19mm（每行多一条 0.5pt 横线）。 要得到 8.01mm 的真实行高，ht 要给 7.834mm。

4. presep/postsep/headsep/footsep 是 outer 键

写进 \begin{longtblr}[...] 的方括号里；写进花括号（inner spec）不会生效， 反而会把 0pt 当表内容印在表格第一行 —— 表头上会出现一串 0pt0pt0pt0pt 的垃圾文字，而且不报错。

同理，表级默认字号必须写 cells={font=\ccszix}，单独写 font= 会被静默忽略。

5. 跨页续页提示要清两组模板

longtblr 跨页时默认印 ( Continued )、表尾印 Continued on next page， 有 caption 时还印 表0:。清干净要动两组：

% (a) 内容模板 *-text —— 不能设成 empty！会报
%     "LaTeX3 Error: Erroneous variable \l__tblr_template_conthead_text_tl"
\DefTblrTemplate{conthead-text}{normal}{}
\DefTblrTemplate{contfoot-text}{normal}{}
\SetTblrTemplate{conthead-text}{normal}
\SetTblrTemplate{contfoot-text}{normal}
% (b) 模板实例
\SetTblrTemplate{caption-tag}{empty}
\SetTblrTemplate{caption-sep}{empty}
\SetTblrTemplate{caption-text}{empty}
\SetTblrTemplate{caption}{empty}
\SetTblrTemplate{conthead}{empty}
\SetTblrTemplate{contfoot}{empty}

只做 (b) 时第 5 页仍会出现「表0:」与「(Continued)」，因为模板实例里调的是 \UseTblrTemplate{...}{default}，会回退到 normal 内容。

6. \linespread 是乘在基准字号上的

ctex 默认 \linespread ≈ 1.3，会把 \fontsize{12}{18} 的行距放大到 23.4pt。

给字号设行距时必须先归 1：

\newcommand{\ccfont}[2]{\linespread{1}\relax\fontsize{#1}{#2}\selectfont}

反过来，在已经缩小过字号的上下文里，不能用 \linespread{1.2} 当"1.2 倍行距" （它乘的是外层的 9pt，不是当前的 10.5pt），要直接钉 \fontsize{10.5}{12.6}。

字体降级

原 docx 用了 4 个字体，其中 3 个是方正商业字体，嵌在 docx 里但本机没装：

docx 原字体	用在哪	本包替代
方正小标宋简体	校名、副标题、大标题、教学日历	宋体 + 伪粗（AutoFakeBold=3.2）
方正仿宋_GB2312	正文、表 0、签字栏	仿宋（FangSong）
黑体	各级标题	黑体（SimHei）
宋体	教学日历表 9pt	宋体（SimSun）

装过方正字体的话，改 ouccourse.sty 第 75~78 行的 \newCJKfontfamily 即可，其余不动。

同时 \xeCJKsetup{CJKecglue={}} 关掉了西文与汉字之间的自动空隙 —— 原 docx 没有这种空隙， 不关会出现「×× 学部×× 学院」这种多出来的空格。

与 docx 的已知差异

项目	docx	本模板	原因
纸张	210.08 × 297.04	210 × 297	标准 A4，肉眼不可辨
表格是否跨页	表 1 跨第 4/5 页	同	表高 334mm > 版心 267mm
跨页处表头	不重复（无 tblHeader）	不重复	一致
行内是否允许断开	允许（无 cantSplit）	允许	一致
表 0 每行高	8.01	8.01	一致
表 1 表宽	165.54	165.36（−0.18）	竖线宽度舍入
字体	方正小标宋/仿宋	宋体加粗/仿宋	商业字体未安装
修订标记	46 处 w:ins	不保留	已接受全部插入修订
46 处 w:ins 中的红字	color=C00000	黑色	那是修订高亮，非正式版式

校验方法

不靠肉眼，靠量。

pdftocairo -svg -f 4 -l 4 课程执行大纲.pdf /tmp/p4.svg   # 矢量线条
pdftotext -bbox 课程执行大纲.pdf /tmp/bbox.html           # 字坐标

或用 pymupdf 直接读（推荐，能同时拿到线段与 span 的 bbox）：

import pymupdf
d = pymupdf.open('课程执行大纲.pdf')
for dr in d[3].get_drawings():          # 表格横竖线
    for it in dr['items']:
        if it[0] == 'l':
            print(it[1], it[2])         # 两端点，单位 pt

注意：同一条竖线会被重复计入多次（每个单元格一段），做列宽计算前必须 sorted(set(round(x,2) ...)) 去重，否则 xs[1]-xs[0] 算出来是 0。

验收结果（实测，26/26 项达标）

表 0   宽 156.753  目标 156.930  差 −0.177
       左  27.608  目标  27.520
       高  40.040  目标  40.050
       列  131.830 / 24.924  目标 131.921 / 25.012
表 1   宽 165.358  目标 165.540  差 −0.182
       左  22.320  目标  22.270
       列  14.894 / 19.971 / 33.076 / 14.965 / 49.975 / 32.477
           目标 14.922 / 20.002 / 33.108 / 14.993 / 50.006 / 32.508
       R0 16.334（目标 16.170）  R14 32.385（目标 32.190）
       R15 56.339（atLeast 下限 18.930，被 12 段内容撑高）
页数   5（与原 docx 一致）
编译   零错误、零 Overfull、零 Underfull
各页最低点均 ≤ 292.06mm 版心下沿，无越界