@aigne/doc-smith 0.8.11-beta → 0.8.11-beta.2

package/docs/cli-reference.zh.md

@@ -1,8 +1,8 @@
 # CLI 命令参考
 
-本指南为所有可用的 `aigne doc` 子命令及其参数和选项提供了参考。它旨在帮助希望充分利用命令行的用户。
+本指南为所有可用的 `aigne doc` 子命令、其参数和选项提供了参考。它旨在帮助用户充分利用命令行界面。
 
-通用语法为：
+通用语法是：
 
 ```bash
 aigne doc <command> [options]
@@ -10,7 +10,7 @@ aigne doc <command> [options]
 
 ### 命令工作流
 
-下图展示了使用 DocSmith CLI 命令创建和维护文档的典型生命周期：
+下图展示了使用 DocSmith 的 CLI 命令创建和维护文档的典型生命周期：
 
 ```d2
 direction: down
@@ -69,11 +69,11 @@ publish -> End
 
 ## `aigne doc generate`
 
-分析您的源代码，并根据您的配置生成一套完整的文档。如果未找到配置，它将自动启动交互式设置向导。
+分析您的源代码，并根据您的配置生成一套完整的文档。如果找不到配置，它会自动启动交互式设置向导。
 
 ### 选项
 
-| Option              | Type    | Description                                                                                                   |
+| 选项              | 类型    | 描述                                                                                                   |
 | ------------------- | ------- | ------------------------------------------------------------------------------------------------------------- |
 | `--feedback`        | string  | 提供反馈以调整和优化整体文档结构。                                   |
 | `--forceRegenerate` | boolean | 丢弃现有内容并从头开始重新生成所有文档。                                     |
@@ -96,10 +96,10 @@ aigne doc generate --forceRegenerate
 **通过反馈优化文档结构：**
 
 ```bash
-aigne doc generate --feedback "Add a new section for API examples and remove the 'About' page."
+aigne doc generate --feedback "为 API 示例添加一个新部分，并删除‘关于’页面。"
 ```
 
-**使用 AIGNE Hub 中的特定模型生成：**
+**使用 AIGNE Hub 中的特定模型进行生成：**
 
 ```bash
 aigne doc generate --model google:gemini-1.5-flash
@@ -109,11 +109,11 @@ aigne doc generate --model google:gemini-1.5-flash
 
 ## `aigne doc update`
 
-优化并重新生成特定文档。您可以以交互方式运行它来选择文档，或直接使用选项指定文档。这对于根据反馈进行有针对性的改进非常有用，而无需重新生成整个项目。
+优化并重新生成特定文档。您可以以交互方式运行它来选择文档，或使用选项直接指定文档。这对于根据反馈进行有针对性的改进非常有用，而无需重新生成整个项目。
 
 ### 选项
 
-| Option     | Type  | Description                                                                                 |
+| 选项     | 类型  | 描述                                                                                 |
 | ---------- | ----- | ------------------------------------------------------------------------------------------- |
 | `--docs`     | array | 要重新生成的文档路径列表。可多次使用。                         |
 | `--feedback` | string | 提供具体反馈以改进所选文档的内容。              |
@@ -129,23 +129,23 @@ aigne doc update
 **使用有针对性的反馈更新特定文档：**
 
 ```bash
