 laoyang
|
6819d78f29
|
工作流全部迁到 WSL：新增 WORKFLOW.md，build.sh 改为 WSL 原生 #21
用户要求「全部在 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（重写）
|
2026-10-29 21:50:34 +08:00 |
|