laoyang/ouc_latex_template
1
0
Fork 0
Code Issues 1 Pull Requests Actions Packages Projects Releases Wiki Activity
47 Commits 1 Branch 0 Tags
203e490197288aaf6c22e824d7ca8ed3e1499d87
Commit Graph
15 Commits
Author SHA1 Message Date
laoyang f87d763602 重写全部 README，只保留使用说明 
17 个 README 统一改成使用说明书，去掉来源、踩坑、需求过程等内容。

只保留：
- 怎么编译、跑几遍
- 文件结构
- 要改哪些参数（逐项列出宏名与含义）
- 用到的命令（表格）
- 版式参数

删除：
- 原文件来源、抽取过程
- 踩坑记录、最小复现、实测数据
- 用户需求、工单号、历史沿革
- 改造前后对比

行数 4185 → 2261。

全库 16/16 编译通过。
 2026-11-01 08:52:54 +08:00
laoyang 0fd6021b03 新增特殊事项说明表 LaTeX 模板 #16 
把报销用的《中国海洋大学特殊事项说明表》Word 版复刻为 LaTeX 模板，
新增 特殊事项说明表/ 目录，与库内其余模板同一套约定。

三处关键设计：

1. 版心取「表格宽度」而非 docx 版心。原表 169.54mm 比 docx 版心宽
   13.54mm，靠 tblInd 负值顶出去；照搬 docx 版心必然 Overfull。
   改把 geometry 的版心直接设成表格宽度，零 Overfull 且位置逐点相同，
   代价是标题/备注需额外偏移补回 docx 版心的中心。

2. 行距不用 \baselineskip。本表行距逐行不同（10.5pt 与 12pt 混排），
   而 \baselineskip 只在同一段落内管行距 —— 每行 \par 自成一段后它
   根本没被读到（实测所有行距被压成 13.51，整表矮 2.25bp）。
   改成逐行插 \kern：基线距 = 上盒深度 + \kern + 本盒高度，
   与字体度量彻底解耦。

3. R0 改成「上下两半 + \vfil」，删掉原件那 8 个手写空段。
   描述写长写短都不再影响签名区位置，比原件更稳。

顺带记录六个实测踩出来的坑（块首行胶被丢弃、负 \kern 不能挡、
多行段 \ht 参照末行基线、\prevgen 必须在 \par 之后且在盒内取、
\vbox to N 的深度另计等），详见 sty 内注释与 README。

验证：
- xelatex 0 error / 0 Overfull / 0 Underfull / 1 页
- 与 Word 导出 PDF 逐项对齐：33 个文字元素 dY 全部 0.00bp，
  dX ≤ 0.04bp；四条横线与页码 0.00bp
- 像素差分 3.03%，全部落在字形轮廓上，无整体错位
- 全库 12 个模板回归通过，既有 11 个 PDF 零字节变化

与原件仅 3 处有意差异：字体换本库 OUC Serif（可分发）、
标题小标宋换真粗体（商业字体不可分发）、第 3 条备注编号统一对齐
（原件是手打漏配编号，偏 0.36bp）。
 2026-10-28 19:09:12 +08:00
laoyang 69da5b41a6 简历排版修正：项目经验整块右移、西文换 Cochineal、课程执行大纲漏网 × #12 
一、项目经验整块右移（简历/awesome-source-cv.cls）
  \rightcolumnlength 算早了：geometry 的 1.5cm 边距要到导言区结束才生效，
  cls 里那句 \setlength 读到 article 默认 \textwidth=345pt，算出 249.87pt，
  比应有的 417.02pt 少 167.15pt。longtable 把窄表居中排，整块右移 83.6pt。
  修法：计算挪进 \AtBeginDocument 并减去 | 竖线的 \arrayrulewidth；
  R 列由 >{\hfill}m{2.5cm} 改为 >{\raggedright\arraybackslash}p{2.5cm}。
  日期左边缘 145.1 -> 48.5pt，与其余章节严格对齐。
  这类错误零 error 零 warning，只能量 PDF 坐标才能发现。

