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

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

@@ -1,101 +1,120 @@
 # 產生文件
 
-`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 指令會觸發設定精靈](https://docsmith.aigne.io/image-bin/uploads/0c45a32667c5250e54194a61d9495965.png)
 
-系統會詢問您一系列問題以定義：
+系統將提示您回答一系列問題，以定義您文件的關鍵面向，包括：
 
 - 文件產生規則與風格
-- 目標讀者
-- 主要語言與翻譯語言
-- 原始碼與輸出路徑
+- 目標受眾
+- 主要語言及任何額外的翻譯語言
+- 原始碼輸入與文件輸出路徑
 
-![回答問題以設定您的文件風格、語言和來源路徑](https://docsmith.aigne.io/image-bin/uploads/fbedbfa256036ad6375a6c18047a75ad.png)
+![回答問題以設定您的文件風格、語言及原始碼路徑](https://docsmith.aigne.io/image-bin/uploads/fbedbfa256036ad6375a6c18047a75ad.png)
 
-設定完成後，DocSmith 將繼續進行文件產生。
+設定完成後，DocSmith 會繼續進行文件產生。
 
 ![DocSmith 會分析您的程式碼、規劃結構並產生每個文件](https://docsmith.aigne.io/image-bin/uploads/d0766c19380a02eb8a6f8ce86a838849.png)
 
-成功完成後，您新建立的文件將會出現在您指定的輸出目錄中。
+成功完成後，新建立的文件將可在設定期間指定的輸出目錄中找到。
 
 ![完成後，您將在指定的輸出目錄中找到新文件](https://docsmith.aigne.io/image-bin/uploads/0967443611408ad9d0042793d590b8fd.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: "找到設定檔？" {
+Config-Check: {
+  label: "設定檔\n是否存在？"
   shape: diamond
 }
 
-interactive_setup: "啟動互動式設定精靈" {
-  shape: rectangle
+Setup-Wizard: {
+  label: "互動式\n設定精靈"
 }
 
-plan_structure: "1. 分析程式碼並規劃結構" {
-  shape: rectangle
+Generation-Process: {
+  label: "產生流程"
+  grid-columns: 1
+
+  Analyze: { label: "分析程式碼庫" }
+  Plan: { label: "規劃結構" }
+  Generate: { label: "產生內容" }
 }
 
-gen_content: "2. 產生文件內容" {
-  shape: rectangle
+Source-Code: {
+  label: "原始碼"
+  shape: cylinder
 }
 
-save_docs: "3. 儲存文件" {
-  shape: rectangle
+Config-File: {
+  label: "config.yaml"
+  shape: cylinder
 }
 
-end: "結束" {
-  shape: oval
+Output-Directory: {
+  label: "輸出目錄"
+  shape: cylinder
 }
 
-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: "1. aigne doc generate"
+AIGNE-CLI -> Config-Check: "2. 檢查設定檔"
+
+Config-Check -> Setup-Wizard: "3a. 否"
+Setup-Wizard -> User: "提示輸入"
+User -> Setup-Wizard: "提供答案"
+Setup-Wizard -> Config-File: "建立"
+Config-File -> Generation-Process: "使用"
+Setup-Wizard -> Generation-Process: "4. 繼續"
+
+Config-Check -> Generation-Process: "3b. 是"
+
+Source-Code -> Generation-Process.Analyze: "輸入"
+Generation-Process.Analyze -> Generation-Process.Plan
+Generation-Process.Plan -> Generation-Process.Generate
+Generation-Process.Generate -> Output-Directory: "5. 寫入文件"
+
+Output-Directory -> User: "6. 檢閱文件"
 ```
 
-## 命令選項
+## 指令選項
 
-雖然預設的 `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 section"`         |
+| `--model`           | 指定使用 AIGNE Hub 中的特定大型語言模型來產生內容。這讓您可以在不同模型之間切換。                                                | `aigne doc generate --model anthropic:claude-3-5-sonnet`                |
 
-## 接下來呢？
+## 下一步是什麼？
 
-既然您已經產生了初始文件，您的專案將會持續發展。為了讓文件與程式碼保持同步，您需要更新它們。請前往下一節，學習如何進行針對性修改並重新產生特定檔案。
+產生初始文件後，您的專案將繼續發展。為了讓您的文件與程式碼保持同步，您需要執行更新。下一節將說明如何根據新需求或程式碼修改進行針對性變更並重新產生特定檔案。
 
