From e9e2432c0244628e6bc813e710d1bc3bd6d8d470 Mon Sep 17 00:00:00 2001
From: Y1hsiaochunnn <66012385+Y1hsiaochunnn@users.noreply.github.com>
Date: Tue, 8 Sep 2026 11:57:53 +0800
Subject: [PATCH 1/2] docs: add product gallery to bilingual readmes

---
 README.md    | 38 ++++++++++++++++++++++++++++++++++++++
 README_ZH.md | 37 +++++++++++++++++++++++++++++++++++++
 2 files changed, 75 insertions(+)

diff --git a/README.md b/README.md
index 7b21b77..88577c6 100644
--- a/README.md
+++ b/README.md
@@ -24,6 +24,44 @@ bilingual documentation, and generation/build checks.
 
 ## 📋 Board catalog
 
+Product images from Waveshare’s official product repositories. Follow the links
+below for board definitions and product documentation.
+
+<table>
+  <tr>
+    <td align="center" valign="top" width="50%">
+      <p><strong>ESP32-S3-Touch-AMOLED-1.75C</strong></p>
+      <a href="https://docs.waveshare.com/ESP32-S3-Touch-AMOLED-1.75C">
+        <img src="https://raw.githubusercontent.com/waveshareteam/ESP32-S3-Touch-AMOLED-1.75C/6d19f7e16fb9a3be219e9eed43ca9eb56c88d01c/docs/images/esp32-s3-touch-amoled-1.75c.jpg" alt="ESP32-S3-Touch-AMOLED-1.75C development board" width="360">
+      </a>
+      <p><a href="boards/esp32_s3_touch_amoled_1_75c/">Board definition</a> · <a href="https://docs.waveshare.com/ESP32-S3-Touch-AMOLED-1.75C">Product documentation</a></p>
+    </td>
+    <td align="center" valign="top" width="50%">
+      <p><strong>ESP32-S3-Touch-AMOLED-1.8</strong></p>
+      <a href="https://docs.waveshare.com/ESP32-S3-Touch-AMOLED-1.8">
+        <img src="https://raw.githubusercontent.com/waveshareteam/ESP32-S3-Touch-AMOLED-1.8/7ab8f957e22ea1ab811256359f4eddcaaf49ee91/assets/ESP32-S3-Touch-AMOLED-1.8-hero.webp" alt="ESP32-S3-Touch-AMOLED-1.8 development board" width="360">
+      </a>
+      <p><a href="boards/esp32_s3_touch_amoled_1_8/">Board definition</a> · <a href="https://docs.waveshare.com/ESP32-S3-Touch-AMOLED-1.8">Product documentation</a></p>
+    </td>
+  </tr>
+  <tr>
+    <td align="center" valign="top" width="50%">
+      <p><strong>ESP32-S3-Touch-AMOLED-2.16</strong></p>
+      <a href="https://docs.waveshare.com/ESP32-S3-Touch-AMOLED-2.16">
+        <img src="https://raw.githubusercontent.com/waveshareteam/ESP32-S3-Touch-AMOLED-2.16/225a62bff11b5d0a0b607873860d39485a9a9685/docs/assets/ESP32-S3-Touch-AMOLED-2.16-details-1.jpg" alt="ESP32-S3-Touch-AMOLED-2.16 development board" width="360">
+      </a>
+      <p><a href="boards/esp32_s3_touch_amoled_2_16/">Board definition</a> · <a href="https://docs.waveshare.com/ESP32-S3-Touch-AMOLED-2.16">Product documentation</a></p>
+    </td>
+    <td align="center" valign="top" width="50%">
+      <p><strong>ESP32-S3-Touch-LCD-7</strong></p>
+      <a href="https://docs.waveshare.com/ESP32-S3-Touch-LCD-7">
+        <img src="https://raw.githubusercontent.com/waveshareteam/ESP32-S3-Touch-LCD-7/bc51a84b30c0cea018fee6e0d7427ec10102060e/assets/Product-1.webp" alt="ESP32-S3-Touch-LCD-7 development board" width="360">
+      </a>
+      <p><a href="boards/esp32_s3_touch_lcd_7/">Board definition</a> · <a href="https://docs.waveshare.com/ESP32-S3-Touch-LCD-7">Product documentation</a></p>
+    </td>
+  </tr>
+</table>
+
 The table lists definitions present in this repository. Peripheral declarations
 such as `spi_sd` describe a bus; they do not imply a complete storage application.
 
