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

package/docs/features-publish-your-docs.ja.md

@@ -1,10 +1,10 @@
 # ドキュメントを公開する
 
-ドキュメントを生成した後、 `aigne doc publish` コマンドはファイルをアップロードし、共有可能なリンク経由でアクセスできるようにします。このガイドでは、公式のAIGNEプラットフォームまたはセルフホストインスタンスにドキュメントを公開するためのステップバイステップのプロセスを提供します。
+ドキュメントを生成した後、`aigne doc publish` コマンドはファイルをアップロードし、共有可能なリンクを通じてアクセス可能にします。このガイドでは、公式の AIGNE プラットフォームまたは自己ホスト型のインスタンスにドキュメントを公開するためのステップバイステップのプロセスを提供します。
 
 ## 公開プロセス
 
-`aigne doc publish` コマンドは、インタラクティブなワークフローを開始します。初めて宛先に公開する際、CLIはブラウザを開き、1回限りの認証プロセスを案内します。その後の公開では、 `~/.aigne/doc-smith-connected.yaml` に保存されている認証情報が使用されます。
+`aigne doc publish` コマンドは対話型のワークフローを開始します。特定の宛先に初めて公開する場合、CLI はブラウザを開き、一度限りの認証プロセスを案内します。その後の公開では、`~/.aigne/doc-smith-connected.yaml` に保存されている認証情報が使用されます。
 
 ```d2 公開ワークフロー icon=lucide:upload-cloud
 shape: sequence_diagram
@@ -26,21 +26,21 @@ Local-Config: {
 Browser
 
 Platform: {
-  label: "プラットフォーム\n(公式またはセルフホスト)"
+  label: "プラットフォーム\n(公式または自己ホスト型)"
 }
 
-User -> CLI: "コマンド実行"
+User -> CLI: "コマンドを実行"
 
-alt "インタラクティブモード" {
+alt "対話モード" {
   CLI -> Local-Config: "認証情報を確認"
-  opt "認証情報が見つからない（初回）" {
-    CLI -> User: "プラットフォーム選択を促す"
-    User -> CLI: "プラットフォーム選択済み"
-    CLI -> Browser: "認証URLを開く"
+  opt "認証情報が見つからない (初回)" {
+    CLI -> User: "プラットフォームの選択を促す"
+    User -> CLI: "プラットフォームを選択"
+    CLI -> Browser: "認証 URL を開く"
     User -> Browser: "ログイン & 承認"
     Browser -> Platform: "トークンを要求"
     Platform -> Browser: "トークンを返す"
-    Browser -> CLI: "CLIにトークンを送信"
+    Browser -> CLI: "トークンを CLI に送信"
     CLI -> Local-Config: "認証情報を保存"
   }
   CLI -> Platform: "ドキュメントをアップロード"
@@ -48,8 +48,8 @@ alt "インタラクティブモード" {
   CLI -> User: "成功メッセージを表示"
 }
 
-alt "CI/CDモード" {
-  note over CLI: "ENV VARからトークンを読み取る"
+alt "CI/CD モード" {
+  note over CLI: "ENV VAR からトークンを読み取る"
   CLI -> Platform: "ドキュメントをアップロード"
   Platform -> CLI: "成功を確認"
   CLI -> User: "成功ステータスを返す"
@@ -58,14 +58,14 @@ alt "CI/CDモード" {
 
 ## 公開オプション
 
-ドキュメントをホストする主要な宛先として、2つの選択肢があります：
+ドキュメントをホストするために、2つの主要な宛先から選択できます。
 
 <x-cards data-columns="2">
   <x-card data-title="公式プラットフォーム" data-icon="lucide:globe">
-    AIGNEが運営するサービスであるdocsmith.aigne.ioに公開します。これは、オープンソースプロジェクトやドキュメントを迅速に公開共有するための簡単なオプションです。
+    AIGNE が運営するサービスである docsmith.aigne.io に公開します。これは、オープンソースプロジェクトやドキュメントを迅速に公開共有するための簡単なオプションです。
   </x-card>
-  <x-card data-title="セルフホストインスタンス" data-icon="lucide:server">
-    ブランディング、アクセス、データプライバシーを完全に制御するために、独自のDiscuss Kitインスタンスに公開します。これは、内部またはプライベートなドキュメントに推奨されるオプションです。公式ドキュメントにある指示に従って、独自のDiscuss Kitインスタンスを実行できます。
+  <x-card data-title="自己ホスト型インスタンス" data-icon="lucide:server">
+    ブランディング、アクセス、データプライバシーを完全に制御するために、独自の Discuss Kit インスタンスに公開します。これは、内部またはプライベートなドキュメントに推奨されるオプションです。公式ドキュメントにある指示に従って、独自の Discuss Kit インスタンスを実行できます。
   </x-card>
 </x-cards>
 
@@ -73,58 +73,58 @@ alt "CI/CDモード" {
 
 以下の手順に従ってドキュメントを公開してください。
 
-### 1. 公開コマンドの実行
+### 1. 公開コマンドを実行する
 
-プロジェクトのルートディレクトリに移動し、次のコマンドを実行します：
+プロジェクトのルートディレクトリに移動し、次のコマンドを実行します。
 
-```bash ターミナル icon=lucide:terminal
+```bash Terminal icon=lucide:terminal
 aigne doc publish
 ```
 
