@aigne/doc-smith 0.8.11-beta.5 → 0.8.11-beta.7

package/docs/features-generate-documentation.zh-TW.md

@@ -1,101 +1,95 @@
 # 產生文件
 
-`aigne doc generate` 命令是從您的原始碼建立完整文件集的核心功能。此過程會分析您的程式碼庫、規劃邏輯性的文件結構，然後為每個部分產生內容。這是從零開始建立文件的主要方式。
+`aigne doc generate` 指令是從原始程式碼建立完整文件集的主要功能。此指令會啟動一個流程，分析您的程式碼庫、規劃邏輯性的文件結構，然後為每個部分產生內容。這是從初始狀態建立文件的標準方法。
 
-## 您的首次產生
+## 首次產生
 
-首先，請導覽至您專案的根目錄並執行以下命令：
+首先，請導覽至您專案的根目錄並執行以下指令：
 
-```bash
+```bash aigne doc generate icon=lucide:play-circle
 aigne doc generate
 ```
 
 ### 自動設定
 
-當您首次在專案中執行此命令時，DocSmith 會偵測到尚無設定。接著，它會啟動一個互動式設定精靈，引導您完成初始設定。這能確保在開始產生文件前，您擁有一個正確配置的環境。
+如果您是首次在專案中執行此指令，DocSmith 將偵測到沒有任何設定存在。然後，它會自動啟動一個互動式設定精靈，引導您完成所需的設定步驟。此過程可確保在開始產生文件之前，有一個有效的設定。
 
-![首次執行 generate 命令會觸發設定精靈](https://docsmith.aigne.io/image-bin/uploads/0c45a32667c5250e54194a61d9495965.png)
+![執行 generate 指令，智慧執行初始化](../assets/screenshots/doc-generate.png)
 
-系統會詢問您一系列問題以定義：
+系統會提示您回答一系列問題，以定義文件的關鍵面向，包括：
 
-- 文件產生規則與風格
-- 目標讀者
-- 主要語言與翻譯語言
-- 原始碼與輸出路徑
+*   文件產生規則與風格
+*   目標受眾
+*   主要語言及任何其他翻譯語言
+*   原始程式碼輸入與文件輸出路徑
 
-![回答問題以設定您的文件風格、語言和來源路徑](https://docsmith.aigne.io/image-bin/uploads/fbedbfa256036ad6375a6c18047a75ad.png)
+![回答問題以完成專案設定](../assets/screenshots/doc-complete-setup.png)
 
-設定完成後，DocSmith 將繼續進行文件產生。
+設定完成後，DocSmith 會繼續進行文件產生。
 
-![DocSmith 會分析您的程式碼、規劃結構並產生每個文件](https://docsmith.aigne.io/image-bin/uploads/d0766c19380a02eb8a6f8ce86a838849.png)
+![執行結構規劃並產生文件](../assets/screenshots/doc-generate-docs.png)
 
-成功完成後，您新建立的文件將會出現在您指定的輸出目錄中。
+成功完成後，新建立的文件將可在設定時指定的輸出目錄中找到。
 
-![完成後，您將在指定的輸出目錄中找到新文件](https://docsmith.aigne.io/image-bin/uploads/0967443611408ad9d0042793d590b8fd.png)
+![文件成功產生](../assets/screenshots/doc-generated-successfully.png)
 
-## 產生過程
+## 產生流程
 
-`generate` 命令遵循一個自動化的工作流程。其過程可視覺化如下：
+`generate` 指令會執行一個自動化的多步驟工作流程。流程概述如下：
 
 ```d2
 direction: down
 
