wip

Author: overtrue

AGENTS.md

@@ -8,15 +8,12 @@
 
 1. 所有翻译都以中文作为源语言。
 1. 选择目标语言，比如按照 docs/ 下的顺序，先选中目标为 de，并创建此语言专用特性分支(切分支前确保主分支是最新的)。
-1. 获取中文目录文件结构，逐一对比需要翻译的文件，举例：docs/zh/index.md 对比方案是：如果 docs/zh/ 下的内容不符合 docs/de 下的同名文件的内容翻译，则需要翻译，加入 todolist.
-1. 如果在目标语言下不存在对应的文件，则需要翻译，加入 todolist.
-1. 如果在目标语言下的占位符文件，没有翻译完成的，则需要翻译，加入 todolist.
+1. 使用 npm run sync:de 命令同步到目标语言。
 1. 如果已经存在对应的文件，则检查内容是否需要更新。
+1. 找出对应语言下内容为待翻译的文件，并翻译。
 1. 开始翻译中文对应的内容为目标语言，如果是外链，代码，则不翻译，并且删除在中文目录下没有的仅在目标语言目录中存在的文件。
-1. 图片则直接从中文对应的目录拷贝。
-1. 其他非文本内容（如音频、视频等）则直接从中文对应的目录拷贝。
 1. 翻译完成后请仔细检查，确保所有内容都已翻译，尤其是不能存在任何占位符待翻译的文档。
-1. docs/{locale}/sidebar.ts 请确保仅仅是语言目录不同，其他内容保持跟中文的（docs/zh/sidebar.ts）一致，当然了导出的名字和各个菜单的文字是要翻译的。
+1. docs/{locale}/sidebar.ts 请确保仅仅是语言目录不同，其他内容保持跟中文的（docs/zh/sidebar.ts）一致。
 1. 翻译完成一个语言后，确保目标语言下的文件结构跟中文一模一样，如果发现遗漏则重复此翻译流程。
 1. 翻译完成后仔细对比，确保没有遗漏，每一个文件都翻译了，不要多也不要少。
 1. 翻译完成后请执行 vitepress 的 build 命令，确保生成静态文件不出错，不能存在死链和任何报错信息。

SYNC_DOCS_README.md