diff --git a/README_ZH.md b/README_ZH.md
index 7eff548..283d2a4 100644
--- a/README_ZH.md
+++ b/README_ZH.md
@@ -23,6 +23,43 @@
 
 ## 📋 板卡目录
 
+产品图片来自微雪官方产品仓库。点击下方链接查看板卡定义或产品文档。
+
+<table>
+  <tr>
+    <td align="center" valign="top" width="50%">
+      <p><strong>ESP32-S3-Touch-AMOLED-1.75C</strong></p>
+      <a href="https://docs.waveshare.com/ESP32-S3-Touch-AMOLED-1.75C">
+        <img src="https://raw.githubusercontent.com/waveshareteam/ESP32-S3-Touch-AMOLED-1.75C/6d19f7e16fb9a3be219e9eed43ca9eb56c88d01c/docs/images/esp32-s3-touch-amoled-1.75c.jpg" alt="ESP32-S3-Touch-AMOLED-1.75C 开发板产品图" width="360">
+      </a>
+      <p><a href="boards/esp32_s3_touch_amoled_1_75c/">板卡定义</a> · <a href="https://docs.waveshare.com/ESP32-S3-Touch-AMOLED-1.75C">产品文档</a></p>
+    </td>
+    <td align="center" valign="top" width="50%">
+      <p><strong>ESP32-S3-Touch-AMOLED-1.8</strong></p>
+      <a href="https://docs.waveshare.com/ESP32-S3-Touch-AMOLED-1.8">
+        <img src="https://raw.githubusercontent.com/waveshareteam/ESP32-S3-Touch-AMOLED-1.8/7ab8f957e22ea1ab811256359f4eddcaaf49ee91/assets/ESP32-S3-Touch-AMOLED-1.8-hero.webp" alt="ESP32-S3-Touch-AMOLED-1.8 开发板产品图" width="360">
+      </a>
+      <p><a href="boards/esp32_s3_touch_amoled_1_8/">板卡定义</a> · <a href="https://docs.waveshare.com/ESP32-S3-Touch-AMOLED-1.8">产品文档</a></p>
+    </td>
+  </tr>
+  <tr>
+    <td align="center" valign="top" width="50%">
+      <p><strong>ESP32-S3-Touch-AMOLED-2.16</strong></p>
+      <a href="https://docs.waveshare.com/ESP32-S3-Touch-AMOLED-2.16">
+        <img src="https://raw.githubusercontent.com/waveshareteam/ESP32-S3-Touch-AMOLED-2.16/225a62bff11b5d0a0b607873860d39485a9a9685/docs/assets/ESP32-S3-Touch-AMOLED-2.16-details-1.jpg" alt="ESP32-S3-Touch-AMOLED-2.16 开发板产品图" width="360">
+      </a>
+      <p><a href="boards/esp32_s3_touch_amoled_2_16/">板卡定义</a> · <a href="https://docs.waveshare.com/ESP32-S3-Touch-AMOLED-2.16">产品文档</a></p>
+    </td>
+    <td align="center" valign="top" width="50%">
+      <p><strong>ESP32-S3-Touch-LCD-7</strong></p>
+      <a href="https://docs.waveshare.com/ESP32-S3-Touch-LCD-7">
+        <img src="https://raw.githubusercontent.com/waveshareteam/ESP32-S3-Touch-LCD-7/bc51a84b30c0cea018fee6e0d7427ec10102060e/assets/Product-1.webp" alt="ESP32-S3-Touch-LCD-7 开发板产品图" width="360">
+      </a>
+      <p><a href="boards/esp32_s3_touch_lcd_7/">板卡定义</a> · <a href="https://docs.waveshare.com/ESP32-S3-Touch-LCD-7">产品文档</a></p>
+    </td>
+  </tr>
+</table>
+
 下表列出仓库中实际存在的定义。`spi_sd` 等外设声明描述的是总线，
 不代表已经提供完整的存储应用。
 