-start: "開始" {
-  shape: oval
+User: {
+  shape: c4-person
 }
 
-run_cmd: "執行 `aigne doc generate`" {
-  shape: rectangle
-}
+AIGNE-CLI: {
+  label: "AIGNE CLI"
 
-check_config: "找到設定檔？" {
-  shape: diamond
-}
+  config-check: {
+    label: "設定檔是否存在？"
+    shape: diamond
+  }
 
-interactive_setup: "啟動互動式設定精靈" {
-  shape: rectangle
-}
+  interactive-setup: {
+    label: "互動式設定精靈"
+  }
 
-plan_structure: "1. 分析程式碼並規劃結構" {
-  shape: rectangle
-}
+  generation-process: {
+    label: "3. 產生流程"
 
-gen_content: "2. 產生文件內容" {
-  shape: rectangle
-}
+    analyze-code: "分析程式碼"
+    plan-structure: "規劃結構"
+    generate-content: "產生內容"
 
-save_docs: "3. 儲存文件" {
-  shape: rectangle
-}
+    analyze-code -> plan-structure -> generate-content
+  }
 
-end: "結束" {
-  shape: oval
+  output: {
+    label: "輸出目錄"
+  }
 }
 
-start -> run_cmd
-run_cmd -> check_config
-check_config -> interactive_setup: "否"
-interactive_setup -> plan_structure
-check_config -> plan_structure: "是"
-plan_structure -> gen_content
-gen_content -> save_docs
-save_docs -> end
+User -> AIGNE-CLI.config-check: "'aigne doc generate'"
+AIGNE-CLI.config-check -> AIGNE-CLI.interactive-setup: "[否] 2. 啟動設定"
+AIGNE-CLI.interactive-setup -> AIGNE-CLI.generation-process: "建立設定檔"
+AIGNE-CLI.config-check -> AIGNE-CLI.generation-process: "[是]"
+AIGNE-CLI.generation-process -> AIGNE-CLI.output: "4. 寫入文件"
 ```
 
-## 命令選項
+## 指令選項
 
-雖然預設的 `generate` 命令已足夠應付大多數使用情境，但您仍可使用數個選項來控制產生過程。這些選項對於重新產生內容或優化文件結構很有幫助。
+預設的 `generate` 指令足以應付大多數使用情境。然而，有幾個選項可用於修改其行為，這對於強制完整重新產生或完善文件結構非常有用。
 
-| Option              | Description                                                                                                                              | Example                                                              |
-|---------------------|------------------------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------|
-| `--forceRegenerate` | 刪除所有現有文件並從頭開始重新產生。當您的原始碼或設定有重大變更時，請使用此選項。 | `aigne doc generate --forceRegenerate`                                 |
-| `--feedback`        | 提供高層次的回饋以優化整體文件結構，例如新增、移除或重組章節。           | `aigne doc generate --feedback "Add an API Reference section"`         |
-| `--model`           | 指定一個來自 AIGNE Hub 的特定大型語言模型用於內容產生，讓您可以在不同模型之間切換。       | `aigne doc generate --model claude:claude-3-5-sonnet`                |
+| 選項 | 描述 | 範例 |
+| :------------------ | :----------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------- |
+| `--forceRegenerate` | 刪除所有現有文件並從頭開始重新產生。在對原始程式碼或設定進行重大變更後使用此選項。 | `aigne doc generate --forceRegenerate` |
+| `--feedback` | 提供高層次的回饋以完善整體文件結構，例如新增、移除或重組章節。 | `aigne doc generate --feedback "Add an API Reference"` |
+| `--model` | 指定從 AIGNE Hub 使用特定的大型語言模型來產生內容，讓您可以在不同模型之間切換。 | `aigne doc generate --model openai:gpt-4o` |
 
-## 接下來呢？
+## 下一步是什麼？
 
-既然您已經產生了初始文件，您的專案將會持續發展。為了讓文件與程式碼保持同步，您需要更新它們。請前往下一節，學習如何進行針對性修改並重新產生特定檔案。
+產生初始文件後，您的專案將會持續演進。為了讓您的文件與程式碼保持同步，您需要執行更新。下一節將說明如何根據新的需求或程式碼修改進行針對性變更並重新產生特定檔案。
 
-<x-card data-title="更新與優化" data-icon="lucide:file-edit" data-href="/features/update-and-refine">
-  了解當程式碼變更時如何更新文件，或利用回饋進行特定改進。
-</x-card>
+<x-card data-title="更新與完善" data-icon="lucide:file-edit" data-href="/features/update-and-refine">學習如何在程式碼變更時更新文件，或使用回饋進行特定改進。</x-card>

package/docs/features-generate-documentation.zh.md

@@ -1,101 +1,95 @@
 # 生成文档
 
-`aigne doc generate` 命令是用于从源代码创建完整文档集的核心功能。此过程会分析您的代码库，规划逻辑文档结构，然后为每个部分生成内容。这是从头开始创建文档的主要方式。
+`aigne doc generate` 命令是用于从源代码创建完整文档集的主要功能。该命令会启动一个流程，分析您的代码库，规划逻辑化的文档结构，然后为每个部分生成内容。这是从初始状态创建文档的标准方法。
 
 ## 首次生成
 
 首先，请导航到您项目的根目录并运行以下命令：
 
-```bash
+```bash aigne doc generate icon=lucide:play-circle
 aigne doc generate
 ```
 
 ### 自动配置
 
-如果您在项目中首次运行此命令，DocSmith 会检测到不存在任何配置。然后，它将启动一个交互式设置向导来指导您完成初始设置。这能确保在生成开始前，您拥有一个正确配置的环境。
+如果您是首次在项目中运行此命令，DocSmith 将检测到尚不存在任何配置。随后，它将自动启动一个交互式设置向导，引导您完成所需的设置步骤。此过程可确保在生成开始前已准备好有效的配置。
 
-![首次运行 generate 命令会触发设置向导](https://docsmith.aigne.io/image-bin/uploads/0c45a32667c5250e54194a61d9495965.png)
+![运行 generate 命令，智能执行初始化](../assets/screenshots/doc-generate.png)
 
-系统将询问您一系列问题以定义：
+系统将提示您回答一系列问题，以定义文档的关键方面，包括：
 
-- 文档生成规则和风格
-- 目标受众
-- 主要语言和翻译语言
-- 源代码和输出路径
+*   文档生成规则和风格
+*   目标受众
+*   主要语言及任何其他翻译语言
+*   源代码输入和文档输出路径
 
-![回答问题以配置您的文档风格、语言和源路径](https://docsmith.aigne.io/image-bin/uploads/fbedbfa256036ad6375a6c18047a75ad.png)
+![回答问题以完成项目设置](../assets/screenshots/doc-complete-setup.png)
 
 配置完成后，DocSmith 将继续进行文档生成。
 
-![DocSmith 分析您的代码，规划结构，并生成每个文档](https://docsmith.aigne.io/image-bin/uploads/d0766c19380a02eb8a6f8ce86a838849.png)
+![执行结构规划并生成文档](../assets/screenshots/doc-generate-docs.png)
 
-成功完成后，您新创建的文档将在您指定的输出目录中可用。
+成功完成后，新创建的文档将位于设置期间指定的输出目录中。
 
-![完成后，您将在指定的输出目录中找到新文档](https://docsmith.aigne.io/image-bin/uploads/0967443611408ad9d0042793d590b8fd.png)
+![文档生成成功](../assets/screenshots/doc-generated-successfully.png)
 
 ## 生成过程
 
-`generate` 命令遵循自动化工作流程。该过程可按如下方式可视化：
+`generate` 命令执行一个自动化的多步骤工作流。该过程概述如下：
 
 ```d2
 direction: down
 
-start: "开始" {
-  shape: oval
+User: {
+  shape: c4-person
 }
 
-run_cmd: "运行 `aigne doc generate`" {
-  shape: rectangle
-}
+AIGNE-CLI: {
+  label: "AIGNE CLI"
 
-check_config: "找到配置？" {
-  shape: diamond
-}
+  config-check: {
+    label: "配置文件是否存在？"
+    shape: diamond
+  }
 
-interactive_setup: "启动交互式设置向导" {
-  shape: rectangle
-}
+  interactive-setup: {
+    label: "交互式设置向导"
+  }
 
-plan_structure: "1. 分析代码并规划结构" {
-  shape: rectangle
-}
+  generation-process: {
+    label: "3. 生成过程"
 
-gen_content: "2. 生成文档内容" {
-  shape: rectangle
-}
+    analyze-code: "分析代码"
+    plan-structure: "规划结构"
+    generate-content: "生成内容"
 
-save_docs: "3. 保存文档" {
-  shape: rectangle
-}
+    analyze-code -> plan-structure -> generate-content
+  }
 
-end: "结束" {
-  shape: oval
+  output: {
+    label: "输出目录"
+  }
 }
 
-start -> run_cmd
-run_cmd -> check_config
-check_config -> interactive_setup: "否"
-interactive_setup -> plan_structure
-check_config -> plan_structure: "是"
-plan_structure -> gen_content
-gen_content -> save_docs
-save_docs -> end
+User -> AIGNE-CLI.config-check: "'aigne doc generate'"
+AIGNE-CLI.config-check -> AIGNE-CLI.interactive-setup: "[否] 2. 启动设置"
+AIGNE-CLI.interactive-setup -> AIGNE-CLI.generation-process: "创建配置文件"
+AIGNE-CLI.config-check -> AIGNE-CLI.generation-process: "[是]"
+AIGNE-CLI.generation-process -> AIGNE-CLI.output: "4. 编写文档"
 ```
 
 ## 命令选项
 
-虽然默认的 `generate` 命令足以满足大多数用例，但您可以使用几个选项来控制生成过程。这些选项对于重新生成内容或优化文档结构非常有用。
+默认的 `generate` 命令足以满足大多数使用场景。但是，有几个选项可用于修改其行为，这对于强制完全重新生成或优化文档结构非常有用。
 
-| 选项 | 描述 | 示例 |
-|---------------------|------------------------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------|
-| `--forceRegenerate` | 删除所有现有文档并从头开始重新生成。在对源代码或配置进行重大更改后使用此选项。 | `aigne doc generate --forceRegenerate` |
-| `--feedback` | 提供高层反馈以优化整体文档结构，例如添加、删除或重组部分。 | `aigne doc generate --feedback "添加一个 API 参考部分"` |
-| `--model` | 指定一个来自 AIGNE Hub 的特定大型语言模型用于内容生成，允许您在不同模型之间切换。 | `aigne doc generate --model claude:claude-3-5-sonnet` |
+| 选项              | 描述                                                                                                                                   | 示例                                                   |
+| :------------------ | :--------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------- |
+| `--forceRegenerate` | 删除所有现有文档并从头开始重新生成。在对源代码或配置进行重大更改后使用此选项。                                                                 | `aigne doc generate --forceRegenerate`                   |
+| `--feedback`        | 提供高层反馈以优化整体文档结构，例如添加、删除或重组部分。                                                                                       | `aigne doc generate --feedback "添加 API 参考"`    |
+| `--model`           | 指定 AIGNE Hub 中的特定大型语言模型用于内容生成，允许您在不同模型之间切换。                                                                      | `aigne doc generate --model openai:gpt-4o`               |
 
 ## 接下来做什么？
 
-既然您已经生成了初始文档，您的项目将继续发展。为了使文档与代码保持同步，您需要更新它们。请继续下一部分，学习如何进行有针对性的更改并重新生成特定文件。
+生成初始文档后，您的项目将继续发展。为了使您的文档与代码保持同步，您需要执行更新。下一节将解释如何根据新需求或代码修改进行有针对性的更改并重新生成特定文件。
 
-<x-card data-title="更新和优化" data-icon="lucide:file-edit" data-href="/features/update-and-refine">
-  学习当您的代码发生变化时如何更新文档，或使用反馈进行特定改进。
-</x-card>
+<x-card data-title="更新和优化" data-icon="lucide:file-edit" data-href="/features/update-and-refine">了解如何在代码更改时更新文档，或使用反馈进行特定改进。</x-card>

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

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