@@ -0,0 +1,155 @@
+# 文档同步工具说明
+
+## 功能介绍
+
+`sync-docs.js` 是一个用于同步中文文档到其他语言版本的 Node.js 脚本。它可以：
+
+1. **自动创建文档结构**：为目标语言创建与中文版本完全一致的目录结构
+2. **智能文件处理**：
+   - 非 Markdown 文件（如图片、SVG等）直接复制
+   - 新的 Markdown 文件创建占位符内容（标记为"待翻译"）
+   - 已存在的文件根据更新时间判断是否需要更新
+3. **自动清理多余文件**：删除目标语言中存在但中文版本中不存在的文件和目录
+4. **时间戳比较**：通过比较文件修改时间，识别需要更新翻译的文件
+5. **详细统计**：提供同步操作的详细统计信息
+
+## 使用方法
+
+### 使用 npm scripts（推荐）
+
+```bash
+# 同步所有语言
+npm run sync
+# 或
+npm run sync:all
+
+# 同步特定语言
+npm run sync:ko    # 韩语
+npm run sync:en    # 英语
+npm run sync:de    # 德语
+npm run sync:es    # 西班牙语
+npm run sync:fr    # 法语
+npm run sync:ja    # 日语
+npm run sync:pt    # 葡萄牙语
+npm run sync:ru    # 俄语
+npm run sync:tr    # 土耳其语
+```
+
+### 直接运行脚本
+
+```bash
+# 同步所有语言
+node sync-docs.js
+
+# 同步单个语言
+node sync-docs.js ko
+
+# 同步多个语言
+node sync-docs.js en fr de
+```
+
+### 支持的语言代码
+
+- `de` - 德语
+- `en` - 英语
+- `es` - 西班牙语
+- `fr` - 法语
+- `ja` - 日语
+- `ko` - 韩语
+- `pt` - 葡萄牙语
+- `ru` - 俄语
+- `tr` - 土耳其语
+
+## 工作原理
+
+1. **源语言**：始终以 `docs/zh/` 作为源语言
+2. **文件处理规则**：
+   - `.md` 文件：
+     - 不存在时创建占位符文件
+     - 存在但中文版本更新时间更晚时，提示需要更新
+     - 存在且是最新的，跳过处理
+   - 非 `.md` 文件（图片、资源文件等）：
+     - 不存在或源文件更新时直接复制
+     - 已是最新的则跳过
+   - 多余文件/目录：
+     - 目标语言中存在但中文版本中不存在的文件或目录会被自动删除
+3. **特殊文件**：自动跳过 `config.ts`、`sidebar.ts` 和以 `.` 开头的文件
+
+## 占位符内容
+
+当创建新的 Markdown 文件时，会自动生成如下占位符内容：
+
+```markdown
+---
+title: "待翻译"
+description: "此页面待翻译"
+source: "相对路径"
+---
+
+# 待翻译
+
+此页面内容尚未翻译，请参考[中文版本](../../zh/相对路径)。
+
+---
+
+*This page is pending translation. Please refer to the [Chinese version](../../zh/相对路径).*
+```
+
+## 输出说明
+
+脚本运行时会输出：
+
+1. **实时操作日志**：
+   - `✓ 复制: 文件路径` - 成功复制文件
+   - `✓ 创建占位符: 文件路径` - 创建占位符文件
+   - `✗ 删除文件: 文件路径` - 删除多余文件
+   - `✗ 删除目录: 目录路径` - 删除多余目录
+   - `⚠ 需要更新: 文件路径` - 文件需要更新翻译
+
+2. **统计信息**（每个语言）：
+   - 创建占位符文件数
+   - 复制非MD文件数
+   - 删除多余文件数
+   - 需要更新翻译数
+   - 已是最新数
+   - 跳过数
+
+3. **总体统计**：
+   - 处理的语言总数
+   - 各类操作的总计数
+   - 需要更新翻译的提醒
+
+## 注意事项
+
+1. **不会覆盖翻译**：脚本不会覆盖已经翻译的内容，只会提示哪些文件需要更新
+2. **保留本地修改**：如果目标文件的修改时间晚于中文版本，脚本会保留目标文件
+3. **自动创建目录**：脚本会自动创建必要的目录结构
+4. **资源文件同步**：图片等资源文件会自动从中文版本复制
+
+## 典型工作流程
+
+1. 运行脚本检查状态：
+
+   ```bash
+   npm run sync        # 同步所有语言
+   # 或
+   npm run sync:ko     # 仅同步特定语言
+   ```
+
+2. 查看输出，了解哪些文件需要更新
+
+3. 对需要更新的文件进行翻译
+
+4. 提交更改
+
+## 故障排除
+
+- **错误：中文文档目录不存在**：确保 `docs/zh/` 目录存在
+- **权限问题**：确保有读写 `docs/` 目录的权限
+- **Node.js 版本**：建议使用 Node.js 14.0 或更高版本
+
+## 相关文件
+
+- 脚本位置：`/sync-docs.js`
+- 源目录：`/docs/zh/`
+- 目标目录：`/docs/{语言代码}/`

docs/config.ts

@@ -1,5 +1,5 @@
 import { defineAdditionalConfig } from 'vitepress';