-aigne doc update --docs overview.md --feedback "Add more detailed FAQ entries"
+aigne doc update --docs overview.md --feedback "添加更详细的常见问题解答条目"
 ```
 
 ---
 
 ## `aigne doc translate`
 
-将现有文档翻译成一种或多种语言。可以以交互方式运行它来选择文档和语言，也可以通过将它们指定为参数以非交互方式运行。
+将现有文档翻译成一种或多种语言。可以以交互方式运行以选择文档和语言，也可以通过将它们指定为参数以非交互方式运行。
 
 ### 选项
 
-| Option       | Type  | Description                                                                                                |
+| 选项       | 类型  | 描述                                                                                                |
 | ------------ | ----- | ---------------------------------------------------------------------------------------------------------- |
 | `--docs`       | array | 要翻译的文档路径列表。可多次使用。                                         |
-| `--langs`      | array | 目标语言代码列表（例如，`zh`、`ja`）。可多次使用。                            |
+| `--langs`      | array | 目标语言代码列表（例如 `zh`、`ja`）。可多次使用。                            |
 | `--feedback`   | string | 提供反馈以提高翻译质量。                                               |
-| `--glossary`   | string | 词汇表文件的路径，以确保跨语言术语的一致性。使用 `@path/to/glossary.md`。 |
+| `--glossary`   | string | 术语表文件的路径，以确保跨语言术语的一致性。使用 `@path/to/glossary.md`。 |
 
 ### 使用示例
 
@@ -161,23 +161,23 @@ aigne doc translate
 aigne doc translate --langs zh --langs ja --docs examples.md --docs overview.md
 ```
 
-**使用词汇表和反馈进行翻译以获得更好的质量：**
+**使用术语表和反馈进行翻译以获得更好的质量：**
 
 ```bash
-aigne doc translate --glossary @glossary.md --feedback "Use technical terminology consistently"
+aigne doc translate --glossary @glossary.md --feedback "始终如一地使用技术术语"
 ```
 
 ---
 
 ## `aigne doc publish`
 
-将您生成的文档发布到 Discuss Kit 平台。您可以发布到官方的 AIGNE DocSmith 平台或您自己托管的实例。
+将您生成的文档发布到 Discuss Kit 平台。您可以发布到官方的 AIGNE DocSmith 平台，也可以发布到您自己托管的实例。
 
 ### 选项
 
-| Option     | Type   | Description                                                                                          |
+| 选项     | 类型   | 描述                                                                                          |
 | ---------- | ------ | ---------------------------------------------------------------------------------------------------- |
-| `--appUrl` | string | 您自行托管的 Discuss Kit 实例的 URL。如果未提供，该命令将以交互方式运行。 |
+| `--appUrl` | string | 您自托管的 Discuss Kit 实例的 URL。如果未提供，该命令将以交互方式运行。 |
 
 ### 使用示例
 
@@ -187,7 +187,7 @@ aigne doc translate --glossary @glossary.md --feedback "Use technical terminolog
 aigne doc publish
 ```
 
-**直接发布到自行托管的实例：**
+**直接发布到自托管实例：**
 
 ```bash
 aigne doc publish --appUrl https://your-discuss-kit-instance.com
