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

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

@@ -1,14 +1,14 @@
 # Publishing Your Docs
 
-Once you have generated your documentation, the next step is to publish it online, making it accessible to your audience. This guide provides a systematic overview of the publishing process using the `aigne doc publish` command.
+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 primary command for making your documentation live is `aigne doc publish`. This command uploads your generated files to a web service, where they can be viewed in a browser.
+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 its shorter aliases:
+You can execute the command using its full name or one of its aliases for convenience.
 
-```bash
+```bash Command Execution icon=lucide:terminal
 # Full command
 aigne doc publish
 
@@ -17,62 +17,67 @@ aigne doc pub
 aigne doc p
 ```
 
-When you run the publish command for the first time, you will be presented with an interactive prompt to select your preferred publishing platform.
+When this command is run for the first time, it initiates an interactive prompt to guide you through selecting a publishing platform.
 
-## Publishing Options
+![Publish Documentation Dialog](../assets/screenshots/doc-publish.png)
 
-You have several options for where to host your documentation. The interactive prompt will guide you through the selection.
+## Publishing Destinations
 
-### 1. DocSmith Cloud (Free Hosting)
+The tool provides several destinations for hosting your documentation. The interactive setup will present the following choices.
 
-This option publishes your documentation to `docsmith.aigne.io`, a free hosting service provided by AIGNE.
+### Option 1: DocSmith Cloud
 
--   **Use Case:** Ideal for open-source projects, personal blogs, or any scenario where public accessibility is desired without the need for custom infrastructure.
--   **Cost:** Free.
--   **Outcome:** Your documents will be publicly available at a URL provided upon successful publication.
+This option publishes your documentation to `docsmith.aigne.io`, a free hosting service.
 
-### 2. Your Existing Website
+*   **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.
 
-This option allows you to publish the documentation to a website that you already own and manage.
+### Option 2: Your Existing Website
 
--   **Use Case:** Best for integrating documentation directly into an existing company website, product site, or personal domain. This method requires you to run your own instance of Discuss Kit.
--   **Cost:** Requires your own hosting infrastructure.
--   **Setup:**
-    1.  Select this option in the prompt.
-    2.  You will be asked to enter the URL of your website (e.g., `https://docs.your-company.com`).
-    3.  To set up your own documentation website, you can get a Discuss Kit instance from the official store: [https://www.web3kit.rocks/discuss-kit](https://www.web3kit.rocks/discuss-kit).
+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.
 
-### 3. New Website (Paid Service)
+*   **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.
 
-If you do not have an existing website, this service helps you set up a new, dedicated site for your documentation.
+### Option 3: New Website
 
--   **Use Case:** Suitable for creating a professional, standalone documentation portal with a custom domain and hosting managed for you.
--   **Cost:** This is a paid service.
--   **Process:** The command will guide you through the necessary steps to deploy and configure a new Discuss Kit instance. If you have started this process before, you will also see an option to resume your previous setup.
+This option assists you in setting up a new, dedicated website for your documentation.
 
-## Direct Publishing
+*   **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.
 
-For automated workflows, such as CI/CD pipelines, or after you have completed the initial setup, you can bypass the interactive prompt by specifying the application URL directly.
+## Automated Publishing
 
-Use the `--appUrl` flag followed by your website's URL.
+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.
 
-```bash
-# Example for a custom documentation site
+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 successfully publish to a specific URL (either by selecting an option in the prompt or by using the `--appUrl` flag), DocSmith saves this URL in your local configuration. On subsequent runs, it will automatically publish to the saved URL without asking again.
+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 you encounter an error message containing "401" or "403," it indicates that your authentication token is invalid or has expired. This can happen if permissions have changed or if the token is old.
+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, you can clear all stored configuration and credentials by running the `clear` command:
+To resolve this, reset your local configuration and credentials by running the `clear` command:
 
-```bash
+```bash Clear Configuration icon=lucide:terminal
 aigne doc clear
 ```
 
-After clearing the configuration, run `aigne doc publish` again. You will be guided through the authentication and setup process as if it were the first time.
+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-translating-documentation.ja.md

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

package/docs/guides-translating-documentation.md

@@ -2,43 +2,48 @@
 
 This guide provides instructions on how to translate your generated documentation into multiple languages using the `aigne doc translate` command. The process uses AI to ensure translations are contextually aware and maintain technical accuracy.
 
-The tool supports 12 languages, allowing you to reach a global audience. The primary language of your source documents will be automatically excluded from the list of available translation languages.
+The tool supports 12 languages, such as Chinese, Japanese, and German, allowing you to make your documentation accessible to a global audience. The primary language of your source documents is automatically excluded from the list of available translation languages.
 
 ## The `translate` Command
 
-The `aigne doc translate` command is used to generate translations for your existing documentation files. You can run it interactively to select which documents and languages you want, or you can specify these options directly using command-line flags for automated workflows.
+The `aigne doc translate` command generates translations for your existing documentation files. You can run it in an interactive mode for a step-by-step process or specify options directly on the command line for faster, automated workflows.
 
 ### Interactive Mode
 
-For a guided experience, run the command without any arguments:
+For a guided experience, run the command without any arguments. This is the recommended approach for new users.
 
 ```bash
 aigne doc translate
 ```
 
-When executed, the tool will perform the following steps:
-1.  Scan for existing documents.
-2.  Prompt you to select the specific documents you wish to translate from a list.
-3.  Prompt you to select the target languages for translation. Previously selected languages will be pre-checked for convenience.
-4.  Begin the translation process for each selected document and language pair.
-5.  Save the translated files in the appropriate language-specific directories.
+When you run this command, the tool will guide you through the following steps:
+
+1.  **Select Documents:** You will be prompted to choose the specific documents you wish to translate from a list of all available files in your project.
+
+    ![Select documents to translate](../assets/screenshots/doc-translate.png)
+
+2.  **Select Languages:** Next, you will be asked to select the target languages for translation. Any languages you have used before will be pre-selected to save time.
+
+    ![Select languages for translation](../assets/screenshots/doc-translate-langs.png)
+
+3.  **Process and Save:** The tool begins the translation process. Once complete, the translated files are saved in the same directory as the original files. The new files are named by adding a language code to the original filename. For example, a Chinese translation of `overview.md` will be saved as `overview.zh.md`.
 
 ### Command-Line Options
 
-For non-interactive use or scripting, you can use the following command-line flags to control the translation process.
+For non-interactive use or scripting, you can use command-line flags to control the translation process. This method is efficient when you already know which files and languages you need.
 
 <x-field-group>
   <x-field data-name="--docs" data-type="array<string>">
-    <x-field-desc markdown>Specify one or more document paths to translate. If not provided, the tool will enter interactive mode to let you select from a list of available documents.</x-field-desc>
+    <x-field-desc markdown>Specify one or more document paths to translate. If this flag is not used, the tool will start in interactive mode to let you select from a list of available documents.</x-field-desc>
   </x-field>
   <x-field data-name="--langs" data-type="array<string>">
-    <x-field-desc markdown>Specify one or more target language codes (e.g., `zh`, `ja`). If omitted, you will be prompted to select languages interactively.</x-field-desc>
+    <x-field-desc markdown>Specify one or more target language codes (e.g., `zh`, `ja`, `de`). If omitted, you will be prompted to select languages interactively.</x-field-desc>
   </x-field>
   <x-field data-name="--glossary" data-type="string">
-    <x-field-desc markdown>Provide a path to a glossary file (e.g., `@path/to/glossary.md`). This ensures that specific technical terms are translated consistently across all documents.</x-field-desc>
+    <x-field-desc markdown>Provide a path to a glossary file (e.g., `@path/to/glossary.md`). This ensures that specific technical terms, brand names, or acronyms are translated consistently across all documents.</x-field-desc>
   </x-field>
   <x-field data-name="--feedback" data-type="string">
-    <x-field-desc markdown>Provide specific instructions or feedback to guide the AI's translation style, such as adjusting the tone or terminology.</x-field-desc>
+    <x-field-desc markdown>Provide specific instructions to guide the AI's translation style. For example, you can ask for a more formal tone or specify how to handle certain phrases.</x-field-desc>
   </x-field>
 </x-field-group>
 
@@ -46,7 +51,7 @@ For non-interactive use or scripting, you can use the following command-line fla
 
 #### 1. Translate Specific Documents into Multiple Languages
 
-To translate `overview.md` and `examples.md` into Chinese (`zh`) and Japanese (`ja`) without interactive prompts:
+To translate `overview.md` and `examples.md` into Chinese (`zh`) and Japanese (`ja`) without any interactive prompts, run the following command:
 
 ```bash
 aigne doc translate --docs overview.md --docs examples.md --langs zh --langs ja
@@ -54,42 +59,42 @@ aigne doc translate --docs overview.md --docs examples.md --langs zh --langs ja
 
 #### 2. Use a Glossary for Consistent Terminology
 
-To ensure technical terms are translated correctly, provide a glossary file. This is useful for maintaining consistency for brand names or specialized vocabulary.
+If your documentation contains specialized vocabulary or brand names, you can use a glossary file to ensure they are always translated correctly.
 
 ```bash
-aigne doc translate --glossary @./glossary.md
+aigne doc translate --glossary @./project-glossary.md
 ```
 
 #### 3. Provide Feedback to Refine Translation Style
 
-You can guide the translation style by providing feedback. For instance, to request a more formal tone:
+You can guide the translation style by providing feedback. For instance, to request a more formal and technical tone for the output:
 
 ```bash
 aigne doc translate --feedback "Use a formal, technical tone for all translations."
 ```
 
-This feedback will be recorded in the history for the updated documents.
+This feedback is recorded in the document's update history, which can be useful for tracking changes.
 
 ## Supported Languages
 
 The tool provides translation support for 12 languages. The native language of the documentation is English (`en`).
 
-| Language | Code |
-| :--- | :--- |
-| Chinese (Simplified) | `zh` |
-| Chinese (Traditional)| `zh-TW`|
-| Japanese | `ja` |
-| Korean | `ko` |
-| Spanish | `es` |
-| French | `fr` |
-| German | `de` |
-| Portuguese | `pt` |
-| Russian | `ru` |
-| Italian | `it` |
-| Arabic | `ar` |
+| Language              | Code    |
+| --------------------- | ------- |
+| Chinese (Simplified)  | `zh`    |
+| Chinese (Traditional) | `zh-TW` |
+| Japanese              | `ja`    |
+| Korean                | `ko`    |
+| Spanish               | `es`    |
+| French                | `fr`    |
+| German                | `de`    |
+| Portuguese            | `pt`    |
+| Russian               | `ru`    |
+| Italian               | `it`    |
+| Arabic                | `ar`    |
 
 ## Summary
 
-The `translate` command offers a structured method for localizing your documentation. You can use its interactive mode for guided translations or command-line options for automated workflows. Using features like glossaries and feedback helps maintain the quality and consistency of the translated content.
+The `translate` command offers a structured and reliable method for localizing your documentation. You can use its interactive mode for a guided process or its command-line options for efficient, automated workflows. Features like glossaries and feedback help maintain the quality and consistency of the translated content.
 
-After translating your documents, you can proceed to [Publishing Your Docs](./guides-publishing-your-docs.md).
+After translating your documents, the next step is to make them available to your users. For instructions on how to do this, see the [Publishing Your Docs](./guides-publishing-your-docs.md) guide.

package/docs/guides-translating-documentation.zh-TW.md

@@ -1,44 +1,44 @@
 # 翻譯文件
 
-本指南說明如何使用 `aigne doc translate` 指令將您產生的文件翻譯成多種語言。此過程使用 AI 來確保翻譯具有上下文感知能力並保持技術準確性。
+本指南說明如何使用 `aigne doc translate` 指令將您產生的文件翻譯成多種語言。此過程使用 AI 來確保翻譯具有情境感知能力並保持技術準確性。
 
-該工具支援 12 種語言，讓您能夠觸及全球受眾。您的源文件的主要語言將自動從可用的翻譯語言清單中排除。
+該工具支援 12 種語言，讓您能夠觸及全球受眾。您的來源文件的主要語言將自動從可用的翻譯語言清單中排除。
 
 ## `translate` 指令
 
-`aigne doc translate` 指令用於為您現有的文件檔案產生翻譯。您可以以互動模式執行它，以選擇您想要的文件和語言，或者您也可以使用命令列標誌直接指定這些選項，以實現自動化工作流程。
+`aigne doc translate` 指令用於為您現有的文件檔案產生翻譯。您可以以互動模式執行它來選擇您想要的文件和語言，或者您也可以使用命令列旗標直接指定這些選項以實現自動化工作流程。
 
 ### 互動模式
 
-若要獲得引導式體驗，請在不帶任何參數的情況下執行該指令：
+若要獲得引導式體驗，請在不帶任何參數的情況下執行此指令：
 
 ```bash
 aigne doc translate
 ```
 
-執行後，該工具將執行以下步驟：
+執行時，該工具將執行以下步驟：
 1.  掃描現有文件。
-2.  提示您從清單中選擇要翻譯的特定文件。
+2.  提示您從清單中選擇您希望翻譯的特定文件。
 3.  提示您選擇目標翻譯語言。為方便起見，先前選擇的語言將被預先勾選。
-4.  為每個選定的文件和語言對開始翻譯過程。
-5.  將翻譯後的文件儲存在相應的特定語言目錄中。
+4.  為每個選定的文件和語言組合開始翻譯過程。
+5.  將翻譯後的文件儲存在同一個目錄中。新檔案的命名方式是在原始檔名後附加語言代碼（例如，`overview.md` 的中文翻譯會變成 `overview.zh.md`）。
 
 ### 命令列選項
 
-對於非互動式使用或腳本編寫，您可以使用以下命令列標誌來控制翻譯過程。
+對於非互動式使用或腳本編寫，您可以使用以下命令列旗標來控制翻譯過程。
 
 <x-field-group>
   <x-field data-name="--docs" data-type="array<string>">
-    <x-field-desc markdown>指定一個或多個要翻譯的文件路徑。如果未提供，該工具將進入互動模式，讓您從可用文件清單中選擇。</x-field-desc>
+    <x-field-desc markdown>指定一個或多個要翻譯的文件路徑。若未提供，該工具將進入互動模式，讓您從可用文件清單中進行選擇。</x-field-desc>
   </x-field>
   <x-field data-name="--langs" data-type="array<string>">
-    <x-field-desc markdown>指定一個或多個目標語言代碼（例如，`zh`、`ja`）。如果省略，系統將提示您以互動方式選擇語言。</x-field-desc>
+    <x-field-desc markdown>指定一個或多個目標語言代碼（例如 `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-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-desc markdown>提供具體的指示或回饋來引導 AI 的翻譯風格，例如調整語氣或術語。</x-field-desc>
   </x-field>
 </x-field-group>
 
@@ -46,7 +46,7 @@ aigne doc translate
 
 #### 1. 將特定文件翻譯成多種語言
 
-要將 `overview.md` 和 `examples.md` 翻譯成中文（`zh`）和日文（`ja`）而無需互動式提示：
+若要將 `overview.md` 和 `examples.md` 翻譯成中文（`zh`）和日文（`ja`）且不使用互動式提示：
 
 ```bash
 aigne doc translate --docs overview.md --docs examples.md --langs zh --langs ja
@@ -54,25 +54,25 @@ aigne doc translate --docs overview.md --docs examples.md --langs zh --langs ja
 
 #### 2. 使用詞彙表以確保術語一致
 
-為確保技術術語翻譯正確，請提供一個詞彙表檔案。這對於保持品牌名稱或專業詞彙的一致性非常有用。
+為確保技術術語翻譯正確，請提供一個詞彙表檔案。這對於保持品牌名稱或專業詞彙的一致性很有用。
 
 ```bash
 aigne doc translate --glossary @./glossary.md
 ```
 
-#### 3. 提供回饋以優化翻譯風格
+#### 3. 提供回饋以完善翻譯風格
 
-您可以透過提供回饋來指導翻譯風格。例如，若要請求更正式的語氣：
+您可以透過提供回饋來引導翻譯風格。例如，若要請求更正式的語氣：
 
 ```bash
 aigne doc translate --feedback "Use a formal, technical tone for all translations."
 ```
 
-此回饋將記錄在更新文件的歷史記錄中。
+此回饋將記錄在更新後文件的歷史記錄中。
 
 ## 支援的語言
 
-該工具提供 12 種語言的翻譯支援。文件的原生語言是英文（`en`）。
+該工具支援 12 種語言的翻譯。文件的原生語言是英文（`en`）。
 
 | 語言 | 代碼 |
 | :--- | :--- |
@@ -90,6 +90,6 @@ aigne doc translate --feedback "Use a formal, technical tone for all translation
 
 ## 總結
 
-`translate` 指令為您的文件本地化提供了一種結構化的方法。您可以使用其互動模式進行引導式翻譯，或使用命令列選項進行自動化工作流程。使用詞彙表和回饋等功能有助於保持翻譯內容的品質和一致性。
+`translate` 指令提供了一種結構化的方法來本地化您的文件。您可以使用其互動模式進行引導式翻譯，或使用命令列選項進行自動化工作流程。使用詞彙表和回饋等功能有助於保持翻譯內容的品質和一致性。
 
-翻譯完文件後，您可以繼續進行[發布您的文件](./guides-publishing-your-docs.md)。
+翻譯完文件後，您可以繼續進行[發佈您的文件](./guides-publishing-your-docs.md)。

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

@@ -1,16 +1,16 @@
 # 翻译文档
 
-本指南介绍了如何使用 `aigne doc translate` 命令将您生成的文档翻译成多种语言。该过程使用 AI 来确保翻译能够感知上下文并保持技术准确性。
+本指南介绍如何使用 `aigne doc translate` 命令将您生成的文档翻译成多种语言。该过程利用 AI 来确保翻译能够感知上下文并保持技术准确性。
 
-该工具支持 12 种语言，使您能够触达全球受众。您源文档的主要语言将自动从可用翻译语言列表中排除。
+该工具支持 12 种语言，让您的内容能够触达全球受众。您源文档的主要语言将自动从可用翻译语言列表中排除。
 
 ## `translate` 命令
 
-`aigne doc translate` 命令用于为您现有的文档文件生成翻译。您可以以交互方式运行它来选择您想要的文档和语言，也可以使用命令行标志直接指定这些选项以实现自动化工作流。
+`aigne doc translate` 命令用于为现有文档文件生成翻译。您可以以交互方式运行它来选择要翻译的文档和语言，也可以直接使用命令行标志指定这些选项以实现自动化工作流程。
 
 ### 交互模式
 
-若需引导式体验，请不带任何参数运行该命令：
+如需引导式体验，请不带任何参数运行该命令：
 
 ```bash
 aigne doc translate
@@ -18,27 +18,27 @@ aigne doc translate
 
 执行后，该工具将执行以下步骤：
 1.  扫描现有文档。
-2.  提示您从列表中选择希望翻译的特定文档。
-3.  提示您选择目标翻译语言。为方便起见，先前选择的语言将被预先选中。
+2.  提示您从列表中选择要翻译的具体文档。
+3.  提示您选择目标翻译语言。为方便起见，先前选择的语言将被预先勾选。
 4.  为每个选定的文档和语言对开始翻译过程。
-5.  将翻译后的文件保存在相应的特定语言目录中。
+5.  将翻译后的文件保存在同一目录中。新文件通过在原始文件名后附加语言代码来命名（例如，`overview.md` 的中文翻译将变为 `overview.zh.md`）。
 
 ### 命令行选项
 
-对于非交互式使用或编写脚本，您可以使用以下命令行标志来控制翻译过程。
+对于非交互式使用或脚本编写，您可以使用以下命令行标志来控制翻译过程。
 
 <x-field-group>
   <x-field data-name="--docs" data-type="array<string>">
-    <x-field-desc markdown>指定一个或多个要翻译的文档路径。如果未提供，该工具将进入交互模式，让您从可用文档列表中进行选择。</x-field-desc>
+    <x-field-desc markdown>指定要翻译的一个或多个文档路径。如果未提供，该工具将进入交互模式，让您从可用文档列表中进行选择。</x-field-desc>
   </x-field>
   <x-field data-name="--langs" data-type="array<string>">
-    <x-field-desc markdown>指定一个或多个目标语言代码（例如，`zh`、`ja`）。如果省略，系统将提示您以交互方式选择语言。</x-field-desc>
+    <x-field-desc markdown>指定一个或多个目标语言代码（例如 `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-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-desc markdown>提供具体说明或反馈以指导 AI 的翻译风格，例如调整语气或术语。</x-field-desc>
   </x-field>
 </x-field-group>
 
@@ -46,15 +46,15 @@ aigne doc translate
 
 #### 1. 将特定文档翻译成多种语言
 
-要将 `overview.md` 和 `examples.md` 翻译成中文（`zh`）和日文（`ja`）且无需交互式提示：
+要将 `overview.md` 和 `examples.md` 翻译成中文（`zh`）和日文（`ja`），且无需交互式提示：
 
 ```bash
 aigne doc translate --docs overview.md --docs examples.md --langs zh --langs ja
 ```
 
-#### 2. 使用词汇表以确保术语一致
+#### 2. 使用词汇表确保术语一致
 
-为确保技术术语翻译正确，请提供一个词汇表文件。这对于保持品牌名称或专业词汇的一致性非常有用。
+为确保技术术语翻译正确，请提供词汇表文件。这对于保持品牌名称或专业词汇的一致性非常有用。
 
 ```bash
 aigne doc translate --glossary @./glossary.md
@@ -62,7 +62,7 @@ aigne doc translate --glossary @./glossary.md
 
 #### 3. 提供反馈以优化翻译风格
 
-您可以通过提供反馈来指导翻译风格。例如，要请求更正式的语气：
+您可以通过提供反馈来指导翻译风格。例如，要求使用更正式的语气：
 
 ```bash
 aigne doc translate --feedback "Use a formal, technical tone for all translations."
@@ -72,7 +72,7 @@ aigne doc translate --feedback "Use a formal, technical tone for all translation
 
 ## 支持的语言
 
-该工具提供 12 种语言的翻译支持。文档的母语是英语（`en`）。
+该工具支持 12 种语言的翻译。文档的母语是英语（`en`）。
 
 | 语言 | 代码 |
 | :--- | :--- |
@@ -90,6 +90,6 @@ aigne doc translate --feedback "Use a formal, technical tone for all translation
 
 ## 总结
 
-`translate` 命令为本地化您的文档提供了一种结构化的方法。您可以使用其交互模式进行引导式翻译，或使用命令行选项实现自动化工作流。使用词汇表和反馈等功能有助于保持翻译内容的质量和一致性。
+`translate` 命令为本地化文档提供了一种结构化方法。您可以使用其交互模式进行引导式翻译，或使用命令行选项实现自动化工作流程。使用词汇表和反馈等功能有助于保持翻译内容的质量和一致性。
 
 翻译完文档后，您可以继续[发布您的文档](./guides-publishing-your-docs.md)。