-import { enSidebar } from './en/sidebar';
+import { sidebar } from './en/sidebar';
 
 export default defineAdditionalConfig({
   lang: 'en-US',
@@ -16,7 +16,7 @@ export default defineAdditionalConfig({
     ],
 
     sidebar: {
-      '/': enSidebar,
+      '/': sidebar,
     },
 
     editLink: {

docs/de/concepts/limit.md

@@ -1,9 +1,70 @@
 ---
-title: "待翻译"
-description: "此文档正在翻译中"
+title: "Nutzungsbeschränkungen"
+description: "RustFS ist eine einfache, effiziente, verteilte Objektspeicherlösung. Sie ist 100% S3-kompatibel und als Open-Source-Software unter der Apache2-Lizenz veröffentlicht."
 ---
 
-# 此文档正在翻译中
+# Nutzungsbeschränkungen
 
-请稍后查看更新。
+## I. S3 API Beschränkungen
+
+> Die folgenden Standards folgen strikt den S3-Protokollstandards zur Spezifikation.
+
+| Element | Spezifikation |
+| --------------------- | ---------------------------------- |
+| Maximale Objektgröße | 5 TiB |
+| Minimale Objektgröße | 0 B |
+| Maximale Objektgröße für einzelne PUT-Operation | Nicht-Multipart-Upload: 500 GiB; Multipart-Upload: 5 TiB |
+| Maximale Anzahl von Teilen pro Upload | 10,000 |
+| Teilgrößenbereich | 5 MiB bis 5 GiB; letzter Teil kann 0 B bis 5 GiB sein |
+| Maximale Anzahl von Teilen pro Listenteile-Anfrage | 10,000 |
+| Maximale Anzahl von Objekten pro Listenobjekte-Anfrage | 1,000 |
+| Maximale Anzahl von Multipart-Uploads pro Listen-Multipart-Uploads-Anfrage | 1,000 |
+| Maximale Länge des Bucket-Namens | 63 Zeichen |
+| Maximale Länge des Objektnamens | 1024 Zeichen |
+| Maximale Länge pro `/`-getrennte Objektnamensegment | 255 Zeichen |
+| Maximale Anzahl von Versionen pro Objekt | 10,000 (konfigurierbar) |
+
+---
+
+## II. Erasure Coding Beschränkungen
+
+> EC-Parameter basierend auf Reed-Solomon-Matrix EC-Algorithmus konfigurieren. Tatsächliche EC-Parameterkonfiguration ist maßgebend.
+
+| Element | Spezifikation |
+| ---------------------------- | ------------------------------ |
+| Maximale Anzahl von Servern pro Cluster | Unbegrenzt |
+| Minimale Anzahl von Servern | 1 |
+| Bei 1 Server: Minimale Anzahl von Laufwerken pro Server | 1 (für Single-Node-Single-Drive-Deployment, bietet keine zusätzliche Zuverlässigkeit oder Verfügbarkeit) |
+| Bei 2 oder mehr Servern: Minimale Anzahl von Laufwerken pro Server | 1 |
+| Maximale Anzahl von Laufwerken pro Server | Unbegrenzt |
+| Lese-Quorum-Anzahl | N/2 |
+| Schreib-Quorum-Anzahl | (N/2) + 1 |
+
+---
+
+## III. Objektbenennungsbeschränkungen
+
+### Dateisystem- und Betriebssystembeschränkungen
+
+Objektnamen in RustFS sind hauptsächlich durch das zugrunde liegende Betriebssystem und Dateisystem beschränkt. Zum Beispiel beschränken Windows und einige andere Betriebssysteme die Verwendung bestimmter Sonderzeichen wie `^`, `*`, `|`, `\`, `/`, `&`, `"` oder `;`.
+
+Bitte konsultieren Sie die entsprechende Dokumentation für eine vollständige Liste der Beschränkungen basierend auf Ihrem spezifischen Betriebssystem und Dateisystem.
+
+RustFS empfiehlt die Verwendung von Linux-Betriebssystemen basierend auf XFS-Dateisystem in Produktionsumgebungen für bessere Leistung und Kompatibilität.
+
+### Behandlung von Namenskonflikten
+
+In RustFS müssen Anwendungen allen Objekten eindeutige und nicht-kollidierende Schlüssel zuweisen. Dies beinhaltet die Vermeidung der Erstellung von Objekten, deren Namen mit übergeordneten Objekten oder gleichrangigen Objektnamen kollidieren könnten. RustFS gibt ein leeres Set zurück, wenn LIST-Operationen an konfliktbehafteten Stellen ausgeführt werden.
+
+Zum Beispiel würden die folgenden Operationen zu Namespace-Konflikten führen:
+
+```bash
+PUT data/hello/2025/first/a.csv
+PUT data/hello/2025/first # Konflikt mit vorhandenem Objektpräfix
+
+PUT data/hello/2025/first/
+PUT data/hello/2025/first/vendors.csv # Konflikt mit vorhandenem Objekt
+```
+
+Obwohl Sie GET- oder HEAD-Operationen auf diese Objekte ausführen können, führen Namenskonflikte dazu, dass LIST-Operationen im Pfad `hello/2025/first/` ein leeres Ergebnisset zurückgeben.
 

docs/de/config.ts

@@ -1,5 +1,5 @@
 import { defineAdditionalConfig } from 'vitepress'
-import { deSidebar } from './sidebar'
+import { sidebar } from './sidebar'
 
 export default defineAdditionalConfig({
   lang: 'de-DE',
@@ -16,7 +16,7 @@ export default defineAdditionalConfig({
     ],
 
     sidebar: {
-      '/de/': deSidebar,
+      '/de/': sidebar,
     },
 
     editLink: {
@@ -29,4 +29,4 @@ export default defineAdditionalConfig({
       copyright: 'Copyright © 2025 RustFS'
     }
   }
-})
+})