From cd09c94ebb0e649de9913655af367ebe2c2a07f1 Mon Sep 17 00:00:00 2001
From: Y1hsiaochunnn <66012385+Y1hsiaochunnn@users.noreply.github.com>
Date: Tue, 8 Sep 2026 12:02:15 +0800
Subject: [PATCH 2/2] docs: refine board catalog layout

---
 README.md    | 52 +++++++++++++++++++++++++++++++++-------------------
 README_ZH.md | 51 +++++++++++++++++++++++++++++++++------------------
 2 files changed, 66 insertions(+), 37 deletions(-)

diff --git a/README.md b/README.md
index 88577c6..e1c7113 100644
--- a/README.md
+++ b/README.md
@@ -24,44 +24,56 @@ bilingual documentation, and generation/build checks.
 
 ## 📋 Board catalog
 
-Product images from Waveshare’s official product repositories. Follow the links
-below for board definitions and product documentation.
-
 <table>
   <tr>
-    <td align="center" valign="top" width="50%">
-      <p><strong>ESP32-S3-Touch-AMOLED-1.75C</strong></p>
+    <td align="center" valign="middle" width="180">
       <a href="https://docs.waveshare.com/ESP32-S3-Touch-AMOLED-1.75C">
-        <img src="https://raw.githubusercontent.com/waveshareteam/ESP32-S3-Touch-AMOLED-1.75C/6d19f7e16fb9a3be219e9eed43ca9eb56c88d01c/docs/images/esp32-s3-touch-amoled-1.75c.jpg" alt="ESP32-S3-Touch-AMOLED-1.75C development board" width="360">
+        <img src="https://raw.githubusercontent.com/waveshareteam/ESP32-S3-Touch-AMOLED-1.75C/6d19f7e16fb9a3be219e9eed43ca9eb56c88d01c/docs/images/esp32-s3-touch-amoled-1.75c.jpg" alt="ESP32-S3-Touch-AMOLED-1.75C development board" width="160">
       </a>
-      <p><a href="boards/esp32_s3_touch_amoled_1_75c/">Board definition</a> · <a href="https://docs.waveshare.com/ESP32-S3-Touch-AMOLED-1.75C">Product documentation</a></p>
     </td>
-    <td align="center" valign="top" width="50%">
-      <p><strong>ESP32-S3-Touch-AMOLED-1.8</strong></p>
+    <td valign="middle" width="600">
+      <p><strong>ESP32-S3-Touch-AMOLED-1.75C</strong></p>
+      <a href="boards/esp32_s3_touch_amoled_1_75c/">Board definition</a> · <a href="https://docs.waveshare.com/ESP32-S3-Touch-AMOLED-1.75C">Product documentation</a>
+    </td>
+  </tr>
+  <tr>
+    <td align="center" valign="middle" width="180">
       <a href="https://docs.waveshare.com/ESP32-S3-Touch-AMOLED-1.8">
-        <img src="https://raw.githubusercontent.com/waveshareteam/ESP32-S3-Touch-AMOLED-1.8/7ab8f957e22ea1ab811256359f4eddcaaf49ee91/assets/ESP32-S3-Touch-AMOLED-1.8-hero.webp" alt="ESP32-S3-Touch-AMOLED-1.8 development board" width="360">
+        <img src="https://raw.githubusercontent.com/waveshareteam/ESP32-S3-Touch-AMOLED-1.8/7ab8f957e22ea1ab811256359f4eddcaaf49ee91/assets/ESP32-S3-Touch-AMOLED-1.8-hero.webp" alt="ESP32-S3-Touch-AMOLED-1.8 development board" width="160">
       </a>
