@aigne/doc-smith 0.8.12-beta.8 → 0.8.12

package/docs/guides-managing-history.ja.md

@@ -1,48 +0,0 @@
-# 履歴の管理
-
-AIGNE DocSmithは、ドキュメントに加えられたすべての更新の時系列ログを保持します。この機能により、変更を追跡し、更新時に提供されたフィードバックを確認し、時間とともにドキュメントがどのように変化したかを理解できます。このガイドでは、この履歴にアクセスして解釈する方法について説明します。
-
-## 更新履歴の表示
-
-すべてのドキュメント更新のログを表示するには、`history view` コマンドを使用します。このコマンドは、バージョン管理ログのように、各エントリの簡潔な1行の要約を表示します。
-
-ターミナルで次のコマンドを実行してください：
-
-```bash 履歴の表示 icon=material-symbols:history
-aigne history view
-```
-
-`history` コマンドは、`view` サブコマンドの2つのエイリアス、`log` と `list` もサポートしています。以下のコマンドは同等であり、同じ出力を生成します：
-
-```bash
-aigne history log
-aigne history list
-```
-
-### 履歴出力の理解
-
-`history view` コマンドの出力は、各更新に関する主要な情報を一目でわかるようにフォーマットされています。各行は、1つの更新エントリを表します。
-
-以下にそのフォーマットの内訳を示します：
-
-| コンポーネント | 説明 |
-| :--- | :--- |
-| **Short Hash** | 更新のタイムスタンプから生成される8文字の一意の識別子。 |
-| **Date** | 更新が発生した時期を示す相対的なタイムスタンプ（例：「5 minutes ago」、「2 days ago」）。古いエントリには、特定の日付が表示されます。 |
-| **Operation** | `generate_document` や `update_document_detail` など、実行されたアクションの種類。 |
-| **Document Path** | 操作が単一ファイルを対象とした場合に、変更された特定のドキュメントのパス。これは括弧で囲まれます。 |
-| **Feedback** | 更新が行われたときに提供されたフィードバックまたは要約メッセージ。 |
-
-### 例
-
-以下は `aigne history view` コマンドを実行した際のサンプル出力です。
-
-```bash
-📜 Update History
-
-e5a4f8b1 2 hours ago update_document_detail (/guides/generating-documentation): Added a new section on advanced configuration options.
-a3b1c9d2 1 day ago  update_document_detail (/overview): Refined the introduction to be more concise.
-f8d2e0c3 3 days ago generate_document (/guides/managing-history): Initial generation of the history management guide.
-```
-
-このログは、ドキュメントの変更履歴を明確かつ整理された記録として提供し、進捗の追跡や過去の変更の確認に役立ちます。

package/docs/guides-managing-history.md

@@ -1,53 +0,0 @@
-# Managing History
-
-AIGNE DocSmith maintains a chronological log of all updates made to your documentation. This feature allows you to track changes, review the feedback provided for each update, and observe the evolution of your documents over time. This guide provides instructions on how to access and interpret this history log.
-
-## Viewing Update History
-
-To view the log of all documentation updates, use the `history view` command. This command displays a compact, one-line summary for each entry, formatted similarly to a version control log.
-
-Execute the following command in your project's root directory:
-
-```bash Viewing History icon=material-symbols:history
-aigne history view
-```
-
-For convenience, the `history` command also supports two aliases for the `view` subcommand: `log` and `list`. The following commands are equivalent to the one above and will produce the identical output:
-
-```bash
-aigne history log
-```
-
-```bash
-aigne history list
-```
-
-If no updates have been made yet, the tool will display the message: `No update history found`.
-
-### Understanding the History Output
-
-The output of the `history view` command is structured to provide key information about each update in a concise format. Each line in the log represents a single update event.
-
-The format is composed of the following components:
-
-| Component | Description |
-| :--- | :--- |
-| **Short Hash** | An 8-character unique identifier generated from the timestamp of the update. This hash is deterministic, meaning the same timestamp will always produce the same hash. |
-| **Date** | A relative timestamp indicating when the update occurred (e.g., "5 minutes ago", "2 days ago"). For entries older than one week, a specific date is shown. |
-| **Operation** | The type of action performed, such as `generate_document` or `update_document_detail`. |
-| **Document Path** | The path of the specific document that was modified, if the operation targeted a single file. This is enclosed in parentheses for clarity. |
-| **Feedback** | The summary message or feedback that was provided when the update was executed. |
-
-### Example Output
-
-Below is a sample output from running the `aigne history view` command. This example illustrates how different operations are recorded in the log.
-
-```bash
-📜 Update History
-
-e5a4f8b1 2 hours ago update_document_detail (/guides/generating-documentation): Added a new section on advanced configuration options.
-a3b1c9d2 1 day ago  update_document_detail (/overview): Refined the introduction to be more concise.
-f8d2e0c3 3 days ago generate_document (/guides/managing-history): Initial generation of the history management guide.
-```
-
-This log provides a clear and orderly record of your documentation's modification history, which is an effective tool for tracking progress and reviewing past changes.