@@ -207,4 +207,4 @@ aigne doc publish --appUrl https://your-discuss-kit-instance.com
 aigne doc init
 ```
 
-有关如何根据您的需求定制 DocSmith 的更多详细信息，请参阅[配置指南](./configuration.md)。
+有关如何根据您的需求定制 DocSmith 的更多详细信息，请参阅[配置指南](./configuration.md)。

package/docs/configuration-interactive-setup.ja.md

@@ -0,0 +1,135 @@
+# 対話型セットアップ
+
+AIGNE DocSmithには、プロジェクト設定を効率化するための対話型セットアップウィザードが含まれており、`aigne doc init`コマンドで起動します。このガイド付きプロセスでは、ドキュメントの目標に関する一連の質問が行われ、その回答から`config.yaml`ファイルが生成されます。これは、設定エラーを防ぎ、入力に基づいて具体的な推奨事項を提供するため、新しいドキュメントプロジェクトを開始する際に推奨される方法です。
+
+## ウィザードの実行
+
+プロセスを開始するには、プロジェクトのルートディレクトリで次のコマンドを実行します。
+
+```bash aigne doc init icon=lucide:sparkles
+npx aigne doc init
+```
+
+ウィザードは、ドキュメントを設定するための8ステップのプロセスを案内します。
+
+## ガイド付きプロセス
+
+ウィザードは、以下の主要な設定詳細を尋ねます。
+
+1.  **主な目標**: 読者の主な目的を定義します（例：入門、回答の検索）。
+2.  **対象読者**: ドキュメントの主な読者を指定します（例：非技術的なエンドユーザー、開発者）。
+3.  **読者の知識レベル**: 対象読者の典型的な初期知識を評価します。
+4.  **ドキュメントの深さ**: コンテンツの詳細レベルと範囲を決定します。
+5.  **主な言語**: ドキュメントの主要言語を設定します。
+6.  **翻訳言語**: 翻訳のための追加言語を選択します。
+7.  **出力ディレクトリ**: 生成されたドキュメントファイルの場所を指定します。
+8.  **ソースコードのパス**: globパターンをサポートし、分析対象のファイルとディレクトリを定義します。
+
+## 設定支援
+
+ウィザードは、一貫性のある効果的な設定を作成するために、事前定義された一連のルールを使用します。
+
+```d2
+direction: down
+
+User-Selections: {
+  label: "1. User provides input\n(Purpose, Audience, etc.)"
+  shape: rectangle
+}
+
+Wizard-Engine: {
+  label: "2. Wizard's Rule Engine"
+  shape: rectangle
+  grid-columns: 2
+
+  Filtering: {
+    label: "Option Filtering\n(Prevents incompatible selections)"
+  }
+
+  Conflict-Detection: {
+    label: "Conflict Detection\n(Identifies complex needs)"
+  }
+}
+
+Guided-Experience: {
+  label: "3. Guided Experience"
+  shape: rectangle
+  content: "User sees simplified, relevant options"
+}
+
+Final-Config: {
+  label: "4. Final Configuration"
+  content: "config.yaml is generated with\nconflict resolution strategies"
+}
+
+User-Selections -> Wizard-Engine
+Wizard-Engine.Filtering -> Guided-Experience
+Wizard-Engine.Conflict-Detection -> Final-Config
+Guided-Experience -> User-Selections: "Refines"
+```
+
+### デフォルトの提案とオプションのフィルタリング
+
+選択を行うと、ウィザードはデフォルトを提供し、後続のオプションをフィルタリングして、論理的な設定に導きます。これは、質問間の競合ルールセットに基づいています。
+
+-   **デフォルトの提案**: 主な目標として「すぐに始める」を選択すると、ウィザードは読者の知識レベルとして「完全な初心者」を推奨します。
+-   **リアルタイムフィルタリング**: 対象読者が「エンドユーザー（非技術的）」の場合、ウィザードは「専門家」の知識レベルを非表示にします。このルールの理由は、非技術的なユーザーは通常、経験豊富な技術ユーザーではないため、互換性のない選択を防ぐためです。
+
+### 競合の検出と解決
+
+場合によっては、非技術的な**エンドユーザー**と専門家の**開発者**の両方向けにドキュメントを作成するなど、効果的なドキュメント構造を必要とする複数の目標や対象者がいることがあります。ウィザードはこれらを「解決可能な競合」として識別します。
+
+次に、これらのニーズにドキュメント構造内で対応するための戦略を策定します。エンドユーザー対開発者の例では、解決戦略として別々のユーザーパスを作成します。
+
+-   **ユーザーガイドパス**: 平易な言葉を使用し、UIの操作に焦点を当て、ビジネスの成果を志向します。
+-   **開発者ガイドパス**: コード中心で技術的に正確であり、SDKの例や設定スニペットを含みます。
+
+このアプローチにより、最終的なドキュメントは、単一の混乱したコンテンツの混合物を作成するのではなく、複数の対象者に効果的に対応できるように構成されます。
+
+## 生成される出力
+
+ウィザードを完了すると、プロジェクトに`config.yaml`ファイルが保存されます。このファイルは完全にコメント化されており、各オプションを説明し、利用可能なすべての選択肢をリストアップしているため、後で手動で確認・修正するのが簡単です。
+
+以下は生成されたファイルのスニペットです。
+
+```yaml config.yaml icon=logos:yaml
+# ドキュメント公開のためのプロジェクト情報
+projectName: your-project-name
+projectDesc: Your project description.
+projectLogo: ""
+
+# =============================================================================
+# ドキュメント設定
+# =============================================================================
+
+# 目的: 読者に達成してほしい主な成果は何ですか？
+# 利用可能なオプション（必要に応じてコメントを解除して変更してください）：
+#   getStarted       - すぐに始める：新規ユーザーが30分以内にゼロから作業を開始できるように支援します
+#   completeTasks    - 特定のタスクを完了する：一般的なワークフローやユースケースをユーザーに案内します
+documentPurpose:
+  - completeTasks
+  - findAnswers
+
+# 対象読者: これを最も頻繁に読むのは誰ですか？
+# 利用可能なオプション（必要に応じてコメントを解除して変更してください）：
+#   endUsers         - エンドユーザー（非技術的）：製品を使用するがコーディングはしない人々
+#   developers       - 開発者（製品/APIを統合）：これを自分のプロジェクトに追加するエンジニア
+targetAudienceTypes:
+  - endUsers
+  - developers
+
+# ... その他の設定
+```
+
+## 次のステップ
+
+設定ファイルが準備できたので、ドキュメントの生成、翻訳、または公開を行う準備が整いました。
+
+<x-cards>
+  <x-card data-title="ドキュメントの生成" data-icon="lucide:play-circle" data-href="/features/generate-documentation">
+    単一のコマンドを使用して、ソースコードから完全なドキュメントセットを自動的に作成する方法を学びます。
+  </x-card>
+  <x-card data-title="設定ガイド" data-icon="lucide:settings" data-href="/configuration">
+    利用可能なすべての設定を深く掘り下げ、`config.yaml`ファイルを手動で微調整する方法を学びます。
+  </x-card>
+</x-cards>

package/docs/configuration-interactive-setup.zh-TW.md

@@ -0,0 +1,135 @@
+# 互動式設定
+
+AIGNE DocSmith 包含一個互動式設定精靈，可透過 `aigne doc init` 指令啟動，以簡化專案設定。此引導式流程會詢問一系列關於您文件目標的問題，並根據您的回答產生一個 `config.yaml` 檔案。這是開始新文件專案的建議方法，因為它有助於防止設定錯誤，並根據您的輸入提供具體建議。
+
+## 執行精靈
+
+若要開始此流程，請在您專案的根目錄中執行以下指令：
+
+```bash aigne doc init icon=lucide:sparkles
+npx aigne doc init
+```
+
+精靈接著會引導您完成一個 8 步驟的流程來設定您的文件。
+
+## 引導式流程
+
+精靈會提示您輸入以下關鍵設定詳細資訊：
+
+1.  **主要目標**：定義讀者的主要目的（例如，開始使用、尋找答案）。
+2.  **目標受眾**：指明文件的主要讀者（例如，非技術性終端使用者、開發人員）。
+3.  **讀者知識水平**：評估您受眾的典型起始知識水平。
+4.  **文件深度**：決定內容的詳細程度和範圍。
+5.  **主要語言**：設定文件的主要語言。
+6.  **翻譯語言**：選擇額外的翻譯語言。
+7.  **輸出目錄**：指定產生文件檔案的位置。
+8.  **原始碼路徑**：定義要分析的檔案和目錄，支援 glob 模式。
+
+## 輔助設定
+
+精靈使用一組預定義的規則來幫助您建立一個一致且有效的設定。
+
+```d2
+direction: down
+
+User-Selections: {
+  label: "1. 使用者提供輸入\n（目的、受眾等）"
+  shape: rectangle
+}
+
+Wizard-Engine: {
+  label: "2. 精靈的規則引擎"
+  shape: rectangle
+  grid-columns: 2
+
+  Filtering: {
+    label: "選項篩選\n（防止不相容的選擇）"
+  }
+
+  Conflict-Detection: {
+    label: "衝突偵測\n（識別複雜需求）"
+  }
+}
+
+Guided-Experience: {
+  label: "3. 引導式體驗"
+  shape: rectangle
+  content: "使用者看到簡化且相關的選項"
+}
+
+Final-Config: {
+  label: "4. 最終設定"
+  content: "config.yaml 產生時帶有\n衝突解決策略"
+}
+
+User-Selections -> Wizard-Engine
+Wizard-Engine.Filtering -> Guided-Experience
+Wizard-Engine.Conflict-Detection -> Final-Config
+Guided-Experience -> User-Selections: "優化"
+```
+
+### 預設建議與選項篩選
+
+當您進行選擇時，精靈會提供預設值並篩選後續選項，以引導您進行邏輯性的設定。這是基於一組跨問題的衝突規則。
+
+-   **預設建議**：如果您選擇「快速入門」作為主要目標，精靈會建議將讀者的知識水平設定為「完全是初學者」。
+-   **即時篩選**：如果您的目標受眾是「終端使用者（非技術人員）」，精靈將會隱藏「是專家」的知識水平選項。此規則的理由是非技術使用者通常不是經驗豐富的技術使用者，從而防止不相容的選擇。
+
+### 衝突偵測與解決
+
+在某些情況下，您可能有多個目標或受眾，需要特定的文件結構才能有效，例如為非技術性的**終端使用者**和專家級的**開發人員**建立文件。精靈會將這些情況識別為「可解決的衝突」。
+
+然後，它會制定一個策略，在文件結構中解決這些需求。對於終端使用者與開發人員的例子，解決策略是建立獨立的使用者路徑：
+
+-   **使用者指南路徑**：使用淺顯的語言，專注於 UI 互動，並以業務成果為導向。
+-   **開發人員指南路徑**：以程式碼為優先，技術上精確，並包含 SDK 範例和設定片段。
+
+這種方法確保最終的文件結構能夠有效地服務多個受眾，而不是建立單一、混亂的內容組合。
+
+## 產生的輸出
+
+完成精靈後，它會在您的專案中儲存一個 `config.yaml` 檔案。此檔案有完整的註解，解釋了每個選項並列出了所有可用的選擇，使其易於稍後手動檢閱和修改。
+
+以下是產生的檔案片段：
+
+```yaml config.yaml icon=logos:yaml
+# 用於文件發布的專案資訊
+projectName: your-project-name
+projectDesc: 您的專案描述。
+projectLogo: ""
+
+# =============================================================================
+# 文件設定
+# =============================================================================
+
+# 目的：您希望讀者達成的最主要成果是什麼？
+# 可用選項（取消註解並視需要修改）：
+#   getStarted       - 快速入門：幫助新使用者在 30 分鐘內從零到上手
+#   completeTasks    - 完成特定任務：引導使用者完成常見的工作流程和使用案例
+documentPurpose:
+  - completeTasks
+  - findAnswers
+
+# 目標受眾：誰會最常閱讀此文件？
+# 可用選項（取消註解並視需要修改）：
+#   endUsers         - 終端使用者（非技術人員）：使用產品但不編寫程式碼的人
+#   developers       - 開發人員整合您的產品/API：將此產品/API 加入其專案的工程師
+targetAudienceTypes:
+  - endUsers
+  - developers
+
+# ... 其他設定
+```
+
+## 後續步驟
+
+設定檔案就緒後，您就可以產生、翻譯或發布您的文件了。
+
+<x-cards>
+  <x-card data-title="產生文件" data-icon="lucide:play-circle" data-href="/features/generate-documentation">
+    了解如何使用單一指令從您的原始碼自動建立一套完整的文件。
+  </x-card>
+  <x-card data-title="設定指南" data-icon="lucide:settings" data-href="/configuration">
+    深入了解所有可用的設定，並學習如何手動微調 config.yaml 檔案。
+  </x-card>
+</x-cards>

package/docs/configuration-interactive-setup.zh.md

@@ -1,6 +1,6 @@
 # 交互式设置
 
-AIGNE DocSmith 包含一个交互式设置向导，通过 `aigne doc init` 命令启动，以简化项目配置。该引导过程会询问一系列关于你的文档目标的问题，并根据你的回答生成一个 `config.yaml` 文件。这是启动新文档项目的推荐方法，因为它有助于防止配置错误，并根据你的输入提供具体建议。
+AIGNE DocSmith 包含一个交互式设置向导，通过 `aigne doc init` 命令启动，用于简化项目配置。这个引导式过程会询问一系列关于您的文档目标的问题，并根据您的回答生成一个 `config.yaml` 文件。这是启动新文档项目的推荐方法，因为它有助于防止配置错误，并根据您的输入提供具体建议。
 
 ## 运行向导
 
@@ -10,24 +10,24 @@ AIGNE DocSmith 包含一个交互式设置向导，通过 `aigne doc init` 命
 npx aigne doc init
 ```
 
