Skip to content

docs(rock3b): link boot-from-sd-card image download to the consolidated download page#1923

Merged
Milir-Radxa merged 2 commits into
radxa-docs:mainfrom
tangzz-radxa:docs/rock3b-boot-from-sd-card-download-link-20260708
Jul 9, 2026
Merged

docs(rock3b): link boot-from-sd-card image download to the consolidated download page#1923
Milir-Radxa merged 2 commits into
radxa-docs:mainfrom
tangzz-radxa:docs/rock3b-boot-from-sd-card-download-link-20260708

Conversation

@tangzz-radxa

@tangzz-radxa tangzz-radxa commented Jul 8, 2026

Copy link
Copy Markdown
Contributor

Summary

把 ROCK 3B 「安装系统到 microSD 卡」和「安装系统到 eMMC Module」两页里通过 _image.mdx 组件嵌入的镜像下载段落,统一改为直接指向 ../../download 资源下载汇总页面,与 ROCK 4A/B 同类页面的现行写法保持一致。

Why

  • 两页原先通过 import Images from "../../_image.mdx" 渲染系统镜像链接,但 _image.mdx 里写死的 URL(b18)和 /rock3/rock3b/download 维护的最新镜像列表(已包含 rsdk-r1)会逐步脱节,容易把客户引到过期镜像。
  • 售后技术支持群收到反馈:镜像下载部分已过时,需要按同类页面的写法收敛到 download 页面。

Changes

  • docs/rock3/rock3b/getting-started/install-system/boot-from-sd-card.md (commit 1)
    • 删除 _image.mdximportimports_resolve_to 条目
    • source_of_truthlocal 改为 common
    • 「文件下载」段落改为「到资源下载汇总页面下载 ROCK 3B 系统镜像
    • 新增一句话简介,与 ROCK 4A/B 同类页面风格对齐
  • i18n/en/docusaurus-plugin-content-docs/current/rock3/rock3b/getting-started/install-system/boot-from-sd-card.md (commit 1)
    • 同步去掉 _image.mdx import、source_of_truth 改为 common
    • 「File Download」段落改为「Download the ROCK 3B system image from the resource download page.」
    • 标题与简介同步对齐英文版本风格
  • docs/rock3/rock3b/getting-started/install-system/boot-from-emmc.md (commit 2)
    • 与 sd-card 完全一致的处理方式(去掉 _image.mdx,改为 download 链接)
    • 顺手把全文大小写不统一的 EMMC Module / EMMC Reader 归一为 eMMC,与 ROCK 4A/B 参考页对齐
  • i18n/en/docusaurus-plugin-content-docs/current/rock3/rock3b/getting-started/install-system/boot-from-emmc.md (commit 2)
    • 同步上面三处处理

参考

  • docs/rock4/rock4ab-se/getting-started/install-os/boot-from-sd-card.md(同类页面目标格式)
  • docs/rock4/rock4ab-se/getting-started/install-os/boot-from-emmc.md(同类页面目标格式)
  • docs/rock3/rock3b/download.md(新的镜像下载地址)

影响范围

  • 仅 ROCK 3B:microSD 卡 / eMMC Module 两套安装引导页面(共 4 个文件:中英文各 2)
  • maskrom 三页(windows/linux/mac-os)也引用 _image.mdx,但本次按内部沟通结果暂不动,单独跟进

Verification

  • python3 /Users/tomclawz/.openclaw/workspaces/support/scripts/github_pr_guard.py check --repo-path ~/radxa-docs/docs --fetch
    • ok: truereasons: []
    • bilingual 同步:中文 / 英文都齐全
    • scope 仅 docs/rock3/rock3b,文件数 4,commit 数 2

…ed download page

The image download links embedded via the local _image.mdx component on
the ROCK 3B 'install system to microSD card' page had drifted from the
maintained download page (which lists the current Radxa OS images and
third-party builds). Follow the pattern used by similar pages such as
ROCK 4A/B and point users straight to the download summary instead.

- Replace the _image.mdx import with a direct link to ../../download
- Drop the now-unused _image.mdx entry from imports_resolve_to
- Mirror the same change in i18n/en for the English version
- Switch source_of_truth from local to common since the page no longer
  relies on product-local imports

Fixes the outdated image section reported in the 售后技术支持 topic.
@tangzz-radxa tangzz-radxa requested a review from Ken-Vamrs as a code owner July 8, 2026 11:31
…download page

Apply the same image-download refactor to the ROCK 3B 'install system to
eMMC Module' page as the previous commit did for the microSD card page.

- Replace the _image.mdx import with a direct link to ../../download
- Drop the now-unused _image.mdx entry from imports_resolve_to
- Switch source_of_truth from local to common
- Normalise 'EMMC Module' / 'EMMC Reader' to the 'eMMC' casing used by
  the ROCK 4A/B reference page
- Mirror the same change in i18n/en for the English version
@Milir-Radxa Milir-Radxa merged commit a13c10b into radxa-docs:main Jul 9, 2026
5 of 6 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants