跳到主要内容

10.1HP-CAPQLED-B 中文 Wiki 设计

目标​

在中文文档站点的 HDMI 显示屏目录中新增 10.1HP-CAPQLED-B 产品文档。文档采用当前 Docusaurus 页面结构，以 B 版商城资料、专用图纸和本地产品图片为准；旧版 10.1HP-CAPQLED Wiki 仅用于参考仍适用的使用方法。

同批更新 7inch 1080x1080 LCD 的三条结构图纸链接。

页面与目录​

新建目录：

docs/Displays/LCD/HDMI/10.1HP-CAPQLED-B/

目录包含：

  • Product-Overview.md
  • User-Guide-Rpi.md
  • User-Guide-PC.md
  • FAQ.md
  • Resources-And-Documents.md
  • Technical-Support.md
  • _category_.json
  • images/

HDMI 导航使用自动生成方式，因此通过 _category_.json 增加产品分类，页面顺序与现有 HDMI 产品保持一致，不修改 sidebars.js。

内容来源与取舍​

B 版产品资料​

产品型号、SKU 和硬件参数以 10.1HP-CAPQLED-B 商城页为准。已确认信息包括：

  • SKU：35248
  • 10.1 英寸 IPS QLED 显示面板
  • 硬件分辨率：1280 × 720
  • 10 点电容触控
  • G+G 钢化玻璃面板
  • 亮度：350 cd/m²
  • HDMI 显示接口
  • Micro USB 触摸接口
  • 3.5 mm 耳机接口和 4PIN 音频接口
  • 支持 DDC/CI 亮度调节

尺寸、接口布局等图示信息以 B 版图片和专用图纸为准，不沿用旧款数据。

参考 Wiki​

旧版 10.1HP-CAPQLED Wiki 只用于参考 Raspberry Pi 和 Windows PC 的连接逻辑。Jetson Nano、旭日 X3 派、PWM 改装和长按右键内容不纳入新文档。

本地图片​

从 F:\Desktop\照片\10.1HP-CAPQLED-B 复制以下 WebP 图片，并在页面中使用相对路径：

  • 产品主图
  • Raspberry Pi 和 PC 连接示意图
  • 接口介绍图
  • 产品尺寸图

图片文件名保持可读、稳定；不重复保存用途相同的图片。Markdown 图片提供准确的中文替代文本。

页面设计​

产品概述​

包括产品主图与商城链接、SKU 表、产品特点、规格参数、接口介绍和外观尺寸。产品特点使用技术性陈述，不复制商城营销措辞。

Raspberry Pi 使用​

包括硬件连接、Raspberry Pi OS 使用说明、显示与触摸检查，以及确有必要的分辨率或旋转设置。教程覆盖当前 Raspberry Pi OS，并避免沿用只适用于旧系统的配置。

Windows PC 使用​

包括电源、HDMI、Micro USB 触摸连接，Windows 自动识别触摸设备，多显示器环境中的触摸映射，以及 HDMI 音频输出说明。

FAQ​

收录与该显示屏直接相关且仍适用的问题：

  • Squeekboard 虚拟键盘的自动弹出、手动显示和关闭方法。
  • Raspberry Pi OS Trixie 更换 Plymouth 启动 Logo 的依赖安装、图片替换路径和重启步骤。
  • 显示、触摸、多显示器或休眠相关的必要排查项。

不收录旧款 PWM 硬件改装和过时的长按右键方案。

资源与文档​

加入以下 B 版专用图纸：

  • https://files.waveshare.com/wiki/10.1HP-CAPQLED-B/10.1HP-CAPQLED-B-20260721.pdf
  • https://files.waveshare.com/wiki/10.1HP-CAPQLED-B/10.1HP-CAPQLED-B-20260721.dxf.zip
  • https://files.waveshare.com/wiki/10.1HP-CAPQLED-B/10.1HP-CAPQLED-B_3d-20260721.stp.zip

同时列出必要的官方系统或工具入口，不添加旧款专用图纸。

技术支持​

沿用当前站点统一的技术支持页面结构和联系方式，不复制旧 Wiki 的个人售后联系人信息。

7inch 1080x1080 LCD 图纸更新​

该产品目前没有资源页面，因此新增 Resources-And-Documents.md，并加入以下图纸：

  • https://files.waveshare.com/wiki/7inch%201080x1080%20LCD/7inch%201080x1080%20LCD-20260721.pdf
  • https://files.waveshare.com/wiki/7inch%201080x1080%20LCD/7inch%201080x1080%20LCD-DXF.zip
  • https://files.waveshare.com/wiki/7inch%201080x1080%20LCD/7inch%201080x1080%20LCD-STP.zip

仅修改图纸链接及必要的链接文本，不改写该产品的其他内容。

格式与验证​

  • 遵守 Docusaurus Strict MDX 和中文写作规范。
  • 图片统一使用 Markdown 语法，不使用 <img>。
  • 新增标题锚点使用英文 ID。
  • 检查所有相对图片路径和外部链接。
  • 运行仓库 Markdown 检查、格式检查和 Docusaurus 构建。
  • 检查 Git 差异，确认未改动无关文件。

完成标准​

  • HDMI 导航中可访问 10.1HP-CAPQLED-B 的完整六页文档。
  • 页面参数和图片均对应 B 版。
  • Raspberry Pi 与 Windows PC 教程可按步骤执行。
  • FAQ 包含确认的新系统内容，不含已排除的旧方案。
  • 两款产品的图纸链接均指向指定文件。
  • 本地构建通过。