laoyang
a4bfcac82a
源：D:\Yongquan\code\sre =《软件需求工程导论》完整教材
（13 章 + 5 附录，78 万字节，265 页 PDF，elegantbook 文档类）
## 新增文件
教材/ouctextbook.sty 版式配置
教材/elegantbook.cls 本地化过的文档类（改过字体）
教材/教材.tex 示例正文（1 章 + 附录 + 参考文献）
教材/reference.bib 参考文献库（虚构条目）
教材/README.md 用法 + 踩坑记录
## 核心约束：字体的共用性
用户明确要求「注意字体的共用性」。原教材用 elegantbook 的
chinesefont=founder 档，加载方正四大字体：
FZShuSong-Z01 / FZHei-B01 / FZKai-Z03 / FZFangSong-Z02
这些是**商业字体，不能随仓库分发**（#17 定下的规矩）。
### elegantbook 三档字体全都不通用
| 选项 | 实际字体 | 问题 |
|---|---|---|
| founder（默认） | 方正四大字体 | 商业字体，换机器就废 |
| ctexfont | 系统字体（Win=SimSun，macOS=PingFang） | 三平台三种样子 |
| nofont | 不设 | 不配置就报错 |
### 只写 nofont 还不够 —— cls 自身还硬编码字体
elegantbook.cls 第 176/184 行：
\setmainfont{TeXGyreTermesX}[...]
\setsansfont{texgyreheros}[...]
这两款在精简 TeX Live 上都没有，报 9 个错误连发：
! Package fontspec Error: The font "texgyreheros-regular" cannot be found
**实测：在 \documentclass 之后用 \setsansfont 覆盖无效** ——
类加载时字体族已注册失败，后面重新指定救不回来。
⇒ 所以本模板必须带一份**本地化的 cls**，改三处（都留了"本地化"注释）：
| 位置 | 改动 |
|---|---|
| ~176 行 | TeXGyreTermesX → texgyretermes + Path=../fonts/tex-gyre-termes/ |
| ~184 行 | texgyreheros → OUCSans + Path=../fonts/ouc-sans/ |
| \maketitle | example-image → \ouc@coverblank |
这是本模板与仓库其他模板的**唯一结构性差异**：别的模板只要
\input{../fonts.tex}，本模板还要那份改过字体的 cls。
## 踩到的三个坑
### 1. 封面不写 \cover{} 会插一张 "Image" 占位图
cls 第 1288~1300 行：
\ifcsname @cover\endcsname ... \else
\includegraphics[width=\linewidth]{example-image} ← mwe 的灰底占位图
首页顶着 "Image" 两个大字。已把 else 分支换成空盒子。
### 2. 占位盒宽度不能是 0（这个坑耗了最久）
第一版 \rule{0pt}{0pt}（0 宽），立刻冒出：
Overfull \hbox (5.00002pt too wide) in paragraph at lines 44--44
试过全部无效，溢出量死钉在 5.00002pt 不动：
改 \hspace{2em} / \hspace{2.5em} 无效
改 minipage 的 0.67/0.27\linewidth 无效
改 tabular 列间距 @{}l@{} 无效
改 \colorbox 的 \makebox[\hsize] 无效
根因：0 宽空盒让 \linewidth 在 titlepage 里与 \textwidth 差 5pt，
后续并排的 \parbox{0.8\textwidth} + 两个 minipage 整体超宽。
✅ 正解：给占位盒满宽
\newcommand{\ouc@coverblank}{%
\rule{0pt}{0pt}\hspace{\linewidth}\rule{0pt}{0pt}}
实测 0 Overfull。
### 3. 封面色带改不动（一行 \colorlet 的位置问题）
cls 第 345 行 `\colorlet{coverlinecolor}{second}` 在**类加载末尾**执行，
把 coverlinecolor 绑到 second 色（black 模式下就是黑）。
⇒ 导言区写 \colorlet 会被覆盖，实测色带仍是纯黑。
必须用 \AtBeginDocument 排到它后面。
## build.sh 补了 bibtex 支持
原来只跑两遍 xelatex，教材的参考文献出不来。
新增：目录下有 .bib（排除 *-blx.bib 这种中间产物）就插一次 bibtex，
再补一遍 xelatex，最后跑统计那一遍。
## 验证
8 页 error 0 Overfull 0 Underfull 0
封面色带 RGB(32,178,170) 青绿，实测 fill=(0.125,0.698,0.667)
封面无 example-image 占位
字体（PDF 内嵌实测，全部来自仓库）：
OUCSerif-Regular / -Bold 中文正文
OUCKai-Regular 中文斜体（楷体代）
TeXGyreTermes-Regular/-Bold/-Italic 西文
LMMono10-Regular \texttt 等宽（TeX Live 自带）
→ **无方正、无 SimSun/SimHei、无 Times New Roman**
全库 16/16 通过（新增第 16 项，已加入 verify_all.sh）。
⚠️ Windows 端本机未能编译：TeX Live 写字体缓存
（C:\texlive\2022\texmf-var）被安全策略拦截，属环境限制非模板问题。
模板只依赖 TeX Live 标准宏包与发行版自带字体；原教材本身就是在
Windows + TeX Live 2022 上编出来的。
## .gitignore 补充
新增 *-blx.bib、*.run.xml（biblatex 中间产物）、*/.preview/（预览图）。
## 与原教材的差异
| 项 | 原教材 | 本模板 | 原因 |
|---|---|---|---|
| 封面图 | cover.jpg | 无（纯色带） | 模板不附图片 |
| 字体 | 方正四大字体 | 仓库开源字体 | 商业字体不能分发 |
| 西文无衬线 | texgyreheros | OUC Sans | 仓库没有 Hero |
| 正文 | 13 章 265 页 | 1 章示例 | 只抽骨架 |
83 lines
3.2 KiB
Bash
Executable File
83 lines
3.2 KiB
Bash
Executable File
#!/usr/bin/env bash
|
||
# 批量编译验证仓库内全部模板，打印每个的 error / Overfull / Underfull / 页数
|
||
#
|
||
# 用法：
|
||
# bash verify_all.sh # 全部
|
||
# bash verify_all.sh 试卷 # 只跑指定目录（按目录名精确匹配）
|
||
#
|
||
# 设计说明：
|
||
# · 每个模板都在**自己的目录**里编译。模板的 .sty 与 ../fonts/ 都是相对
|
||
# 编译时工作目录解析的，从仓库根调用会找不到字体。
|
||
# · 只排除 error，不排除 Overfull/Underfull —— 这两类是排版质量的早期信号，
|
||
# 要看得见。已知的几处属既有问题（试卷/、课程执行大纲/ 各 1 处 Overfull，
|
||
# 幻灯片/、科技报告/ 各 1 处 Underfull），不是回归。
|
||
# · 主文件不像「目录名.tex」的，在 TARGETS 里显式登记（幻灯片/slides.tex、
|
||
# 科技报告/report.tex、试卷/ 的两个示例）。
|
||
# · 简历/ 目录下还有 fontawesomesymbols-*.tex 等宏包片段，不是文档，
|
||
# 不能拿 ls 的第一个 .tex 当主文件，否则报 Emergency stop。
|
||
set -u
|
||
|
||
ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
|
||
cd "$ROOT" || exit 1
|
||
TEXBIN="${TEXBIN:-xelatex}"
|
||
|
||
TARGETS=(
|
||
"劳务发放说明表|劳务发放说明表.tex"
|
||
"年度考核登记表|年度考核登记表.tex"
|
||
"幻灯片|slides.tex"
|
||
"成绩构成说明|成绩构成说明.tex"
|
||
"特殊事项说明表|特殊事项说明表.tex"
|
||
"科技报告|report.tex"
|
||
"简历|简历.tex"
|
||
"试卷|试卷题型示例.tex"
|
||
"试卷|参考答案与评分标准示例.tex"
|
||
"试卷归档封面|试卷归档封面.tex"
|
||
"试卷归档目录|试卷归档目录.tex"
|
||
"课程执行大纲|课程执行大纲.tex"
|
||
"课程教学日历|课程教学日历.tex"
|
||
"课程大纲|课程大纲.tex"
|
||
"会议预算表|会议预算表.tex"
|
||
"教材|教材.tex"
|
||
)
|
||
|
||
filter="${1:-}"
|
||
total=0; ok=0; fail=0
|
||
failed_list=""
|
||
|
||
for entry in "${TARGETS[@]}"; do
|
||
dir="${entry%%|*}"; tex="${entry##*|}"
|
||
if [ -n "$filter" ] && [ "$dir" != "$filter" ]; then continue; fi
|
||
total=$((total+1))
|
||
printf "=== [%d] %s/%s ===\n" "$total" "$dir" "$tex"
|
||
|
||
log="$(mktemp)"
|
||
( cd "$dir" && "$TEXBIN" -interaction=nonstopmode -halt-on-error "$tex" > "$log" 2>&1 )
|
||
rc=$?
|
||
|
||
# grep -c 无匹配时已经输出 0（退出码 1），不能再 `|| echo 0`，
|
||
# 否则变量会变成 "0\n0"，后面的整数比较直接报 integer expected。
|
||
err=$(grep -c "^!" "$log" 2>/dev/null || :)
|
||
over=$(grep -c "Overfull" "$log" 2>/dev/null || :)
|
||
under=$(grep -c "Underfull" "$log" 2>/dev/null || :)
|
||
pages=$(grep -oE "Output written on .*\([0-9]+ page" "$log" 2>/dev/null \
|
||
| tail -1 | grep -oE "\([0-9]+" | tr -d "(")
|
||
|
||
printf " rc=%s err=%s Overfull=%s Underfull=%s pages=%s\n" \
|
||
"$rc" "${err:-0}" "${over:-0}" "${under:-0}" "${pages:-?}"
|
||
|
||
if [ "$rc" -eq 0 ] && [ "${err:-1}" -eq 0 ] && [ -n "${pages:-}" ]; then
|
||
ok=$((ok+1))
|
||
else
|
||
fail=$((fail+1))
|
||
failed_list="${failed_list}
|
||
- $dir/$tex"
|
||
grep -A2 "^!" "$log" 2>/dev/null | head -9 | sed "s/^/ /"
|
||
fi
|
||
rm -f "$log"
|
||
done
|
||
|
||
echo
|
||
echo "================ 汇总 ================"
|
||
echo "总数 $total | 通过 $ok | 失败 $fail"
|
||
[ -n "$failed_list" ] && printf "%s\n" "$failed_list"
|
||
exit 0 |