package/docs/guides-managing-history.zh-TW.md

@@ -1,48 +0,0 @@
-# 管理歷史紀錄
-
-AIGNE DocSmith 會按時間順序記錄您對文件所做的所有更新。此功能可讓您追蹤變更、檢閱更新期間提供的回饋，並了解文件隨時間的演變過程。本指南將說明如何存取和解讀此歷史紀錄。
-
-## 查看更新歷史紀錄
-
-若要查看所有文件的更新日誌，您可以使用 `history view` 指令。此指令會為每個項目顯示精簡的單行摘要，類似於版本控制的日誌。
-
-在您的終端機中執行以下指令：
-
-```bash 查看歷史紀錄 icon=material-symbols:history
-aigne history view
-```
-
-`history` 指令也支援 `view` 子指令的兩個別名：`log` 和 `list`。以下指令是等效的，將會產生相同的輸出：
-
-```bash
-aigne history log
-aigne history list
-```
-
-### 了解歷史紀錄輸出
-
-`history view` 指令的輸出格式旨在讓您能一目了然地獲取每次更新的關鍵資訊。每一行代表一個單獨的更新項目。
-
-以下是其格式的詳細說明：
-
-| 元件 | 說明 |
-| :--- | :--- |
-| **簡短雜湊值** | 一個從更新時間戳產生的 8 字元唯一識別碼。 |
-| **日期** | 一個相對時間戳，表示更新發生的時間（例如，「5 分鐘前」、「2 天前」）。對於較舊的項目，則會顯示具體日期。 |
-| **操作** | 執行的操作類型，例如 `generate_document` 或 `update_document_detail`。 |
-| **文件路徑** | 如果操作針對的是單一檔案，則為被修改的特定文件的路徑。此路徑會用括號括起來。 |
-| **回饋** | 進行更新時所提供的回饋或摘要訊息。 |
-
-### 範例
-
-以下是執行 `aigne history view` 指令的範例輸出。
-
-```bash
-📜 更新歷史紀錄
-
-e5a4f8b1 2 小時前 update_document_detail (/guides/generating-documentation): 新增了關於進階設定選項的新章節。
-a3b1c9d2 1 天前  update_document_detail (/overview): 修訂了簡介，使其更加簡潔。
-f8d2e0c3 3 天前 generate_document (/guides/managing-history): 初次產生歷史紀錄管理指南。
-```
-
-此日誌提供了您文件修改歷史的清晰有序記錄，有助於追蹤進度和檢閱過去的變更。

package/docs/guides-managing-history.zh.md

