Merge branch 'docusaurus-version' into docusaurus-version

Author: nfs0619

docusaurus.config.js

@@ -0,0 +1,6 @@
+module.exports = {
+  title: 'Serve Build',
+  url: 'https://wiki.seeedstudio.com',
+  baseUrl: '/',
+  favicon: 'img/favicon.ico',
+};

package.json

@@ -28,8 +28,8 @@
     "typecheck": "tsc",
     "generatewiki": "node scripts/generateWiki.js",
     "generate-lang-map": "node scripts/generate-language-map.js",
+    "generate-jetson-config": "node scripts/generate-jetson-config.js",
     "normalize-frontmatter": "node scripts/normalize-frontmatter.js"
-
   },
   "dependencies": {
     "@ant-design/icons": "^5.4.0",

scripts/generate-jetson-config.js

@@ -0,0 +1,269 @@
+#!/usr/bin/env node
+
+const fs = require('fs');
+const path = require('path');
+
+// 定义要搜索的多语言目录
+const APP_DIRS = {
+  en: 'sites/en/docs/Edge/NVIDIA_Jetson/Application',
+  zh: 'sites/zh-CN/docs/Edge/NVIDIA_Jetson/Application',
+  ja: 'sites/ja/docs/Edge/NVIDIA_Jetson/Application',
+  es: 'sites/es/docs/Edge/NVIDIA_Jetson/Application'
+};
+
+// 站点语言前缀
+const LANG_URL_PREFIX = {
+  en: '',
+  zh: '/cn',
+  ja: '/ja',
+  es: '/es'
+};
+
+// 定义分类映射（目录名 -> 配置变量名）
+const CATEGORY_MAPPING = {
+  'Computer_Vision': 'communityList_cv',
+  'Generative_AI': 'communityList_gen',
+  'Robotics': 'communityList_robot',
+  'Developer_Tools': 'developerToolsList',
+  'Multimodal_AI': 'multimodalList',
+  'Physical_AI': 'physicalAIList',
+  'Managed_Services': 'managedServicesList'
+};
+
+// 存储提取的数据（按分类）
+const data = {
+  communityList_cv: [],
+  communityList_gen: [],
+  communityList_robot: [],
+  developerToolsList: [],
+  multimodalList: [],
+  physicalAIList: [],
+  managedServicesList: []
+};
+
+// 用于跨语言聚合同一项目
+const projectMap = {
+  communityList_cv: new Map(),
+  communityList_gen: new Map(),
+  communityList_robot: new Map(),
+  developerToolsList: new Map(),
+  multimodalList: new Map(),
+  physicalAIList: new Map(),
+  managedServicesList: new Map()
+};
+
+// 遍历目录提取数据
+function extractData() {
+  Object.entries(APP_DIRS).forEach(([lang, dir]) => {
+    if (!fs.existsSync(dir)) {
+      console.warn(`[WARN] Directory not found for ${lang}: ${dir}`);
+      return;
+    }
+
+    fs.readdirSync(dir, { withFileTypes: true }).forEach(categoryDir => {
+      if (!categoryDir.isDirectory()) return;
+
+      const category = categoryDir.name;
+      const categoryKey = CATEGORY_MAPPING[category] || 'communityList_cv';
+      const categoryPath = path.join(dir, category);
+
+      fs.readdirSync(categoryPath, { withFileTypes: true }).forEach(file => {
+        if (!file.isFile() || !(file.name.endsWith('.md') || file.name.endsWith('.mdx'))) {
+          return;
+        }
+
+        const filePath = path.join(categoryPath, file.name);
+        const content = fs.readFileSync(filePath, 'utf8');
+
+        const project = extractProjectInfo(content, filePath, lang);
+        if (!project) return;
+
+        const map = projectMap[categoryKey];
+        const mergeKey = project.mergeKey;
+
+        if (!map.has(mergeKey)) {
+          map.set(mergeKey, {
+            name: {},
+            img: project.img,
+            URL: {},
+            category: {},
+            lastUpdated: project.lastUpdated,
+            author: project.author
+          });
+        }
+
+        const existing = map.get(mergeKey);
+
+        existing.name[lang] = project.name;
+        existing.URL[lang] = project.URL;
+        existing.category[lang] = project.category;
+
+        if (!existing.img && project.img) {
+          existing.img = project.img;
+        }
+
+        if (lang === 'en' || !existing.lastUpdated) {
+          existing.lastUpdated = project.lastUpdated;
+        }
+
+        if (lang === 'en' || !existing.author) {
+          existing.author = project.author;
+        }
+      });
+    });
+  });
+
+  Object.keys(projectMap).forEach(categoryKey => {
+    data[categoryKey] = Array.from(projectMap[categoryKey].values());
+  });
+}
+
+// 从文件内容中提取项目信息
+function extractProjectInfo(content, filePath, lang) {
+  // 提取 frontmatter
+  const frontmatterMatch = content.match(/^---\s*\n([\s\S]*?)\n---/);
+  const frontmatter = frontmatterMatch ? frontmatterMatch[1] : '';
+
+  // 提取标题（优先从 frontmatter 的 title 字段，否则从正文）
+  const titleMatch = frontmatter.match(/^title:\s*(.*)$/m) || content.match(/^#\s+(.*)$/m);
+  if (!titleMatch) return null;
+
+  const name = cleanValue(titleMatch[1]);
+
+  // 提取图片（优先从 frontmatter 的 image 字段）
+  let img = 'https://files.seeedstudio.com/wiki/reComputer-Jetson/default-project.png';
+  const frontmatterImgMatch = frontmatter.match(/^image:\s*(.*)$/m);
+
+  if (frontmatterImgMatch) {
+    img = cleanValue(frontmatterImgMatch[1]);
+
+    // 如果是临时图片，寻找文档中的首个真实图片
+    if (img === 'https://files.seeedstudio.com/wiki/wiki-platform/S-tempor.png') {
+      const markdownImgMatch = content.match(/!\[.*?\]\((.*?\.(jpg|jpeg|png|webp|gif))\)/i);
+      const htmlImgMatch = content.match(/<img[^>]+src=["']([^"']*?\.(jpg|jpeg|png|webp|gif))["']?[^>]*>/is);
+      const htmlImgMatchMultiline = content.match(/<img[^>]*src=["']([^"']*?\.(jpg|jpeg|png|webp|gif))["']?[^>]*>/is);
+
+      if (markdownImgMatch && markdownImgMatch[1] !== img) {
+        img = markdownImgMatch[1];
+      } else if (htmlImgMatch && htmlImgMatch[1] !== img) {
+        img = htmlImgMatch[1].replace(/\s+/g, '');
+      } else if (htmlImgMatchMultiline && htmlImgMatchMultiline[1] !== img) {
+        img = htmlImgMatchMultiline[1].replace(/\s+/g, '');
+      }
+    }
+  } else {
+    const markdownImgMatch = content.match(/!\[.*?\]\((.*?)\)/);
+    const htmlImgMatch = content.match(/<img[^>]+src=["']([^"']+)["'][^>]*>/i);
+
+    if (markdownImgMatch) {
+      img = markdownImgMatch[1];
+    } else if (htmlImgMatch) {
+      img = htmlImgMatch[1].replace(/\s+/g, '');
+    }
+  }
+
+  // 生成 URL（所有语言 slug 相同，靠站点前缀区分）
+  let slug = '';
+  const slugMatch = frontmatter.match(/^slug:\s*(.*)$/m);
+
+  if (slugMatch) {
+    slug = cleanSlug(slugMatch[1]);
+  } else {
+    slug = buildSlugFromFilePath(filePath, lang);
+  }
+
+  const URL = `https://wiki.seeedstudio.com${LANG_URL_PREFIX[lang]}${slug}`;
+  const mergeKey = slug;
+
+  // 提取分类标签
+  const categoryMatch = content.match(/categories:\s*\[(.*?)\]/s);
+  const categoryArray = categoryMatch
+    ? categoryMatch[1]
+        .split(',')
+        .map(c => c.trim().replace(/['"]/g, ''))
+        .filter(Boolean)
+    : [];
+
+  // 提取最后更新时间
+  const dateMatch =
+    frontmatter.match(/last_update:\s*\n\s*date:\s*(.*)/) ||
+    content.match(/lastUpdated:\s*(.*)/);
+
+  const lastUpdated = dateMatch ? cleanValue(dateMatch[1]) : new Date().toLocaleDateString();
+
+  // 提取作者
+  const authorMatch =
+    frontmatter.match(/last_update:\s*\n[\s\S]*?author:\s*(.*)/) ||
+    content.match(/author:\s*(.*)/);
+
+  const author = authorMatch ? cleanValue(authorMatch[1]) : 'Seeed Studio';
+
+  return {
+    mergeKey,
+    name,
+    img,
+    URL,
+    category: categoryArray,
+    lastUpdated,
+    author
+  };
+}
+
+function cleanValue(value) {
+  return String(value || '')
+    .trim()
+    .replace(/^['"]|['"]$/g, '');
+}
+
+function cleanSlug(value) {
+  const slug = cleanValue(value);
+  if (!slug) return '';
+  return slug.startsWith('/') ? slug : `/${slug}`;
+}
+
+// 当没有 slug 时，从文件名推导 slug
+function buildSlugFromFilePath(filePath, lang) {
+  const normalized = filePath.replace(/\\/g, '/');
+  const baseDir = APP_DIRS[lang].replace(/\\/g, '/');
+
+  let relativePath = normalized.replace(`${baseDir}/`, '').replace(/\.mdx?$/, '');
+
+  // 只取文件名作为 slug，避免把 docs 目录路径带进 URL
+  const fileName = path.basename(relativePath);
+  return `/${fileName}`;
+}
+
+// 生成配置文件
+function generateConfig() {
+  let output = `// Auto-generated by generate-jetson-config.js
+// DO NOT EDIT MANUALLY - Run "node scripts/generate-jetson-config.js" to regenerate
+// Generated at: ${new Date().toISOString()}\n\n`;
+
+  Object.entries(data).forEach(([key, projects]) => {
+    output += `export const ${key} = [\n`;
+    projects.forEach((project, index) => {
+      const jsonStr = JSON.stringify(project, null, 2);
+      const indentedStr = jsonStr.split('\n').map(line => '  ' + line).join('\n');
+      output += indentedStr;
+      if (index < projects.length - 1) {
+        output += ',\n';
+      }
+    });
+    output += '\n]\n\n';
+  });
+
+  const outputPath = path.join(__dirname, '../src/components/jetson/config.auto.js');
+  fs.writeFileSync(outputPath, output);
+  console.log(`Generated config.auto.js at ${outputPath}`);
+  console.log(`Total projects extracted: ${Object.values(data).reduce((sum, arr) => sum + arr.length, 0)}`);
+}
+
+// 执行提取和生成
+if (require.main === module) {
+  console.log('Extracting Jetson project data...');
+  extractData();
+  generateConfig();
+  console.log('Done!');
+}
+
+module.exports = { extractData, generateConfig };

sites/en/docs/Sensor/reSpeaker_XVF3800_USB_4_Mic_Array/respeaker_xvf3800_usb_4_mic_array.md

@@ -9,8 +9,8 @@ sku: 101991441,114993701
 last_update:
   date: 11/10/2025
   author: Kasun Thushara
-createdAt: '2023-08-20'
-updatedAt: '2026-03-03'
+createdAt: '2025-08-20'
+updatedAt: '2026-03-06'
 url: https://wiki.seeedstudio.com/respeaker_xvf3800_introduction/
 ---
 
@@ -192,24 +192,71 @@ Each type of firmware on the ReSpeaker XVF3800 supports different update methods
 
 ### Update Firmware
 
-Connect the reSpeaker XVF3800 to your PC via the USB cable. Note that you need to use the XMOS USB-C port(close to 3.5mm jack port) to flash XMOS’s firmware.
+Three firmware versions are available in the official GitHub repository. You can choose and flash the appropriate firmware depending on your application requirements. For more details and downloads, please refer to the [Github Link](https://github.com/respeaker/reSpeaker_XVF3800_USB_4MIC_ARRAY)
+
+:::note 
+Please make sure that you will need to download whole repository. 
+:::
+
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+<Tabs>
+<TabItem value="USB" label="USB">
+
+The USB firmware is designed for use with host operating systems such as **Windows, Linux, and macOS** when communicating through the USB hardware interface.
+
+Two firmware variants are available: **respeaker_xvf3800_usb_dfu_firmware_v2.0.x.bin**, which provides **2-channel** audio, and **respeaker_xvf3800_usb_dfu_firmware_6chl_v2.0.x.bin**, which provides **6-channel** audio. Both firmware versions operate at a **16 kHz** sampling rate with **32-bit** depth.
+
+You can explore these firmware files in [this link](https://github.com/respeaker/reSpeaker_XVF3800_USB_4MIC_ARRAY/tree/master/xmos_firmwares/usb)
+
+
 
 | Firmware | Channels | Notes |
 |---------|----------|-------|
 | respeaker_xvf3800_usb_dfu_firmware_v2.0.x.bin | 2 | Processed 2-channel output <br /> Channel 0: Conference <br /> Channel 1: ASR |
 | respeaker_xvf3800_usb_dfu_firmware_6chl_v2.0.x.bin | 6 | Channel 0: Processed audio (Conference) <br /> Channel 1: Processed audio (ASR) <br /> Channel 2: Mic 0 raw data <br /> Channel 3: Mic 1 raw data <br /> Channel 4: Mic 2 raw data <br /> Channel 5: Mic 3 raw data |
+
+
+</TabItem>
+
+ <TabItem value="I2S" label="I2S">
+
+The I2S firmware is intended for use when the device is connected to a microcontroller host such as the **XIAO ESP32S3**. In this configuration, voice data is transmitted using the I2S protocol.
+
+The firmware file **respeaker_xvf3800_i2s_dfu_firmware_v1.0.x.bin** is available in [here](https://github.com/respeaker/reSpeaker_XVF3800_USB_4MIC_ARRAY/tree/master/xmos_firmwares/i2s). This firmware supports **2-channel** audio with a **32-bit** depth.
+
+| Firmware | Channels | Notes |
+|---------|----------|-------|
 | respeaker_xvf3800_i2s_dfu_firmware_v1.0.x.bin | 2 | Processed 2-channel output <br /> Channel 0: Conference <br /> Channel 1: ASR |
+
+</TabItem>
+
+<TabItem value="HA" label="HA">
+
+The Home Assistant firmware is another I2S-based firmware specifically designed for integration with Home Assistant. This optimized firmware uses 2-channel audio with a 48 kHz sampling rate, providing better compatibility and performance within the Home Assistant environment.
+You can view the firmware from [here](https://github.com/formatBCE/Respeaker-XVF3800-ESPHome-integration/tree/main)
+
+
+
+| Firmware | Channels | Notes |
+|---------|----------|-------|
 | respeaker_xvf3800_i2s_master_dfu_firmware_v1.0.x_48k.bin | 2 | Processed 2-channel output <br /> Channel 0: ASR <br /> Channel 1: Wake word |
 
-Users can modify the processed output channel selection for the firmware variants mentioned above.
-Please refer to the [XMOS documentation](https://www.xmos.com/documentation/XM-014888-PC/html/modules/fwk_xvf/doc/user_guide/03_using_the_host_application.html#output-selection) for details:
+  </TabItem>
+</Tabs>
+
+
+
+Connect the reSpeaker XVF3800 to your PC via the USB cable. Note that you need to use the XMOS USB-C port(close to 3.5mm jack port) to flash XMOS’s firmware.
+
+
 
 #### Install DFU Util
 
 [`dfu-util`](http://dfu-util.sourceforge.net/) is a command line tool for Device Firmware Upgrade via USB.
 
-import Tabs from '@theme/Tabs';
-import TabItem from '@theme/TabItem';
+
 
 <Tabs>
 <TabItem value="windows" label="Windows">
@@ -316,7 +363,7 @@ Found DFU: [2886:001a] ver=0202, devnum=5, cfg=1, intf=3, path="1-1.1", alt=0, n
 
 #### Flash Firmware
 
-Download Firmware From Here.[`XMOS XVF 3800`](https://github.com/respeaker/reSpeaker_XVF3800_USB_4MIC_ARRAY)
+Download the complete firmware repository from GitHub here[`XMOS XVF 3800`](https://github.com/respeaker/reSpeaker_XVF3800_USB_4MIC_ARRAY)
 
 - Run the following command to flash the firmware