Skip to content

docs(q8b): add Ubuntu, Debian and Fedora installation guides - #2128

Merged
Milir-Radxa merged 1 commit into
radxa-docs:mainfrom
tzz-radxa:docs/q8b-other-system-tutorials-20260918
Sep 18, 2026
Merged

Milir-Radxa merged 1 commit into
radxa-docs:mainfrom
tzz-radxa:docs/q8b-other-system-tutorials-20260918

Conversation

@tzz-radxa

Copy link
Copy Markdown
Contributor

背景

Dragon Q8B 的「安装第三方系统」文档目前只有 Armbian 与 Windows 11 两篇。本次参照内部教程,补齐 Ubuntu 26.04、Debian 14、Fedora 44 Workstation 三套系统的安装说明,并同步中英文页面。

变更内容

新增三篇中英文文档(docs/dragon/q8b/other-system/i18n/en/.../other-system/):

  • ubuntu.md(Install Ubuntu 26.04)
  • debian.md(Install Debian 14)
  • fedora.md(Install Fedora 44)

每篇覆盖:下载 ARM64 系统镜像 → 使用 balenaEtcher 制作启动 U 盘 → 在 UEFI 中启用 Third-party OS Compatibility Settings → 安装程序完整流程(含分区、账户、时区等)→ 首次进入桌面。

新增 70 张步骤配图,统一为 WebP(static/img/dragon/q8b/{ubuntu,debian,fedora}/),命名与步骤一一对应。

实现说明

  • Ubuntu 篇在「选择安装方式」一步使用 <Tabs> 组件,可在「手动安装」与「擦除整盘安装」两条路径之间切换,避免两套分区操作互相干扰。
  • Fedora 篇从 Live 启动项开始,不包含与该教程无关的引导菜单截图。
  • 目标存储统一表述为 microSD 卡(mmcblk0),并明确提示安装会清空目标磁盘。
  • 三篇均补充了数据清空告警,并保持与 armbian.mdwindows-11.md 一致的 front matter 风格。

验证

  • scripts/agent-doc-lint.sh 通过(6 篇中英文页面)
  • scripts/agent-doc-drift-guard.sh 通过,无新增 docs-only / i18n-only 漂移
  • 中英文页面图片引用逐条比对一致(23 / 25 / 22),且全部文件存在
  • PR guard 双语 diff 检查通过

内容来源:内部产品教程整理,配图已人工核查,无隐私或敏感信息。

@tzz-radxa
tzz-radxa requested review from a team, akgnah and xzuoqi as code owners September 18, 2026 07:52
Add step-by-step installation guides for Ubuntu 26.04, Debian 14 and
Fedora 44 Workstation on Dragon Q8B, in both Chinese and English:

- download the ARM64 image and write a bootable USB drive
- enable third-party OS compatibility options in the UEFI setup
- full installer walkthrough with annotated screenshots
- first boot into the desktop

The Ubuntu guide presents manual partitioning and erasing the whole
disk as switchable tabs under the installation method step.
@tzz-radxa
tzz-radxa force-pushed the docs/q8b-other-system-tutorials-20260918 branch from 5857d3a to 21a2d1d Compare September 18, 2026 07:57
@Milir-Radxa
Milir-Radxa merged commit 6fd6056 into radxa-docs:main Sep 18, 2026
3 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