@aigne/doc-smith 0.8.12-beta.3 → 0.8.12-beta.5

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

@@ -1,138 +0,0 @@
-# インタラクティブなセットアップ
-
-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が競合解決戦略とともに生成される"
-}
-
-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: Your project description.
-projectLogo: ""
-
-# =============================================================================
-# Documentation Configuration
-# =============================================================================
-
-# Purpose: What's the main outcome you want readers to achieve?
-# Available options (uncomment and modify as needed):
-#   getStarted       - すぐに始める: 新規ユーザーが30分未満でゼロから作業を開始できるように支援
-#   completeTasks    - 特定のタスクを完了する: 一般的なワークフローやユースケースをユーザーに案内
-documentPurpose:
-  - completeTasks
-  - findAnswers
-
-# Target Audience: Who will be reading this most often?
-# Available options (uncomment and modify as needed):
-#   endUsers         - エンドユーザー (非技術者): 製品を使用するがコーディングはしない人々
-#   developers       - 開発者 (製品/APIを統合): これを自分のプロジェクトに追加するエンジニア
-targetAudienceTypes:
-  - endUsers
-  - developers
-
-# ... その他の設定
-```
-
-完了すると、ターミナルに確認メッセージが表示されます。
-
-![インタラクティブなセットアップウィザードが正常に完了したことを示すターミナルウィンドウ。](../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ファイルを手動で微調整する方法を学びます。
-  </x-card>
-</x-cards>

package/docs/configuration-interactive-setup.md

@@ -1,138 +0,0 @@
-# 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 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
-
-To start the process, run the following command in the root directory of your project:
-
-```bash aigne doc init icon=lucide:sparkles
-npx aigne doc init
-```
-
-The wizard will then walk you through an 8-step process to configure your documentation.
-
-## The Guided Process
-
-The wizard prompts for the following key configuration details:
-
-1.  **Primary Goal**: Defines the main purpose for your readers (e.g., getting started, finding answers).
-2.  **Target Audience**: Specifies the primary readers of the documentation (e.g., non-technical end-users, developers).
-3.  **Reader Knowledge Level**: Assesses the typical starting knowledge of your audience.
-4.  **Documentation Depth**: Determines the level of detail and scope of the content.
-5.  **Primary Language**: Sets the main language for the documentation.
-6.  **Translation Languages**: Selects additional languages for translation.
-7.  **Output Directory**: Specifies the location for the generated documentation files.
-8.  **Source Code Paths**: Defines which files and directories to analyze, with support for glob patterns.
-
-## Assisted Configuration
-
-The wizard uses a set of predefined rules to help you create a coherent and effective configuration.
-
-```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"
-```
-
-### Option Filtering
-
-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.
-
-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
-
-In some cases, you may have multiple goals or audiences that require a specific documentation structure to be effective, such as creating documentation for both non-technical **End Users** and expert **Developers**. The wizard identifies these as "resolvable conflicts."
-
-It then formulates a strategy to address these needs within the documentation structure. For the End User vs. Developer example, the resolution strategy is to create separate user paths:
-
--   **User Guide Path**: Uses plain language, focuses on UI interactions, and is oriented toward business outcomes.
--   **Developer Guide Path**: Is code-first, technically precise, and includes SDK examples and configuration snippets.
-
-This approach ensures the final documentation is structured to serve multiple audiences effectively, rather than creating a single, confusing mix of content.
-
-## Generated Output
-
-After you complete the wizard, it saves a `config.yaml` file in your project. This file is fully commented, explaining each option and listing all available choices, which makes it easy to review and modify manually later.
-
-Here is a snippet of a generated file:
-
-```yaml config.yaml icon=logos:yaml
-# Project information for documentation publishing
-projectName: your-project-name
-projectDesc: Your project description.
-projectLogo: ""
-
-# =============================================================================
-# Documentation Configuration
-# =============================================================================
-
-# Purpose: What's the main outcome you want readers to achieve?
-# Available options (uncomment and modify as needed):
-#   getStarted       - Get started quickly: Help new users go from zero to working in <30 minutes
-#   completeTasks    - Complete specific tasks: Guide users through common workflows and use cases
-documentPurpose:
-  - completeTasks
-  - findAnswers
-
-# Target Audience: Who will be reading this most often?
-# Available options (uncomment and modify as needed):
-#   endUsers         - End users (non-technical): People who use the product but don't code
-#   developers       - Developers integrating your product/API: Engineers adding this to their projects
-targetAudienceTypes:
-  - endUsers
-  - developers
-
-# ... 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.
-
-<x-cards>
-  <x-card data-title="Generate Documentation" data-icon="lucide:play-circle" data-href="/features/generate-documentation">
-    Learn how to use a single command to automatically create a complete set of documentation from your source code.
-  </x-card>
-  <x-card data-title="Configuration Guide" data-icon="lucide:settings" data-href="/configuration">
-    Dive deeper into all available settings and learn how to fine-tune the config.yaml file manually.
-  </x-card>
-</x-cards>

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