-然后，向导将引导你完成一个 8 步流程来配置文档。
+然后，向导将引导您完成一个 8 步过程来配置您的文档。
 
-## 引导流程
+## 引导式过程
 
-向导会提示输入以下关键配置细节：
+向导会提示您输入以下关键配置细节：
 
-1.  **主要目标**：定义读者的主要目的（例如，入门、寻找答案）。
-2.  **目标受众**：指明文档的主要读者（例如，非技术最终用户、开发者）。
+1.  **主要目标**：定义读者的主要目的（例如，快速入门、寻找答案）。
+2.  **目标受众**：指定文档的主要读者（例如，非技术最终用户、开发者）。
 3.  **读者知识水平**：评估受众的典型初始知识水平。
 4.  **文档深度**：确定内容的详细程度和范围。
 5.  **主要语言**：设置文档的主要语言。
-6.  **翻译语言**：选择其他需要翻译的语言。
-7.  **输出目录**：指定生成文档文件的位置。
+6.  **翻译语言**：选择用于翻译的其他语言。
+7.  **输出目录**：指定生成的文档文件的位置。
 8.  **源代码路径**：定义要分析的文件和目录，支持 glob 模式。
 
 ## 辅助配置
 
-向导使用一套预定义规则来帮助你创建一致且有效的配置。
+向导使用一套预定义的规则来帮助您创建连贯且有效的配置。
 
 ```d2
 direction: down
@@ -43,7 +43,7 @@ Wizard-Engine: {
   grid-columns: 2
 
   Filtering: {
-    label: "选项筛选\n（防止不兼容的选择）"
+    label: "选项过滤\n（防止不兼容的选择）"
   }
 
   Conflict-Detection: {
@@ -59,61 +59,61 @@ Guided-Experience: {
 
 Final-Config: {
   label: "4. 最终配置"
-  content: "config.yaml 生成时\n包含冲突解决策略"
+  content: "生成 config.yaml 并包含\n冲突解决策略"
 }
 
 User-Selections -> Wizard-Engine
 Wizard-Engine.Filtering -> Guided-Experience
 Wizard-Engine.Conflict-Detection -> Final-Config
-Guided-Experience -> User-Selections: "完善"
+Guided-Experience -> User-Selections: "优化"
 ```
 
