laoyang
dc5e9337e8
源文件：SynologyDrive\授课\数字逻辑\教学大纲\课程大纲模板-数字逻辑-2024版.docx
（2025-01-02 修订，是同目录 17 个文件里最新的一个）。所有尺寸从 OOXML 量出。
## 新增文件
课程大纲/oucSyllabus.sty 版式包
课程大纲/课程大纲.tex 示例（数字逻辑，已脱敏）
课程大纲/README.md 用法
## 版式参数（实测）
页面 A4 210×297mm
边距 上下左右均 25.4mm（正好 1 英寸）
正文 12pt 大标题 15pt 居中 表格 9~10pt
原 docx 字体：Times/宋体/黑体/仿宋_GB2312/微软雅黑
字体全部取自 ../fonts.tex（OUC Serif + OUC Sans），无系统字体依赖。
仿宋_GB2312 与微软雅黑是商业字体，不能随仓库分发（#17 的规矩）。
## 还原的 6 个表格
表0 课程基本信息 6 行，不规则（各行列跨度不同）
表1 课程目标×指标点 6×6 打勾矩阵
表2 目标×教学内容 6×3
表3 教学进度 8×5（主要大表）
表4 成绩与能力对应 6×4
表5 成绩评分体系 5×2
## 踩坑记录（都写进代码注释了）
### 1. tabularray 的 \SetCell 会吞掉下一格，且不报错
`\SetCell[c=2]{c} 内容 & 下一格` → **下一格连同内容一起消失**。
最小复现（6 列表）：
A & \SetCell[c=2]{c} B & C & \SetCell[c=2]{c} D \\
渲染只得 A / B / D，C 没了。**没有报错，没有任何警告。**
✅ 正确写法：跨 n 列后用 n-1 个 `{}` 占位
A & \SetCell[c=2]{c} B & {} & C & \SetCell[c=2]{c} D & {} \\
⇒ 规律：`&` 总数固定为「列数-1」，与是否跨列无关。
跨列只是把内容摊到多格上，被摊掉的格要用 `{}` 顶住。
这个坑让「责任教师」「课程性质」「总课时」三个标签凭空消失了三轮，
每次都要靠 pymupdf 逐行数文字才发现。README 里也记了。
### 2. xeCJK 带缩进的段落会多排一个字，但也不报 Overfull
A4、左右 25.4mm、\linewidth=452.97pt、版心右界 523.28bp 下实测：
无缩进的纯中文段落 右缘 523.28 ✅
带 2em 缩进（三种写法） 右缘 530.53 ❌ 超 7.25bp
三种失败的写法：
① \par\noindent\hspace*{2em}#1\par
② \par\setlength{\parindent}{2em}\indent #1\par
③ \parbox{\linewidth}{\setlength{\parindent}{2em}\indent #1}
根因：xeCJK 算断行点时仍按「整行可用宽度」，比应停的位置多放一个字。
✅ 正解：把 \hsize 也减掉缩进量
\setlength{\hsize}{\dimexpr\linewidth-2em\relax}
\setlength{\parindent}{2em}
实测右缘 502.28bp，落在版心内。
⚠️ 同样**不报 Overfull** —— TeX 认为这行"刚好"。
### 3. 表 0 列宽不能用固定值
课程代码「080502101231」12 位数字，10.5pt 下宽约 22mm + 内边距 3.81mm。
标签列 26.5mm → Overfull 10.26pt；24mm → 3.14pt；22mm → 0。
22mm 是下限（再窄「课程名称」自己折行）。
## 验证
全库 14/14 通过（新增第 14 项，已加入 verify_all.sh TARGETS）：
课程大纲 6 页 err=0 over=0
逐页越界检查：6 页最右 499.37~514.48bp，全部在版心 523.3bp 内。
内容核查：标题、12 项基本信息、八章标题、7 个关键段落、签字栏，
共 17 项全部命中。
双端一致：
WSL TeX Live 2025 6 页 err=0 over=0
Windows TeX Live 2022 6 页 err=0 over=0
## 偏离原文件的地方（README 有表）
1. 「六、成绩评定」原 docx 是 10.5pt，与其余七章 12pt 不一致
（复制粘贴漏改），本模板统一 12pt。
2. 表 0 的竖线按 6 等分统一，原 docx 逐行不同（tabularray 限制）。
## 脱敏
责任教师等真实姓名换成虚构的「张远航」，与仓库其他模板一致。
ouc_latex_template
中国海洋大学各类文件 LaTeX 模板。本仓库是本项目唯一的模板维护库，各模板按文档类别分目录存放，互不依赖、可单独编译。
目录
| 目录 | 内容 | 编译入口 |
|---|---|---|
试卷/ |
期末考试试卷、参考答案及评分标准两套模板 | 试卷题型示例.tex、参考答案与评分标准示例.tex |
试卷归档封面/ |
信息科学与工程学部试卷归档封面（理论课） | 试卷归档封面.tex |
试卷归档目录/ |
信息科学与工程学部试卷归档目录（理论课，12 项核对清单） | 试卷归档目录.tex |
年度考核登记表/ |
教职工年度考核登记表 | 年度考核登记表.tex |
劳务发放说明表/ |
劳务发放说明表 | 劳务发放说明表.tex |
特殊事项说明表/ |
报销用特殊事项说明表（事项描述 + 三级签字审批） | 特殊事项说明表.tex |
课程执行大纲/ |
本科课程教学执行大纲 | 课程执行大纲.tex |
课程教学日历/ |
学校通用版课程教学日历（理论课程）（附件3，16 周日历表） | 课程教学日历.tex |
成绩构成说明/ |
成绩构成说明（理论课/实验课比例分解表 + 教师签字栏） | 成绩构成说明.tex |
幻灯片/ |
演示文稿（beamer 主题，海大配色） | slides.tex |
科技报告/ |
科技报告、实验讲义、说明文档 | report.tex |
简历/ |
个人简历（中文，A4 两栏式，含圆形头像与分区条目） | 简历.tex |
编译
全部模板都必须用 XeLaTeX（fontspec + xeCJK），pdflatex 编译不过：
cd 幻灯片
xelatex slides.tex
xelatex slides.tex # 跑两遍，第二遍才能取到正确的目录、交叉引用与总页数
目录名含中文不影响编译（已实测 12 个模板目录在中文目录下零报错编译通过）。
说明
- 字体单一来源：全库字体集中在根目录
fonts/，由fonts.tex统一加载。十二个模板通过\input{../fonts.tex}取字体，不自带字体、不依赖系统字体——换机器（Windows / macOS / Linux / Overleaf）编译结果一致。 - 全部开源可商用：无方正、无 SimSun / SimHei / KaiTi / FangSong、无 Times New Roman、无微软雅黑。用的是思源宋体/黑体、霞鹜文楷、朱雀仿宋、TeX Gyre Termes、Cochineal、鸿蒙 HarmonyOS Sans（各字体授权见
fonts/LICENSE，来源与字符集见fonts/README.md）。 - 每个子目录自包含：样式文件（
.sty/.cls）、图片都在各目录内，编译时不需要额外的宏包搜索路径；只有字体是共享的上层目录。 - 各目录的
README.md写明该模板的用法、可改参数、版式数据来源与书写注意事项，改之前先看。 - 示例内容全部虚构：为了让人一眼看出排版效果，模板里填的是一整套连贯的假想数据（虚构教师「张远航」、虚构课程《数字逻辑》2025 秋、虚构的论文 / 专利 / 项目 / 获奖），不是满篇
×。这些内容不含任何真人信息、不含真题，纯粹是为了让版式跑起来有真实感，使用时整体替换成自己的内容即可。- 跨模板虚构设定是统一的：教学日历、成绩构成说明、试卷归档封面、试卷都对应《数字逻辑》2025 秋学期；简历里的论文 / 专利 / 项目 / 获奖属于同一位虚构人物。
- 一眼可辨的假数据特征：DOI 统一
10.9999/…、专利号统一ZL209999…、软著登记号2024SR99999…、手机号138 0000 0000、邮箱用example.net。 - 少数必须留空让人手填的位置（签字、日期、评语栏）仍然是空白或
×，这类不能编——编了就分不清哪儿该改了。
字体
| 目录 | 字体 | 上游 | 授权 |
|---|---|---|---|
fonts/ouc-serif/ |
OUC Serif（宋体） | 思源宋体 SC 的 GB2312 子集 | SIL OFL 1.1 |
fonts/ouc-sans/ |
OUC Sans（黑体） | 思源黑体 SC 的 GB2312 子集 | SIL OFL 1.1 |
fonts/ouc-kai/ |
OUC Kai（楷体） | 霞鹜文楷的 GB2312 子集 | SIL OFL 1.1 |
fonts/zhuque-fangsong/ |
朱雀仿宋（仿宋） | 朱雀仿宋 | SIL OFL 1.1 |
fonts/tex-gyre-termes/ |
TeX Gyre Termes（西文，全库默认） | Times New Roman 度量兼容替代 | GUST Font License |
fonts/cochineal/ |
Cochineal（西文，仅 简历/ 用） |
Minion 风格，Michael Sharpe | SIL OFL 1.1 |
fonts/harmonyos-sans/ |
HarmonyOS Sans（幻灯片/科技报告） | 华为 | 华为官方允许免费商用 |
合计约 50 MB（改造前 141 MB，见 fonts/README.md 第五节）。
子集字体已按 OFL §3 改名（
Source/LXGW是上游的 Reserved Font Name，裁剪即构成修改版），并保留了 OFL 声明。 用本模板编译出的文档不受这些字体授权约束，版权归作者本人。
历史沿革
幻灯片/ 与 科技报告/ 此前分别维护在两个独立仓库（ouc-slide-latex-template、ouc-report-latex-template），2026-10 起并入本仓库统一维护，两个旧仓库不再更新。迁入时保留了原有目录结构、字体与图片资源，旧仓库的提交历史留在原仓库中。