English | 简体中文

文档仓库

本仓库是 RDK S100 / S600 开发文档站点源码，基于 Docusaurus 构建，包含中文主文档、英文文档翻译、站点主题定制、文档范围过滤（Doc Scope）和自动化发布流程。

环境准备

• Node.js：>= 18
• 包管理：npm

# 日常开发快速安装（会按 semver 更新依赖）
npm install

维护常用命令

内容与结构维护

# 生成侧边栏范围配置（Doc Scope）
npm run generate-sidebar-config

# 开发时监听文档变化，自动更新侧边栏范围配置
npm run watch-sidebar-config

本地运行

# 中文开发模式（包含侧边栏配置监听）
npm run start

# 英文开发模式（包含侧边栏配置监听）
npm run start:en

# 中文开发模式，使用 3001 端口
npm run start:port

# 中文开发模式（不启动监听）
npm run start:no-watch

# 英文开发模式（不启动监听）
npm run start:no-watch:en

# 清理 Docusaurus 缓存
npm run clear

构建与产物验证

# 标准全量构建
npm run build

# 本地预览 build 目录
npm run serve

# 指定 host 和 port 预览（示例）
npm run serve -- --host=10.64.62.34 --port=1688 --no-open

常见访问路径（端口以实际 serve 输出为准）：

• 英文：http://localhost:3000/en/rdk_s_doc/RDK
• 中文：http://localhost:3000/rdk_s_doc/RDK