@@ -1,138 +0,0 @@
-# 互動式設定
-
-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: "優化"
-```
-
-### 選項篩選
-
-當您進行選擇時，精靈會篩選後續選項，引導您達成一個合乎邏輯的設定。這是基於一組跨問題的衝突規則，用以防止不相容的選擇。
-
-例如，如果您選擇「終端使用者（非技術背景）」作為您的目標受眾，精靈將會隱藏「是專家」這個知識水平選項。該規則的理由是「非技術背景的使用者通常不是經驗豐富的技術使用者」，從而防止不合邏輯的選擇。
-
-### 衝突偵測與解決
-
-在某些情況下，您可能有多個目標或受眾，需要特定的文件結構才能有效，例如為非技術背景的**終端使用者**和專業的**開發人員**建立文件。精靈將這些情況識別為「可解決的衝突」。
-
-然後，它會制定一個策略，在文件結構內解決這些需求。以終端使用者與開發人員的例子來說，解決策略是建立獨立的使用者路徑：
-
--   **使用者指南路徑**：使用淺顯的語言，專注於使用者介面互動，並以業務成果為導向。
--   **開發人員指南路徑**：以程式碼優先，技術上精確，並包含 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
-
-# ... 其他設定
-```
-
-完成後，您將在終端機中看到一條確認訊息。
-
-![一個終端機視窗，顯示互動式設定精靈已成功完成。](../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 檔案。
-  </x-card>
-</x-cards>

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

@@ -1,138 +0,0 @@
-# 交互式设置
-
-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: Your project description.
-projectLogo: ""
-
-# =============================================================================
-# 文档配置
-# =============================================================================
-
-# 目的：您希望读者达成的最主要成果是什么？
-# 可用选项（根据需要取消注释并修改）：
-#   getStarted       - 快速入门：帮助新用户在 30 分钟内从零开始上手
-#   completeTasks    - 完成特定任务：引导用户完成常见工作流程和用例
-documentPurpose:
-  - completeTasks
-  - findAnswers
-
-# 目标受众：谁会最常阅读这份文档？
-# 可用选项（根据需要取消注释并修改）：
-#   endUsers         - 最终用户（非技术）：使用产品但不编写代码的人
-#   developers       - 集成您的产品/API 的开发者：将此产品添加到其项目中的工程师
-targetAudienceTypes:
-  - endUsers
-  - developers
-
-# ... 其他设置
-```
-
-完成后，您将在终端中看到一条确认消息。
-
-![一个终端窗口，显示交互式设置向导成功完成。](../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 文件。
-  </x-card>
-</x-cards>

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

@@ -1,64 +0,0 @@
-# 言語サポート
-
-AIGNE DocSmithは、12言語へのドキュメントの自動翻訳を提供し、グローバルな読者向けのローカライズされたコンテンツの生成と維持を可能にします。この機能は主に `aigne doc translate` コマンドを通じて管理されます。
-
-翻訳ワークフローは、AIエンジンを使用してソースドキュメントを処理し、選択したターゲット言語でバージョンを生成します。`aigne doc translate` コマンドは、翻訳するドキュメントと言語を選択するためのインタラクティブなインターフェースを提供します。
-
-![インタラクティブなドキュメント翻訳フロー](../assets/screenshots/doc-translate.png)
-
-## サポートされている言語
-
-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 translate` コマンドを使用して、いつでも新しい言語を追加したり、既存のドキュメントを翻訳したりできます。このコマンドは2つの操作モードをサポートしています。
-
-### ガイド付き翻訳のためのインタラクティブモード
-
-ステップバイステップのガイド付きプロセスについては、引数なしでコマンドを実行してください。この方法はほとんどのユーザーに推奨されます。
-
-```bash Interactive Translation icon=lucide:wand
-aigne doc translate
-```
-
-インタラクティブモードでは、一連のプロンプトが表示され、翻訳するドキュメントを選択し、リストからターゲット言語を選ぶことができます。このモードでは、プロジェクトの設定にまだ含まれていない新しい翻訳言語を追加することもできます。
-
-![翻訳対象言語の選択](../assets/screenshots/doc-translate-langs.png)
-
-### 自動化のためのコマンドライン引数
-
-直接制御したり、自動化スクリプトで使用したりする場合は、ドキュメントと言語をコマンドライン引数として指定できます。この方法は、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
-```
-
-以下の表は、`translate` コマンドの主要なパラメータを詳述しています。
-
-| Parameter | Description |
-|---|---|
-| `--langs` | ターゲット言語の言語コードを指定します。このフラグを複数回使用して、複数の言語を選択できます。 |
-| `--docs` | 翻訳するドキュメントへのパス（例：`overview.md`）を指定します。このフラグも複数回使用できます。 |
-| `--feedback` | 翻訳モデルをガイドするための特定の指示を提供します（例：`"Use a formal tone"`）。 |
-| `--glossary` | カスタム用語集ファイル（例：`@path/to/glossary.md`）を使用して、プロジェクト固有の用語の一貫した翻訳を保証します。 |
-
----
-
-このセクションでは、利用可能な言語とその有効化方法の概要を説明しました。翻訳ワークフローに関する完全なガイドについては、[ドキュメントの翻訳](./features-translate-documentation.md)ガイドを参照してください。