Merge branch 'feature/complete-all-translations'

Author: overtrue

.claude/settings.local.json

@@ -9,10 +9,20 @@
       "Bash(git merge:*)",
       "Bash(git branch:*)",
       "Bash(rsync:*)",
+      "Bash(comm:*)",
+      "Bash(echo:*)",
       "Bash(npm run build:*)",
       "Bash(git pull:*)",
       "Bash(git stash:*)",
-      "Bash(git push:*)"
+      "Bash(git push:*)",
+      "Bash(for lang in de en ja fr es ko)",
+      "Bash(do)",
+      "Bash(echo:*)",
+      "Bash(done)",
+      "Bash(for lang in de en es fr ja ko pt ru tr)",
+      "Bash(for lang in de fr es ko ja ru)",
+      "Bash(do echo \"=== $lang features ===\")",
+      "Bash(ls:*)"
     ],
     "deny": [],
     "ask": []

AGENTS.md

@@ -8,15 +8,12 @@
 
 1. 所有翻译都以中文作为源语言。
 1. 选择目标语言，比如按照 docs/ 下的顺序，先选中目标为 de，并创建此语言专用特性分支(切分支前确保主分支是最新的)。
-1. 获取中文目录文件结构，逐一对比需要翻译的文件，举例：docs/zh/index.md 对比方案是：如果 docs/zh/ 下的同名文件更新时间晚于 docs/de 下的同名文件，则需要翻译，加入 todolist.
-1. 如果在目标语言下不存在对应的文件，则需要翻译，加入 todolist.
+1. 使用 npm run sync:de 命令同步到目标语言。
 1. 如果已经存在对应的文件，则检查内容是否需要更新。
+1. 找出对应语言下内容为待翻译的文件，并翻译。
 1. 开始翻译中文对应的内容为目标语言，如果是外链，代码，则不翻译，并且删除在中文目录下没有的仅在目标语言目录中存在的文件。
-1. 记住：是需要翻译全部中文内容为目标语言，不要仅翻译一部分。
-1. 图片则直接从中文对应的目录拷贝。
-1. 其他非文本内容（如音频、视频等）则直接从中文对应的目录拷贝。
-1. 翻译完成后请仔细检查，确保所有内容都已翻译。
-1. docs/{locale}/sidebar.ts 请确保仅仅是语言目录不同，其他内容保持跟中文的（docs/zh/sidebar.ts）一致，当然了导出的名字和各个菜单的文字是要翻译的。
+1. 翻译完成后请仔细检查，确保所有内容都已翻译，尤其是不能存在任何占位符待翻译的文档。
+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/architecture.md

@@ -0,0 +1,45 @@
+---
+title: "RustFS Architektur"
+description: "Einführung in die RustFS Architektur"
+---
+
+# RustFS Architektur
+
+RustFS ist ein Objektspeichersystem, ähnlich dem bekannten AWS S3. Als Alternative zu MinIO referenziert RustFS die saubere, leichte, skalierbare und elegante Architektur von MinIO.
+
+Objekte können Dokumente, Videos, PDF-Dateien und mehr sein. Für die Speicherung von Objekten bietet MinIO eine skalierbare, flexible und effiziente Lösung zum Speichern, Zugreifen und Verwalten von Daten. Seine Kompatibilität mit der AWS S3-API ermöglicht eine nahtlose Integration mit AWS S3-basierten Anwendungen.
+
+Das Architekturdiagramm ist wie folgt:
+
+![RustFS Architekturdiagramm](./images/s2-1.png)
+
+Dies ist die grundlegende Architektur von RustFS. Ein verteiltes Netzwerk ist eine Computerarchitektur, die mehrere Knoten zur Ausführung einer einzelnen Aufgabe verwendet. Die Knoten sind über ein Netzwerk miteinander verbunden, wodurch sie miteinander kommunizieren können.
+
+## Konsistenz-Design
+
+In verteilten und Einzelrechner-Modi folgen alle Lese- und Schreiboperationen strikt dem read-after-write-Konsistenzmodell.
+
+## Wichtige Konzepte in RustFS
+
+**Object (Objekt)**: Das grundlegende Objekt, das in RustFS gespeichert wird, wie Dateien, Byte-Streams, alles...
+
+**Bucket (Eimer)**: Der logische Raum zum Speichern von Objekten. Die Daten zwischen jedem Bucket sind voneinander isoliert. Für den Client ist es gleichbedeutend mit einem Ordner der obersten Ebene zum Speichern von Dateien.
+
+**Drive (Laufwerk)**: Das Laufwerk, das Daten speichert, wird beim Start von RustFS als Parameter übergeben. Alle Objektdaten in RustFS werden in Laufwerken gespeichert.
+
+**Set (Satz)**: Eine Sammlung von Laufwerken. Die verteilte Bereitstellung teilt automatisch einen oder mehrere Sets basierend auf der Clustergröße auf, und die Laufwerke in jedem Set sind an verschiedenen Orten verteilt. Ein Objekt wird in einem Set gespeichert.
+
+Daher sollte beim Entwerfen der Architektur und beim Bereitstellen von Geräten beachtet werden:
+
+1. Ein Objekt wird in einem Set gespeichert;
+2. Ein Cluster wird in mehrere Sets unterteilt;
+3. Die Anzahl der Laufwerke in einem Set ist fest und wird standardmäßig automatisch vom System basierend auf der Clustergröße berechnet;
+4. Die Laufwerke in einem Set sind so weit wie möglich auf verschiedene Knoten verteilt;
+
+## Besonderer Dank
+
+Alle Knoten befinden sich in gleichrangigen Beziehungen, was das Architekturdesign erheblich vereinfacht und Sorgen über Metadatenverluste eliminiert. Es kann mit einem einzigen Befehl gestartet werden.
+
+Ohne Eleganz, Einfachheit und Zuverlässigkeit zu verlieren, übernimmt RustFS das gleiche Architekturdesign wie MinIO.
+
+Dank an MinIO für das vorgeschlagene Architekturkonzept, das Benutzern weltweit enormen Komfort bietet und das S3-Protokoll gefördert hat.