zepan
|
0724332cf8
|
chore(assets): deduplicate same-product images across doc trees
同一产品的素材散在多个文档树里各存一份（hardware/assets、
hardware/{zh,en}/<产品>、soft/<产品> 等），260 组、399 个副本，49MB。
判别「同产品」用两个条件，缺一不可：
1. 文件名完全相同 —— 文件名不同说明是两个产品碰巧用了同一张图
（cleam.png 与 clean_core_board.png），不是刻意复制
2. 路径里不含同一产品族的两个不同型号
第 2 条拦下了 100 组：lpi3a/lpi4a、lpi3h/lpi4a、tang-nano/-1k/-4k、
tang-primer-20k/25k、tang-mega-138k/60k、spmod_eink/spmod_rfid。
这些合并会制造耦合——更新一个产品的图会让另一个产品的文档悄悄跟着变。
规范副本优先级：hardware/assets 共享区 > zh > 路径较短者。
引用改写基于解析后的目标文件，128 个 md 共 381 处，增删一一对应。
验证：断链 5 -> 5（新增 0），构建通过，抽查页面图片全部可取到。
|
2026-10-07 21:32:47 +08:00 |
|
zepan
|
3cb995f851
|
chore(assets): deduplicate zh/en mirrored images
早期文档的素材基本是中英共用一套，却在 docs/.../zh/ 和 docs/.../en/
各存了一份完全相同的文件。251 组镜像副本，白占 39.5MB。
只处理「路径仅差语言段」的镜像组：保留 zh 作为规范副本，删除 en 副本，
把 en 页面的引用改向 zh（32U3 已经是这个约定）。引用改写基于解析后的
目标文件而非字符串匹配，共 39 个页面 214 处；文件读写保留原始行尾。
跨产品的重复没有动——tang-primer-20k 与 25k、lc3a 与 lc4a 虽然碰巧
共用同一张图，但文件名本就不同，合并会制造耦合：以后更新一个产品的
图会让另一个产品的文档悄悄跟着变。为省空间绑定两条独立产品线不划算。
验证：断链 5 -> 5（新增 0），构建通过，抽查英文页图片全部可取到。
|
2026-10-07 21:27:07 +08:00 |
|
zepan
|
73defb366b
|
fix(docs): update image references and repair broken paths
两部分改动：
1. 跟随上一个提交的格式变更，改写引用（PNG→JPG、GIF→WebP），
共 408 处。注意站点绝对路径（/hardware/zh/...）需按 site_config
的 route 映射解析，不能当成仓库相对路径。
2. 修复 108 处本来就断掉的图片引用——文件还在仓库里，但素材目录
搬家/改名后引用没跟着改。只在候选唯一且与页面处于同一产品线时
自动改写；多候选的 75 处与文件确实缺失的 83 处保留，记入
tools/known_broken_images.txt 待人工处理。
以 HEAD 为基线用同一检查器核对：断链 230 → 121，新引入 0 处。
|
2026-10-07 01:01:21 +08:00 |
|
junhuanchen
|
e75d983e11
|
[release]
|
2022-07-06 11:24:18 +08:00 |
|