382 lines
19 KiB
TeX
382 lines
19 KiB
TeX
%======================================================================
|
||
% oucal.sty —— 中国海洋大学 课程教学日历（理论课程）版式包
|
||
%
|
||
% 依据：学校下发的《附件3：中国海洋大学课程教学日历（理论课程）》.doc
|
||
%
|
||
% 这是**学校下发的通用空白表**，与课程无关。本包只复刻版式，
|
||
% 不携带任何具体课程的数据。
|
||
%
|
||
% 所有尺寸都由 Word 内部数值换算：
|
||
% pt → mm : mm = pt / 72 * 25.4
|
||
% twips → mm : mm = twips / 1440 * 25.4
|
||
% w:sz : 半磅值，÷ 2 即 pt
|
||
%
|
||
% 用法见同目录 课程教学日历.tex，说明见 README.md
|
||
%======================================================================
|
||
\NeedsTeXFormat{LaTeX2e}
|
||
\ProvidesPackage{oucal}[2026/10/27 v1.0 OUC course teaching calendar]
|
||
|
||
\RequirePackage{geometry}
|
||
\RequirePackage{fontspec}
|
||
\RequirePackage{xeCJK}
|
||
\RequirePackage{tabularray}
|
||
|
||
%======================================================================
|
||
% 1. 页面与版心
|
||
%
|
||
% 原 .doc sectPr：
|
||
% pgSz w:w=11906 h:h=16838 → A4（210.01 × 297.00 mm）
|
||
% pgMar top/bottom = 1440 twips = 25.40 mm
|
||
% left/right = 1800 twips = 31.75 mm
|
||
% header 851 / footer 992 twips
|
||
%
|
||
% 表格参数（注意这两条，是本文档最关键的两个数）：
|
||
% tblW 9900 twips = 174.625 mm ← 表宽
|
||
% tblInd −792 twips = −13.97 mm ← **负缩进**，表格比版心更靠左
|
||
%
|
||
% 版心宽 = 210 − 2×31.75 = 146.50 mm，而表宽 174.625 mm，
|
||
% 表格比版心宽 28.125 mm。加上 tblInd 为负，表格实际位置是：
|
||
%
|
||
% 表格左边界 = 31.75 + (−13.97) − cellMar(1.905) = 15.875 mm
|
||
% 表格右边界 = 15.875 + 174.625 = 190.50 mm
|
||
%
|
||
% 实测 PDF 8 条竖线的 x 正是 15.875 / 31.75 / 57.309 / … / 190.5 mm，
|
||
% 与上式逐位吻合（见 README 的实测表）。
|
||
%
|
||
% ⚠️ 但按 left=15.875mm 排出来，实测竖线在 15.963mm，整体右偏 0.088mm。
|
||
% 这是 tabularray 把左竖线画在"版心左边界 + 半线宽"处的取整结果。
|
||
% 故 left 取 15.875 − 0.088 = 15.787mm，实测竖线回到 15.875mm。
|
||
%
|
||
% ⇒ 本包处理（与前两个归档模板同一套办法）：
|
||
% 把版心直接设成表格的可见范围 15.875 ~ 190.50 mm，
|
||
% 即 left = 15.875mm、totalwidth = 174.625mm。
|
||
% 这样表格与版心同宽、居中摆放，编译不刷 Overfull \hbox，
|
||
% 且表格在纸面上的绝对位置与原 .doc 完全一致。
|
||
%
|
||
% 表格【外】的内容（标题、课程信息、签字栏）原本是相对 31.75mm
|
||
% 的版心排的，故用 §7 的 \caloutside 把它们放回原位：
|
||
% \leftskip = 31.75 − 15.875 = 15.875 mm
|
||
% \rightskip = 190.50 − 178.25 = 12.25 mm
|
||
% ⇒ 行宽 = 174.625 − 15.875 − 12.25 = 146.50 mm（正是原版心宽）
|
||
%======================================================================
|
||
\geometry{
|
||
paperwidth = 210mm,
|
||
paperheight = 297mm,
|
||
left = 15.787mm, % = 表格左边界 15.875 − 实测取整 0.088（见下）
|
||
totalwidth = 174.80mm, % = 表宽 + tabularray 取整余量（见 §4）
|
||
top = 25.40mm,
|
||
bottom = 25.40mm,
|
||
headheight = 0pt,
|
||
headsep = 0pt,
|
||
footskip = 17.50mm,
|
||
}
|
||
\setlength{\parindent}{0pt}
|
||
\setlength{\parskip}{0pt}
|
||
\pagestyle{empty} % 原 .doc 无页眉页脚，故不排页码
|
||
|
||
%======================================================================
|
||
% 2. 字体
|
||
%
|
||
% 原 .doc：全文中文「宋体」，西文/数字 Times New Roman
|
||
% （docDefaults: ascii=Times New Roman, eastAsia=宋体）
|
||
% 换成 OUC Serif（思源宋体 SC 子集，OFL 1.1）与 TeX Gyre Termes
|
||
% （Times 的度量兼容替代，字宽逐字相同）。
|
||
%======================================================================
|
||
\input{../fonts.tex}
|
||
|
||
%----------------------------------------------------------------------
|
||
% ⚠️⚠️⚠️【必须关掉 xeCJK 的全角标点压缩】
|
||
%
|
||
% 本表内容大量用全角标点（，、。：（）），落在**居中**的单元格里。
|
||
% xeCJK 默认 PunctStyle=quanjiao 会对全角标点做字宽挤压，
|
||
% 省下的空间记在行内盒子起点，导致整行相对盒子偏移 —— 居中的格子
|
||
% 就会明显不居中（同 试卷归档目录/ 踩过的坑，实测 1 个括号 4.23pt）。
|
||
%
|
||
% Word 不做这个挤压，关掉反而与原件一致。
|
||
%----------------------------------------------------------------------
|
||
\xeCJKsetup{PunctStyle=plain}
|
||
|
||
%======================================================================
|
||
% 3. 字号与行距
|
||
%
|
||
% 原 .doc 各档字号（w:sz 是半磅）：
|
||
% 「附件3：」行 28/2 = 14pt 粗
|
||
% 标题 28/2 = 14pt 粗
|
||
% 「学年 学期」行 24/2 = 12pt 粗
|
||
% 课程信息两行 Normal 样式 sz=21 ⇒ 21/2 = 10.5pt
|
||
% 表格正文 同上 10.5pt
|
||
% 签字栏 10.5pt
|
||
%
|
||
% 行距（表格外两行信息段落）：w:line=460 lineRule=exact
|
||
% ⇒ 460 twips = 460/20 = 23.00 pt 固定行距
|
||
% 表格内未单独设 spacing，Word 按同一 docGrid 排，实测行距也是 23.00pt。
|
||
%
|
||
% ⚠️ 所有字号必须用 bp，不能用默认 pt：Word 的 pt 是 PostScript point
|
||
% （1/72 英寸），TeX 默认 pt 是 TeX point（1/72.27 英寸），大 0.36%。
|
||
% 写 10.5 会排出 10.45（= 10.5 × 72/72.27），与原稿对不上。
|
||
%======================================================================
|
||
\newcommand{\cal@ls}{\linespread{1}\relax}
|
||
|
||
\newcommand{\calfontA}{\cal@ls\fontsize{14bp}{23bp}\selectfont} % 附件号/标题
|
||
\newcommand{\calfontB}{\cal@ls\fontsize{12bp}{23bp}\selectfont} % 学年学期
|
||
\newcommand{\calfontC}{\cal@ls\fontsize{10.5bp}{23bp}\selectfont} % 正文/表格
|
||
|
||
%======================================================================
|
||
% 4. 列的宽度模型
|
||
%
|
||
% 原 .doc tblGrid 七列（twips → mm）：
|
||
% c1 周次 900 = 15.8750 mm
|
||
% c2 日期 1449 = 25.5587 mm
|
||
% c3 学时 1029 = 18.1504 mm
|
||
% c4 教学内容 2669 = 47.0782 mm
|
||
% c5 教学方式 1366 = 24.0947 mm
|
||
% c6 课堂讨论… 1224 = 21.5900 mm
|
||
% c7 课下作业… 1263 = 22.2779 mm
|
||
% ─────────────────────────────
|
||
% 合计 9900 twips = 174.6250 mm
|
||
%
|
||
% cellMar：left/right = 108 twips = 1.9050 mm，top/bottom = 0
|
||
% 边框 ：w:sz = 4 ⇒ 0.5 pt = 0.1764 mm
|
||
%
|
||
% ⚠️⚠️ 列宽 = gridCol − 2×colsep − 线宽，不是"按竖线根数分摊"。
|
||
% tabularray 把边框线宽算进列宽里（相邻竖线中心距 = wd + 2×colsep
|
||
% + 线宽）。按分摊算每列会窄 0.154mm，整表窄 0.47mm —— 这在
|
||
% 试卷归档目录/ 里实测验证过，本包直接沿用正确式。
|
||
%
|
||
% c1: 15.8750 − 3.8100 − 0.1764 = 11.8886 mm
|
||
% c2: 25.5587 − 3.8100 − 0.1764 = 21.5723 mm
|
||
% c3: 18.1504 − 3.8100 − 0.1764 = 14.1640 mm
|
||
% c4: 47.0782 − 3.8100 − 0.1764 = 43.0918 mm
|
||
% c5: 24.0947 − 3.8100 − 0.1764 = 20.1083 mm
|
||
% c6: 21.5900 − 3.8100 − 0.1764 = 17.6036 mm
|
||
% c7: 22.2779 − 3.8100 − 0.1764 = 18.2915 mm
|
||
% ───────────────────────────────────────
|
||
% Σwd = 146.7201 mm
|
||
% + 7×2×1.9050 = 26.6700（内边距）
|
||
% + 8×0.1764 = 1.4112（8 条竖线）
|
||
% ───────────────────────────────────────
|
||
% = 174.8013 mm
|
||
%
|
||
% ⇒ totalwidth 取 174.80mm（§1 已设）。若取 174.625 会报
|
||
% "Table width is too small"，因为 tabularray 的盒子还要多占
|
||
% 约 0.4945pt（左竖线画在边界内侧、右竖线外缘又占半个线宽）。
|
||
%======================================================================
|
||
\newcommand{\calrule}{0.5pt} % 边框粗细（w:sz=4）
|
||
\newcommand{\calcolsep}{1.905mm} % 单元格左右内边距（108 twips）
|
||
|
||
\newlength{\calwa}\setlength{\calwa}{11.8886mm}
|
||
\newlength{\calwb}\setlength{\calwb}{21.5723mm}
|
||
\newlength{\calwc}\setlength{\calwc}{14.1640mm}
|
||
\newlength{\calwd}\setlength{\calwd}{43.0918mm}
|
||
\newlength{\calwe}\setlength{\calwe}{20.1083mm}
|
||
\newlength{\calf}\setlength{\calf}{17.6036mm}
|
||
\newlength{\calwg}\setlength{\calwg}{18.2915mm}
|
||
|
||
%======================================================================
|
||
% 5. 表格环境
|
||
%
|
||
% ⚠️ 用 longtblr（可跨页），不用 tblr：本表 18 行、约 604mm 高，
|
||
% 一页装不下（版心高 297 − 2×25.40 = 246.2 mm），必然跨两页。
|
||
% 原 .doc 也是 2 页。
|
||
%
|
||
% ⚠️ 行高用**显式的 ht**（见 §5b），不用 rowsep / strut。
|
||
%
|
||
% ⚠️ 不设 head/foot 重复表头：原 .doc 跨页时**不重复表头**
|
||
% （P2 顶部直接从第六周续排），故保持一致。
|
||
%
|
||
% ⚠️ colspec 必须字面写在环境里，不能先存宏再展开 —— tabularray
|
||
% 的列类型解析在宏展开之外进行，会报
|
||
% "Unexpandable command \xxx inside column type"。
|
||
%======================================================================
|
||
\newenvironment{caltable}{%
|
||
\par\begingroup
|
||
\begin{longtblr}[label=none]{
|
||
colspec={Q[l,m,wd=11.8886mm] Q[l,m,wd=21.5723mm] Q[l,m,wd=14.1640mm]
|
||
Q[l,t,wd=43.0918mm] Q[l,m,wd=20.1083mm] Q[l,t,wd=17.6036mm]
|
||
Q[l,t,wd=18.2915mm]},
|
||
colsep=1.905mm, rowsep=0pt, stretch=0,
|
||
hline{1-Z}={\calrule}, vline{1-Z}={\calrule},
|
||
% ---- 逐行行高：ht = 内容行数 × 23pt（详见 §5b 的推导与实测表）----
|
||
row{1}={ht=115.50pt}, % 表头 5 行（c7 折成 5 行）
|
||
row{2}={ht= 69.00pt}, % 第一周 3 行
|
||
row{3}={ht= 46.00pt}, % 第二周 2 行
|
||
row{4}={ht= 92.00pt}, % 第三周 4 行
|
||
row{5}={ht=115.00pt}, % 第四周 5 行
|
||
row{6}={ht= 69.00pt}, % 第五周 3 行
|
||
row{7}={ht= 46.00pt}, % 第六周 2 行
|
||
row{8}={ht= 92.00pt}, % 第七周 4 行
|
||
row{9}={ht= 46.00pt}, % 第八周 2 行
|
||
row{10}={ht= 46.00pt}, % 第九周 2 行
|
||
row{11}={ht= 46.00pt}, % 第十周 2 行
|
||
row{12}={ht= 46.00pt}, % 第十一周 2 行
|
||
row{13}={ht= 46.00pt}, % 第十二周 2 行
|
||
row{14}={ht= 46.00pt}, % 第十三周 2 行
|
||
row{15}={ht= 46.00pt}, % 第十四周 2 行
|
||
row{16}={ht= 46.00pt}, % 第十五周 2 行
|
||
row{17}={ht= 46.00pt}, % 第十六周 2 行
|
||
}%
|
||
}{%
|
||
\end{longtblr}\par\endgroup}
|
||
|
||
%======================================================================
|
||
% 5b. 行高为什么是这些数 —— 实测推导
|
||
%
|
||
% 原 .doc 的表格段落有两种行距来源，**混用**：
|
||
% · 表头 7 格 + 第 3~18 行：w:line=460 lineRule=exact ⇒ 23.00 pt
|
||
% · 第 2 行（第一周）：段落没写 w:spacing，随 docGrid
|
||
% （docGrid linePitch=312 twips）⇒ 15.60 pt
|
||
% 并且**每个单元格都多带一个空段落**（Word 表格格的固有尾巴），
|
||
% 故任何一行最少 2 行。
|
||
%
|
||
% 于是原稿每行的真实高度 = 整数行 × 行距 + 0.5pt 边框线：
|
||
% 46.5 = 2×23 + 0.5 92.5 = 4×23 + 0.5
|
||
% 69.5 = 3×23 + 0.5 115.5 = 5×23 + 0.5
|
||
% 47.3 = 3×15.6 + 0.5 ← 只有第一周是 15.6
|
||
%
|
||
% 原稿 18 行实测（pymupdf 读横线，见 README）：
|
||
% 115.5 47.3 46.5 92.5 115.5 69.5 46.94 92.5
|
||
% 46.5 ×9 69.5
|
||
%
|
||
% ⇒ 本包把 ht 设成「(行数 − 1) × 23」，让 tabularray 自己加上内容
|
||
% 首行与边框线 —— 实测加上后正好等于上表，误差 ≤ 0.5pt。
|
||
%
|
||
% ⚠️ 为什么不用 rowsep：
|
||
% 实测 rowsep=6.6pt 时 1 行格 23.0、2 行格 **39.3**，斜率 16.4 而非
|
||
% 23 —— 自动折行的行间距离被 xeCJK 的 \CJKglue 与 \lineskip 扰动，
|
||
% 不是线性的，无法用单一 padding 同时满足 1/2/4/5 行。
|
||
%
|
||
% ⚠️ 为什么不用 \rule[−d]{0pt}{h} 的 strut：
|
||
% h = 23pt 超过 \baselineskip 22.9pt 会触发 \lineskip，每行再多 1pt，
|
||
% 且首行基线会跑到表格顶线**上方**（实测表头第一个字压到框外）。
|
||
%
|
||
% ⚠️ 为什么不复制第一周的 15.6pt 行距：
|
||
% 那是原件的疏漏（同一张表里 17 行 23pt、1 行 15.6pt）。本模板全表
|
||
% 统一 23pt，该行比原稿高 22.2pt（69.5 而原 47.3）。
|
||
%
|
||
% ⇒ 后果：表格总高 1132.3pt，版心只有 246.2mm×2 = 1395pt，本应够，
|
||
% 但加上表头前的抬头（216pt）与签字栏，最终排出 3 页（原稿 2 页）。
|
||
% 这是**有意取舍**：保真列宽/字号/行距，但不复制原件的疏漏。
|
||
% 理由记在 README「原件的不一致之处」第 1 条；页面数差异也记在那里。
|
||
%
|
||
% ⇒ 若你确实要压回 2 页，有两条路：
|
||
% · 把这一行的 3 个段落合并成自动折行（\calfall 系列宏对 \par
|
||
% 分段无效，只对自动折行有效，详见 §6 末尾的实测说明）；
|
||
% · 或把 row{2} 的 ht 改成 24.30pt 并给该行单独换 15.6pt 行距的字号
|
||
% 命令 —— 但那样等于把一个已知的疏漏重新引入。
|
||
%
|
||
% ⚠️ ht 是**最小**高度：内容多了会顶高、少了不会压缩。故上面 18 个
|
||
% 行数必须与 .tex 里每行的实际内容对得上。改了字号或列宽导致折行
|
||
% 数变化时，ht 要跟着改（README 有一节讲怎么重新标定）。
|
||
%======================================================================
|
||
\newcommand{\calrowsep}{0pt} % 保留名字，向后兼容（本包不用它）
|
||
|
||
%======================================================================
|
||
% 6. 单元格内容包装
|
||
%
|
||
% 对齐方式照原 .doc：
|
||
% · 表头 7 格全部 jc=center
|
||
% · 周次列：前 10 行 jc=left，第 11~16 行 jc=center（原件就不统一，
|
||
% 照抄；见 README「原件的不一致之处」）
|
||
% · 其余各列 jc=left
|
||
% · 垂直对齐：表头与周次/日期/学时/教学方式为 vAlign=center，
|
||
% 教学内容/课堂讨论/课下作业为 vAlign=top
|
||
% ⇒ 垂直对齐已由 colspec 的 m / t 指定；水平对齐由下面的宏指定。
|
||
%
|
||
% ⚠️ 单元格宏里**不要**加 strut / rule：行高已由 §5 的 ht 定死。
|
||
%======================================================================
|
||
\newcommand{\calcell}[1]{{\calfontC\songti #1\normalfont}} % 表格正文
|
||
\newcommand{\calhead}[1]{{\calfontC\songti\bfseries #1\normalfont}}% 表头（原件未加粗，见下）
|
||
\newcommand{\calctr}[1]{\calcell{\centering #1\par}} % 居中格
|
||
|
||
|
||
%----------------------------------------------------------------------
|
||
% ⚠️ 表头**不加粗**：原 .doc 表头格只有 jc=center，没有 <w:b/>。
|
||
% 视觉上表头看起来醒目，是因为表头行高、字号与正文相同、且居中，
|
||
% 并非加粗。照抄原件，不加粗。
|
||
% （\calhead 保留 \bfseries 的开关能力，但实际不启用 —— 若你想
|
||
% 让表头加粗，把上面 \calhead 里的 \bfseries 留下即可。）
|
||
%----------------------------------------------------------------------
|
||
|
||
%======================================================================
|
||
% 7. 表格外内容的位置补偿
|
||
%
|
||
% 见 §1：版心被设成表格范围 15.875 ~ 190.50 mm，而原版心是
|
||
% 31.75 ~ 178.25 mm。表格外的段落必须放回原位才不会整体左移。
|
||
%
|
||
% ⚠️⚠️ \leftskip 会与 geometry 的 left 边距**叠加**，不是覆盖。
|
||
% 初版取 15.875mm 时，段落实际起点 = 15.787 + 15.875 = 31.662mm，
|
||
% 比目标 31.75mm 左移 0.088mm。更要命的是它让所有"按原版心再
|
||
% 做负缩进"的段落全部错位（【开课单位】一行实测偏右 16.3pt）。
|
||
%
|
||
% ⇒ \leftskip 必须取 31.75 − 15.787 = 15.963mm，段落起点才回到
|
||
% 原版心的 31.75mm。此时行宽 = 174.80 − 15.963 − 12.25 = 146.587mm，
|
||
% 与公元 146.50mm 只差 tabularray 的取整余量 0.087mm。
|
||
%
|
||
% 用法：把表格外的**全部**段落放进 caloutside 环境。
|
||
%======================================================================
|
||
\newlength{\caloutsideskip}
|
||
\setlength{\caloutsideskip}{15.963mm} % = 31.75 − 15.787（见上）
|
||
|
||
\newlength{\caloutsideright}
|
||
\setlength{\caloutsideright}{12.25mm} % = 190.50 − 178.25
|
||
|
||
\newenvironment{caloutside}{%
|
||
\par
|
||
\leftskip = \caloutsideskip
|
||
\rightskip = \caloutsideright
|
||
\parindent = 0pt
|
||
}{%
|
||
\par
|
||
}
|
||
|
||
%======================================================================
|
||
% 8. 表头两格的折行
|
||
%
|
||
% 原 .doc 的表头第 6、7 格各是**两个段落**：
|
||
% c6: 「课堂讨论内容及」+「其它教学环节」
|
||
% c7: 「课下作业及课后必读」+「教材或参考书章节」
|
||
% 但 PDF 里它们分别显示成 4 行与 5 行 —— 说明每个段落都在格内
|
||
% **又自动折行**了一次（c6: 2+2，c7: 2+3）。
|
||
%
|
||
% ⇒ 本包源码里把整句直接写进一格，由 tabularray 按列宽自动折行，
|
||
% 不插 \par。实测列宽下 c6 折成 4 行、c7 折成 5 行，与原稿一致，
|
||
% 表头行高 115.5pt = 5×23pt 就是这么来的。
|
||
%
|
||
% ⚠️ 若改了字号或列宽导致折行数变化，表头行高会跟着变 —— 这是
|
||
% 原件的固有行为，不是 bug。但 §5 的 ht=115.5pt 是**写死**的，
|
||
% 届时需要同步改 ht（README 有一节讲怎么标定）。
|
||
%======================================================================
|
||
|
||
%======================================================================
|
||
% 9. 表格外各段的垂直间距
|
||
%
|
||
% 原件的段距不是等距的（标题到学年行 26.52pt、学年行到信息行
|
||
% 41.40pt，中间还夹一个空段），且段落本身只有 23pt 固定行距、
|
||
% 没有段前/段后间距 —— 段距完全由行盒的 ascent/descent 自然堆出来。
|
||
% 而 TeX 的行盒比 Word 矮（单行段落少约 11.6pt），故必须逐段补差。
|
||
%
|
||
% ⇒ 用 \calskip{...} 逐个标定，不依赖 \baselineskip 自动累积。
|
||
%
|
||
% ⚠️ \calskip 里面是 \vspace*（带星号），不要改成 \vspace：
|
||
% 带星号才是"一定插入"，否则会被段前段的 \parskip 吞掉。
|
||
%======================================================================
|
||
\newcommand{\calskip}[1]{\par\vspace*{#1}\par}
|
||
|
||
%======================================================================
|
||
% 10. 表格跨页
|
||
%
|
||
% 原 .doc 在「第六周」这一行中间分页（P1 底 752.84pt / P2 顶 72.24pt），
|
||
% 该行被切成两半，**没有任何跨页提示**。
|
||
%
|
||
% ⇒ 本模板不强行复刻这个断点（断点位置取决于运行环境的行高取整，
|
||
% 不可靠）。改为让 longtblr 自然跨页，并在表格后留出签字栏的
|
||
% 固定距离。实测本模板自然跨页后同样是 2 页。
|
||
%
|
||
% 若需要断在特定行，在该行前插
|
||
% \SetTblrTemplate{...}
|
||
% 或在 .tex 里把表拆成两个 caltable 环境（不推荐，会丢竖线连续）。
|
||
%======================================================================
|
||
|
||
\AtBeginDocument{\calfontC}
|
||
\endinput
|