# 第 1 章 引论 · 逐页还原版（网页）

本目录是**按源课件逐页转写**的网页版，用来替代此前"重编成 40 页"的版本。

## 与旧版（40 页）的区别

| 项目 | 旧版（重编版） | 本版（逐页还原） |
|---|---|---|
| 页数 | 40 页（合并/删减了源页） | **61 页＝源课件页数** |
| 图片 | 只用了 5 张已核实的截图 | **35 个去重媒体文件全部导出**（源文件 41 个图片位、46 个媒体文件，重复的按内容去重） |
| 矢量图形 | 线条/自选图形/组合丢失 | 保留（由原页高清图承载，100% 不走形） |
| 文字 | 重新撰写的教学文案 | **源页文字全部保留**（173 个文字块），可选中、可复制、可搜索 |
| 演讲者备注 | 未保留 | 有备注的页（9 页）在侧栏展示 |

## 每页包含什么

- **原页高清图**（150 DPI 渲染，10×5.62 英寸 16:9）；
- **真实文字层**：按源页文字框位置绝对定位，三种显示模式随时切换 ——
  `原页`（看原貌）/ `叠字`（文字层叠在原页上，核对图文一致）/ `纯文字`（隐藏底图，纯文本阅读）；
- **侧栏**：本页文字稿（分段列表）、本页素材（缩略图，点击下载原图）、演讲者备注；
- **导航**：方向键 ← → 翻页、滚轮翻页、Home 回目录，页码显示"第 N / 61 页"。

## 目录页（index.html）

- 61 页缩略图网格；
- **全页文字搜索**：输入关键词（如"缺陷""等价类""TDD"）即时过滤页码，用来快速定位知识点。

## 生成方式（可复现/可扩展到其他章节）

```bash
cd 25-软件测试方法和技术第4版OCR整理
# 1) 源码页渲染成图片（61 页）
soffice --headless --convert-to pdf --outdir _conv_work 课件PPT-加校徽/Ch1-引论-STMT-2022.pptx
pdftoppm -r 150 -png _conv_work/Ch1-引论-STMT-2022.pdf _conv_work/assets/page/slide
# 2) 抽取每页文字（含位置）与全部媒体
python _conv_work/_extract.py 课件PPT-加校徽/Ch1-引论-STMT-2022.pptx _conv_work
# 3) 生成网页
python _conv_work/_build_faithful.py _conv_work \
  "课件成品-HTML-逐页还原/软件测试课程设计-Ch1-逐页版" 软件测试课程设计 "第 1 章 引论（逐页还原版）"
```

## 校验结果

- 页数：源 61 ｜ 生成 61；
- 文字块：源 173 ｜ 网页 173（无遗漏）；
- 媒体：35 个去重文件全部导出并被页面引用；网页内 **204 条资源引用，文件缺失 0 条**；
- 位置校验：把同一份位置数据画成叠加框与原页比对，识图确认文字框对准原页文字、无明显错位。

## 说明

- 源文件用的是 `课件PPT-加校徽/Ch1-引论-STMT-2022.pptx`（已含本校校徽、署名已改为"广东金融学院 周宇文"、版权行已删）。
- 旧版（40 页重编版）与 PPT 初版已备份到 `课件成品-HTML/_备份-40页版-20260915-2055/`，未删除、未覆盖。
- 本次**未部署到云服务器**，仅在本地（下载中心为局域网服务）。

---

## 换图方式（2026-09-15 第三版：裁切填满）

换图**只动图片，不改 PPT 任何颜色值**（可用 `unzip -p` 逐文件对比验证：颜色 XML 差异 0）。

**新图合成改为 cover 裁切**（先前那版是"横幅 + 底部模糊延伸"，会出现一段模糊色块，已废弃）：

- 源图：`www.gduf.edu.cn/images/47.jpg`（1920×500，站点最大尺寸，46.jpg 同尺寸、54321.jpg 是标语横幅不可用）；
- 做法：**等比放大 2.00×** → 按目标比例**横向裁切**填满 → 补一次反锐化掩模（radius 2 / 80%）；
  - `image20.jpg`：目标 2130×1000（页面 10.0×4.7 in），裁切窗口中心取源图宽度 56%（主体建筑偏右）；
  - `image1.jpg`：目标 1780×1000（页面 10.0×5.62 in），中心取 53%。
- 调色仍按原照片实测指标对齐，使新图融入蓝色主调：
  - `image20`：饱和 0.28、明度 0.65、色相 164°（原图 0.25 / 0.73 / 152°）；
  - `image1`：饱和 0.34、明度 0.58、色相 182°（原图 0.29 / 0.58 / 93°）。