-      <p><a href="boards/esp32_s3_touch_amoled_1_8/">Board definition</a> · <a href="https://docs.waveshare.com/ESP32-S3-Touch-AMOLED-1.8">Product documentation</a></p>
+    </td>
+    <td valign="middle" width="600">
+      <p><strong>ESP32-S3-Touch-AMOLED-1.8</strong></p>
+      <a href="boards/esp32_s3_touch_amoled_1_8/">Board definition</a> · <a href="https://docs.waveshare.com/ESP32-S3-Touch-AMOLED-1.8">Product documentation</a>
     </td>
   </tr>
   <tr>
-    <td align="center" valign="top" width="50%">
-      <p><strong>ESP32-S3-Touch-AMOLED-2.16</strong></p>
+    <td align="center" valign="middle" width="180">
       <a href="https://docs.waveshare.com/ESP32-S3-Touch-AMOLED-2.16">
-        <img src="https://raw.githubusercontent.com/waveshareteam/ESP32-S3-Touch-AMOLED-2.16/225a62bff11b5d0a0b607873860d39485a9a9685/docs/assets/ESP32-S3-Touch-AMOLED-2.16-details-1.jpg" alt="ESP32-S3-Touch-AMOLED-2.16 development board" width="360">
+        <img src="https://raw.githubusercontent.com/waveshareteam/ESP32-S3-Touch-AMOLED-2.16/225a62bff11b5d0a0b607873860d39485a9a9685/docs/assets/ESP32-S3-Touch-AMOLED-2.16-details-1.jpg" alt="ESP32-S3-Touch-AMOLED-2.16 development board" width="160">
       </a>
-      <p><a href="boards/esp32_s3_touch_amoled_2_16/">Board definition</a> · <a href="https://docs.waveshare.com/ESP32-S3-Touch-AMOLED-2.16">Product documentation</a></p>
     </td>
-    <td align="center" valign="top" width="50%">
-      <p><strong>ESP32-S3-Touch-LCD-7</strong></p>
+    <td valign="middle" width="600">
+      <p><strong>ESP32-S3-Touch-AMOLED-2.16</strong></p>
+      <a href="boards/esp32_s3_touch_amoled_2_16/">Board definition</a> · <a href="https://docs.waveshare.com/ESP32-S3-Touch-AMOLED-2.16">Product documentation</a>
+    </td>
+  </tr>
+  <tr>
+    <td align="center" valign="middle" width="180">
       <a href="https://docs.waveshare.com/ESP32-S3-Touch-LCD-7">
-        <img src="https://raw.githubusercontent.com/waveshareteam/ESP32-S3-Touch-LCD-7/bc51a84b30c0cea018fee6e0d7427ec10102060e/assets/Product-1.webp" alt="ESP32-S3-Touch-LCD-7 development board" width="360">
+        <img src="https://raw.githubusercontent.com/waveshareteam/ESP32-S3-Touch-LCD-7/bc51a84b30c0cea018fee6e0d7427ec10102060e/assets/Product-1.webp" alt="ESP32-S3-Touch-LCD-7 development board" width="160">
       </a>
-      <p><a href="boards/esp32_s3_touch_lcd_7/">Board definition</a> · <a href="https://docs.waveshare.com/ESP32-S3-Touch-LCD-7">Product documentation</a></p>
+    </td>
+    <td valign="middle" width="600">
+      <p><strong>ESP32-S3-Touch-LCD-7</strong></p>
+      <a href="boards/esp32_s3_touch_lcd_7/">Board definition</a> · <a href="https://docs.waveshare.com/ESP32-S3-Touch-LCD-7">Product documentation</a>
     </td>
   </tr>
 </table>
 
+<details>
+<summary>Device and peripheral definitions</summary>
+
 The table lists definitions present in this repository. Peripheral declarations
 such as `spi_sd` describe a bus; they do not imply a complete storage application.
 
@@ -74,6 +86,8 @@ such as `spi_sd` describe a bus; they do not imply a complete storage applicatio
 | [`esp32_s3_touch_lcd_7`](boards/esp32_s3_touch_lcd_7/) | ESP32-S3 | `display_lcd`, `lcd_touch` | `i2c_master`, `uart_rs485`, `uart_external`, `adc_sensor`, `spi_sd` |
 <!-- END SUPPORTED_BOARDS -->
 