-<x-card data-title="更新與優化" data-icon="lucide:file-edit" data-href="/features/update-and-refine">
-  了解當程式碼變更時如何更新文件，或利用回饋進行特定改進。
+<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,121 @@
 # 生成文档
 
-`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)
 
-系统将询问您一系列问题以定义：
+系统将提示您回答一系列问题，以定义文档的关键方面，包括：
 
 - 文档生成规则和风格
 - 目标受众
-- 主要语言和翻译语言
-- 源代码和输出路径
+- 主要语言和任何其他翻译语言
+- 源代码输入和文档输出路径
 
-![回答问题以配置您的文档风格、语言和源路径](https://docsmith.aigne.io/image-bin/uploads/fbedbfa256036ad6375a6c18047a75ad.png)
+![回答问题以配置文档风格、语言和源路径](https://docsmith.aigne.io/image-bin/uploads/fbedbfa256036ad6375a6c18047a75ad.png)
 
-配置完成后，DocSmith 将继续进行文档生成。
+配置完成后，DocSmith 会继续进行文档生成。
 
-![DocSmith 分析您的代码，规划结构，并生成每个文档](https://docsmith.aigne.io/image-bin/uploads/d0766c19380a02eb8a6f8ce86a838849.png)
+![DocSmith 分析您的代码、规划结构并生成每个文档](https://docsmith.aigne.io/image-bin/uploads/d0766c19380a02eb8a6f8ce86a838849.png)
 
-成功完成后，您新创建的文档将在您指定的输出目录中可用。
+成功完成后，新创建的文档将位于设置期间指定的输出目录中。
 
 ![完成后，您将在指定的输出目录中找到新文档](https://docsmith.aigne.io/image-bin/uploads/0967443611408ad9d0042793d590b8fd.png)
 
 ## 生成过程
 
-`generate` 命令遵循自动化工作流程。该过程可按如下方式可视化：
+`generate` 命令执行一个自动化的多步骤工作流。流程概述如下：
 
 ```d2
 direction: down
 