二、西文换 Cochineal（fonts/cochineal/ + fonts.tex + 简历 cls）
  中文思源宋体配 Termes 时西文笔画偏细，中英混排会「陷进去」。
  Cochineal 宽 225.42pt vs Termes 229.68pt，只窄 1.9%，断行位置基本不动；
  Pagella/XCharter 宽 7~11%，会把全库断行推着变，故不选。
  字体 920KB 入 fonts/cochineal/（SIL OFL 1.1，附 OFL.txt），
  fonts.tex 新增 \oucUseCochineal 开关，只简历调用，其余 10 个模板不受影响。

三、换字体后暴露的真实缺陷
  西文窄 1.9% 让断点整体前移，ICIEA 那条论文冲出 88.49pt（文字顶到纸边）。
  根因是中文紧跟英文的位置不是断开点，整串被当长单词。
  加 \emergencystretch=3em 解决。

四、课程执行大纲漏网占位符（ouccourse.sty）
  ××学部××学院 硬编码在 \ccschool 里，#11 只扫了 .tex 没扫 .sty 所以漏了。
  拆成 \ccdepartment / \cccollege 两个名称宏，默认「信息科学与工程学部 /
  计算机科学与技术学院」。重编后全文 × 归零。

「代码库 PDF 没更新」经核实不成立：本地/远程 HEAD 均为 8984b93，
从服务器下载 8 个 PDF 逐字节比对全部一致，简历.pdf 3 页 0 个 ×。

验证：简历 3 页 0 error/0 Overfull/0 Underfull；全库 12 项编译回归与基线一致。
 2026-10-27 13:13:54 +08:00
laoyang 8984b93ee7 模板内容填充：全库 × 占位换成完整虚构示例，README 表述同步 #11 
把 11 个模板里满篇的 × 换成一套连贯的虚构数据，让样张能看出排版效果。

虚构设定（跨模板统一）：
- 数字逻辑 / 2025 秋 / 张远航 / 计算机科学与技术学院，教学日历、成绩构成
  说明、试卷归档封面、试卷四份互相对得上
- 简历：张远航，1985.03，教授博导，论文/专利/项目/获奖全套虚构
- 年度考核：同一人的 2025 年度考核表，年度总结四段写满
- 执行大纲：刻意不套用上面那套（原件就是《信号与线性系统分析》的课，
  强行改课程名会让章节体系、学时分配、思政案例全对不上）

假数据都留肉眼可辨标记：DOI 统一 10.9999/、专利号 ZL209999…、
软著 2024SR99999…、手机 138 0000 0000、邮箱 example.net。
签字/日期/评语栏仍然留空——编了就分不清该改哪儿。

修掉一个既有 bug（填充时才暴露）：
年度考核登记表「出生年月」的值从来不显示，连字符都不在 PDF 里。
根因是 tabularray 的 cell{r}{c}={c=n} 里那个 c 是数据行的单元序号、
不是视觉列号，表头三处 c=2 要求该行吃 15 个视觉列而表只有 11 列，
超出部分静默丢弃。迷惑点：写 12 格丢值，写 9 格反而正常。
正解是表头不写 cell{}，改用行内 \SetCell[c=n]{c}，每行照常写满 11 格。
同时 R0 行原件本就装不下（前六字段 115.76mm，剩 42.20mm 要放
19.68mm 标签 + 17.22mm 值，但列宽被切成 15.31/1.38/25.51），
把标签折两行「出生/年月」解决，列宽一个没改。

README 同步：根 README 与 8 个模板 README 里「一律用 × 占位」的说法
已不成立，统一改为「示例内容全部虚构」，并说明哪些位置仍必须留空。

验证：12 个模板零 error，4 处基线警告未新增；干净副本重编页数一致；
PDF 正文 × 清零；真实信息零泄漏。
 2026-10-27 12:50:02 +08:00
laoyang cc0dfb7257 新增个人简历模板（简历/），字体全部换成仓库自带的 #10 
从个人目录的中文简历迁移为第 11 个模板，三处字体重做：