@@ -1,48 +0,0 @@
-# 管理历史记录
-
-AIGNE DocSmith 会为您的文档所做的所有更新保留一份按时间顺序排列的日志。此功能允许您跟踪变更、审查更新期间提供的反馈，并了解文档随时间的演变过程。本指南说明了如何访问和解读此历史记录。
-
-## 查看更新历史记录
-
-要查看所有文档更新的日志，您可以使用 `history view` 命令。该命令会为每条记录显示一个紧凑的单行摘要，类似于版本控制日志。
-
-在您的终端中执行以下命令：
-
-```bash 查看历史记录 icon=material-symbols:history
-aigne history view
-```
-
-`history` 命令还支持 `view` 子命令的两个别名：`log` 和 `list`。以下命令是等效的，并将产生相同的输出：
-
-```bash
-aigne history log
-aigne history list
-```
-
-### 理解历史记录输出
-
-`history view` 命令的输出经过格式化，以便一目了然地提供每次更新的关键信息。每一行代表一条更新记录。
-
-以下是其格式的分解说明：
-
-| 组件 | 描述 |
-| :--- | :--- |
-| **短哈希值** | 根据更新时间戳生成的 8 位字符唯一标识符。 |
-| **日期** | 一个相对时间戳，表示更新发生的时间（例如，“5 分钟前”、“2 天前”）。对于较早的记录，会显示具体日期。 |
-| **操作** | 执行的操作类型，例如 `generate_document` 或 `update_document_detail`。 |
-| **文档路径** | 如果操作针对单个文件，则为被修改的具体文档的路径。该路径包含在括号中。 |
-| **反馈** | 更新时提供的反馈或摘要信息。 |
-
-### 示例
-
-以下是运行 `aigne history view` 命令的示例输出。
-
-```bash
-📜 更新历史记录
-
-e5a4f8b1 2 hours ago update_document_detail (/guides/generating-documentation): Added a new section on advanced configuration options.
-a3b1c9d2 1 day ago  update_document_detail (/overview): Refined the introduction to be more concise.
-f8d2e0c3 3 days ago generate_document (/guides/managing-history): Initial generation of the history management guide.
-```
-
-此日志为您的文档修改历史提供了清晰有序的记录，有助于跟踪进度和回顾过去的变更。

package/docs/guides-publishing-your-docs.ja.md