+</details>
+
 Definitions live under `boards/<full_model>/`. The three AMOLED profiles come
 from Espressif Brookesia; see [board revisions and migration notes](docs/BOARDS.md).
 CI validates generation and compilation; physical operation requires board testing.
diff --git a/README_ZH.md b/README_ZH.md
index 283d2a4..4cf10a9 100644
--- a/README_ZH.md
+++ b/README_ZH.md
@@ -23,43 +23,56 @@
 
 ## 📋 板卡目录
 
-产品图片来自微雪官方产品仓库。点击下方链接查看板卡定义或产品文档。
-
 <table>
   <tr>
-    <td align="center" valign="top" width="50%">
-      <p><strong>ESP32-S3-Touch-AMOLED-1.75C</strong></p>
+    <td align="center" valign="middle" width="180">
       <a href="https://docs.waveshare.com/ESP32-S3-Touch-AMOLED-1.75C">
-        <img src="https://raw.githubusercontent.com/waveshareteam/ESP32-S3-Touch-AMOLED-1.75C/6d19f7e16fb9a3be219e9eed43ca9eb56c88d01c/docs/images/esp32-s3-touch-amoled-1.75c.jpg" alt="ESP32-S3-Touch-AMOLED-1.75C 开发板产品图" width="360">
+        <img src="https://raw.githubusercontent.com/waveshareteam/ESP32-S3-Touch-AMOLED-1.75C/6d19f7e16fb9a3be219e9eed43ca9eb56c88d01c/docs/images/esp32-s3-touch-amoled-1.75c.jpg" alt="ESP32-S3-Touch-AMOLED-1.75C 开发板产品图" width="160">
       </a>
-      <p><a href="boards/esp32_s3_touch_amoled_1_75c/">板卡定义</a> · <a href="https://docs.waveshare.com/ESP32-S3-Touch-AMOLED-1.75C">产品文档</a></p>
     </td>
-    <td align="center" valign="top" width="50%">
-      <p><strong>ESP32-S3-Touch-AMOLED-1.8</strong></p>
+    <td valign="middle" width="600">
+      <p><strong>ESP32-S3-Touch-AMOLED-1.75C</strong></p>
+      <a href="boards/esp32_s3_touch_amoled_1_75c/">板卡定义</a> · <a href="https://docs.waveshare.com/ESP32-S3-Touch-AMOLED-1.75C">产品文档</a>
+    </td>
+  </tr>
+  <tr>
+    <td align="center" valign="middle" width="180">
       <a href="https://docs.waveshare.com/ESP32-S3-Touch-AMOLED-1.8">
-        <img src="https://raw.githubusercontent.com/waveshareteam/ESP32-S3-Touch-AMOLED-1.8/7ab8f957e22ea1ab811256359f4eddcaaf49ee91/assets/ESP32-S3-Touch-AMOLED-1.8-hero.webp" alt="ESP32-S3-Touch-AMOLED-1.8 开发板产品图" width="360">
+        <img src="https://raw.githubusercontent.com/waveshareteam/ESP32-S3-Touch-AMOLED-1.8/7ab8f957e22ea1ab811256359f4eddcaaf49ee91/assets/ESP32-S3-Touch-AMOLED-1.8-hero.webp" alt="ESP32-S3-Touch-AMOLED-1.8 开发板产品图" width="160">
       </a>
-      <p><a href="boards/esp32_s3_touch_amoled_1_8/">板卡定义</a> · <a href="https://docs.waveshare.com/ESP32-S3-Touch-AMOLED-1.8">产品文档</a></p>
+    </td>
+    <td valign="middle" width="600">
+      <p><strong>ESP32-S3-Touch-AMOLED-1.8</strong></p>
+      <a href="boards/esp32_s3_touch_amoled_1_8/">板卡定义</a> · <a href="https://docs.waveshare.com/ESP32-S3-Touch-AMOLED-1.8">产品文档</a>
     </td>
   </tr>
   <tr>