1) 字体三层依赖全部拆掉
   - 删 zh_cn-adobefonts_external/internal.sty（Adobe 宋/黑/楷/仿，56 MB，
     商业授权不可分发），中文字体改由 ../fonts.tex 提供
   - awesome-source-cv.cls 的 localFont 分支（SourceSansPro 9 个 .otf）
     整段删除，西文改走 ../fonts.tex 的 TeX Gyre Termes
   - fontawesome.sty 原按字体名找系统 FontAwesome，改成显式
     Path=../fonts/fontawesome/，并把 FontAwesome.otf 收进仓库

   顺带修掉一个设计缺陷：原 adobefonts 里 BoldFont/ItalicFont/SmallCapsFont
   全部指向 Regular，等于加粗不变、斜体不变。现用字体自带的真粗体。

2) 占位化：真实姓名/手机/邮箱/住址/出生年月/论文题名与 DOI/专利号/
   软著号/33 条获奖全部改为 ××× / 20××；真人照 a.jpg/a.png 换成
   PIL 生成的 400×400 中性剪影 photo.jpg

3) 排版修正
   - 左栏宽度改为 \dimexpr\linewidth-\leftcolumn-4\tabcolsep\relax 自适应，
     修掉长表格 Overfull 4.48pt（原来没把 4 个 \tabcolsep 算进去）
   - 抬头两处 \vspace*{...}\\、\smallskip\\ 改为 \\[...]，
     修掉 Underfull \hbox (badness 10000)
   - \socialinfo 末尾多余的 \\ 去掉

fonts.tex 的改动（全库共享）：\textsc 用的 sc 档改用
\DeclareFontShape{TU}{OUCSerif(0)}{m}{sc}{<->ssub * OUCSerif(0)/m/n}{}
做形状替换，而不是 SmallCapsFont 选项 —— 后者与本文件 ItalicFeatures 的
跨目录 Path 互斥，任何写法都报 The font "OUCSerif-Regular" cannot be found.

回归：11 个模板全部零 error 编译通过；科技报告/试卷/课程执行大纲
文本与改动前逐字一致，4 个既有 boxwarn 为改动前基线，未新增。

编译：cd 简历 && xelatex 简历.tex 跑两遍，3 页，零 error/Underfull/Overfull。
嵌入字体仅 OUCSerif-{Regular,Bold}、TeXGyreTermes-{Regular,Bold}、FontAwesome。
 2026-10-27 11:17:24 +08:00
laoyang a29f193cff 新增成绩构成说明 LaTeX 模板（成绩构成说明/） #9 2026-10-27 09:15:58 +08:00
laoyang 25dc872062 新增课程教学日历 LaTeX 模板（课程教学日历/） #8 
把学校下发的通用空白表「附件3：中国海洋大学课程教学日历（理论课程）」
做成 XeLaTeX 模板，与 试卷归档封面/、试卷归档目录/ 同一套做法。

版式按原 .doc 逐项还原并实测标定：
- 表宽 174.625mm（tblW 9900 twips），tblInd 为负（−13.97mm），
  表格比版心更靠左，可见左边界 15.875mm
- 7 列宽度取 gridCol − 2×colsep − 线宽
- 边框 0.5pt（w:sz=4），内边距 1.905mm（108 twips）
- 字号 14 / 12 / 10.5bp 三档，全部用 bp（Word 的 pt 是 PostScript pt）
- 行高按「行数 × 23pt」显式给 ht（原件 w:line=460 exact）

实测校验（pymupdf 读两版 PDF）：
- 8 条竖线 x 偏差 ≤ 0.004mm
- 纵向锚点：附件号 / 标题 / 表格顶线 Δ = 0.00pt，其余 ≤ 0.03pt
- 行高 18 行中 17 行 Δ ≤ 0.4pt
- 字号 14.00 / 12.00 / 10.50 精确
- 零警告（无 Overfull / Underfull / 缺字）

真实数据零泄漏：原 .doc 是填过的实例，模板把所有字段换成占位符
（××××、000000000000、×、20××），已 grep 确认课程名、开课号、
教师姓名、年份、16 周日期与章节名均零命中。