-### 默认建议和选项筛选
+### 默认建议和选项过滤
 
-在你进行选择时，向导会提供默认值并筛选后续选项，以引导你进行逻辑配置。这是基于一套跨问题冲突规则。
+当您进行选择时，向导会提供默认值并过滤后续选项，以引导您进行逻辑配置。这是基于一套跨问题冲突规则。
 
--   **默认建议**：如果你选择“快速入门”作为主要目标，向导将推荐“完全是初学者”作为读者的知识水平。
--   **实时筛选**：如果你的目标受众是“最终用户（非技术人员）”，向导将隐藏“是专家”这一知识水平选项。该规则的理由是，非技术用户通常不是经验丰富的技术用户，从而防止不兼容的选择。
+-   **默认建议**：如果您选择“快速入门”作为主要目标，向导将推荐“完全是初学者”作为读者的知识水平。
+-   **实时过滤**：如果您的目标受众是“最终用户（非技术人员）”，向导将隐藏“是专家”这个知识水平选项。该规则的理由是，非技术用户通常不是经验丰富的技术用户，从而防止了不兼容的选择。
 
 ### 冲突检测与解决
 
-在某些情况下，你可能有多个目标或受众，需要特定的文档结构才能有效，例如为非技术的 **最终用户** 和专业的 **开发者** 创建文档。向导将这些识别为“可解决的冲突”。
+在某些情况下，您可能有多个目标或受众，需要特定的文档结构才能有效，例如为非技术的**最终用户**和专业的**开发者**创建文档。向导将这些情况识别为“可解决的冲突”。
 
