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

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

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

package/docs/configuration-interactive-setup.md

@@ -1,6 +1,6 @@
 # Interactive Setup
 
-AIGNE DocSmith includes an interactive setup wizard, launched with the `aigne doc init` command, to streamline project configuration. This guided process asks a series of questions about your documentation goals and generates a `config.yaml` file from your answers. It is the recommended method for starting a new documentation project, as it helps prevent configuration errors and provides specific recommendations based on your inputs.
+AIGNE DocSmith includes an interactive setup wizard, launched with the `aigne doc init` command, to streamline project configuration. This guided process asks a series of questions about your documentation goals and generates a `config.yaml` file based on your answers. It is the recommended method for starting a new documentation project, as it helps prevent configuration errors and provides specific recommendations based on your inputs.
 
 ## Running the Wizard
 
@@ -68,12 +68,11 @@ Wizard-Engine.Conflict-Detection -> Final-Config
 Guided-Experience -> User-Selections: "Refines"
 ```
 
-### Default Suggestions and Option Filtering
+### Option Filtering
 
-As you make selections, the wizard provides defaults and filters subsequent options to guide you toward a logical configuration. This is based on a set of cross-question conflict rules.
+As you make selections, the wizard filters subsequent options to guide you toward a logical configuration. This is based on a set of cross-question conflict rules that prevent incompatible choices.
 
--   **Default Suggestions**: If you select "Get started quickly" as your primary goal, the wizard will recommend "Is a total beginner" as the reader's knowledge level.
--   **Real-time Filtering**: If your target audience is "End users (non-technical)," the wizard will hide the "Is an expert" knowledge level. The rule's reasoning is that non-technical users are typically not experienced technical users, thus preventing an incompatible selection.
+For example, if you select "End users (non-technical)" as your target audience, the wizard will hide the "Is an expert" knowledge level option. The rule's reasoning is that "Non-technical users are typically not experienced technical users," thus preventing an illogical selection.
 
 ### Conflict Detection and Resolution
 
@@ -121,6 +120,10 @@ targetAudienceTypes:
 # ... other settings
 ```
 
+Upon completion, you will see a confirmation message in your terminal.
+
+![A terminal window showing the successful completion of the interactive setup wizard.](../assets/screenshots/doc-complete-setup.png)
+
 ## Next Steps
 
 With your configuration file in place, you are ready to generate, translate, or publish your documentation.

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

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

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

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

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

@@ -1,94 +1,64 @@
 # 言語サポート
 
-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: "生成"
-```
+AIGNE DocSmithは、12言語へのドキュメントの自動翻訳を提供し、グローバルな読者向けのローカライズされたコンテンツの生成と維持を可能にします。この機能は主に `aigne doc translate` コマンドを通じて管理されます。
+
+翻訳ワークフローは、AIエンジンを使用してソースドキュメントを処理し、選択したターゲット言語でバージョンを生成します。`aigne doc translate` コマンドは、翻訳するドキュメントと言語を選択するためのインタラクティブなインターフェースを提供します。
+
+![インタラクティブなドキュメント翻訳フロー](../assets/screenshots/doc-translate.png)
 
 ## サポートされている言語
 
-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` | مرحبا |
+DocSmithは、以下の言語に対するAIによる翻訳をサポートしています。プロジェクトの主要言語は `aigne doc init` による初期設定時に定義でき、以下の言語からいくつでも翻訳対象として選択できます。
+
+| Language | Language Code |
+|---|---|
+| English | `en` |
+| 简体中文 | `zh` |
+| 繁體中文 | `zh-TW` |
+| 日本語 | `ja` |
+| 한국어 | `ko` |
+| Español | `es` |
+| Français | `fr` |
+| Deutsch | `de` |
+| Português | `pt` |
+| Русский | `ru` |
+| Italiano | `it` |
+| العربية | `ar` |
 
 ## 翻訳の設定と使用方法
 