README 记录五类坑：bp 单位、固定行距在 TeX 里不等于 baselineskip、
linespread 必须在 fontsize 之后、SetCell 的 c 列不折行、leftskip 与
geometry 叠加；以及原件五处不一致（第一周行距 15.6pt、周次列对齐
前后不同、表头折行数、表头不加粗、签字栏用空格顶位）。

注：本模板 3 页，原件 2 页 —— 因不复制第一周行距的疏漏，该行多 22pt。
 2026-10-27 08:37:28 +08:00
laoyang 8fa44b138c 新增试卷归档目录 LaTeX 模板 #7 
把「附件2：信息科学与工程学院归档目录（理论课）.doc」做成 LaTeX 模板，
落在 试卷归档目录/。版式逐项照原 .doc 还原，尺寸全部注明换算过程。

- oucgddir.sty：A4、表宽 150.81mm、13 行固定行高、单元格宏
- 试卷归档目录.tex：12 项核对清单
- README.md：用法 / 版式参数表 / 实测数据 / 踩坑记录
- 根 README.md、fonts.tex：模板清单加一项，「七个」改「八个」

与原稿实测对比（pymupdf 读 PDF）：
  表格竖线 x Δ ≤ 0.001mm，横线 y Δ ≤ 0.006mm
  32 行文字水平中心 Δ ≤ 0.11pt，字号 24/18/12/10.45 全部精确
  编译 1 页，零 Overfull / Underfull / 缺字

踩到并解决的五个坑：
  1. \fontsize 必须用 bp（TeX pt 比 PostScript pt 大 0.36%，24pt 实测 23.91）
  2. xeCJK 吞连续半角空格 → 标题字间用 \gdgap 手动 kern 24bp
  3. xeCJK 默认 PunctStyle=quanjiao 会挤压全角括号，使含括号的行整行
     右移 4.23pt → 必须 \xeCJKsetup{PunctStyle=plain}
  4. tabularray 把线宽算进列宽、ht 不含 hline 线宽、boxes 比 Σwd 多
     0.4945pt → 三处都要实测标定
  5. 单元格整体下移只有「尾部 \vspace*」有效，顶部 \vspace*/rule 会被
     首行 ascent 吃掉，\raisebox 被 m 居中抵销

字体：方正楷体_GB2312（商业，不可分发）→ OUC Kai（霞鹜文楷子集，OFL 1.1），
西文 Times New Roman → TeX Gyre Termes。字宽逐字相同（60.00 / 120.00pt 全等）。
 2026-10-27 07:51:10 +08:00