-然后，它会制定一个策略来解决文档结构中的这些需求。对于最终用户与开发者的例子，解决策略是创建独立的用户路径：
+然后，它会制定一个策略来在文档结构中满足这些需求。对于最终用户与开发者的例子，解决策略是创建独立的用户路径：
 
--   **用户指南路径**：使用通俗易懂的语言，侧重于 UI 交互，并以业务成果为导向。
+-   **用户指南路径**：使用通俗易懂的语言，侧重于 UI 交互，并面向业务成果。
 -   **开发者指南路径**：代码优先，技术上精确，并包含 SDK 示例和配置片段。
 
 这种方法确保最终的文档结构能够有效地服务于多个受众，而不是创建一个单一、混乱的内容混合体。
 
-## 生成输出
+## 生成的输出
 
-完成向导后，它会在你的项目中保存一个 `config.yaml` 文件。该文件带有完整的注释，解释了每个选项并列出了所有可用选择，这使得以后手动审查和修改变得容易。
+完成向导后，它会在您的项目中保存一个 `config.yaml` 文件。该文件带有完整的注释，解释了每个选项并列出了所有可用选择，这使得以后手动审查和修改变得容易。
 
 以下是生成文件的片段：
 
 ```yaml config.yaml icon=logos:yaml
 # 用于文档发布的项目信息
 projectName: your-project-name
-projectDesc: 你的项目描述。
+projectDesc: 您的项目描述。
 projectLogo: ""
 
 # =============================================================================
 # 文档配置
 # =============================================================================
 
-# 目的：你希望读者实现的主要成果是什么？
+# 目的：您希望读者达到的主要结果是什么？
 # 可用选项（根据需要取消注释并修改）：
-#   getStarted       - 快速入门：帮助新用户在 30 分钟内从零开始上手
-#   completeTasks    - 完成特定任务：引导用户了解常见工作流程和用例
+#   getStarted       - 快速入门：帮助新用户在 <30 分钟内从零到上手
+#   completeTasks    - 完成特定任务：引导用户完成常见工作流程和用例
 documentPurpose:
   - completeTasks
   - findAnswers
 
-# 目标受众：谁会最常阅读本文档？
+# 目标受众：谁会最常阅读这份文档？
 # 可用选项（根据需要取消注释并修改）：
-#   endUsers         - 最终用户（非技术人员）：使用产品但不编写代码的人
-#   developers       - 集成你的产品/API 的开发者：将此产品添加到其项目中的工程师
+#   endUsers         - 最终用户（非技术人员）：使用产品但不编码的人
+#   developers       - 开发者（集成您的产品/API）：将此添加到其项目中的工程师
 targetAudienceTypes:
   - endUsers
   - developers
@@ -123,7 +123,7 @@ targetAudienceTypes:
 
 ## 后续步骤
 
-配置文件就绪后，你就可以生成、翻译或发布文档了。
+配置文件就位后，您就可以生成、翻译或发布您的文档了。
 
 <x-cards>
   <x-card data-title="生成文档" data-icon="lucide:play-circle" data-href="/features/generate-documentation">

package/docs/configuration-language-support.ja.md

@@ -0,0 +1,94 @@
+# 言語サポート
+
+AIGNE DocSmithはAIを使用して、12言語への自動ドキュメント翻訳を提供します。これにより、`aigne doc translate`コマンドを使用して、世界中の読者向けのドキュメントを生成および維持できます。
+
+翻訳ワークフローは、ソースドキュメントをAIエンジンで処理し、選択したターゲット言語でローカライズされたバージョンを生成します。
+
+```d2
+direction: down
+
+Source-Doc: {
+  label: "ソースドキュメント\n(例：英語)"
+  shape: rectangle
+}
+
+AI-Engine: {
+  label: "AIGNE DocSmith\nAI翻訳エンジン"
+  shape: rectangle
+}
+
+Translated-Docs: {
+  label: "翻訳済みドキュメント"
+  shape: rectangle
+  grid-columns: 3
+
+  zh: "简体中文"
+  ja: "日本語"
+  es: "Español"
+  fr: "Français"
+  de: "Deutsch"
+  more: "..."
+}
+
+Source-Doc -> AI-Engine: "`aigne doc translate`"
+AI-Engine -> Translated-Docs: "生成"
+```
+
+## サポートされている言語
+
+DocSmithは、以下の言語に対してAIによる翻訳を提供します。プロジェクトの初期設定時に主要言語を定義し、翻訳対象として任意の数のターゲット言語を選択できます。
+
+| 言語 | 言語コード | サンプルテキスト |
+|---|---|---|
+| English | `en` | こんにちは |
+| 简体中文 | `zh` | 你好 |
+| 繁體中文 | `zh-TW` | 你好 |
+| 日本語 | `ja` | こんにちは |
+| 한국어 | `ko` | 안녕하세요 |
+| Español | `es` | Hola |
+| Français | `fr` | Bonjour |
+| Deutsch | `de` | Hallo |
+| Português | `pt` | Olá |
+| Русский | `ru` | Привет |
+| Italiano | `it` | Ciao |
+| العربية | `ar` | مرحبا |
+
+## 翻訳の設定と使用方法
+
+翻訳言語は、`aigne doc init`でプロジェクトを初期化する際に設定されます。`aigne doc translate`コマンドを使用すれば、いつでも新しい言語を追加したり、ドキュメントを翻訳したりできます。このコマンドには2つの操作モードがあります。
+
+### ガイド付き翻訳のためのインタラクティブモード
+
+ステップバイステップのガイド付きエクスペリエンスを利用するには、引数なしでコマンドを実行します。これはほとんどのユーザーに推奨されるアプローチです。
+
+```bash Interactive Translation icon=lucide:wand
+aigne doc translate
+```
+
+インタラクティブモードでは、一連のプロンプトが表示され、以下の操作が可能です：
+
+1.  既存のドキュメントのリストから翻訳するものを選択する。
+2.  サポートされているリストから1つ以上のターゲット言語を選択する。
+3.  プロジェクトの設定にまだ含まれていない新しい翻訳言語を追加する。
+
+### 自動化のためのコマンドライン引数
+
+直接的な制御や自動化スクリプトで使用するために、ドキュメントと言語をコマンドライン引数として直接指定できます。これは開発者やCI/CDパイプラインに最適です。
+
+```bash Command Example icon=lucide:terminal
+# overview.mdとexamples.mdを中国語と日本語に翻訳
+aigne doc translate --langs zh --langs ja --docs overview.md --docs examples.md
+```
+
+このコマンドの主要なパラメータは次のとおりです：
+
+| パラメータ | 説明 |
+|---|---|
+| `--langs` | ターゲット言語の言語コードを指定します。このフラグは複数回使用して、いくつかの言語を選択できます。 |
+| `--docs` | 翻訳するドキュメントへのパスを指定します（例：`overview.md`）。これも複数回使用できます。 |
+| `--feedback` | 翻訳モデルをガイドするための具体的な指示を提供します（例：`"フォーマルなトーンを使用する"`）。 |
+| `--glossary` | カスタム用語集ファイル（例：`@path/to/glossary.md`）を使用して、プロジェクト固有の用語の一貫した翻訳を保証します。 |
+
+---
+
+このセクションでは、利用可能な言語とその有効化方法について説明しました。翻訳ワークフローに関する完全なガイドについては、[ドキュメントの翻訳](./features-translate-documentation.md)ガイドを参照してください。