From 7fc97e29b8aa2b15d317cac5ea9c452adffa51a2 Mon Sep 17 00:00:00 2001 From: Tang ZZ Date: Wed, 8 Jul 2026 14:01:19 +0800 Subject: [PATCH 1/4] docs(common): fix broken uart/ssh jump links in shared screenless/use-system partials The shared common partials `_screenless.mdx` and `_use_system.mdx` link to `./uart_login` / `./ssh_remote` (and `../system-config/uart_login` / `ssh_login`), but the actual page slugs are `uart-login` and `ssh-login` (with hyphens), so every cross-reference to the serial-console and SSH pages returns 404 on docs.radxa.com. Both partials are only consumed by cubie a5e and cubie a7s, and those two products are the only ones whose local UART/SSH pages use the `uart-login` / `ssh-login` slugs, so the rename is safe for the current set of importers. Update both partials in Chinese and English to keep the docs in sync. --- docs/common/radxa-os/install-system/_use_system.mdx | 2 +- docs/common/radxa-os/system-config/_screenless.mdx | 6 +++--- .../current/common/radxa-os/install-system/_use_system.mdx | 2 +- .../current/common/radxa-os/system-config/_screenless.mdx | 6 +++--- 4 files changed, 8 insertions(+), 8 deletions(-) diff --git a/docs/common/radxa-os/install-system/_use_system.mdx b/docs/common/radxa-os/install-system/_use_system.mdx index eaeb54a8a..904ea7f41 100644 --- a/docs/common/radxa-os/install-system/_use_system.mdx +++ b/docs/common/radxa-os/install-system/_use_system.mdx @@ -31,4 +31,4 @@ ### 无屏模式 -[无屏模式](../system-config/screenless)指的是不使用显示器，建议用户通过[串口登录](../system-config/uart_login)或[SSH 登录](../system-config/ssh_login)和控制系统。 +[无屏模式](../system-config/screenless)指的是不使用显示器，建议用户通过[串口登录](../system-config/uart-login)或[SSH 登录](../system-config/ssh-login)和控制系统。 diff --git a/docs/common/radxa-os/system-config/_screenless.mdx b/docs/common/radxa-os/system-config/_screenless.mdx index 8ea0b19b2..99a49ad0a 100644 --- a/docs/common/radxa-os/system-config/_screenless.mdx +++ b/docs/common/radxa-os/system-config/_screenless.mdx @@ -2,7 +2,7 @@ ## 串口登录 -可以参考 [串口登录](./uart_login) 教程进行操作。 +可以参考 [串口登录](./uart-login) 教程进行操作。 ## SSH 登录 @@ -14,7 +14,7 @@ ### 有线网络 -使用网线连接主板和路由器，路由器分配 IP 地址后，可以访问路由器后台查看 IP 地址，然后参考 [SSH 远程](./ssh_remote) 教程登录和控制系统。 +使用网线连接主板和路由器，路由器分配 IP 地址后，可以访问路由器后台查看 IP 地址，然后参考 [SSH 远程](./ssh-login) 教程登录和控制系统。 ### 无线网络 @@ -36,7 +36,7 @@ connect_wi-fi YOUR_WIFI_SSID YOUR_WIFI_PASSWORD 修改并保存文件后，将 MicroSD 卡安全取出，插入主板，启动系统后，系统会自动连接到 WiFi 网络； -路由器会自动分配 IP 地址给主板，你可以通过路由器后台查看 IP 地址，然后参考 [SSH 远程](./ssh_remote) 教程登录和控制系统。 +路由器会自动分配 IP 地址给主板，你可以通过路由器后台查看 IP 地址，然后参考 [SSH 远程](./ssh-login) 教程登录和控制系统。 :::tip before.txt `before.txt` 只在首次启动系统时出现，启动系统后将消失；若想要通过该方式再次配置网络，需要重新烧录系统到 MicroSD 卡中。 diff --git a/i18n/en/docusaurus-plugin-content-docs/current/common/radxa-os/install-system/_use_system.mdx b/i18n/en/docusaurus-plugin-content-docs/current/common/radxa-os/install-system/_use_system.mdx index ad92868a2..29b26dc33 100644 --- a/i18n/en/docusaurus-plugin-content-docs/current/common/radxa-os/install-system/_use_system.mdx +++ b/i18n/en/docusaurus-plugin-content-docs/current/common/radxa-os/install-system/_use_system.mdx @@ -29,4 +29,4 @@ Display mode refers to connecting the motherboard to a monitor using an HDMI cab ### Display-less Mode -[Display-less mode](../system-config/screenless) refers to using the system without a monitor. Users are recommended to access and control the system through [serial console login](../system-config/uart_login) or [SSH login](../system-config/ssh_login). +[Display-less mode](../system-config/screenless) refers to using the system without a monitor. Users are recommended to access and control the system through [serial console login](../system-config/uart-login) or [SSH login](../system-config/ssh-login). diff --git a/i18n/en/docusaurus-plugin-content-docs/current/common/radxa-os/system-config/_screenless.mdx b/i18n/en/docusaurus-plugin-content-docs/current/common/radxa-os/system-config/_screenless.mdx index f2bc5dcc3..4fa9b643e 100644 --- a/i18n/en/docusaurus-plugin-content-docs/current/common/radxa-os/system-config/_screenless.mdx +++ b/i18n/en/docusaurus-plugin-content-docs/current/common/radxa-os/system-config/_screenless.mdx @@ -2,7 +2,7 @@ Screenless mode refers to using the board without a display, accessing the syste ## Serial Port Login -You can refer to the [Serial Port Login](./uart_login) tutorial for instructions. +You can refer to the [Serial Port Login](./uart-login) tutorial for instructions. ## SSH Login @@ -14,7 +14,7 @@ To log in to the system via SSH, ensure that the board and your operating device ### Wired Network -Connect the board to a router using an Ethernet cable. After the router assigns an IP address, you can check the IP address in the router's admin panel, then refer to the [SSH Remote](./ssh_remote) tutorial to log in and control the system. +Connect the board to a router using an Ethernet cable. After the router assigns an IP address, you can check the IP address in the router's admin panel, then refer to the [SSH Remote](./ssh-login) tutorial to log in and control the system. ### Wireless Network @@ -36,7 +36,7 @@ connect_wi-fi YOUR_WIFI_SSID YOUR_WIFI_PASSWORD After modifying and saving the file, safely eject the MicroSD card and insert it into the board. The system will automatically connect to the WiFi network upon boot. -The router will automatically assign an IP address to the board. You can check the IP address in the router's admin panel, then refer to the [SSH Remote](./ssh_remote) tutorial to log in and control the system. +The router will automatically assign an IP address to the board. You can check the IP address in the router's admin panel, then refer to the [SSH Remote](./ssh-login) tutorial to log in and control the system. :::tip about before.txt `before.txt` only appears during the first system boot and will be removed afterward. To reconfigure the network using this method, you'll need to reflash the system to the MicroSD card. From 0040209fe9abd7ffa9fc0a60586e946e8a1023b6 Mon Sep 17 00:00:00 2001 From: Tang ZZ Date: Wed, 8 Jul 2026 14:15:59 +0800 Subject: [PATCH 2/4] =?UTF-8?q?docs(cubie=20a5e/a7s):=20translate=20'?= =?UTF-8?q?=E6=97=A0=E5=B1=8F'=20as=20'Headless'=20instead=20of=20'Screenl?= =?UTF-8?q?ess'=20in=20EN?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit The English pages for cubie a5e and a7s render the '无屏模式' section as 'Screenless Mode', which is not the conventional term in the SBC / Linux-on-arm world. ROCK 5 / ROCK 4 / ROCK 3 / Zero / CM3 / template-sbc all already use 'Headless Mode' for the same concept. Update the EN titles, headings and first-sentence wording to use 'Headless' / 'Headless Mode' so cubie's terminology matches the rest of the docs. Leave the slug and filename (`screenless` /`screenless.md`) alone for now — renaming those would also require a URL redirect and a follow-up PR. --- .../current/common/radxa-os/install-system/_use_system.mdx | 4 ++-- .../current/common/radxa-os/system-config/_screenless.mdx | 2 +- .../current/cubie/a5e/system-config/screenless.md | 2 +- .../current/cubie/a7s/system-config/screenless.md | 2 +- 4 files changed, 5 insertions(+), 5 deletions(-) diff --git a/i18n/en/docusaurus-plugin-content-docs/current/common/radxa-os/install-system/_use_system.mdx b/i18n/en/docusaurus-plugin-content-docs/current/common/radxa-os/install-system/_use_system.mdx index 29b26dc33..a2b8ac0ce 100644 --- a/i18n/en/docusaurus-plugin-content-docs/current/common/radxa-os/install-system/_use_system.mdx +++ b/i18n/en/docusaurus-plugin-content-docs/current/common/radxa-os/install-system/_use_system.mdx @@ -27,6 +27,6 @@ Here are some recommendations for users in both display and display-less modes t Display mode refers to connecting the motherboard to a monitor using an HDMI cable, allowing you to view the system interface on the display and use a mouse and keyboard for graphical interface operations. -### Display-less Mode +### Headless Mode -[Display-less mode](../system-config/screenless) refers to using the system without a monitor. Users are recommended to access and control the system through [serial console login](../system-config/uart-login) or [SSH login](../system-config/ssh-login). +[Headless mode](../system-config/screenless) refers to using the system without a monitor. Users are recommended to access and control the system through [serial console login](../system-config/uart-login) or [SSH login](../system-config/ssh-login). diff --git a/i18n/en/docusaurus-plugin-content-docs/current/common/radxa-os/system-config/_screenless.mdx b/i18n/en/docusaurus-plugin-content-docs/current/common/radxa-os/system-config/_screenless.mdx index 4fa9b643e..f0550da52 100644 --- a/i18n/en/docusaurus-plugin-content-docs/current/common/radxa-os/system-config/_screenless.mdx +++ b/i18n/en/docusaurus-plugin-content-docs/current/common/radxa-os/system-config/_screenless.mdx @@ -1,4 +1,4 @@ -Screenless mode refers to using the board without a display, accessing the system through a serial port or SSH for operations! +Headless mode refers to using the board without a display, accessing the system through a serial port or SSH for operations! ## Serial Port Login diff --git a/i18n/en/docusaurus-plugin-content-docs/current/cubie/a5e/system-config/screenless.md b/i18n/en/docusaurus-plugin-content-docs/current/cubie/a5e/system-config/screenless.md index 80e6c040d..0fbbebd5f 100644 --- a/i18n/en/docusaurus-plugin-content-docs/current/cubie/a5e/system-config/screenless.md +++ b/i18n/en/docusaurus-plugin-content-docs/current/cubie/a5e/system-config/screenless.md @@ -9,6 +9,6 @@ imports_resolve_to: import SCREENLESS from '../../../common/radxa-os/system-config/\_screenless.mdx'; -# Screenless Mode +# Headless Mode diff --git a/i18n/en/docusaurus-plugin-content-docs/current/cubie/a7s/system-config/screenless.md b/i18n/en/docusaurus-plugin-content-docs/current/cubie/a7s/system-config/screenless.md index b79828cdb..9af78ec82 100644 --- a/i18n/en/docusaurus-plugin-content-docs/current/cubie/a7s/system-config/screenless.md +++ b/i18n/en/docusaurus-plugin-content-docs/current/cubie/a7s/system-config/screenless.md @@ -9,6 +9,6 @@ imports_resolve_to: import SCREENLESS from '../../../common/radxa-os/system-config/\_screenless.mdx'; -# Headless mode +# Headless Mode From 69bac125d5a42070aa54fcf20402309ba2bb26f4 Mon Sep 17 00:00:00 2001 From: Tang ZZ Date: Wed, 8 Jul 2026 14:27:47 +0800 Subject: [PATCH 3/4] docs(cubie a5e/a7s): rename shared partial _screenless.mdx to _headless.mdx MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Follow up on the 'screenless → headless' terminology cleanup. The cubie shared partial lived at `common/radxa-os/system-config/_screenless.mdx`, which is the only place outside of CN/EN headless pages still using the 'screenless' term. Rename it to `_headless.mdx` so the partial file matches the rest of the docs (rock5/rock4/rock3/zero/cm3/template all already use `_headless.mdx`). Update the frontmatter `imports_resolve_to` and the `import … from …` statement in the four cubie a5e / a7s wrapper files (CN + EN) to point to the new file. Note: this leaves us with two partials called `_headless.mdx` — `docs/common/radxa-os/_headless.mdx` (rock5/zero/etc, concise, uses props) and `docs/common/radxa-os/system-config/_headless.mdx` (cubie, detailed with before.txt/config.txt walkthrough). They have different content shapes and merging them is out of scope here. Page slug `screenless` and the `screenless.md` wrappers are intentionally unchanged — renaming those would break published URLs and needs a separate redirect-based PR. --- .../radxa-os/system-config/{_screenless.mdx => _headless.mdx} | 0 docs/cubie/a5e/system-config/screenless.md | 4 ++-- docs/cubie/a7s/system-config/screenless.md | 4 ++-- .../radxa-os/system-config/{_screenless.mdx => _headless.mdx} | 0 .../current/cubie/a5e/system-config/screenless.md | 4 ++-- .../current/cubie/a7s/system-config/screenless.md | 4 ++-- 6 files changed, 8 insertions(+), 8 deletions(-) rename docs/common/radxa-os/system-config/{_screenless.mdx => _headless.mdx} (100%) rename i18n/en/docusaurus-plugin-content-docs/current/common/radxa-os/system-config/{_screenless.mdx => _headless.mdx} (100%) diff --git a/docs/common/radxa-os/system-config/_screenless.mdx b/docs/common/radxa-os/system-config/_headless.mdx similarity index 100% rename from docs/common/radxa-os/system-config/_screenless.mdx rename to docs/common/radxa-os/system-config/_headless.mdx diff --git a/docs/cubie/a5e/system-config/screenless.md b/docs/cubie/a5e/system-config/screenless.md index c6257542f..4d55ed9da 100644 --- a/docs/cubie/a5e/system-config/screenless.md +++ b/docs/cubie/a5e/system-config/screenless.md @@ -4,10 +4,10 @@ sidebar_position: 1 doc_kind: wrapper source_of_truth: common imports_resolve_to: - - docs/common/radxa-os/system-config/_screenless.mdx + - docs/common/radxa-os/system-config/_headless.mdx --- -import SCREENLESS from '../../../common/radxa-os/system-config/\_screenless.mdx'; +import SCREENLESS from '../../../common/radxa-os/system-config/\_headless.mdx'; # 无屏模式 diff --git a/docs/cubie/a7s/system-config/screenless.md b/docs/cubie/a7s/system-config/screenless.md index 58fb5c3e6..00c879c3b 100644 --- a/docs/cubie/a7s/system-config/screenless.md +++ b/docs/cubie/a7s/system-config/screenless.md @@ -4,10 +4,10 @@ sidebar_position: 1 doc_kind: wrapper source_of_truth: common imports_resolve_to: - - docs/common/radxa-os/system-config/_screenless.mdx + - docs/common/radxa-os/system-config/_headless.mdx --- -import SCREENLESS from '../../../common/radxa-os/system-config/\_screenless.mdx'; +import SCREENLESS from '../../../common/radxa-os/system-config/\_headless.mdx'; # 无屏模式 diff --git a/i18n/en/docusaurus-plugin-content-docs/current/common/radxa-os/system-config/_screenless.mdx b/i18n/en/docusaurus-plugin-content-docs/current/common/radxa-os/system-config/_headless.mdx similarity index 100% rename from i18n/en/docusaurus-plugin-content-docs/current/common/radxa-os/system-config/_screenless.mdx rename to i18n/en/docusaurus-plugin-content-docs/current/common/radxa-os/system-config/_headless.mdx diff --git a/i18n/en/docusaurus-plugin-content-docs/current/cubie/a5e/system-config/screenless.md b/i18n/en/docusaurus-plugin-content-docs/current/cubie/a5e/system-config/screenless.md index 0fbbebd5f..d17db535f 100644 --- a/i18n/en/docusaurus-plugin-content-docs/current/cubie/a5e/system-config/screenless.md +++ b/i18n/en/docusaurus-plugin-content-docs/current/cubie/a5e/system-config/screenless.md @@ -4,10 +4,10 @@ sidebar_position: 1 doc_kind: wrapper source_of_truth: common imports_resolve_to: - - i18n/en/docusaurus-plugin-content-docs/current/common/radxa-os/system-config/_screenless.mdx + - i18n/en/docusaurus-plugin-content-docs/current/common/radxa-os/system-config/_headless.mdx --- -import SCREENLESS from '../../../common/radxa-os/system-config/\_screenless.mdx'; +import SCREENLESS from '../../../common/radxa-os/system-config/\_headless.mdx'; # Headless Mode diff --git a/i18n/en/docusaurus-plugin-content-docs/current/cubie/a7s/system-config/screenless.md b/i18n/en/docusaurus-plugin-content-docs/current/cubie/a7s/system-config/screenless.md index 9af78ec82..0a167941e 100644 --- a/i18n/en/docusaurus-plugin-content-docs/current/cubie/a7s/system-config/screenless.md +++ b/i18n/en/docusaurus-plugin-content-docs/current/cubie/a7s/system-config/screenless.md @@ -4,10 +4,10 @@ sidebar_position: 1 doc_kind: wrapper source_of_truth: common imports_resolve_to: - - i18n/en/docusaurus-plugin-content-docs/current/common/radxa-os/system-config/_screenless.mdx + - i18n/en/docusaurus-plugin-content-docs/current/common/radxa-os/system-config/_headless.mdx --- -import SCREENLESS from '../../../common/radxa-os/system-config/\_screenless.mdx'; +import SCREENLESS from '../../../common/radxa-os/system-config/\_headless.mdx'; # Headless Mode From d4793e5585155146bca9fba7ccad4183d4961f62 Mon Sep 17 00:00:00 2001 From: Tang ZZ Date: Wed, 8 Jul 2026 14:38:19 +0800 Subject: [PATCH 4/4] =?UTF-8?q?docs(cubie=20a5e/a7s):=20rename=20page=20fi?= =?UTF-8?q?le=20screenless.md=20=E2=86=92=20headless.md?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Follow up on the partial rename in the previous commit. The actual published pages lived at `cubie/{a5e,a7s}/system-config/screenless.md`, so rename those wrappers too so the page slug matches the partial and the rest of the docs. Update the only remaining internal link to the old slug (`_use_system.mdx`, both CN and EN) to point at `system-config/headless`. Note: this changes the published URL of `/cubie/a5e/system-config/screenless` → `/cubie/a5e/system-config/headless` (same for a7s). No redirect is added — this matches the existing repo convention used for previous file renames (e.g. `docs/rockpi/rocks0 → rockpis0`), where URLs simply change on rename. --- docs/common/radxa-os/install-system/_use_system.mdx | 2 +- docs/cubie/a5e/system-config/{screenless.md => headless.md} | 0 docs/cubie/a7s/system-config/{screenless.md => headless.md} | 0 .../current/common/radxa-os/install-system/_use_system.mdx | 2 +- .../cubie/a5e/system-config/{screenless.md => headless.md} | 0 .../cubie/a7s/system-config/{screenless.md => headless.md} | 0 6 files changed, 2 insertions(+), 2 deletions(-) rename docs/cubie/a5e/system-config/{screenless.md => headless.md} (100%) rename docs/cubie/a7s/system-config/{screenless.md => headless.md} (100%) rename i18n/en/docusaurus-plugin-content-docs/current/cubie/a5e/system-config/{screenless.md => headless.md} (100%) rename i18n/en/docusaurus-plugin-content-docs/current/cubie/a7s/system-config/{screenless.md => headless.md} (100%) diff --git a/docs/common/radxa-os/install-system/_use_system.mdx b/docs/common/radxa-os/install-system/_use_system.mdx index 904ea7f41..b4295d88e 100644 --- a/docs/common/radxa-os/install-system/_use_system.mdx +++ b/docs/common/radxa-os/install-system/_use_system.mdx @@ -31,4 +31,4 @@ ### 无屏模式 -[无屏模式](../system-config/screenless)指的是不使用显示器，建议用户通过[串口登录](../system-config/uart-login)或[SSH 登录](../system-config/ssh-login)和控制系统。 +[无屏模式](../system-config/headless)指的是不使用显示器，建议用户通过[串口登录](../system-config/uart-login)或[SSH 登录](../system-config/ssh-login)和控制系统。 diff --git a/docs/cubie/a5e/system-config/screenless.md b/docs/cubie/a5e/system-config/headless.md similarity index 100% rename from docs/cubie/a5e/system-config/screenless.md rename to docs/cubie/a5e/system-config/headless.md diff --git a/docs/cubie/a7s/system-config/screenless.md b/docs/cubie/a7s/system-config/headless.md similarity index 100% rename from docs/cubie/a7s/system-config/screenless.md rename to docs/cubie/a7s/system-config/headless.md diff --git a/i18n/en/docusaurus-plugin-content-docs/current/common/radxa-os/install-system/_use_system.mdx b/i18n/en/docusaurus-plugin-content-docs/current/common/radxa-os/install-system/_use_system.mdx index a2b8ac0ce..c24c1dbbc 100644 --- a/i18n/en/docusaurus-plugin-content-docs/current/common/radxa-os/install-system/_use_system.mdx +++ b/i18n/en/docusaurus-plugin-content-docs/current/common/radxa-os/install-system/_use_system.mdx @@ -29,4 +29,4 @@ Display mode refers to connecting the motherboard to a monitor using an HDMI cab ### Headless Mode -[Headless mode](../system-config/screenless) refers to using the system without a monitor. Users are recommended to access and control the system through [serial console login](../system-config/uart-login) or [SSH login](../system-config/ssh-login). +[Headless mode](../system-config/headless) refers to using the system without a monitor. Users are recommended to access and control the system through [serial console login](../system-config/uart-login) or [SSH login](../system-config/ssh-login). diff --git a/i18n/en/docusaurus-plugin-content-docs/current/cubie/a5e/system-config/screenless.md b/i18n/en/docusaurus-plugin-content-docs/current/cubie/a5e/system-config/headless.md similarity index 100% rename from i18n/en/docusaurus-plugin-content-docs/current/cubie/a5e/system-config/screenless.md rename to i18n/en/docusaurus-plugin-content-docs/current/cubie/a5e/system-config/headless.md diff --git a/i18n/en/docusaurus-plugin-content-docs/current/cubie/a7s/system-config/screenless.md b/i18n/en/docusaurus-plugin-content-docs/current/cubie/a7s/system-config/headless.md similarity index 100% rename from i18n/en/docusaurus-plugin-content-docs/current/cubie/a7s/system-config/screenless.md rename to i18n/en/docusaurus-plugin-content-docs/current/cubie/a7s/system-config/headless.md