-### 2. プラットフォームの選択
+### 2. プラットフォームを選択する
 
 初めて公開する場合、宛先を選択するよう求められます。要件に合ったオプションを選択してください。
 
-![公式プラットフォームまたはセルフホストインスタンスから選択](https://docsmith.aigne.io/image-bin/uploads/9fd929060b5abe13d0_3cf5eb7aea85aa.png)
+![公式プラットフォームまたは自己ホスト型プラットフォームにドキュメントを公開する](../assets/screenshots/doc-publish.png)
 
-セルフホストインスタンスを選択した場合は、そのURLを入力するよう求められます。
+自己ホスト型のインスタンスを選択した場合、その URL を入力するよう求められます。
 
-### 3. アカウントの認証
+### 3. アカウントを認証する
 
-初回接続時には、ブラウザウィンドウが自動的に開き、ログインしてCLIを承認します。この手順はプラットフォームごとに1回だけ必要です。アクセストークンは、将来の使用のためにローカルに保存されます。
+最初の接続では、ブラウザウィンドウが自動的に開き、ログインして CLI を承認します。このステップはプラットフォームごとに一度だけ必要です。アクセストークンは将来の使用のためにローカルに保存されます。
 
 ### 4. 確認
 
 アップロードが完了すると、ターミナルに成功メッセージが表示され、ドキュメントが公開されたことを確認します。
 
 ```
-✅ ドキュメントが正常に公開されました！
+✅ Documentation Published Successfully!
 ```
 
-## CI/CD環境での公開
+## CI/CD 環境での公開
 
-CI/CDパイプラインなどの自動化されたワークフローで公開コマンドを使用するには、引数や環境変数を通じて必要な情報を提供することで、インタラクティブなプロンプトをバイパスできます。
+CI/CD パイプラインのような自動化されたワークフローで公開コマンドを使用するには、引数と環境変数を通じて必要な情報を提供することで、対話型のプロンプトをバイパスできます。
 
 | 方法 | 名前 | 説明 |
 |---|---|---|
-| **引数** | `--appUrl` | Discuss KitインスタンスのURLを指定します。 |
-| **環境変数** | `DOC_DISCUSS_KIT_ACCESS_TOKEN` | インタラクティブなログインプロセスをスキップするためのアクセストークンを提供します。 |
+| **引数** | `--appUrl` | Discuss Kit インスタンスの URL を指定します。 |
+| **環境変数** | `DOC_DISCUSS_KIT_ACCESS_TOKEN` | 対話型のログインプロセスをスキップするためのアクセストークンを提供します。 |
 
-以下は、CI/CDスクリプトに適した非インタラクティブな公開コマンドの例です：
+以下は、CI/CD スクリプトに適した非対話型の公開コマンドの例です。
 
-```bash CI/CDの例 icon=lucide:workflow
+```bash CI/CD の例 icon=lucide:workflow
 export DOC_DISCUSS_KIT_ACCESS_TOKEN="your_access_token_here"
 aigne doc publish --appUrl https://docs.mycompany.com
 ```
 
 ## トラブルシューティング
 
-公開プロセス中に問題が発生した場合、以下の一般的な問題のいずれかが原因である可能性があります。
+公開プロセス中に問題が発生した場合、それは以下の一般的な問題のいずれかが原因である可能性があります。
 
-- **接続エラー**: CLIが `Unable to connect to: <URL>` のようなエラーメッセージを返すことがあります。これは、ネットワークの問題、サーバーが一時的に利用できない、またはURLが正しくないことが原因である可能性があります。URLが正しく、サーバーに到達可能であることを確認してください。
+- **接続エラー**: CLI は `Unable to connect to: <URL>` のようなエラーメッセージを返すことがあります。これは、ネットワークの問題、サーバーが一時的に利用できない、または URL が間違っていることが原因である可能性があります。URL が正しく、サーバーに到達可能であることを確認してください。
 
-- **無効なウェブサイトURL**: コマンドが `The provided URL is not a valid website on ArcBlock platform` というメッセージで失敗することがあります。宛先URLはArcBlockプラットフォーム上に構築されたウェブサイトでなければなりません。ドキュメントをホストするには、独自のDiscuss Kitインスタンスを実行できます。
+- **無効なウェブサイト URL**: コマンドは `The provided URL is not a valid website on ArcBlock platform` というメッセージで失敗することがあります。宛先 URL は ArcBlock プラットフォーム上に構築されたウェブサイトでなければなりません。ドキュメントをホストするには、独自の Discuss Kit インスタンスを実行できます。
 
-- **必須コンポーネントの欠落**: `This website does not have required components for publishing` というエラーは、宛先のウェブサイトにDiscuss Kitコンポーネントがインストールされていないことを示します。サイトに必要なコンポーネントを追加するには、Discuss Kitのドキュメントを参照してください。
+- **必要なコンポーネントの欠落**: `This website does not have required components for publishing` というエラーは、宛先のウェブサイトに Discuss Kit コンポーネントがインストールされていないことを示します。サイトに必要なコンポーネントを追加するには、Discuss Kit のドキュメントを参照してください。
 
-コマンドとオプションの完全なリストについては、[CLIコマンドリファレンス](./cli-reference.md)を参照してください。
+コマンドとオプションの完全なリストについては、[CLI コマンドリファレンス](./cli-reference.md) を参照してください。

package/docs/features-publish-your-docs.md

@@ -4,7 +4,7 @@ After generating your documentation, the `aigne doc publish` command uploads you
 
 ## The Publishing Process
 
-The `aigne doc publish` command starts an interactive workflow. The first time you publish to a destination, the CLI will open a browser to guide you through a one-time authentication process. For subsequent publishes, it will use the saved credentials stored in `~/.aigne/doc-smith-connected.yaml`.
+The `aigne doc publish` command initiates an interactive workflow. The first time you publish to a specific destination, the CLI will open a browser to guide you through a one-time authentication process. For subsequent publishes, it will use the saved credentials stored in `~/.aigne/doc-smith-connected.yaml`.
 
 ```d2 The Publishing Workflow icon=lucide:upload-cloud
 shape: sequence_diagram
@@ -85,7 +85,7 @@ aigne doc publish
 
 If this is your first time publishing, you will be prompted to select a destination. Choose the option that fits your requirements.
 
-![Choose between the official platform or a self-hosted instance](https://docsmith.aigne.io/image-bin/uploads/9fd929060b5abe13d0_3cf5eb7aea85aa.png)
+![Publish documentation to the official platform or a self-hosted platform](../assets/screenshots/doc-publish.png)
 
 If you select a self-hosted instance, you will be asked to enter its URL.
 

package/docs/features-publish-your-docs.zh-TW.md

@@ -1,10 +1,10 @@
 # 發佈您的文件
 
-產生您的文件後，`aigne doc publish` 指令會上傳您的檔案，並透過可分享的連結使其可供存取。本指南提供了將您的文件發佈到官方 AIGNE 平台或自行託管實例的逐步流程。
+在產生您的文件後，`aigne doc publish` 指令會上傳您的檔案，並透過一個可分享的連結讓它們可以被存取。本指南提供了將您的文件發佈到 AIGNE 官方平台或自架實例的逐步流程。
 
 ## 發佈流程
 
-`aigne doc publish` 指令會啟動一個互動式工作流程。當您第一次發佈到某個目的地時，CLI 會開啟瀏覽器引導您完成一次性的身份驗證過程。對於後續的發佈，它將使用儲存在 `~/.aigne/doc-smith-connected.yaml` 中的已儲存憑證。
+`aigne doc publish` 指令會啟動一個互動式工作流程。當您第一次發佈到特定目的地時，CLI 會開啟一個瀏覽器來引導您完成一次性的身份驗證過程。對於後續的發佈，它將使用儲存在 `~/.aigne/doc-smith-connected.yaml` 中的已存認證資訊。
 
 ```d2 The Publishing Workflow icon=lucide:upload-cloud
 shape: sequence_diagram
@@ -19,29 +19,29 @@ CLI: {
 }
 
 Local-Config: {
-  label: "本地設定\n(~/.aigne/...)"
+  label: "本機設定\n(~/.aigne/...)"
   shape: cylinder
 }
 
 Browser
 
 Platform: {
-  label: "平台\n(官方或自行託管)"
+  label: "平台\n(官方或自架)"
 }
 
 User -> CLI: "執行指令"
 
 alt "互動模式" {
-  CLI -> Local-Config: "檢查憑證"
-  opt "找不到憑證 (首次)" {
+  CLI -> Local-Config: "檢查認證資訊"
+  opt "未找到認證資訊 (首次)" {
     CLI -> User: "提示選擇平台"
     User -> CLI: "已選擇平台"
     CLI -> Browser: "開啟驗證 URL"
     User -> Browser: "登入並授權"
     Browser -> Platform: "請求權杖"
     Platform -> Browser: "返回權杖"
-    Browser -> CLI: "傳送權杖至 CLI"
-    CLI -> Local-Config: "儲存憑證"
+    Browser -> CLI: "將權杖傳送至 CLI"
+    CLI -> Local-Config: "儲存認證資訊"
   }
   CLI -> Platform: "上傳文件"
   Platform -> CLI: "確認成功"
@@ -62,10 +62,10 @@ alt "CI/CD 模式" {
 
 <x-cards data-columns="2">
   <x-card data-title="官方平台" data-icon="lucide:globe">
-    發佈到由 AIGNE 營運的服務 docsmith.aigne.io。對於開源專案或希望快速公開分享文件的使用者來說，這是一個直接的選項。
+    發佈到 docsmith.aigne.io，這是由 AIGNE 營運的服務。對於開源專案或希望快速公開分享文件的使用者來說，這是一個直接的選項。
   </x-card>
-  <x-card data-title="自行託管實例" data-icon="lucide:server">
-    發佈到您自己的 Discuss Kit 實例，以完全控制品牌、存取權限和資料隱私。這是內部或私有文件的推薦選項。您可以按照官方文件中的說明來執行您自己的 Discuss Kit 實例。
+  <x-card data-title="自架實例" data-icon="lucide:server">
+    發佈到您自己的 Discuss Kit 實例，以完全控制品牌、存取權限和資料隱私。對於內部或私有文件，這是建議的選項。您可以按照官方文件中提供的說明來運行您自己的 Discuss Kit 實例。
   </x-card>
 </x-cards>
 
@@ -83,29 +83,29 @@ aigne doc publish
 
 ### 2. 選擇您的平台
 
-如果這是您第一次發佈，系統會提示您選擇一個目的地。請選擇符合您需求的選項。
+如果這是您第一次發佈，系統將提示您選擇一個目的地。請選擇符合您需求的選項。
 
-![在官方平台或自行託管實例之間進行選擇](https://docsmith.aigne.io/image-bin/uploads/9fd929060b5abe13d0_3cf5eb7aea85aa.png)
+![將文件發佈到官方平台或自架平台](../assets/screenshots/doc-publish.png)
 
-如果您選擇自行託管的實例，系統會要求您輸入其 URL。
+如果您選擇自架實例，系統會要求您輸入其 URL。
 
 ### 3. 驗證您的帳戶
 
-初次連線時，瀏覽器視窗會自動開啟，讓您登入並授權給 CLI。此步驟每個平台僅需執行一次。存取權杖會儲存在本機以供未來使用。
+對於初次連線，瀏覽器視窗將自動開啟，讓您登入並授權 CLI。此步驟每個平台僅需執行一次。存取權杖會儲存在本機以供未來使用。
 
 ### 4. 確認
 
-上傳完成後，您的終端機中會出現一條成功訊息，確認文件已上線。
+上傳完成後，您的終端機中將會出現一條成功訊息，確認文件已上線。
 
 ```
-✅ Documentation Published Successfully!
+✅ 文件發佈成功！
 ```
 
 ## 在 CI/CD 環境中發佈
 
 若要在 CI/CD 管線等自動化工作流程中使用發佈指令，您可以透過參數和環境變數提供必要的資訊，以繞過互動式提示。
 
-| 方法 | 名稱 | 說明 |
+| 方法 | 名稱 | 描述 |
 |---|---|---|
 | **參數** | `--appUrl` | 指定您的 Discuss Kit 實例的 URL。 |
 | **環境變數** | `DOC_DISCUSS_KIT_ACCESS_TOKEN` | 提供存取權杖以跳過互動式登入過程。 |
@@ -123,8 +123,8 @@ aigne doc publish --appUrl https://docs.mycompany.com
 
 - **連線錯誤**：CLI 可能會返回類似 `Unable to connect to: <URL>` 的錯誤訊息。這可能是由網路問題、伺服器暫時無法使用或 URL 不正確所引起。請確認 URL 是否正確且伺服器是否可連線。
 
-- **無效的網站 URL**：指令可能會失敗並顯示訊息 `The provided URL is not a valid website on ArcBlock platform`。目標 URL 必須是建立在 ArcBlock 平台上的網站。若要託管您的文件，您可以執行自己的 Discuss Kit 實例。
+- **無效的網站 URL**：指令可能會失敗並顯示訊息 `The provided URL is not a valid website on ArcBlock platform`。目的地 URL 必須是建立在 ArcBlock 平台上的網站。若要託管您的文件，您可以運行自己的 Discuss Kit 實例。
 
-- **缺少必要元件**：一個錯誤訊息，內容為 `This website does not have required components for publishing` 表示目標網站未安裝 Discuss Kit 元件。請參閱 Discuss Kit 文件，將必要的元件新增到您的網站。
+- **缺少必要元件**：出現 `This website does not have required components for publishing` 的錯誤訊息表示目的地網站未安裝 Discuss Kit 元件。請參考 Discuss Kit 文件，將必要的元件新增至您的網站。
 
-有關指令和選項的完整列表，請參閱 [CLI 指令參考](./cli-reference.md)。
+有關完整的指令和選項列表，請參閱 [CLI 指令參考](./cli-reference.md)。

package/docs/features-publish-your-docs.zh.md

@@ -1,12 +1,12 @@
 # 发布您的文档
 
-生成文档后，`aigne doc publish` 命令会上传您的文件，并通过一个可共享的链接使其可访问。本指南提供了将文档发布到 AIGNE 官方平台或自托管实例的分步过程。
+生成文档后，`aigne doc publish` 命令会上传您的文件，并通过一个可共享的链接使其可访问。本指南提供了将文档发布到 AIGNE 官方平台或自托管实例的详细步骤。
 
-## 发布过程
+## 发布流程
 
-`aigne doc publish` 命令会启动一个交互式工作流程。当您首次发布到某个目标时，CLI 将打开一个浏览器来引导您完成一次性身份验证过程。对于后续的发布，它将使用保存在 `~/.aigne/doc-smith-connected.yaml` 中的凭证。
+`aigne doc publish` 命令会启动一个交互式工作流程。当您首次发布到特定目标时，CLI 将打开浏览器引导您完成一次性身份验证过程。对于后续的发布，它将使用存储在 `~/.aigne/doc-smith-connected.yaml` 中的已保存凭据。
 
-```d2 The Publishing Workflow icon=lucide:upload-cloud
+```d2 发布工作流程 icon=lucide:upload-cloud
 shape: sequence_diagram
 
 User: {
@@ -32,16 +32,16 @@ Platform: {
 User -> CLI: "运行命令"
 
 alt "交互模式" {
-  CLI -> Local-Config: "检查凭证"
-  opt "未找到凭证 (首次)" {
+  CLI -> Local-Config: "检查凭据"
+  opt "未找到凭据（首次）" {
     CLI -> User: "提示选择平台"
-    User -> CLI: "平台已选择"
+    User -> CLI: "已选择平台"
     CLI -> Browser: "打开认证 URL"
     User -> Browser: "登录并授权"
     Browser -> Platform: "请求令牌"
     Platform -> Browser: "返回令牌"
-    Browser -> CLI: "发送令牌到 CLI"
-    CLI -> Local-Config: "保存凭证"
+    Browser -> CLI: "发送令牌至 CLI"
+    CLI -> Local-Config: "保存凭据"
   }
   CLI -> Platform: "上传文档"
   Platform -> CLI: "确认成功"
@@ -58,11 +58,11 @@ alt "CI/CD 模式" {
 
 ## 发布选项
 
-您可以选择两个主要的目标来托管您的文档：
+您可以选择以下两个主要目标之一来托管您的文档：
 
 <x-cards data-columns="2">
   <x-card data-title="官方平台" data-icon="lucide:globe">
-    发布到 docsmith.aigne.io，这是由 AIGNE 运营的服务。对于开源项目或希望快速公开分享文档的用户来说，这是一个直接的选择。
+    发布到由 AIGNE 运营的服务 docsmith.aigne.io。对于开源项目或希望快速公开分享文档的用户来说，这是一个简单直接的选择。
   </x-card>
   <x-card data-title="自托管实例" data-icon="lucide:server">
     发布到您自己的 Discuss Kit 实例，以完全控制品牌、访问权限和数据隐私。这是内部或私有文档的推荐选项。您可以按照官方文档中的说明运行自己的 Discuss Kit 实例。
@@ -77,33 +77,33 @@ alt "CI/CD 模式" {
 
 导航到您项目的根目录并执行以下命令：
 
-```bash Terminal icon=lucide:terminal
+```bash 终端 icon=lucide:terminal
 aigne doc publish
 ```
 
 ### 2. 选择您的平台
 
-如果这是您第一次发布，系统会提示您选择一个目标。请选择符合您要求的选项。
+如果这是您第一次发布，系统将提示您选择一个目标。请选择符合您需求的选项。
 
-![在官方平台或自托管实例之间选择](https://docsmith.aigne.io/image-bin/uploads/9fd929060b5abe13d0_3cf5eb7aea85aa.png)
+![将文档发布到官方平台或自托管平台](../assets/screenshots/doc-publish.png)
 
-如果您选择自托管实例，系统会要求您输入其 URL。
+如果您选择自托管实例，系统将要求您输入其 URL。
 
 ### 3. 验证您的账户
 
-对于初次连接，浏览器窗口将自动打开，以便您登录并授权 CLI。此步骤每个平台只需执行一次。访问令牌会保存在本地以备将来使用。
+对于初次连接，浏览器窗口将自动打开，以便您登录并授权 CLI。此步骤每个平台仅需执行一次。访问令牌将保存在本地以供将来使用。
 
 ### 4. 确认
 
 上传完成后，您的终端将显示一条成功消息，确认文档已上线。
 
 ```
-✅ 文档发布成功！
+✅ Documentation Published Successfully!
 ```
 
 ## 在 CI/CD 环境中发布
 
-要在 CI/CD 流水线等自动化工作流程中使用发布命令，您可以通过参数和环境变量提供必要信息来绕过交互式提示。
+要在 CI/CD 流水线等自动化工作流程中使用发布命令，您可以通过参数和环境变量提供必要信息，以绕过交互式提示。
 
 | 方法 | 名称 | 描述 |
 |---|---|---|
@@ -117,14 +117,14 @@ export DOC_DISCUSS_KIT_ACCESS_TOKEN="your_access_token_here"
 aigne doc publish --appUrl https://docs.mycompany.com
 ```
 
-## 故障排除
+## 问题排查
 
-如果您在发布过程中遇到问题，可能是由以下常见问题之一引起的。
+如果在发布过程中遇到问题，可能是由以下常见问题之一引起的。
 
-- **连接错误**：CLI 可能会返回类似 `Unable to connect to: <URL>` 的错误消息。这可能是由网络问题、服务器暂时不可用或 URL 不正确引起的。请验证 URL 是否正确且服务器是否可达。
+- **连接错误**：CLI 可能会返回类似 `Unable to connect to: <URL>` 的错误消息。这可能是由网络问题、服务器暂时不可用或 URL不正确引起的。请验证 URL 是否正确以及服务器是否可达。
 
-- **无效的网站 URL**：命令可能会失败并显示消息 `The provided URL is not a valid website on ArcBlock platform`。目标 URL 必须是基于 ArcBlock 平台构建的网站。要托管您的文档，您可以运行自己的 Discuss Kit 实例。
+- **无效的网站 URL**：该命令可能会失败，并显示消息 `The provided URL is not a valid website on ArcBlock platform`。目标 URL 必须是构建在 ArcBlock 平台上的网站。要托管您的文档，您可以运行自己的 Discuss Kit 实例。
 
-- **缺少必需组件**：错误消息 `This website does not have required components for publishing` 表示目标网站没有安装 Discuss Kit 组件。请参阅 Discuss Kit 文档，将必要的组件添加到您的站点。
+- **缺少必需组件**：错误消息 `This website does not have required components for publishing` 表明目标网站未安装 Discuss Kit 组件。请参考 Discuss Kit 文档，为您的站点添加必要的组件。
 
 有关命令和选项的完整列表，请参阅 [CLI 命令参考](./cli-reference.md)。

package/docs/features-translate-documentation.ja.md

@@ -1,45 +1,46 @@
 # ドキュメントの翻訳
 
-AIGNE DocSmithは、ドキュメントを英語、中国語、スペイン語など12の異なる言語に翻訳し、プロジェクトを世界中のオーディエンスに届けることができます。このツールは、ガイド付きセットアップのためのインタラクティブモードと、正確な制御と自動化のためのコマンドライン引数の2つの翻訳管理方法を提供します。
+AIGNE DocSmithは、ドキュメントを英語、中国語、スペイン語など12の異なる言語に翻訳でき、プロジェクトを世界中のオーディエンスにアクセス可能にします。このツールは、ガイド付きセットアップのための対話モードと、正確な制御と自動化のためのコマンドライン引数の2つの方法で翻訳を管理します。
 
-## インタラクティブ翻訳
+## 対話型翻訳
 
-ガイド付きの体験をしたい場合は、引数なしで`translate`コマンドを実行してください。これは、ステップバイステップのプロセスを好むユーザーに最適です。
+ガイド付きの体験をしたい場合は、引数なしで `translate` コマンドを実行してください。この方法は、ステップバイステップのプロセスを好むユーザーに最適です。
 
 ```bash
 aigne doc translate
 ```
 
-このコマンドは、プロセスを案内するインタラクティブなウィザードを起動します。
+このコマンドは対話型ウィザードを起動し、プロセスをガイドします：
 
-1.  **翻訳するドキュメントを選択:** 既存のドキュメントのリストが表示されます。スペースバーを使用して、翻訳したいドキュメントを選択します。
+1.  **翻訳するドキュメントの選択：** 既存のドキュメントのリストが表示されます。スペースバーを使用して翻訳したいものを選択します。
 
-    ![翻訳するドキュメントを選択](https://docsmith.aigne.io/image-bin/uploads/e2cf5fa45aa856c406a444fb4665ed2d.png)
+    ![翻訳するドキュメントを選択](../assets/screenshots/doc-translate.png)
 
-2.  **ターゲット言語を選択:** ドキュメントを選択した後、サポートされているオプションのリストから1つ以上のターゲット言語を選びます。
+2.  **ターゲット言語の選択：** ドキュメントを選択した後、サポートされているオプションのリストから1つ以上のターゲット言語を選びます。
 
-    ![翻訳する言語を選択](https://docsmith.aigne.io/image-bin/uploads/2e243a2488f2060a693fe0ac0c8fb5ad.png)
+    ![翻訳先の言語を選択](../assets/screenshots/doc-translate-langs.png)
 
-3.  **確認して実行:** DocSmithは翻訳を処理し、選択した各言語に対して選択したファイルの新しいバージョンを生成します。
+3.  **確認と実行：** DocSmithは翻訳を処理し、選択した各言語に対して選択されたファイルの新しいバージョンを生成します。
 
 ## コマンドライン翻訳
 
-スクリプトやCI/CDパイプラインでの自動化には、コマンドラインフラグを使用して翻訳プロセスを制御します。この方法は、開発者や上級ユーザーに適しています。
+スクリプトやCI/CDパイプラインでの自動化のために、コマンドラインフラグを使用して翻訳プロセスを制御します。この方法は、開発者や上級ユーザーにとってより高い柔軟性を提供します。
 
 ### コマンドパラメータ
 
 <x-field-group>
-  <x-field data-name="--langs" data-type="string" data-required="false" data-desc="ターゲット言語を1つ指定します。このフラグを複数回使用して、複数の言語を含めることができます（例: --langs zh --langs ja）。"></x-field>
+  <x-field data-name="--langs" data-type="string" data-required="false" data-desc="ターゲット言語を1つ指定します。このフラグは複数回使用して、複数の言語を含めることができます（例：--langs zh --langs ja）。"></x-field>
   <x-field data-name="--docs" data-type="string" data-required="false" data-desc="翻訳するドキュメントのパスを指定します。これもバッチ翻訳のために複数回使用できます。"></x-field>
-  <x-field data-name="--feedback" data-type="string" data-required="false" data-desc="翻訳の質をガイドするためにAIに提案を提供します（例: --feedback &quot;フォーマルなトーンを使用する&quot;）。"></x-field>
-  <x-field data-name="--glossary" data-type="string" data-required="false" data-desc="Markdown形式の用語集ファイルを使用して、特定の用語の用語集の一貫性を確保します（例: --glossary @path/to/glossary.md）。"></x-field>
+  <x-field data-name="--feedback" data-type="string" data-required="false" data-desc="AIに提案を提供して翻訳品質をガイドします（例：--feedback &quot;フォーマルなトーンを使用してください&quot;）。"></x-field>
+  <x-field data-name="--glossary" data-type="string" data-required="false" data-desc="Markdown形式の用語集ファイルを使用して、特定の用語の一貫性を確保します（例：--glossary @path/to/glossary.md）。"></x-field>
+  <x-field data-name="--model" data-type="string" data-required="false" data-desc="使用する翻訳モデルを指定します。例：'openai:gpt-4o' または 'google:gemini-2.5-pro'。"></x-field>
 </x-field-group>
 
 ### 例
 
 #### 特定のドキュメントの翻訳
 
-`overview.md`と`examples.md`を中国語と日本語に翻訳するには、次を実行します。
+`overview.md` と `examples.md` を中国語と日本語に翻訳するには、次のコマンドを実行します：
 
 ```bash
 aigne doc translate --langs zh --langs ja --docs overview.md --docs examples.md
@@ -47,35 +48,43 @@ aigne doc translate --langs zh --langs ja --docs overview.md --docs examples.md
 
 #### 用語集とフィードバックの使用
 
-ブランド名や技術用語が正しく翻訳されるように、用語集ファイルを提供できます。また、翻訳スタイルを洗練させるためにフィードバックを与えることもできます。
+ブランド名や技術用語が正しく翻訳されるように、用語集ファイルを提供できます。また、翻訳スタイルを洗練させるためのフィードバックも提供できます。
 
 ```bash
 aigne doc translate --glossary @path/to/glossary.md --feedback "Use technical terminology consistently" --docs overview.md --langs de
 ```
 
+#### 翻訳モデルの指定
+
+翻訳タスクに特定のAIモデルを使用するには、`--model` フラグを使用します。
+
+```bash
+aigne doc translate --docs overview.md --langs fr --model openai:gpt-4o
+```
+
 ## サポートされている言語
 
-DocSmithは、以下の12言語の自動翻訳をサポートしています。
+DocSmithは、以下の12言語の自動翻訳をサポートしています：
 
-| 言語               | コード    |
+| 言語             | コード    |
 | -------------------- | ------- |
-| 英語               | `en`    |
-| 簡体字中国語       | `zh-CN` |
-| 繁体字中国語       | `zh-TW` |
+| 英語              | `en`    |
+| 簡体字中国語   | `zh-CN` |
+| 繁体字中国語  | `zh-TW` |
 | 日本語             | `ja`    |
-| 韓国語             | `ko`    |
-| スペイン語         | `es`    |
-| フランス語         | `fr`    |
-| ドイツ語           | `de`    |
-| ポルトガル語       | `pt-BR` |
-| ロシア語           | `ru`    |
-| イタリア語         | `it`    |
-| アラビア語         | `ar`    |
+| 韓国語               | `ko`    |
+| スペイン語              | `es`    |
+| フランス語              | `fr`    |
+| ドイツ語              | `de`    |
+| ポルトガル語           | `pt-BR` |
+| ロシア語              | `ru`    |
+| イタリア語              | `it`    |
+| アラビア語               | `ar`    |
 
 ---
 
-ドキュメントが翻訳されたら、世界と共有する準備が整います。
+ドキュメントが翻訳されたら、世界と共有する準備が整いました。
 
-<x-card data-title="次へ: ドキュメントを公開する" data-icon="lucide:upload-cloud" data-href="/features/publish-your-docs" data-cta="続きを読む">
-  ドキュメントを公開プラットフォームや独自のプライベートウェブサイトに公開する方法についてのガイドです。
+<x-card data-title="次へ：ドキュメントの公開" data-icon="lucide:upload-cloud" data-href="/features/publish-your-docs" data-cta="続きを読む">
+  ドキュメントを公開プラットフォームや独自のプライベートウェブサイトに簡単に公開する方法についてのガイド。
 </x-card>

package/docs/features-translate-documentation.md

@@ -4,7 +4,7 @@ AIGNE DocSmith can translate your documentation into 12 different languages, inc
 
 ## Interactive Translation
 
-For a guided experience, run the `translate` command without any arguments. This is ideal for users who prefer a step-by-step process.
+For a guided experience, run the `translate` command without any arguments. This method is ideal for users who prefer a step-by-step process.
 
 ```bash
 aigne doc translate
@@ -14,17 +14,17 @@ This command launches an interactive wizard that guides you through the process:
 
 1.  **Select Documents to Translate:** You will be presented with a list of your existing documents. Use the spacebar to select the ones you want to translate.
 
-    ![Select documents to translate](https://docsmith.aigne.io/image-bin/uploads/e2cf5fa45aa856c406a444fb4665ed2d.png)
+    ![Select documents to translate](../assets/screenshots/doc-translate.png)
 
 2.  **Choose Target Languages:** After selecting your documents, pick one or more target languages from the list of supported options.
 
-    ![Select languages to translate into](https://docsmith.aigne.io/image-bin/uploads/2e243a2488f2060a693fe0ac0c8fb5ad.png)
+    ![Select languages to translate into](../assets/screenshots/doc-translate-langs.png)
 
 3.  **Confirm and Run:** DocSmith will then process the translation, generating new versions of your selected files for each chosen language.
 
 ## Command-Line Translation
 
-For automation in scripts or CI/CD pipelines, use command-line flags to control the translation process. This method is suitable for developers and advanced users.
+For automation in scripts or CI/CD pipelines, use command-line flags to control the translation process. This method provides greater flexibility for developers and advanced users.
 
 ### Command Parameters
 
@@ -33,13 +33,14 @@ For automation in scripts or CI/CD pipelines, use command-line flags to control
   <x-field data-name="--docs" data-type="string" data-required="false" data-desc="Specify the path of a document to translate. This can also be used multiple times for batch translation."></x-field>
   <x-field data-name="--feedback" data-type="string" data-required="false" data-desc="Provide suggestions to the AI to guide the translation quality (e.g., --feedback &quot;Use a formal tone&quot;)."></x-field>
   <x-field data-name="--glossary" data-type="string" data-required="false" data-desc="Use a glossary file in Markdown format to ensure consistent terminology for specific terms (e.g., --glossary @path/to/glossary.md)."></x-field>
+  <x-field data-name="--model" data-type="string" data-required="false" data-desc="Specify the translation model to use, for example, 'openai:gpt-4o' or 'google:gemini-2.5-pro'."></x-field>
 </x-field-group>
 
 ### Examples
 
 #### Translating Specific Documents
 
-To translate `overview.md` and `examples.md` into Chinese and Japanese, run:
+To translate `overview.md` and `examples.md` into Chinese and Japanese, run the following command:
 
 ```bash
 aigne doc translate --langs zh --langs ja --docs overview.md --docs examples.md
@@ -53,6 +54,14 @@ To ensure brand names and technical terms are translated correctly, you can prov
 aigne doc translate --glossary @path/to/glossary.md --feedback "Use technical terminology consistently" --docs overview.md --langs de
 ```
 
+#### Specifying a Translation Model
+
+To use a specific AI model for the translation task, use the `--model` flag.
+
+```bash
+aigne doc translate --docs overview.md --langs fr --model openai:gpt-4o
+```
+
 ## Supported Languages
 
 DocSmith supports automatic translation for the following 12 languages:
@@ -77,5 +86,5 @@ DocSmith supports automatic translation for the following 12 languages:
 Once your documentation is translated, you are ready to share it with the world.
 
 <x-card data-title="Next: Publish Your Docs" data-icon="lucide:upload-cloud" data-href="/features/publish-your-docs" data-cta="Read More">
-  A guide on how to publish your documentation to a public platform or your own private website.
+  A guide on how to easily publish your documentation to a public platform or your own private website.
 </x-card>