-翻訳言語は、`aigne doc init`でプロジェクトを初期化する際に設定されます。`aigne doc translate`コマンドを使用すれば、いつでも新しい言語を追加したり、ドキュメントを翻訳したりできます。このコマンドには2つの操作モードがあります。
+言語設定は、プロジェクトを初期化する際に設定します。`aigne doc translate` コマンドを使用して、いつでも新しい言語を追加したり、既存のドキュメントを翻訳したりできます。このコマンドは2つの操作モードをサポートしています。
 
 ### ガイド付き翻訳のためのインタラクティブモード
 
-ステップバイステップのガイド付きエクスペリエンスを利用するには、引数なしでコマンドを実行します。これはほとんどのユーザーに推奨されるアプローチです。
+ステップバイステップのガイド付きプロセスについては、引数なしでコマンドを実行してください。この方法はほとんどのユーザーに推奨されます。
 
 ```bash Interactive Translation icon=lucide:wand
 aigne doc translate
 ```
 
-インタラクティブモードでは、一連のプロンプトが表示され、以下の操作が可能です：
+インタラクティブモードでは、一連のプロンプトが表示され、翻訳するドキュメントを選択し、リストからターゲット言語を選ぶことができます。このモードでは、プロジェクトの設定にまだ含まれていない新しい翻訳言語を追加することもできます。
 
-1.  既存のドキュメントのリストから翻訳するものを選択する。
-2.  サポートされているリストから1つ以上のターゲット言語を選択する。
-3.  プロジェクトの設定にまだ含まれていない新しい翻訳言語を追加する。
+![翻訳対象言語の選択](../assets/screenshots/doc-translate-langs.png)
 
 ### 自動化のためのコマンドライン引数
 
-直接的な制御や自動化スクリプトで使用するために、ドキュメントと言語をコマンドライン引数として直接指定できます。これは開発者やCI/CDパイプラインに最適です。
+直接制御したり、自動化スクリプトで使用したりする場合は、ドキュメントと言語をコマンドライン引数として指定できます。この方法は、CI/CDパイプラインへの統合に適しています。
 
 ```bash Command Example icon=lucide:terminal
-# overview.mdとexamples.mdを中国語と日本語に翻訳
+# overview.mdとexamples.mdを中国語と日本語に翻訳する
 aigne doc translate --langs zh --langs ja --docs overview.md --docs examples.md
 ```
 
-このコマンドの主要なパラメータは次のとおりです：
+以下の表は、`translate` コマンドの主要なパラメータを詳述しています。
 
-| パラメータ | 説明 |
+| Parameter | Description |
 |---|---|
-| `--langs` | ターゲット言語の言語コードを指定します。このフラグは複数回使用して、いくつかの言語を選択できます。 |
-| `--docs` | 翻訳するドキュメントへのパスを指定します（例：`overview.md`）。これも複数回使用できます。 |
-| `--feedback` | 翻訳モデルをガイドするための具体的な指示を提供します（例：`"フォーマルなトーンを使用する"`）。 |
+| `--langs` | ターゲット言語の言語コードを指定します。このフラグを複数回使用して、複数の言語を選択できます。 |
+| `--docs` | 翻訳するドキュメントへのパス（例：`overview.md`）を指定します。このフラグも複数回使用できます。 |
+| `--feedback` | 翻訳モデルをガイドするための特定の指示を提供します（例：`"Use a formal tone"`）。 |
 | `--glossary` | カスタム用語集ファイル（例：`@path/to/glossary.md`）を使用して、プロジェクト固有の用語の一貫した翻訳を保証します。 |
 
 ---
 
-このセクションでは、利用可能な言語とその有効化方法について説明しました。翻訳ワークフローに関する完全なガイドについては、[ドキュメントの翻訳](./features-translate-documentation.md)ガイドを参照してください。
+このセクションでは、利用可能な言語とその有効化方法の概要を説明しました。翻訳ワークフローに関する完全なガイドについては、[ドキュメントの翻訳](./features-translate-documentation.md)ガイドを参照してください。