laoyang 8aa979739a 字体统一：建公共字体目录，全部改用开源可商用字体 (#6) 
七个模板原先分两套做法：幻灯片/fonts（49MB 鸿蒙 18 个字重）与
科技报告/font（92MB，含 5 款方正商业字体），其余模板直接调系统
SimSun/SimHei/KaiTi/FangSong/Times New Roman。换机器就编不出来，
方正系列也不允许随仓库分发。

统一到仓库根的 fonts/ + fonts.tex：
- OUC Serif（思源宋体 SC 子集）   —— 宋体
- OUC Sans（思源黑体 SC 子集）    —— 黑体
- OUC Kai（霞鹜文楷子集）          —— 楷体
- Zhuque Fangsong（朱雀仿宋）      —— 仿宋
- TeX Gyre Termes                  —— 西文 Times 等价（度量逐字相同）
- HarmonyOS Sans                   —— 幻灯片/科技报告原有字体

fonts.tex 是唯一允许声明字体的地方，7 个模板全部 \input 它。
字体体积 141MB -> 49MB（去掉重复），全库共用一套最小集合。

几处踩过的坑（均已写进源码注释）：
- \newCJKfontfamily 与 ctex 默认 fontset 冲突会中断编译，改用
  \setCJKfamilyfont + \def
- \newfontfamily 缺粗体档会让 \bfseries 静默失效，四档必须全给
- UprightFont= 与主参数不能同时给，否则文件名被拼两次
- Path= 相对编译时工作目录，不是相对 .sty
- ×/□/○ 等符号按 Unicode 区段被判成西文，需 \xeCJKDeclareCharClass
- 中文斜体的 ItalicFont 与主字体不在同一目录，须在 ItalicFeatures
  里单独写 Path/Extension（否则报 OUCKai-Regular cannot be found）

顺带：
- 科技报告 report.tex 的字体演示正文改为新字体名（原文写着方正系列）
- 试卷归档封面新模板并入本库
- 科技报告 shell 命令框底色改海大蓝（#5 遗留）

验证（7 个模板 8 个 PDF 全量重编 + 逐行 A/B 对照）：
- 错误 0，缺字 0
- 幻灯片 362 行逐行完全一致，零漂移
- 年度考核登记表 / 劳务发放说明表 / 试卷题型示例 / 参考答案 文本完全一致
- 课程执行大纲 仅 2 处断字连字符差异（throughout、processing），
  1 条 6.39pt Overfull 已论证不可见（距纸张右边缘仍有 20.7mm）
- 科技报告 内嵌字体方正归零，只剩 OUC Serif/Sans/Kai + Zhuque
- 全库正文 857 个非 ASCII 字符，四款中文字体（含粗体）覆盖 100%
 2026-10-27 00:43:14 +08:00
laoyang 1f807e9cce 所有模板目录改为中文名，并入幻灯片与科技报告两个仓库（#3） 
目录改名（git mv 保留历史，包名不变）：
  exam/   -> 试卷/
  form/   -> 年度考核登记表/
  form2/  -> 劳务发放说明表/
  course/ -> 课程执行大纲/

改名即可编译：实测 6 个模板在含中文的目录下 XeLaTeX 均零报错，
PDF 逐页文本与改名前的版本完全一致（0 页差异，仅元数据时间戳变化）。

并入两个此前独立维护的仓库：
  ouc-slide-latex-template  -> 幻灯片/
  ouc-report-latex-template -> 科技报告/
带入了 theme/ fonts/ logos/ figs/ cls/ input/ 与 fontawesome.pdf，
字体随模板附带（无须在系统安装）。中间文件一律不入库。

同步修正的文档：根 README 目录表改为中文名并说明统一维护；
四个子 README 的标题；ouclw.sty 注释里对 form/ 的交叉引用；
幻灯片与科技报告 README 里「从旧仓库 clone」「按年份切分支」等已失效的说明
（并入后只有 main 一个分支，各年份 TeX Live 通用）。

两个迁入模板的 PDF 保留源仓库原版（逐字节一致），未重新编译：
源 PDF 出自 TeX Live 2026，本机为 2022，重新编译会让结尾页装饰层定位
产生细微偏移，保留原版以保证样张与原来完全一致。
 2026-10-26 18:31:04 +08:00
laoyang d353aaa324 新增课程教学执行大纲 LaTeX 模板 course/（#2） 
把学校下发的《本科课程教学执行大纲》Word 模板复刻为 XeLaTeX，
内容全部虚构（课程名、代码、开课号、教师、教材、思政案例）。

- ouccourse.sty：版式宏包，尺寸全部从 OOXML 量出
  · 页面：左 27.52 / 右 22.93 / 上 25.05 / 下 4.94 mm（照抄原文件的不对称与极小下边距）
  · 表 0：156.93mm，5 行 × 8.01mm，两列 131.921/25.012mm
  · 表 1：165.54mm（超版心 5.91mm，居中溢出），6 列逐列对齐 gridCol
- 课程执行大纲.tex：虚构课程「信号与系统基础」完整示例，5 页
- README.md：用法、参数表、twips→mm 对照、字体降级、六个坑、校验方法
- 根 README.md 目录表补 course/ 一行

关键技术点（README 有详述）：
- 表宽 > 版心时不能按比例缩列宽（会让长文字提前折行），要用 \leftskip 整块左移；
  \hspace* 对 longtblr 的 \halign 盒子无效
- tabularray 的 wd= 是内容宽，不含竖线自身 0.5pt；ht= 含横线预算
- presep/headsep 是 outer 键，误写进 inner spec 会把 "0pt" 印成垃圾文字且不报错
- 表级默认字号须写 cells={font=...}，单独写 font= 被静默忽略
- longtblr 跨页提示要清两组模板；*-text 不能设 empty（会报 LaTeX3 变量错误）
- ctex 默认 \linespread≈1.3 会覆盖 \fontsize 的行距

验收：26/26 项量化达标，编译零错误零 Overfull/Underfull，5 页
 2026-10-26 17:43:50 +08:00
laoyang e032aec228 新增劳务发放说明表 LaTeX 模板（form2/）#1 
把实验室《劳务发放说明表》docx 复刻为 XeLaTeX 模板，与 exam/、form/ 同一套做法：
自包含子目录、版式逐项对齐原 docx、模板不含真人信息。

- form2/ouclw.sty      版式包：A4 + left=31.70mm + 表宽 150.32mm，
                       4 列 / 5 行、14pt 宋体、15.6pt 行距、0.5pt 边框、
                       1.905mm 单元格内边距，全部尺寸附 twips→mm 换算注释
- form2/劳务发放说明表.tex  主文件，填表只改 4 个变量
- form2/README.md      用法、换算表、四个坑、量化校验方法与实测数据
- README.md            目录表登记 form2/

文字改写：原文「聘请秦依康等2位研究生参与《观测数据驱动的渤海生态系统健康
评估关键技术研发》项目的研究工作。」改为「聘请xxx等x位研究生参与《xxx》
项目的研究工作。」，句式未动；其余内容一律 × 占位。

量化验收（pdftocairo -svg + pdftotext -bbox）：
  表宽 150.137mm（目标 150.319，差 -0.18）
  表左  31.662mm（目标  31.700，差 -0.04）
  R0 11.172 / R1 5.668 / R2 49.646 / R3 22.159 / R4 11.172 mm 全部达标
  三个签字格标签基线、日期行基线完全重合
  编译零错误、零 Overfull / Underfull，输出 1 页

本次踩到并记录在 README 的四个坑：
1. ctex 默认 \linespread≈1.3 会把 \fontsize{14}{15.6} 放大成 20.28pt
2. 合并格 {c} 是 LR 模式，不折行而是撑宽整表；\hsize 也未重设
3. 合并格内容可用宽要补回 2*colsep*(n-1)，否则长文本提前折行
4. \parbox[t] 与 tabularray 的 strut 叠加会每行多出 3.6pt
 2026-10-26 16:18:58 +08:00
laoyang 565ec7c505 add form: 教职工年度考核登记表 LaTeX 模板 
按学校下发的 Word 表逐项复刻，尺寸全部从 docx 的 OOXML 数值换算
（twips→mm/pt），不含真人信息。

- form/ouckhtb.sty          版式包：页面/字体/11 列宽/9 行高/表格环境
- form/年度考核登记表.tex   主文件：占位数据 + 表格 + 年度总结
- form/README.md            用法、版式数据来源、四个排版坑、校验方法

关键排版结论（sty 内均有注释）：
- 合并格 cell{r}{c}={c=n}{c} 的 {c} 是不折行的 LR 模式，文字超宽会
  把列撑宽、整表超出版心（实测 448pt→559pt），故合并格一律包
  \khtbfit{跨度宽}{文字}
- 合并格里 \hsize 未被重设，长文本须用定宽 \parbox
- 跨度声明只有 {c=n}{c} 一种写法
- colspec/row{} 不能放宏（Unexpandable command）
- longtblr 须 stretch=0，且要清空四个 caption 模板去掉「表 0」

校验：零 Overfull/Underfull，2 页，表宽 157.96mm（目标 158.33mm）。
 2026-10-23 12:01:32 +08:00
laoyang 47158f2add add exam: 试卷与参考答案及评分标准模板 
- exam/oucexam.sty    试卷版式包（195x270mm 专用试卷纸）
- exam/ouckey.sty     答案与评分标准版式包（默认 A4，可选 exampaper）
- exam/试卷题型示例.tex        16 类题型，6 页
- exam/参考答案与评分标准示例.tex  8 大题 / 满分 100，3 页
- exam/README.md      用法与书写注意事项
- .gitignore          忽略 LaTeX 编译中间文件
 2026-10-22 16:27:54 +08:00
laoyang c70c063915 Initial commit 2026-10-22 08:15:07 +00:00