-    <td align="center" valign="top" width="50%">
-      <p><strong>ESP32-S3-Touch-AMOLED-2.16</strong></p>
+    <td align="center" valign="middle" width="180">
       <a href="https://docs.waveshare.com/ESP32-S3-Touch-AMOLED-2.16">
-        <img src="https://raw.githubusercontent.com/waveshareteam/ESP32-S3-Touch-AMOLED-2.16/225a62bff11b5d0a0b607873860d39485a9a9685/docs/assets/ESP32-S3-Touch-AMOLED-2.16-details-1.jpg" alt="ESP32-S3-Touch-AMOLED-2.16 开发板产品图" width="360">
+        <img src="https://raw.githubusercontent.com/waveshareteam/ESP32-S3-Touch-AMOLED-2.16/225a62bff11b5d0a0b607873860d39485a9a9685/docs/assets/ESP32-S3-Touch-AMOLED-2.16-details-1.jpg" alt="ESP32-S3-Touch-AMOLED-2.16 开发板产品图" width="160">
       </a>
-      <p><a href="boards/esp32_s3_touch_amoled_2_16/">板卡定义</a> · <a href="https://docs.waveshare.com/ESP32-S3-Touch-AMOLED-2.16">产品文档</a></p>
     </td>
-    <td align="center" valign="top" width="50%">
-      <p><strong>ESP32-S3-Touch-LCD-7</strong></p>
+    <td valign="middle" width="600">
+      <p><strong>ESP32-S3-Touch-AMOLED-2.16</strong></p>
+      <a href="boards/esp32_s3_touch_amoled_2_16/">板卡定义</a> · <a href="https://docs.waveshare.com/ESP32-S3-Touch-AMOLED-2.16">产品文档</a>
+    </td>
+  </tr>
+  <tr>
+    <td align="center" valign="middle" width="180">
       <a href="https://docs.waveshare.com/ESP32-S3-Touch-LCD-7">
-        <img src="https://raw.githubusercontent.com/waveshareteam/ESP32-S3-Touch-LCD-7/bc51a84b30c0cea018fee6e0d7427ec10102060e/assets/Product-1.webp" alt="ESP32-S3-Touch-LCD-7 开发板产品图" width="360">
+        <img src="https://raw.githubusercontent.com/waveshareteam/ESP32-S3-Touch-LCD-7/bc51a84b30c0cea018fee6e0d7427ec10102060e/assets/Product-1.webp" alt="ESP32-S3-Touch-LCD-7 开发板产品图" width="160">
       </a>
-      <p><a href="boards/esp32_s3_touch_lcd_7/">板卡定义</a> · <a href="https://docs.waveshare.com/ESP32-S3-Touch-LCD-7">产品文档</a></p>
+    </td>
+    <td valign="middle" width="600">
+      <p><strong>ESP32-S3-Touch-LCD-7</strong></p>
+      <a href="boards/esp32_s3_touch_lcd_7/">板卡定义</a> · <a href="https://docs.waveshare.com/ESP32-S3-Touch-LCD-7">产品文档</a>
     </td>
   </tr>
 </table>
 
+<details>
+<summary>设备与外设定义</summary>
+
 下表列出仓库中实际存在的定义。`spi_sd` 等外设声明描述的是总线，
 不代表已经提供完整的存储应用。
 
@@ -72,6 +85,8 @@
 | [`esp32_s3_touch_lcd_7`](boards/esp32_s3_touch_lcd_7/) | ESP32-S3 | `display_lcd`, `lcd_touch` | `i2c_master`, `uart_rs485`, `uart_external`, `adc_sensor`, `spi_sd` |
 <!-- END SUPPORTED_BOARDS -->
 
+</details>
+
 板卡定义统一放在 `boards/<完整型号>/`。新增的三个 AMOLED 型号来自 Espressif Brookesia，
 详见[硬件版本与迁移说明](docs/BOARDS_ZH.md)。CI 校验生成与编译，实机运行效果需要单独测试。