81 Commits

Author SHA1 Message Date
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
14df4354c3 fix(docs): repair misspelled image filenames
目录没问题,是文件名本身拼错了:

  enviroument.png -> environment.png   (作者把自己文章名都拼错了)
  succeed_login.png -> susseed_login.png (这次反过来,是文件名拼错,
                                          引用是对的)

判定:引用指向的目录必须存在,在该目录内按编辑距离找同扩展名的近似
文件名,且最优解必须严格优于次优解。

护栏:纯数字或短于 4 字符的文件名不参与近似匹配——实测有一例
1.jpg 被匹配到 WE1.jpg,编辑距离在短名上毫无区分力。

断链 52 -> 50。
2026-10-07 21:09:50 +08:00
zepan
e137cf58a5 chore(assets): convert remaining GIFs to WebP and re-encode bloated MP4s
动图 52 个按内容分流重编(51.2MB -> 27.4MB):
  录屏/合成图形 -> WebP 无损(有损 DCT 会把文字编得又大又糊,
                实测同一文件无损 -58%、有损 q45 反而 +93%)
  实物影像     -> WebP 有损 q35
  需要缩放的用最近邻而非 lanczos:插值做抗锯齿会让同一字形在不同
  位置变成不同像素图案,LZ77 的重复匹配全部失效(同尺寸差 3.5 倍)

MP4 9 个按等效 1080p 码率重编(21.7MB -> 7.9MB):
  M2A-1 折合 1080p 高达 39.6Mbps(338x450 用了近 3Mbps),-98%
  其余按等效 1080p 1Mbps;combo8 的 156 秒录屏按等效 500k,-62%
  传感器对比、微光星空、已极省的 120fps 录屏保持原样

媒体总量 572MB -> 534MB。断链检查 0 新增。
2026-10-07 20:18:51 +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
Rosemary_HSN
5058f0cb1f 修改其他文档内引用链接:从Tang-Nano-Doc 改为 common-doc 2025-02-18 22:44:01 +08:00
Neucrack
4675cd6392 add ad for maixcam 2024-04-20 16:40:30 +08:00
Neucrack
3772e18bad update maixpy ci 2024-03-07 17:48:35 +08:00
wonderfullook
7d23e86c58 modify docs 2023-07-26 17:06:36 +08:00
wonderfullook
ad549ff569 Update v831_usage.md 2023-07-06 15:24:17 +08:00
wonderfullook
93e3f45a25 Update v831_usage.md 2023-06-27 12:01:53 +08:00
wonderfullook
5a44b9fcc2 fix error 2023-06-25 11:22:00 +08:00
wonderfullook
960bd109f9 update 2023-06-15 18:50:27 +08:00
lyx080
6259bc133a update sensor.md 2023-06-13 17:07:58 +08:00
lyx080
736d042b60 update 2023-06-12 17:15:41 +08:00
lyx080
8e0ccc5fd4 update v831_usage.md 2023-06-08 18:35:21 +08:00
lyx080
1ab49e732a update v831_usage.md 2023-06-02 15:45:40 +08:00
lyx080
3411b45ede update 2023-06-01 18:54:55 +08:00
lyx080
0c286af866 update v831 lens_corr.md 2023-05-08 19:00:57 +08:00
Juwan
1bd7aa37a1 Update maixII_connect_udisk.md 2023-03-31 11:33:39 +08:00
wonderfullook
7bcc798110 Update v831_opencv.md 2023-03-24 14:38:13 +08:00
wonderfullook
d7e4d9b966 fix error 2023-03-21 11:08:26 +08:00
wonderfullook
f14092be31 update m2dock opencv document 2023-03-20 18:37:52 +08:00
wonderfullook
ee218795df remove some files 2023-03-14 10:13:39 +08:00
lyx080
e9b65f8d67 update 2023-03-13 18:56:50 +08:00
lyx080
bfaef5b3c2 update 2023-03-07 18:49:37 +08:00
Juwan
91f76dadc0 Update linux_adb.md 2023-02-22 22:14:19 +08:00
wonderfullook
8c799ceb30 update 2023-02-22 09:30:24 +08:00
lyx080
28927aafb8 update 2023-02-20 18:58:04 +08:00
lyx080
1aa131f70c update 2023-02-14 11:11:34 +08:00
wonderfullook
a6f7ab4e5f update 2023-02-06 19:14:13 +08:00
lyx080
7d80e8eb3f update 2023-02-06 17:19:47 +08:00
lyx080
dfb32725a5 update 2023-02-04 18:21:21 +08:00
lyx080
28792d03af update 2023-02-01 18:56:51 +08:00
lyx080
1299d09373 update 2023-01-31 18:51:55 +08:00
junhuanchen
ad0264a379 2023-01-18 18:24:34 +08:00
lyx080
2e5fe4560b update 2023-01-14 18:30:08 +08:00
lyx080
db391b9005 update 2023-01-13 18:53:06 +08:00
lyx080
98212cb09c update 2023-01-09 19:30:08 +08:00
lyx080
ef39a62bce update 2023-01-07 18:45:21 +08:00
lyx080
53916c361f update 2022-12-30 10:42:04 +08:00
wonderfullook
39b0c9ba38 fix error 2022-12-29 18:38:00 +08:00
wonderfullook
32db67a883 update 2022-12-28 19:30:32 +08:00
wonderfullook
561d6255ef fix error 2022-12-15 16:06:12 +08:00
wonderfullook
79fae2b35b update news 2022-12-06 19:09:18 +08:00
lyx080
549632334e update 2022-11-22 19:14:32 +08:00
林栎心
4d9c0c2b4c Update 2022-10-30 23:48:25 +08:00
wonderfullook
7e4a822de1 update 2022-10-24 18:47:54 +08:00
wonderfullook
cf28cbd7da add unfinished docs 2022-10-23 21:22:32 +08:00
lyx080
14e114a211 补充 2022-10-21 18:56:42 +08:00
Juwan
4e4a308732 Update mind_application.md 2022-10-20 16:48:56 +08:00