fix(docs): resolve cross-tree and case-only ambiguities; ignore commented-out refs

- Lichee-RV 文档在 docs/soft/Lichee/zh/,素材却在 docs/hardware/zh/lichee/
  assets/RV/,中英各存一份。按页面语言消歧(两份 md5 相同),2 处
- BiT.png / Bit.png 仅大小写不同、内容相同,取与引用大小写一致的那份。
  注意它写在 <img src> 里而非 markdown ![](),替换要覆盖两种写法
- 检查器补剥离 HTML 注释:被 <!-- --> 包住的引用根本不渲染,
  算断链是误报(sipeed_longan_logo.jpg 即此例)

断链 50 -> 39。剩下 37 处是文件在整个仓库都不存在,自动规则已无能为力。
This commit is contained in:
zepan
2026-10-07 21:14:31 +08:00
parent 14df4354c3
commit 5ad7a1a59e
5 changed files with 7 additions and 16 deletions

View File

@@ -133,11 +133,11 @@ udhcpc -ieth0
- **使用 debian 系统**
点击系统菜单--Preferenes--Connman Settings,打开 Network Settings ,查看网络属性中的 Interface 是否为 wlan0。双击网络名称,并输入 WiFi 密码进行连接
![](./../assets/RV/wifi-1.jpg)
![](../../../../../hardware/zh/lichee/assets/RV/wifi-1.jpg)
连接网络成功之后,通过系统系统菜单--Preferenes--Connman Settings,查看网络属性查看网络的 IP 地址
![](./../assets/RV/wifi-2.jpg)
![](../../../../../hardware/zh/lichee/assets/RV/wifi-2.jpg)
### 屏显触摸

View File

@@ -25,6 +25,6 @@ At present, MaixPy series development boards have the following models:
| Maix Go <img src="../../assets/hardware/maix_go/Go.jpg" width="260"> |Maix Go | STM32 | M1W | --- | --- |
| Maix Dock <img src="../../assets/hardware/maix_dock/Dan_Dock.png" width="260">| CH340 | M1/M1W | --- | --- | --- |
| Maix Duino <img src="../../assets/hardware/maix_duino/maixduino_0.png" width="260"> | CH552 | M1 | --- | --- | --- |
| Maix Bit <img src="../../assets/dk_board/maix_bit/BiT.png" width="260"> | CH552/CH340 | --- | --- | --- | --- |
| Maix Bit <img src="../../../../hardware/en/maix/assets/dk_board/maix_bit/BiT.png" width="260"> | CH552/CH340 | --- | --- | --- | --- |
| Maix Cube <img src="../../assets/dk_board/maix_cube/maixcube_2020-06-13_06-31-29.png" width="260"> | GD32/CH552 | M1n | --- |- - | --- |
|Maix Amigo <img src="" width="260"> | GD32 | M1n | --- | --- | --- |

View File

@@ -25,6 +25,6 @@ desc: maixpy MaixPy 系列开发板
| Maix Go <img src="../../assets/hardware/maix_go/Go.jpg" width="260"> |Maix Go | STM32 | M1W | --- | --- |
| Maix Dock <img src="../../assets/hardware/maix_dock/Dan_Dock.png" width="260">| CH340 | M1/M1W | --- | --- | --- |
| Maix Duino <img src="../../assets/hardware/maix_duino/maixduino_0.png" width="260"> | CH552 | M1 | --- | --- | --- |
| Maix Bit <img src="../../assets/dk_board/maix_bit/BiT.png" width="260"> | CH552/CH340 | --- | --- | --- | --- |
| Maix Bit <img src="../../../../hardware/en/maix/assets/dk_board/maix_bit/BiT.png" width="260"> | CH552/CH340 | --- | --- | --- | --- |
| Maix Cube <img src="../../assets/dk_board/maix_cube/maixcube_2020-06-13_06-31-29.png" width="260"> | GD32/CH552 | M1n | --- | --- | --- |
|Maix Amigo <img src="" width="260"> | GD32 | M1n | --- | --- | --- |

View File

@@ -31,6 +31,8 @@ PAGE_EXTS = {".md", ".html"}
IMG_EXTS = {".png", ".jpg", ".jpeg", ".gif", ".webp", ".svg", ".bmp", ".ico"}
FENCED = re.compile(r"```.*?```|~~~.*?~~~", re.S)
# HTML 注释里的引用不会渲染,不算断链
HTML_COMMENT = re.compile(r"<!--.*?-->", re.S)
INLINE_CODE = re.compile(r"`[^`\n]*`")
MD_IMG = re.compile(r"!\[[^\]]*\]\(\s*<?([^)\s>]+)")
HTML_IMG = re.compile(r"<img\b[^>]*?\bsrc\s*=\s*[\"']([^\"']+)", re.I)
@@ -92,7 +94,7 @@ def scan():
text = open(page, encoding="utf-8").read()
except (OSError, UnicodeDecodeError):
continue
text = INLINE_CODE.sub(" ", FENCED.sub(" ", text))
text = INLINE_CODE.sub(" ", FENCED.sub(" ", HTML_COMMENT.sub(" ", text)))
rel_page = os.path.relpath(page, ROOT)
for ref in set(MD_IMG.findall(text) + HTML_IMG.findall(text)):
if "{{" in ref or "{%" in ref: # jinja template expression

View File

