From 34874034c49aeab541aeed8789e69787e6815af0 Mon Sep 17 00:00:00 2001 From: Tang ZZ Date: Fri, 21 Aug 2026 15:03:19 +0800 Subject: [PATCH 1/2] docs(common/dev): convert multiline pre blocks to standard code block format --- docs/common/dev/_erase-emmc.mdx | 8 ++------ docs/common/dev/_erase-spi-emmc.mdx | 8 ++------ docs/common/dev/_pico2-riscv32-toolchain.mdx | 18 +++++++----------- docs/common/dev/_rkdeveloptoolV2.mdx | 8 +++----- docs/common/dev/_rkdeveloptoolV3.mdx | 8 +++----- .../current/common/dev/_erase-emmc.mdx | 8 ++------ .../current/common/dev/_erase-spi-emmc.mdx | 8 ++------ .../common/dev/_pico2-riscv32-toolchain.mdx | 18 +++++++----------- .../current/common/dev/_rkdeveloptoolV2.mdx | 12 +++++------- .../current/common/dev/_rkdeveloptoolV3.mdx | 12 +++++------- 10 files changed, 38 insertions(+), 70 deletions(-) diff --git a/docs/common/dev/_erase-emmc.mdx b/docs/common/dev/_erase-emmc.mdx index 83dd0ef2e..424789112 100644 --- a/docs/common/dev/_erase-emmc.mdx +++ b/docs/common/dev/_erase-emmc.mdx @@ -25,13 +25,9 @@ 3. 刷入 Loader - 
+    
{`Download the loader file `} Loader {`, then installll the downloaded loader file (replace xxx_loader.bin with the downloaded file name in the following command)
 
-    Download the loader file  Loader , then installll the downloaded loader file (replace xxx_loader.bin with the downloaded file name in the following command)
-
-    sudo rkdeveloptool db xxx_loader.bin
-
-    

+sudo rkdeveloptool db xxx_loader.bin`}
4. 清空 eMMC diff --git a/docs/common/dev/_erase-spi-emmc.mdx b/docs/common/dev/_erase-spi-emmc.mdx index ff334c010..d36a6e659 100644 --- a/docs/common/dev/_erase-spi-emmc.mdx +++ b/docs/common/dev/_erase-spi-emmc.mdx @@ -25,9 +25,7 @@ 3. 刷入 Loader - 
-    sudo rkdeveloptool db  {props.loader_name} 
-
+ 
{`sudo rkdeveloptool db `} {props.loader_name}
4. 清空 eMMC @@ -77,9 +75,7 @@ 2. 刷入 Loader - 
-    sudo rkdeveloptool db  {props.loader_name} 
-
+ 
{`sudo rkdeveloptool db `} {props.loader_name}
3. 清空 SPI Flash diff --git a/docs/common/dev/_pico2-riscv32-toolchain.mdx b/docs/common/dev/_pico2-riscv32-toolchain.mdx index 14601018d..ec33c3a40 100644 --- a/docs/common/dev/_pico2-riscv32-toolchain.mdx +++ b/docs/common/dev/_pico2-riscv32-toolchain.mdx @@ -88,17 +88,13 @@ git clone https://github.com/raspberrypi/pico-examples.git --branch master - 编译 -
-  export PICO_SDK_PATH=path/to/pico-sdk
-  
-  cd pico-examples
-  
-  mkdir build
-  
-  cd build
-  
-  cmake .. -DPICO_PLATFORM=rp2350-riscv && make -j4
-
+```bash +export PICO_SDK_PATH=path/to/pico-sdk +cd pico-examples +mkdir build +cd build +cmake .. -DPICO_PLATFORM=rp2350-riscv && make -j4 +``` - 验证编译出来的程序是否为 riscv 32 的程序 diff --git a/docs/common/dev/_rkdeveloptoolV2.mdx b/docs/common/dev/_rkdeveloptoolV2.mdx index e4a0bcd3c..b273c872d 100644 --- a/docs/common/dev/_rkdeveloptoolV2.mdx +++ b/docs/common/dev/_rkdeveloptoolV2.mdx @@ -62,11 +62,9 @@ rkdeveloptool 可以被认为是[开源版本](https://opensource.rock-chips.com - 
-            可从{" "}
-             AUR {" "}
-            安装 rkdeveloptool。
-
+ 
{`可从 `}
+ AUR {` `}
+{`安装 rkdeveloptool。`}
 {" "} diff --git a/docs/common/dev/_rkdeveloptoolV3.mdx b/docs/common/dev/_rkdeveloptoolV3.mdx index 208df03fd..868903917 100644 --- a/docs/common/dev/_rkdeveloptoolV3.mdx +++ b/docs/common/dev/_rkdeveloptoolV3.mdx @@ -64,11 +64,9 @@ rkdeveloptool 可以被认为是[开源版本](https://opensource.rock-chips.com - 
-            可从{" "}
-             AUR {" "}
-            安装 rkdeveloptool。
-
+ 
{`可从 `}
+ AUR {` `}
+{`安装 rkdeveloptool。`}
 {" "} diff --git a/i18n/en/docusaurus-plugin-content-docs/current/common/dev/_erase-emmc.mdx b/i18n/en/docusaurus-plugin-content-docs/current/common/dev/_erase-emmc.mdx index 4a096e1ae..2e65da36d 100644 --- a/i18n/en/docusaurus-plugin-content-docs/current/common/dev/_erase-emmc.mdx +++ b/i18n/en/docusaurus-plugin-content-docs/current/common/dev/_erase-emmc.mdx @@ -25,13 +25,9 @@ 3. Flash Loader - 
+    
{`Download the loader file `} Loader {`, then installll the downloaded loader file (replace xxx_loader.bin with the downloaded file name in the following command)
 
-    Download the loader file  Loader , then installll the downloaded loader file (replace xxx_loader.bin with the downloaded file name in the following command)
-
-    sudo rkdeveloptool db xxx_loader.bin
-
-    

+sudo rkdeveloptool db xxx_loader.bin`}
4. Erase eMMC diff --git a/i18n/en/docusaurus-plugin-content-docs/current/common/dev/_erase-spi-emmc.mdx b/i18n/en/docusaurus-plugin-content-docs/current/common/dev/_erase-spi-emmc.mdx index b0b7478f8..5ad3028f2 100644 --- a/i18n/en/docusaurus-plugin-content-docs/current/common/dev/_erase-spi-emmc.mdx +++ b/i18n/en/docusaurus-plugin-content-docs/current/common/dev/_erase-spi-emmc.mdx @@ -25,9 +25,7 @@ 3. Flash Loader - 
-    sudo rkdeveloptool db  {props.loader_name} 
-
+ 
{`sudo rkdeveloptool db `} {props.loader_name}
4. Erase eMMC @@ -77,9 +75,7 @@ 2. Flash Loader - 
-    sudo rkdeveloptool db  rk3588_spl_loader_v1.15.113.bin 
-
+ 
{`sudo rkdeveloptool db `} rk3588_spl_loader_v1.15.113.bin
3. Erase SPI Flash diff --git a/i18n/en/docusaurus-plugin-content-docs/current/common/dev/_pico2-riscv32-toolchain.mdx b/i18n/en/docusaurus-plugin-content-docs/current/common/dev/_pico2-riscv32-toolchain.mdx index 8ff73b439..ff6e177d7 100644 --- a/i18n/en/docusaurus-plugin-content-docs/current/common/dev/_pico2-riscv32-toolchain.mdx +++ b/i18n/en/docusaurus-plugin-content-docs/current/common/dev/_pico2-riscv32-toolchain.mdx @@ -88,17 +88,13 @@ git clone https://github.com/raspberrypi/pico-examples.git --branch master - Compile -
-  export PICO_SDK_PATH=path/to/pico-sdk
-  
-  cd pico-examples
-  
-  mkdir build
-  
-  cd build
-  
-  cmake .. -DPICO_PLATFORM=rp2350-riscv && make -j4
-
+```bash +export PICO_SDK_PATH=path/to/pico-sdk +cd pico-examples +mkdir build +cd build +cmake .. -DPICO_PLATFORM=rp2350-riscv && make -j4 +``` - Verify that the compiled program is for riscv 32 diff --git a/i18n/en/docusaurus-plugin-content-docs/current/common/dev/_rkdeveloptoolV2.mdx b/i18n/en/docusaurus-plugin-content-docs/current/common/dev/_rkdeveloptoolV2.mdx index 14f939c53..a5a09b0a1 100644 --- a/i18n/en/docusaurus-plugin-content-docs/current/common/dev/_rkdeveloptoolV2.mdx +++ b/i18n/en/docusaurus-plugin-content-docs/current/common/dev/_rkdeveloptoolV2.mdx @@ -62,13 +62,11 @@ If your operating system does not provide rkdeveloptool, you will need to compil - 
-            rkdeveloptool can be installed from the{" "}
-            
-              {" "}
-              AUR .
-            {" "}
-
+ 
{`rkdeveloptool can be installed from the `}
+
+{`   `}
+{`  AUR .`}
+{` `}
 {" "} diff --git a/i18n/en/docusaurus-plugin-content-docs/current/common/dev/_rkdeveloptoolV3.mdx b/i18n/en/docusaurus-plugin-content-docs/current/common/dev/_rkdeveloptoolV3.mdx index 3a325ca0a..4fff70f44 100644 --- a/i18n/en/docusaurus-plugin-content-docs/current/common/dev/_rkdeveloptoolV3.mdx +++ b/i18n/en/docusaurus-plugin-content-docs/current/common/dev/_rkdeveloptoolV3.mdx @@ -62,13 +62,11 @@ If your operating system does not provide rkdeveloptool, you will need to compil - 
-            rkdeveloptool can be installed from the{" "}
-            
-              {" "}
-              AUR .
-            {" "}
-
+ 
{`rkdeveloptool can be installed from the `}
+
+{`   `}
+{`  AUR .`}
+{` `}
 {" "} From b01a348f9c9efadcdd509ac77d2128691b1b39a6 Mon Sep 17 00:00:00 2001 From: Tang ZZ Date: Fri, 21 Aug 2026 16:16:47 +0800 Subject: [PATCH 2/2] fix: collapse multiline template-literal pre blocks to single line to avoid MDX lazy-line error --- docs/common/dev/_erase-emmc.mdx | 4 +--- docs/common/dev/_rkdeveloptoolV2.mdx | 4 +--- docs/common/dev/_rkdeveloptoolV3.mdx | 4 +--- .../current/common/dev/_erase-emmc.mdx | 4 +--- .../current/common/dev/_rkdeveloptoolV2.mdx | 6 +----- .../current/common/dev/_rkdeveloptoolV3.mdx | 6 +----- 6 files changed, 6 insertions(+), 22 deletions(-) diff --git a/docs/common/dev/_erase-emmc.mdx b/docs/common/dev/_erase-emmc.mdx index 424789112..a35f2a7d9 100644 --- a/docs/common/dev/_erase-emmc.mdx +++ b/docs/common/dev/_erase-emmc.mdx @@ -25,9 +25,7 @@ 3. 刷入 Loader - 
{`Download the loader file `} Loader {`, then installll the downloaded loader file (replace xxx_loader.bin with the downloaded file name in the following command)
-
-sudo rkdeveloptool db xxx_loader.bin`}
+ 
{`Download the loader file `} Loader {`, then installll the downloaded loader file (replace xxx_loader.bin with the downloaded file name in the following command)\n\nsudo rkdeveloptool db xxx_loader.bin`}
4. 清空 eMMC diff --git a/docs/common/dev/_rkdeveloptoolV2.mdx b/docs/common/dev/_rkdeveloptoolV2.mdx index b273c872d..74724692a 100644 --- a/docs/common/dev/_rkdeveloptoolV2.mdx +++ b/docs/common/dev/_rkdeveloptoolV2.mdx @@ -62,9 +62,7 @@ rkdeveloptool 可以被认为是[开源版本](https://opensource.rock-chips.com - 
{`可从 `}
- AUR {` `}
-{`安装 rkdeveloptool。`}
+ 
{`可从 `} AUR {` 安装 rkdeveloptool。`}
 {" "} diff --git a/docs/common/dev/_rkdeveloptoolV3.mdx b/docs/common/dev/_rkdeveloptoolV3.mdx index 868903917..2c88e436b 100644 --- a/docs/common/dev/_rkdeveloptoolV3.mdx +++ b/docs/common/dev/_rkdeveloptoolV3.mdx @@ -64,9 +64,7 @@ rkdeveloptool 可以被认为是[开源版本](https://opensource.rock-chips.com - 
{`可从 `}
- AUR {` `}
-{`安装 rkdeveloptool。`}
+ 
{`可从 `} AUR {` 安装 rkdeveloptool。`}
 {" "} diff --git a/i18n/en/docusaurus-plugin-content-docs/current/common/dev/_erase-emmc.mdx b/i18n/en/docusaurus-plugin-content-docs/current/common/dev/_erase-emmc.mdx index 2e65da36d..ac1439a59 100644 --- a/i18n/en/docusaurus-plugin-content-docs/current/common/dev/_erase-emmc.mdx +++ b/i18n/en/docusaurus-plugin-content-docs/current/common/dev/_erase-emmc.mdx @@ -25,9 +25,7 @@ 3. Flash Loader - 
{`Download the loader file `} Loader {`, then installll the downloaded loader file (replace xxx_loader.bin with the downloaded file name in the following command)
-
-sudo rkdeveloptool db xxx_loader.bin`}
+ 
{`Download the loader file `} Loader {`, then installll the downloaded loader file (replace xxx_loader.bin with the downloaded file name in the following command)\n\nsudo rkdeveloptool db xxx_loader.bin`}
4. Erase eMMC diff --git a/i18n/en/docusaurus-plugin-content-docs/current/common/dev/_rkdeveloptoolV2.mdx b/i18n/en/docusaurus-plugin-content-docs/current/common/dev/_rkdeveloptoolV2.mdx index a5a09b0a1..4477198ca 100644 --- a/i18n/en/docusaurus-plugin-content-docs/current/common/dev/_rkdeveloptoolV2.mdx +++ b/i18n/en/docusaurus-plugin-content-docs/current/common/dev/_rkdeveloptoolV2.mdx @@ -62,11 +62,7 @@ If your operating system does not provide rkdeveloptool, you will need to compil - 
{`rkdeveloptool can be installed from the `}
-
-{`   `}
-{`  AUR .`}
-{` `}
+ 
{`rkdeveloptool can be installed from the `}{`   `}{`  AUR .`}{` `}
 {" "} diff --git a/i18n/en/docusaurus-plugin-content-docs/current/common/dev/_rkdeveloptoolV3.mdx b/i18n/en/docusaurus-plugin-content-docs/current/common/dev/_rkdeveloptoolV3.mdx index 4fff70f44..0f0aa7eae 100644 --- a/i18n/en/docusaurus-plugin-content-docs/current/common/dev/_rkdeveloptoolV3.mdx +++ b/i18n/en/docusaurus-plugin-content-docs/current/common/dev/_rkdeveloptoolV3.mdx @@ -62,11 +62,7 @@ If your operating system does not provide rkdeveloptool, you will need to compil - 
{`rkdeveloptool can be installed from the `}
-
-{`   `}
-{`  AUR .`}
-{` `}
+ 
{`rkdeveloptool can be installed from the `}{`   `}{`  AUR .`}{` `}
 {" "}