-start: "开始" {
-  shape: oval
+User: {
+  shape: c4-person
+  label: "用户"
 }
 
-run_cmd: "运行 `aigne doc generate`" {
-  shape: rectangle
+AIGNE-CLI: {
+  label: "AIGNE CLI"
 }
 
-check_config: "找到配置？" {
+Config-Check: {
+  label: "配置\n存在？"
   shape: diamond
 }
 
-interactive_setup: "启动交互式设置向导" {
-  shape: rectangle
+Setup-Wizard: {
+  label: "交互式\n设置向导"
 }
 
-plan_structure: "1. 分析代码并规划结构" {
-  shape: rectangle
+Generation-Process: {
+  label: "生成过程"
+  grid-columns: 1
+
+  Analyze: { label: "分析代码库" }
+  Plan: { label: "规划结构" }
+  Generate: { label: "生成内容" }
 }
 
-gen_content: "2. 生成文档内容" {
-  shape: rectangle
+Source-Code: {
+  label: "源代码"
+  shape: cylinder
 }
 
-save_docs: "3. 保存文档" {
-  shape: rectangle
+Config-File: {
+  label: "config.yaml"
+  shape: cylinder
 }
 
-end: "结束" {
-  shape: oval
+Output-Directory: {
+  label: "输出目录"
+  shape: cylinder
 }
 
-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: "1. aigne doc generate"
+AIGNE-CLI -> Config-Check: "2. 检查配置"
+
+Config-Check -> Setup-Wizard: "3a. 否"
+Setup-Wizard -> User: "提示输入"
+User -> Setup-Wizard: "提供回答"
+Setup-Wizard -> Config-File: "创建"
+Config-File -> Generation-Process: "使用"
+Setup-Wizard -> Generation-Process: "4. 继续"
+
+Config-Check -> Generation-Process: "3b. 是"
+
+Source-Code -> Generation-Process.Analyze: "输入"
+Generation-Process.Analyze -> Generation-Process.Plan
+Generation-Process.Plan -> Generation-Process.Generate
+Generation-Process.Generate -> Output-Directory: "5. 写入文档"
+
+Output-Directory -> User: "6. 审阅文档"
 ```
 
 ## 命令选项
 
-虽然默认的 `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 "Add an API Reference section"`         |
+| `--model`           | 指定 AIGNE Hub 中的特定大型语言模型用于内容生成。这允许您在不同模型之间切换。       | `aigne doc generate --model anthropic:claude-3-5-sonnet`                |
 
 ## 接下来做什么？
 
-既然您已经生成了初始文档，您的项目将继续发展。为了使文档与代码保持同步，您需要更新它们。请继续下一部分，学习如何进行有针对性的更改并重新生成特定文件。
+生成初始文档后，您的项目将继续演进。为了使文档与代码保持同步，您需要执行更新。下一节将解释如何根据新需求或代码修改进行有针对性的更改并重新生成特定文件。
 
 <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,78 +1,101 @@
 # ドキュメントを公開する
 
-ドキュメントを生成した後、`aigne doc publish`コマンドはコンテンツをDiscuss Kitプラットフォームにアップロードし、オンラインでアクセスできるようにします。このガイドでは、公式プラットフォームまたは自己ホスト型のウェブサイトにドキュメントを公開する方法について説明します。
+ドキュメントを生成した後、 `aigne doc publish` コマンドはファイルをアップロードし、共有可能なリンク経由でアクセスできるようにします。このガイドでは、公式のAIGNEプラットフォームまたはセルフホストインスタンスにドキュメントを公開するためのステップバイステップのプロセスを提供します。
 
 ## 公開プロセス
 
-`aigne doc publish`コマンドは対話的なプロセスを開始します。新しい宛先に初めて公開する場合、認証プロセスが案内されます。その後の公開では、保存された認証情報が使用されます。
+`aigne doc publish` コマンドは、インタラクティブなワークフローを開始します。初めて宛先に公開する際、CLIはブラウザを開き、1回限りの認証プロセスを案内します。その後の公開では、 `~/.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. 公開コマンドを実行する
+### 1. 公開コマンドの実行
 
-プロジェクトのルートディレクトリで、次のコマンドを実行します：
+プロジェクトのルートディレクトリに移動し、次のコマンドを実行します：
 
-```bash Terminal icon=lucide:terminal
+```bash ターミナル icon=lucide:terminal
 aigne doc publish
 ```
 
-### 2. プラットフォームを選択する
+### 2. プラットフォームの選択
 
-初めて公開する場合、宛先を選択するように求められます。ニーズに合ったオプションを選択してください。
+初めて公開する場合、宛先を選択するよう求められます。要件に合ったオプションを選択してください。
 
-![公式プラットフォームまたは自己ホスト型インスタンスから選択](https://docsmith.aigne.io/image-bin/uploads/9fd929060b5abe13d03cf5eb7aea85aa.png)
+![公式プラットフォームまたはセルフホストインスタンスから選択](https://docsmith.aigne.io/image-bin/uploads/9fd929060b5abe13d0_3cf5eb7aea85aa.png)
 
-独自のウェブサイトを選択した場合、そのURLを入力するように求められます。
+セルフホストインスタンスを選択した場合は、そのURLを入力するよう求められます。
 
-### 3. アカウントを認証する
+### 3. アカウントの認証
 
-新しいプラットフォームへの最初の接続では、ブラウザウィンドウが開き、ログインしてCLIを承認します。これはプラットフォームごとに一度だけのステップです。アクセストークンは将来の使用のためにローカルの`~/.aigne/doc-smith-connected.yaml`に保存されます。
+初回接続時には、ブラウザウィンドウが自動的に開き、ログインしてCLIを承認します。この手順はプラットフォームごとに1回だけ必要です。アクセストークンは、将来の使用のためにローカルに保存されます。
 
 ### 4. 確認
 
-アップロードが完了すると、ターミナルに成功メッセージが表示されます。
+アップロードが完了すると、ターミナルに成功メッセージが表示され、ドキュメントが公開されたことを確認します。
 
 ```
 ✅ ドキュメントが正常に公開されました！
@@ -80,28 +103,28 @@ aigne doc publish
 
 ## 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)を参照してください。