@@ -13,41 +13,30 @@ docs/hardware/en/lichee/th1520/lpi4a/8_application.md /images/kubernetes.png
docs/hardware/en/logic_analyzer/slogic16u3/Software_User_Guide.md ./assets/Screenshots/SLogic_Connect_1.png
docs/hardware/en/maix/modules_spmod/spmod_eink.md ../../assets/spmod/spmod_eink/sp_eink_c.png
docs/hardware/en/maix/modules_spmod/spmod_weather.md ../../assets/spmod/spmod_weather/demo.gif
docs/hardware/en/maixcam/README.md ../../assets/maixcam/maixcam.jpeg
docs/hardware/en/maixface/mf_ml_module/mf0_ml_module.md ../assets/mf_module/mf1_bottom_v2(nand).png
docs/hardware/en/maixface/mf_ml_module/mf1_ml_module.md ../../assests/front.png
docs/hardware/en/maixface/mf_ml_module/mf1_ml_module.md assests/bottom.jpg
docs/hardware/en/maixface/mf_ml_module/mf_update_firmwave.md ../../assets/mf_module/mf1/mf_dual_camera_2.png
docs/hardware/en/modules_spmod/spmod_template.md ../../assets/spmod/sipeed_spmod_xxx.jpg
docs/hardware/maixface/en/mf_ml_module/mf0_ml_module.md ../../assets/mf_module/mf0_mf0dock/mf0_dock_flash.png
docs/hardware/maixface/en/mf_ml_module/mf0_ml_module.md ../assets/mf_module/mf1_bottom_v2(nand).png
docs/hardware/maixface/en/mf_ml_module/mf1_ml_module.md ../../assests/front.png
docs/hardware/maixface/en/mf_ml_module/mf1_ml_module.md assests/bottom.jpg
docs/hardware/maixface/en/mf_ml_module/mf_update_firmwave.md ../../assets/mf_module/mf1/mf_dual_camera_2.png
docs/hardware/maixface/zh/mf_ml_module/mf0_ml_module.md ../../assets/mf_module/mf0_mf0dock/mf0_dock_flash.png
docs/hardware/maixface/zh/mf_ml_module/mf0_ml_module.md ../assets/mf_module/mf1_bottom_v2(nand).png
docs/hardware/maixface/zh/mf_ml_module/mf1_ml_module.md ../../assests/front.png
docs/hardware/maixface/zh/mf_ml_module/mf1_ml_module.md assests/bottom.jpg
docs/hardware/maixface/zh/mf_ml_module/mf_update_firmwave.md ../../assets/mf_module/mf1/mf_dual_camera_2.png
docs/hardware/zh/logic_analyzer/slogic16u3/Software_User_Guide.md ../../../en/logic_analyzer/slogic16u3/assets/Screenshots/SLogic_Connect_1.png
docs/hardware/zh/maixcam/README.md ../../assets/maixcam/maixcam.jpeg
docs/hardware/zh/maixface/mf_ml_module/mf0_ml_module.md ../assets/mf_module/mf1_bottom_v2(nand).png
docs/hardware/zh/maixface/mf_ml_module/mf0_ml_module.md ./../zh/maixface/assets/mf_module/mf0_mf0dock/mf0_dock_flash.png
docs/hardware/zh/maixface/mf_ml_module/mf1_ml_module.md ./../assests/front.png
docs/hardware/zh/maixface/mf_ml_module/mf1_ml_module.md assests/bottom.jpg
docs/hardware/zh/modules_spmod/spmod_template.md ../../assets/spmod/sipeed_spmod_xxx.jpg
docs/soft/Lichee/zh/Lichee-RV/get_started/user.md ./../assets/RV/wifi-1.jpg
docs/soft/Lichee/zh/Lichee-RV/get_started/user.md ./../assets/RV/wifi-2.jpg
docs/soft/Lichee/zh/MaixII/V83X/contribution/v83x_sdk_compile/V83x_sdk_kernel_compile.md ./assets/11.png
docs/soft/Lichee/zh/Zero-Doc/System_Development/SPI_falsh_doc4.md ./../static/System_Development/uboot_conf_9.gif
docs/soft/Tang/en/Gowin/Tang_nano/README.md ../assets/sipeed_longan_logo.jpg
docs/soft/maixpy/en/course/others/maixui.md ./image/app_main.gif
docs/soft/maixpy/en/develop_kit_board/develop_kit_board.md ../../assets/dk_board/maix_bit/BiT.png
docs/soft/maixpy/en/develop_kit_board/develop_kit_board.md ../../assets/dk_board/maix_cube/maixcube_2020-06-13_06-31-29.png
docs/soft/maixpy/en/get_started/upgrade_esp8285_firmware.md ../../assets/hardware/maix_dock/sipeed_maix_dock_m1w_2.png
docs/soft/maixpy/en/get_started/upgrade_maixpy_firmware.md ../../assets/kflash_gui_screenshot_download.png
docs/soft/maixpy/zh/course/others/maixui.md ./image/app_main.gif
docs/soft/maixpy/zh/develop_kit_board/develop_kit_board.md ../../assets/dk_board/maix_bit/BiT.png
docs/soft/maixpy/zh/develop_kit_board/develop_kit_board.md ../../assets/dk_board/maix_cube/maixcube_2020-06-13_06-31-29.png
docs/soft/maixpy3/zh/usage/hardware/back/PWM_1.md ./../asserts/pwm.gif
docs/soft/maixpy3/zh/usage/hardware/back/PWM_1.md ./../asserts/pwm.jpg