@@ -1,78 +0,0 @@
-# ドキュメントの公開
-
-ドキュメントを生成したら、次のステップはそれをオンラインで公開し、読者がアクセスできるようにすることです。このガイドでは、`aigne doc publish` コマンドを使用した公開プロセスの体系的な概要を説明します。
-
-## 公開コマンド
-
-ドキュメントを公開するための主要なコマンドは `aigne doc publish` です。このコマンドは、生成されたファイルをウェブサービスにアップロードし、ブラウザで表示できるようにします。
-
-このコマンドは、フルネームまたは短いエイリアスで実行できます：
-
-```bash
-# フルコマンド
-aigne doc publish
-
-# エイリアス
-aigne doc pub
-aigne doc p
-```
-
-publish コマンドを初めて実行すると、希望する公開プラットフォームを選択するための対話型プロンプトが表示されます。
-
-## 公開オプション
-
-ドキュメントをホストする場所にはいくつかのオプションがあります。対話型プロンプトが選択をガイドします。
-
-### 1. DocSmith Cloud（無料ホスティング）
-
-このオプションは、AIGNE が提供する無料のホスティングサービスである `docsmith.aigne.io` にドキュメントを公開します。
-
--   **ユースケース：** オープンソースプロジェクト、個人ブログなど、カスタムインフラを必要とせず公開アクセスが必要なあらゆるシナリオに最適です。
--   **コスト：** 無料。
--   **結果：** 公開が成功すると、提供された URL でドキュメントが公開されます。
-
-### 2. 既存のウェブサイト
-
-このオプションを使用すると、すでに所有および管理しているウェブサイトにドキュメントを公開できます。
-
--   **ユースケース：** 既存の会社のウェブサイト、製品サイト、または個人ドメインにドキュメントを直接統合する場合に最適です。この方法では、Discuss Kit の独自のインスタンスを実行する必要があります。
--   **コスト：** 独自のホスティングインフラが必要です。
--   **セットアップ：**
-    1.  プロンプトでこのオプションを選択します。
-    2.  ウェブサイトの URL を入力するよう求められます（例：`https://docs.your-company.com`）。
-    3.  独自のドキュメントウェブサイトをセットアップするには、公式ストアから Discuss Kit インスタンスを入手できます：[https://www.web3kit.rocks/discuss-kit](https://www.web3kit.rocks/discuss-kit)。
-
-### 3. 新規ウェブサイト（有料サービス）
-
-既存のウェブサイトがない場合、このサービスはドキュメント専用の新しいサイトをセットアップするのに役立ちます。
-
--   **ユースケース：** カスタムドメインと管理されたホスティングを備えた、プロフェッショナルでスタンドアロンのドキュメントポータルを作成するのに適しています。
--   **コスト：** これは有料サービスです。
--   **プロセス：** コマンドは、新しい Discuss Kit インスタンスのデプロイと設定に必要な手順をガイドします。このプロセスを以前に開始したことがある場合は、以前のセットアップを再開するオプションも表示されます。
-
-## 直接公開
-
-CI/CD パイプラインなどの自動化されたワークフローの場合、または初期設定が完了した後は、アプリケーションの URL を直接指定することで対話型プロンプトをバイパスできます。
-
-`--appUrl` フラグに続けてウェブサイトの URL を指定します。
-
-```bash
-# カスタムドキュメントサイトの例
-aigne doc publish --appUrl https://docs.your-company.com
-```
-
-特定の URL への公開に成功すると（プロンプトでオプションを選択するか、`--appUrl` フラグを使用するかのいずれか）、DocSmith はこの URL をローカル設定に保存します。次回以降の実行時には、再度尋ねることなく、保存された URL に自動的に公開します。
-
-## トラブルシューティング
-
-### 認証エラー
-
-「401」または「403」を含むエラーメッセージが表示された場合、認証トークンが無効であるか、期限切れであることを示します。これは、権限が変更された場合や、トークンが古い場合に発生する可能性があります。
-
-これを解決するには、`clear` コマンドを実行して、保存されているすべての設定と認証情報をクリアします：
-
-```bash
-aigne doc clear
-```
-
-設定をクリアした後、再度 `aigne doc publish` を実行してください。初めて実行したときのように、認証とセットアップのプロセスがガイドされます。

package/docs/guides-publishing-your-docs.md

@@ -1,83 +0,0 @@
-# Publishing Your Docs
-
-After generating your documentation, the next step is to make it accessible online. This guide provides a systematic procedure for publishing your documentation using the `aigne doc publish` command.
-
-## The Publish Command
-
-The `aigne doc publish` command uploads your generated documentation files to a web service, making them available to your audience through a web browser.
-
-You can execute the command using its full name or one of its aliases for convenience.
-
-```bash Command Execution icon=lucide:terminal
-# Full command
-aigne doc publish
-
-# Aliases
-aigne doc pub
-aigne doc p
-```
-
-When this command is run for the first time, it initiates an interactive prompt to guide you through selecting a publishing platform.
-
-![Publish Documentation Dialog](../assets/screenshots/doc-publish.png)
-
-## Publishing Destinations
-
-The tool provides several destinations for hosting your documentation. The interactive setup will present the following choices.
-
-### Option 1: DocSmith Cloud
-
-This option publishes your documentation to `docsmith.aigne.io`, a free hosting service.
-
-*   **Intended Use**: This method is suitable for open-source projects or any documentation that is intended for public access.
-*   **Cost**: Free.
-*   **Outcome**: Your documentation will be publicly available at a URL provided after the publishing process is complete.
-
-### Option 2: Your Existing Website
-
-This option allows you to publish documentation to a website you already own and manage. It requires you to operate your own instance of Discuss Kit.
-
-*   **Intended Use**: This is for integrating documentation directly into an existing company website, product portal, or personal domain.
-*   **Requirements**: You must have your own hosting infrastructure and a running instance of Discuss Kit.
-*   **Procedure**:
-    1.  Select the "Your existing website" option from the interactive prompt.
-    2.  When prompted, enter the full URL of your website (e.g., `https://docs.your-company.com`).
-    3.  To set up your own documentation website, you can obtain a Discuss Kit instance from the official store: [https://www.web3kit.rocks/discuss-kit](https://www.web3kit.rocks/discuss-kit). Discuss Kit is a non-open-source service that provides the necessary backend for hosting.
-
-### Option 3: New Website
-
-This option assists you in setting up a new, dedicated website for your documentation.
-
-*   **Intended Use**: This is for users who need a standalone documentation portal but do not have an existing website.
-*   **Cost**: This is a paid service.
-*   **Procedure**: The command-line interface will guide you through the process of deploying and configuring a new Discuss Kit instance. If you have previously started this process, an option to resume the setup will also be available.
-
-## Automated Publishing
-
-For automated environments, such as a Continuous Integration/Continuous Deployment (CI/CD) pipeline, you can bypass the interactive prompt by specifying the destination URL directly.
-
-Use the `--appUrl` flag with the command to define the publishing target.
-
-```bash Direct Publishing Example icon=lucide:terminal
-aigne doc publish --appUrl https://docs.your-company.com
-```
-
-Once you publish to a specific URL for the first time (either through the interactive prompt or the `--appUrl` flag), the tool saves this URL to your local configuration file. Subsequent executions of `aigne doc publish` will automatically use the saved URL, streamlining the update process.
-
-## Troubleshooting
-
-### Authorization Errors
-
-If the publishing process fails with an error message that includes "401" or "403," it signifies an issue with your authentication token. The token may be invalid, expired, or lack the required permissions.
-
-To resolve this, reset your local configuration and credentials by running the `clear` command:
-
-```bash Clear Configuration icon=lucide:terminal
-aigne doc clear
-```
-
-After the command completes, run `aigne doc publish` again. You will be prompted to re-authenticate and configure your publishing destination.
-
----
-
-After successfully publishing your documentation, you may need to update it as your project evolves. For instructions on this process, please see the [Updating Documentation](./guides-updating-documentation.md) guide.

package/docs/guides-publishing-your-docs.zh-TW.md

@@ -1,78 +0,0 @@
-# 發布您的文件
-
-產生文件後，下一步就是將其發布到網路上，讓您的受眾可以存取。本指南將系統性地介紹如何使用 `aigne doc publish` 命令來進行發布流程。
-
-## 發布命令
-
-讓您的文件上線的主要命令是 `aigne doc publish`。此命令會將您產生的檔案上傳到網路服務，以便在瀏覽器中查看。
-
-您可以使用其完整名稱或較短的別名來執行此命令：
-
-```bash
-# 完整命令
-aigne doc publish
-
-# 別名
-aigne doc pub
-aigne doc p
-```
-
-當您首次執行發布命令時，系統會顯示一個互動式提示，讓您選擇偏好的發布平台。
-
-## 發布選項
-
-您有多個選項來託管您的文件。互動式提示將引導您完成選擇。
-
-### 1. DocSmith Cloud (免費託管)
-
-此選項會將您的文件發布到 `docsmith.aigne.io`，這是由 AIGNE 提供的免費託管服務。
-
--   **使用情境：** 非常適合開源專案、個人部落格，或任何希望在無需自訂基礎設施的情況下實現公開存取的場景。
--   **成本：** 免費。
--   **結果：** 成功發布後，您的文件將可透過一個提供的 URL 公開存取。
-
-### 2. 您現有的網站
-
-此選項讓您可以將文件發布到您已擁有並管理的網站。
-
--   **使用情境：** 最適合將文件直接整合到現有的公司網站、產品網站或個人網域。此方法需要您執行自己的 Discuss Kit 實例。
--   **成本：** 需要您自己的託管基礎設施。
--   **設定：**
-    1.  在提示中選擇此選項。
-    2.  系統會要求您輸入網站的 URL (例如：`https://docs.your-company.com`)。
-    3.  若要設定您自己的文件網站，您可以從官方商店取得 Discuss Kit 實例：[https://www.web3kit.rocks/discuss-kit](https://www.web3kit.rocks/discuss-kit)。
-
-### 3. 新網站 (付費服務)
-
-如果您沒有現成的網站，此服務可協助您為文件建立一個新的專屬網站。
-
--   **使用情境：** 適合用於建立一個專業、獨立的文件入口網站，並為您管理自訂網域和託管。
--   **成本：** 此為付費服務。
--   **流程：** 此命令將引導您完成部署和設定新 Discuss Kit 實例的必要步驟。如果您之前已開始此流程，您也會看到一個選項來繼續先前的設定。
-
-## 直接發布
-
-對於自動化工作流程 (例如 CI/CD 管線)，或在您完成初始設定後，您可以透過直接指定應用程式 URL 來繞過互動式提示。
-
-使用 `--appUrl` 旗標，並在後面加上您網站的 URL。
-
-```bash
-# 自訂文件網站的範例
-aigne doc publish --appUrl https://docs.your-company.com
-```
-
-一旦您成功發布到特定 URL (無論是透過在提示中選擇選項或使用 `--appUrl` 旗標)，DocSmith 會將此 URL 儲存在您的本機設定中。在後續執行時，它將自動發布到已儲存的 URL，而不會再次詢問。
-
-## 疑難排解
-
-### 授權錯誤
-
-如果您遇到包含「401」或「403」的錯誤訊息，這表示您的驗證權杖無效或已過期。如果權限已變更或權杖過舊，就可能發生這種情況。
-
-要解決此問題，您可以執行 `clear` 命令來清除所有儲存的設定和憑證：
-
-```bash
-aigne doc clear
-```
-
-清除設定後，再次執行 `aigne doc publish`。系統將引導您完成驗證和設定流程，就像第一次執行一樣。

package/docs/guides-publishing-your-docs.zh.md

@@ -1,78 +0,0 @@
-# 发布您的文档
-
-生成文档后，下一步是将其发布到线上，以便您的受众可以访问。本指南系统地概述了使用 `aigne doc publish` 命令的发布过程。
-
-## 发布命令
-
-`aigne doc publish` 是用于上线文档的主要命令。该命令会将您生成的文件上传到 Web 服务，以便在浏览器中查看。
-
-您可以使用其完整名称或更短的别名来执行该命令：
-
-```bash
-# 完整命令
-aigne doc publish
-
-# 别名
-aigne doc pub
-aigne doc p
-```
-
-当您首次运行发布命令时，系统将显示一个交互式提示，让您选择首选的发布平台。
-
-## 发布选项
-
-您有多种托管文档的选项。交互式提示将引导您完成选择。
-
-### 1. DocSmith Cloud（免费托管）
-
-此选项会将您的文档发布到 `docsmith.aigne.io`，这是 AIGNE 提供的免费托管服务。
-
--   **用例：** 非常适合开源项目、个人博客或任何希望在无需自定义基础设施的情况下实现公开访问的场景。
--   **成本：** 免费。
--   **结果：** 您的文档将在发布成功后通过提供的 URL 公开访问。
-
-### 2. 您现有的网站
-
-此选项允许您将文档发布到您已拥有并管理的网站。
-
--   **用例：** 最适合将文档直接集成到现有公司网站、产品站点或个人域名中。此方法需要您运行自己的 Discuss Kit 实例。
--   **成本：** 需要您自己的托管基础设施。
--   **设置：**
-    1.  在提示中选择此选项。
-    2.  系统会要求您输入网站的 URL（例如，`https://docs.your-company.com`）。
-    3.  要设置您自己的文档网站，您可以从官方商店获取 Discuss Kit 实例：[https://www.web3kit.rocks/discuss-kit](https://www.web3kit.rocks/discuss-kit)。
-
-### 3. 新网站（付费服务）
-
-如果您没有现有网站，此服务可以帮助您为文档建立一个新的专用站点。
-
--   **用例：** 适合创建具有自定义域名和托管服务的专业、独立的文档门户。
--   **成本：** 这是一项付费服务。
--   **流程：** 该命令将引导您完成部署和配置新的 Discuss Kit 实例所需的步骤。如果您之前已开始此过程，您还会看到一个恢复先前设置的选项。
-
-## 直接发布
-
-对于自动化工作流（如 CI/CD 管道），或在您完成初始设置后，您可以通过直接指定应用程序 URL 来绕过交互式提示。
-
-使用 `--appUrl` 标志，后跟您的网站 URL。
-
-```bash
-# 自定义文档站点示例
-aigne doc publish --appUrl https://docs.your-company.com
-```
-
-当您成功发布到特定 URL（通过在提示中选择选项或使用 `--appUrl` 标志）后，DocSmith 会将此 URL 保存在您的本地配置中。在后续运行中，它将自动发布到已保存的 URL，而不会再次询问。
-
-## 问题排查
-
-### 授权错误
-
-如果您遇到包含“401”或“403”的错误消息，这表示您的身份验证令牌无效或已过期。如果权限已更改或令牌过旧，可能会发生这种情况。
-
-要解决此问题，您可以运行 `clear` 命令来清除所有存储的配置和凭据：
-
-```bash
-aigne doc clear
-```
-
-清除配置后，再次运行 `aigne doc publish`。系统将引导您完成身份验证和设置过程，就像第一次一样。

package/docs/guides-translating-documentation.ja.md

@@ -1,95 +0,0 @@
-# ドキュメントの翻訳
-
-このガイドでは、`aigne doc translate` コマンドを使用して、生成されたドキュメントを多言語に翻訳する方法について説明します。このプロセスでは AI を使用して、翻訳が文脈を認識し、技術的な正確性を維持するようにします。
-
-このツールは12の言語をサポートしており、世界中のオーディエンスにリーチすることができます。ソースドキュメントの主要言語は、利用可能な翻訳言語のリストから自動的に除外されます。
-
-## `translate` コマンド
-
-`aigne doc translate` コマンドは、既存のドキュメントファイルの翻訳を生成するために使用されます。対話形式で実行して、翻訳したいドキュメントと言語を選択することも、自動化されたワークフローのためにコマンドラインフラグを使用してこれらのオプションを直接指定することもできます。
-
-### 対話モード
-
-ガイド付きのエクスペリエンスを利用するには、引数なしでコマンドを実行します。
-
-```bash
-aigne doc translate
-```
-
-実行されると、ツールは以下の手順を実行します。
-1.  既存のドキュメントをスキャンします。
-2.  リストから翻訳したい特定のドキュメントを選択するように求めます。
-3.  翻訳の対象言語を選択するように求めます。以前に選択した言語は、便宜上、事前にチェックされています。
-4.  選択された各ドキュメントと言語のペアに対して翻訳プロセスを開始します。
-5.  翻訳されたファイルを同じディレクトリに保存します。新しいファイルは、元のファイル名に言語コードを追加して命名されます（例：`overview.md` の中国語翻訳は `overview.zh.md` になります）。
-
-### コマンドラインオプション
-
-非対話的な使用やスクリプト作成のために、以下のコマンドラインフラグを使用して翻訳プロセスを制御できます。
-
-<x-field-group>
-  <x-field data-name="--docs" data-type="array<string>">
-    <x-field-desc markdown>翻訳する1つ以上のドキュメントパスを指定します。指定しない場合、ツールは対話モードに入り、利用可能なドキュメントのリストから選択できるようになります。</x-field-desc>
-  </x-field>
-  <x-field data-name="--langs" data-type="array<string>">
-    <x-field-desc markdown>1つ以上のターゲット言語コード（例：`zh`、`ja`）を指定します。省略した場合、対話形式で言語を選択するように求められます。</x-field-desc>
-  </x-field>
-  <x-field data-name="--glossary" data-type="string">
-    <x-field-desc markdown>用語集ファイルへのパス（例：`@path/to/glossary.md`）を提供します。これにより、特定の技術用語がすべてのドキュメントで一貫して翻訳されるようになります。</x-field-desc>
-  </x-field>
-  <x-field data-name="--feedback" data-type="string">
-    <x-field-desc markdown>トーンや用語の調整など、AIの翻訳スタイルをガイドするための具体的な指示やフィードバックを提供します。</x-field-desc>
-  </x-field>
-</x-field-group>
-
-### 使用例
-
-#### 1. 特定のドキュメントを複数の言語に翻訳する
-
-対話プロンプトなしで `overview.md` と `examples.md` を中国語（`zh`）と日本語（`ja`）に翻訳するには：
-
-```bash
-aigne doc translate --docs overview.md --docs examples.md --langs zh --langs ja
-```
-
-#### 2. 用語集を使用して一貫した用語を確保する
-
-技術用語が正しく翻訳されるように、用語集ファイルを提供します。これは、ブランド名や専門用語の一貫性を維持するのに役立ちます。
-
-```bash
-aigne doc translate --glossary @./glossary.md
-```
-
-#### 3. フィードバックを提供して翻訳スタイルを洗練させる
-
-フィードバックを提供することで、翻訳スタイルをガイドできます。例えば、よりフォーマルなトーンをリクエストするには：
-
-```bash
-aigne doc translate --feedback "Use a formal, technical tone for all translations."
-```
-
-このフィードバックは、更新されたドキュメントの履歴に記録されます。
-
-## サポートされている言語
-
-このツールは12言語の翻訳をサポートしています。ドキュメントのネイティブ言語は英語（`en`）です。
-
-| 言語 | コード |
-| :--- | :--- |
-| 中国語（簡体字） | `zh` |
-| 中国語（繁体字）| `zh-TW`|
-| 日本語 | `ja` |
-| 韓国語 | `ko` |
-| スペイン語 | `es` |
-| フランス語 | `fr` |
-| ドイツ語 | `de` |
-| ポルトガル語 | `pt` |
-| ロシア語 | `ru` |
-| イタリア語 | `it` |
-| アラビア語 | `ar` |
-
-## 概要
-
-`translate` コマンドは、ドキュメントをローカライズするための構造化された方法を提供します。対話モードを使用してガイド付きの翻訳を行ったり、コマンドラインオプションを使用して自動化されたワークフローを構築したりできます。用語集やフィードバックなどの機能を使用することで、翻訳コンテンツの品質と一貫性を維持するのに役立ちます。
-
-ドキュメントを翻訳した後、[ドキュメントの公開](./guides-publishing-your-docs.md)に進むことができます。