laoyang
6819d78f29
用户要求「全部在 wsl 完成」，原因是 Windows 上工作太多太乱， WSL 像虚拟环境、坏了能重置、不影响系统。 ## 之前为什么乱 分工是「Windows 改代码 + 两端都编」：Windows 侧一份仓库副本装满了 .aux/.log/.toc/.pdf，WSL 侧另一份，靠 scp/git pull 同步维持。 同一项目两份工作副本，漏同步就分叉。 ## 实测确认的技术前提 1. **UNC 路径双向读写** —— `\\wsl$\Ubuntu-26.04\home\yongquan\...` Read/Write/Edit 三个工具都能直接作用于该路径，读写均落到 WSL 磁盘。 延迟 6~63ms。⇒ 不需要「本地编辑 → scp」这套中间环节。 ⚠️ 发行版名是 Ubuntu-26.04，不是常见的 Ubuntu 或 Ubuntu-22.04。 2. **WSL 内 TeX 可完整编译全库** —— `bash build.sh all` 13/13 通过。 3. **WSL 内 git 可推送** —— credential.helper=store 已指向含 token 的 ~/.git-credentials，fetch 实测通过。 4. **gi.py 可迁** —— 纯标准库，无第三方依赖，复制即用。 5. **Python 依赖** —— 建 ~/.venv-latex，装 pymupdf 2.0 + fonttools 4.68.0， 不污染系统 Python。 ## 本 commit 的改动 ### 新增 WORKFLOW.md 写清：为什么在 WSL、目录位置（含 UNC 路径）、日常命令、编辑方式、 PDF 不进版本库的原因、已知排版告警清单、环境重建步骤。 ### build.sh 重写为 WSL 原生 原版是「Windows 通过 ssh 远程调 WSL 编译再 scp 取回」，在 WSL 内跑没意义。 新版改动： - 去掉全部 ssh/scp，直接本地编译 - 两遍编译（目录/页码/LastPage 跨引用第二遍才稳定） - 自动 cd 到模板目录（.sty 的 ../fonts/ 相对编译目录解析） - 目录→主文件映射保留：幻灯片/slides、科技报告/report、 试卷有两个主文件必须显式指定、简历不能拿 ls 第一个 .tex - `all` 转给 verify_all.sh（那边有完整 TARGETS 清单） - 新增 SILENT=1 输出紧凑表格，便于脚本消费 - 单目录模式找不到时列出可选目录/主文件，不用去翻源码 ### WSL 侧环境（不入库，属个人配置） - ~/.config/ouc-latex/env.sh 固定 OUC_PY / GI / WB_GITEA_CONFIG / OUC_REPO， 提供 gi / ouccd / texbuild 别名 - ~/.bashrc 末尾 source - ~/.local/bin/gi.py + ~/.config/ouc-latex/gitea.json（chmod 600） ## 验证 WSL 内全库编译： 总数 13 | 通过 13 | 失败 0 逐项：劳务发放说明表 1 / 年度考核登记表 2 / 幻灯片 30(UF1) / 成绩构成说明 1 / 特殊事项说明表 1 / 科技报告 10(UF4) / 简历 3 / 试卷题型示例 6 / 参考答案 3 / 试卷归档封面 1 / 试卷归档目录 1 / 课程执行大纲 5(OF1) / 课程教学日历 2 页数与 Windows 侧历史记录逐个一致。3 处告警均为既有问题，非回归。 WSL 内工单工具：`gi whoami` → token 有效、仓库识别为 ouc_latex_template。 本工单 #21 即由 WSL 内的 gi 创建，工具链已实证可用。 ## Windows 侧 备份 D:\Yongquan\backup\ouc_latex_template-win-backup-20261029.tar.gz （49MB / 244 项 / 不含 .git）。删除前确认两端 HEAD 同为 fb7c76b、 无未推送提交、无 stash。备份保留，不删。 涉及文件：WORKFLOW.md（新增）、build.sh（重写）
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 起并入本仓库统一维护，两个旧仓库不再更新。迁入时保留了原有目录结构、字体与图片资源，旧仓库的提交历史留在原仓库中。