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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (118) hide show
  1. package/.aigne/doc-smith/config.yaml +2 -4
  2. package/.release-please-manifest.json +1 -1
  3. package/CHANGELOG.md +17 -2
  4. package/README.md +1 -1
  5. package/agents/clear/choose-contents.mjs +2 -2
  6. package/agents/clear/clear-document-structure.mjs +8 -8
  7. package/agents/clear/index.yaml +1 -1
  8. package/agents/evaluate/document-structure.yaml +1 -1
  9. package/agents/generate/check-d2-diagram-valid.mjs +26 -0
  10. package/agents/generate/check-document-structure.yaml +3 -3
  11. package/agents/generate/check-need-generate-structure.mjs +8 -8
  12. package/agents/generate/document-structure-tools/add-document.mjs +3 -3
  13. package/agents/generate/document-structure-tools/delete-document.mjs +2 -2
  14. package/agents/generate/document-structure-tools/move-document.mjs +3 -2
  15. package/agents/generate/document-structure-tools/update-document.mjs +2 -2
  16. package/agents/generate/generate-d2-diagram.yaml +23 -0
  17. package/agents/generate/generate-structure.yaml +1 -1
  18. package/agents/generate/merge-d2-diagram.yaml +39 -0
  19. package/agents/generate/update-document-structure.yaml +3 -3
  20. package/agents/generate/user-review-document-structure.mjs +10 -10
  21. package/agents/init/index.mjs +18 -10
  22. package/agents/publish/publish-docs.mjs +17 -20
  23. package/agents/update/batch-generate-document.yaml +1 -1
  24. package/agents/update/check-document.mjs +2 -2
  25. package/agents/update/generate-document.yaml +25 -0
  26. package/agents/utils/check-feedback-refiner.mjs +1 -1
  27. package/agents/utils/choose-docs.mjs +1 -1
  28. package/agents/utils/load-document-all-content.mjs +3 -3
  29. package/agents/utils/load-sources.mjs +1 -1
  30. package/agents/utils/save-docs.mjs +7 -28
  31. package/aigne.yaml +2 -2
  32. package/docs/_sidebar.md +1 -1
  33. package/docs/advanced-how-it-works.md +3 -3
  34. package/docs/advanced-quality-assurance.md +1 -1
  35. package/docs/cli-reference.ja.md +151 -80
  36. package/docs/cli-reference.md +126 -55
  37. package/docs/cli-reference.zh-TW.md +133 -62
  38. package/docs/cli-reference.zh.md +143 -72
  39. package/docs/configuration-interactive-setup.md +1 -1
  40. package/docs/configuration-language-support.md +1 -1
  41. package/docs/configuration-preferences.md +1 -1
  42. package/docs/configuration.ja.md +104 -48
  43. package/docs/configuration.md +58 -2
  44. package/docs/configuration.zh-TW.md +99 -42
  45. package/docs/configuration.zh.md +78 -21
  46. package/docs/features-generate-documentation.ja.md +63 -44
  47. package/docs/features-generate-documentation.md +54 -35
  48. package/docs/features-generate-documentation.zh-TW.md +67 -48
  49. package/docs/features-generate-documentation.zh.md +61 -41
  50. package/docs/features-publish-your-docs.ja.md +69 -46
  51. package/docs/features-publish-your-docs.md +65 -42
  52. package/docs/features-publish-your-docs.zh-TW.md +73 -50
  53. package/docs/features-publish-your-docs.zh.md +67 -44
  54. package/docs/features-translate-documentation.ja.md +35 -33
  55. package/docs/features-translate-documentation.md +24 -22
  56. package/docs/features-translate-documentation.zh-TW.md +32 -30
  57. package/docs/features-translate-documentation.zh.md +29 -27
  58. package/docs/features-update-and-refine.ja.md +120 -66
  59. package/docs/features-update-and-refine.md +110 -56
  60. package/docs/features-update-and-refine.zh-TW.md +116 -62
  61. package/docs/features-update-and-refine.zh.md +118 -64
  62. package/docs/getting-started.ja.md +22 -22
  63. package/docs/getting-started.md +1 -1
  64. package/docs/getting-started.zh-TW.md +16 -16
  65. package/docs/getting-started.zh.md +28 -28
  66. package/docs/overview.md +3 -3
  67. package/docs-mcp/analyze-docs-relevance.yaml +6 -6
  68. package/docs-mcp/docs-search.yaml +1 -1
  69. package/package.json +3 -3
  70. package/prompts/common/document-structure/conflict-resolution-guidance.md +3 -3
  71. package/prompts/common/document-structure/document-structure-rules.md +2 -2
  72. package/prompts/detail/{d2-chart/rules.md → d2-diagram/rules-system.md} +41 -5
  73. package/prompts/detail/d2-diagram/rules-user.md +4 -0
  74. package/prompts/detail/document-rules.md +3 -4
  75. package/prompts/detail/generate-document.md +8 -2
  76. package/prompts/detail/update-document.md +0 -2
  77. package/prompts/evaluate/document-structure.md +6 -6
  78. package/prompts/structure/check-document-structure.md +10 -10
  79. package/prompts/structure/document-rules.md +2 -2
  80. package/prompts/structure/generate-structure-system.md +3 -3
  81. package/prompts/structure/structure-example.md +1 -1
  82. package/prompts/structure/structure-getting-started.md +1 -1
  83. package/prompts/structure/update-document-structure.md +9 -9
  84. package/prompts/utils/feedback-refiner.md +1 -1
  85. package/tests/agents/clear/choose-contents.test.mjs +1 -1
  86. package/tests/agents/clear/clear-document-structure.test.mjs +36 -30
  87. package/tests/agents/evaluate/generate-report.test.mjs +1 -1
  88. package/tests/agents/generate/check-need-generate-structure.test.mjs +1 -1
  89. package/tests/agents/generate/document-structure-tools/add-document.test.mjs +2 -2
  90. package/tests/agents/generate/document-structure-tools/delete-document.test.mjs +4 -4
  91. package/tests/agents/generate/document-structure-tools/move-document.test.mjs +3 -3
  92. package/tests/agents/generate/document-structure-tools/update-document.test.mjs +3 -3
  93. package/tests/agents/generate/user-review-document-structure.test.mjs +7 -5
  94. package/tests/agents/init/init.test.mjs +25 -19
  95. package/tests/agents/publish/publish-docs.test.mjs +99 -0
  96. package/tests/agents/update/check-document.test.mjs +1 -1
  97. package/tests/agents/utils/check-detail-result.test.mjs +2 -15
  98. package/tests/agents/utils/format-document-structure.test.mjs +5 -5
  99. package/tests/agents/utils/load-sources.test.mjs +4 -4
  100. package/tests/agents/utils/save-docs.test.mjs +1 -1
  101. package/tests/utils/auth-utils.test.mjs +1 -1
  102. package/tests/utils/conflict-detector.test.mjs +1 -1
  103. package/tests/utils/d2-utils.test.mjs +4 -4
  104. package/tests/utils/deploy.test.mjs +3 -10
  105. package/tests/utils/docs-finder-utils.test.mjs +8 -8
  106. package/tests/utils/kroki-utils.test.mjs +5 -5
  107. package/tests/utils/preferences-utils.test.mjs +5 -3
  108. package/tests/utils/save-value-to-config.test.mjs +3 -1
  109. package/types/document-structure-schema.mjs +9 -9
  110. package/utils/auth-utils.mjs +4 -0
  111. package/utils/conflict-detector.mjs +1 -1
  112. package/utils/constants/index.mjs +7 -4
  113. package/utils/d2-utils.mjs +11 -6
  114. package/utils/deploy.mjs +4 -20
  115. package/utils/docs-finder-utils.mjs +11 -11
  116. package/utils/kroki-utils.mjs +5 -4
  117. package/utils/markdown-checker.mjs +1 -21
  118. /package/prompts/detail/{d2-chart → d2-diagram}/official-examples.md +0 -0
@@ -1,10 +1,10 @@
1
1
  # ドキュメントの翻訳
2
2
 
3
- AIGNE DocSmithは、ドキュメントを12の異なる言語に翻訳でき、プロジェクトを世界中のオーディエンスに届けることができます。このツールは翻訳を管理するための2つの方法を提供します。ガイド付きセットアップのためのインタラクティブモードと、正確な制御と自動化のためのコマンドライン引数です。
3
+ AIGNE DocSmithは、ドキュメントを英語、中国語、スペイン語など12の異なる言語に翻訳し、プロジェクトを世界中のオーディエンスに届けることができます。このツールは、ガイド付きセットアップのためのインタラクティブモードと、正確な制御と自動化のためのコマンドライン引数の2つの翻訳管理方法を提供します。
4
4
 
5
- ## インタラクティブな翻訳
5
+ ## インタラクティブ翻訳
6
6
 
7
- ガイド付きの体験には、引数なしで`translate`コマンドを実行します。これは、ステップバイステップのプロセスを好むユーザーに最適です。
7
+ ガイド付きの体験をしたい場合は、引数なしで`translate`コマンドを実行してください。これは、ステップバイステップのプロセスを好むユーザーに最適です。
8
8
 
9
9
  ```bash
10
10
  aigne doc translate
@@ -12,32 +12,34 @@ aigne doc translate
12
12
 
13
13
  このコマンドは、プロセスを案内するインタラクティブなウィザードを起動します。
14
14
 
15
- 1. **翻訳するドキュメントを選択:**既存のドキュメントのリストが表示されます。スペースバーを使用して、翻訳したいものを選択します。
15
+ 1. **翻訳するドキュメントを選択:** 既存のドキュメントのリストが表示されます。スペースバーを使用して、翻訳したいドキュメントを選択します。
16
16
 
17
17
  ![翻訳するドキュメントを選択](https://docsmith.aigne.io/image-bin/uploads/e2cf5fa45aa856c406a444fb4665ed2d.png)
18
18
 
19
- 2. **ターゲット言語を選択:**ドキュメントを選択した後、サポートされているオプションのリストから1つ以上のターゲット言語を選びます。
19
+ 2. **ターゲット言語を選択:** ドキュメントを選択した後、サポートされているオプションのリストから1つ以上のターゲット言語を選びます。
20
20
 
21
21
  ![翻訳する言語を選択](https://docsmith.aigne.io/image-bin/uploads/2e243a2488f2060a693fe0ac0c8fb5ad.png)
22
22
 
23
- 3. **確認と実行:**DocSmithは翻訳を処理し、選択した各言語に対して選択されたファイルの新しいバージョンを生成します。
23
+ 3. **確認して実行:** DocSmithは翻訳を処理し、選択した各言語に対して選択したファイルの新しいバージョンを生成します。
24
24
 
25
- ## コマンドラインによる翻訳
25
+ ## コマンドライン翻訳
26
26
 
27
27
  スクリプトやCI/CDパイプラインでの自動化には、コマンドラインフラグを使用して翻訳プロセスを制御します。この方法は、開発者や上級ユーザーに適しています。
28
28
 
29
29
  ### コマンドパラメータ
30
30
 
31
- <x-field data-name="--langs" data-type="string" data-required="false" data-desc="ターゲット言語を1つ指定します。このフラグを複数回使用して、複数の言語を含めることができます(例:--langs zh --langs ja)。"></x-field>
32
- <x-field data-name="--docs" data-type="string" data-required="false" data-desc="翻訳するドキュメントのパスを指定します。これも複数回使用してバッチ翻訳が可能です。"></x-field>
33
- <x-field data-name="--feedback" data-type="string" data-required="false" data-desc="AIに提案を提供して、翻訳の品質をガイドします(例:--feedback &quot;フォーマルなトーンを使用してください&quot;)。"></x-field>
34
- <x-field data-name="--glossary" data-type="string" data-required="false" data-desc="Markdown形式の用語集ファイルを使用して、特定の用語の一貫性を確保します(例:--glossary @path/to/glossary.md)。"></x-field>
31
+ <x-field-group>
32
+ <x-field data-name="--langs" data-type="string" data-required="false" data-desc="ターゲット言語を1つ指定します。このフラグを複数回使用して、複数の言語を含めることができます(例: --langs zh --langs ja)。"></x-field>
33
+ <x-field data-name="--docs" data-type="string" data-required="false" data-desc="翻訳するドキュメントのパスを指定します。これもバッチ翻訳のために複数回使用できます。"></x-field>
34
+ <x-field data-name="--feedback" data-type="string" data-required="false" data-desc="翻訳の質をガイドするためにAIに提案を提供します(例: --feedback &quot;フォーマルなトーンを使用する&quot;)。"></x-field>
35
+ <x-field data-name="--glossary" data-type="string" data-required="false" data-desc="Markdown形式の用語集ファイルを使用して、特定の用語の用語集の一貫性を確保します(例: --glossary @path/to/glossary.md)。"></x-field>
36
+ </x-field-group>
35
37
 
36
38
  ### 例
37
39
 
38
40
  #### 特定のドキュメントの翻訳
39
41
 
40
- `overview.md`と`examples.md`を中国語と日本語に翻訳するには、以下を実行します。
42
+ `overview.md`と`examples.md`を中国語と日本語に翻訳するには、次を実行します。
41
43
 
42
44
  ```bash
43
45
  aigne doc translate --langs zh --langs ja --docs overview.md --docs examples.md
@@ -45,35 +47,35 @@ aigne doc translate --langs zh --langs ja --docs overview.md --docs examples.md
45
47
 
46
48
  #### 用語集とフィードバックの使用
47
49
 
48
- ブランド名や技術用語が正しく翻訳されるように、用語集ファイルを提供できます。また、フィードバックを与えて翻訳スタイルを洗練させることもできます。
50
+ ブランド名や技術用語が正しく翻訳されるように、用語集ファイルを提供できます。また、翻訳スタイルを洗練させるためにフィードバックを与えることもできます。
49
51
 
50
52
  ```bash
51
- aigne doc translate --glossary @glossary.md --feedback "Use technical terminology consistently" --docs overview.md --langs de
53
+ aigne doc translate --glossary @path/to/glossary.md --feedback "Use technical terminology consistently" --docs overview.md --langs de
52
54
  ```
53
55
 
54
56
  ## サポートされている言語
55
57
 
56
- DocSmithは、以下の言語の自動翻訳をサポートしています。
57
-
58
- | Language | Code |
59
- |---|---|
60
- | 英語 | en |
61
- | 簡体字中国語 | zh-CN |
62
- | 繁体字中国語 | zh-TW |
63
- | 日本語 | ja |
64
- | 韓国語 | ko |
65
- | スペイン語 | es |
66
- | フランス語 | fr |
67
- | ドイツ語 | de |
68
- | ポルトガル語 | pt-BR |
69
- | ロシア語 | ru |
70
- | イタリア語 | it |
71
- | アラビア語 | ar |
58
+ DocSmithは、以下の12言語の自動翻訳をサポートしています。
59
+
60
+ | 言語 | コード |
61
+ | -------------------- | ------- |
62
+ | 英語 | `en` |
63
+ | 簡体字中国語 | `zh-CN` |
64
+ | 繁体字中国語 | `zh-TW` |
65
+ | 日本語 | `ja` |
66
+ | 韓国語 | `ko` |
67
+ | スペイン語 | `es` |
68
+ | フランス語 | `fr` |
69
+ | ドイツ語 | `de` |
70
+ | ポルトガル語 | `pt-BR` |
71
+ | ロシア語 | `ru` |
72
+ | イタリア語 | `it` |
73
+ | アラビア語 | `ar` |
72
74
 
73
75
  ---
74
76
 
75
- ドキュメントが翻訳されたら、世界と共有する準備が整いました。
77
+ ドキュメントが翻訳されたら、世界と共有する準備が整います。
76
78
 
77
- <x-card data-title="次へ:ドキュメントの公開" data-icon="lucide:upload-cloud" data-href="/features/publish-your-docs" data-cta="続きを読む">
78
- ドキュメントを公開プラットフォームまたは独自のプライベートウェブサイトに公開する方法についてのガイド。
79
+ <x-card data-title="次へ: ドキュメントを公開する" data-icon="lucide:upload-cloud" data-href="/features/publish-your-docs" data-cta="続きを読む">
80
+ ドキュメントを公開プラットフォームや独自のプライベートウェブサイトに公開する方法についてのガイドです。
79
81
  </x-card>
@@ -1,6 +1,6 @@
1
1
  # Translate Documentation
2
2
 
3
- AIGNE DocSmith can translate your documentation into 12 different languages, making your project accessible to a global audience. The tool provides two ways to manage translations: an interactive mode for a guided setup and command-line arguments for precise control and automation.
3
+ AIGNE DocSmith can translate your documentation into 12 different languages, including English, Chinese, and Spanish, making your project accessible to a global audience. The tool provides two ways to manage translations: an interactive mode for a guided setup and command-line arguments for precise control and automation.
4
4
 
5
5
  ## Interactive Translation
6
6
 
@@ -28,10 +28,12 @@ For automation in scripts or CI/CD pipelines, use command-line flags to control
28
28
 
29
29
  ### Command Parameters
30
30
 
31
- <x-field data-name="--langs" data-type="string" data-required="false" data-desc="Specify one target language. This flag can be used multiple times to include several languages (e.g., --langs zh --langs ja)."></x-field>
32
- <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>
33
- <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>
34
- <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>
31
+ <x-field-group>
32
+ <x-field data-name="--langs" data-type="string" data-required="false" data-desc="Specify one target language. This flag can be used multiple times to include several languages (e.g., --langs zh --langs ja)."></x-field>
33
+ <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>
34
+ <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>
35
+ <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>
36
+ </x-field-group>
35
37
 
36
38
  ### Examples
37
39
 
@@ -48,27 +50,27 @@ aigne doc translate --langs zh --langs ja --docs overview.md --docs examples.md
48
50
  To ensure brand names and technical terms are translated correctly, you can provide a glossary file. You can also give feedback to refine the translation style.
49
51
 
50
52
  ```bash
51
- aigne doc translate --glossary @glossary.md --feedback "Use technical terminology consistently" --docs overview.md --langs de
53
+ aigne doc translate --glossary @path/to/glossary.md --feedback "Use technical terminology consistently" --docs overview.md --langs de
52
54
  ```
53
55
 
54
56
  ## Supported Languages
55
57
 
56
- DocSmith supports automatic translation for the following languages:
57
-
58
- | Language | Code |
59
- |---|---|
60
- | English | en |
61
- | Simplified Chinese | zh-CN |
62
- | Traditional Chinese | zh-TW |
63
- | Japanese | ja |
64
- | Korean | ko |
65
- | Spanish | es |
66
- | French | fr |
67
- | German | de |
68
- | Portuguese | pt-BR |
69
- | Russian | ru |
70
- | Italian | it |
71
- | Arabic | ar |
58
+ DocSmith supports automatic translation for the following 12 languages:
59
+
60
+ | Language | Code |
61
+ | -------------------- | ------- |
62
+ | English | `en` |
63
+ | Simplified Chinese | `zh-CN` |
64
+ | Traditional Chinese | `zh-TW` |
65
+ | Japanese | `ja` |
66
+ | Korean | `ko` |
67
+ | Spanish | `es` |
68
+ | French | `fr` |
69
+ | German | `de` |
70
+ | Portuguese | `pt-BR` |
71
+ | Russian | `ru` |
72
+ | Italian | `it` |
73
+ | Arabic | `ar` |
72
74
 
73
75
  ---
74
76
 
@@ -1,18 +1,18 @@
1
1
  # 翻譯文件
2
2
 
3
- AIGNE DocSmith 可以將您的文件翻譯成 12 種不同的語言,讓您的專案能夠觸及全球受眾。此工具提供兩種管理翻譯的方式:用於引導式設定的互動模式,以及用於精確控制和自動化的命令列參數。
3
+ AIGNE DocSmith 可以將您的文件翻譯成 12 種不同的語言,包括英文、中文和西班牙文,讓您的專案能觸及全球受眾。此工具提供兩種方式來管理翻譯:一種是用於引導式設定的互動模式,另一種是透過命令列參數進行精確控制和自動化。
4
4
 
5
5
  ## 互動式翻譯
6
6
 
7
- 若想獲得引導式體驗,請執行不含任何參數的 `translate` 指令。這對於偏好逐步操作的使用者來說非常理想。
7
+ 若要獲得引導式體驗,請在不帶任何參數的情況下執行 `translate` 命令。這對於偏好逐步操作流程的使用者來說非常理想。
8
8
 
9
9
  ```bash
10
10
  aigne doc translate
11
11
  ```
12
12
 
13
- 此指令會啟動一個互動式精靈,引導您完成整個過程:
13
+ 此命令會啟動一個互動式精靈,引導您完成整個流程:
14
14
 
15
- 1. **選取要翻譯的文件:** 您將看到現有文件的列表。使用空格鍵選取您想要翻譯的文件。
15
+ 1. **選取要翻譯的文件:** 您將看到現有文件的列表。使用空白鍵選取您想翻譯的文件。
16
16
 
17
17
  ![選取要翻譯的文件](https://docsmith.aigne.io/image-bin/uploads/e2cf5fa45aa856c406a444fb4665ed2d.png)
18
18
 
@@ -20,24 +20,26 @@ aigne doc translate
20
20
 
21
21
  ![選擇要翻譯的語言](https://docsmith.aigne.io/image-bin/uploads/2e243a2488f2060a693fe0ac0c8fb5ad.png)
22
22
 
23
- 3. **確認並執行:** 接著 DocSmith 將處理翻譯,為每個選擇的語言產生您所選檔案的新版本。
23
+ 3. **確認並執行:** DocSmith 接著會處理翻譯,為您選擇的每種語言生成所選文件的新版本。
24
24
 
25
25
  ## 命令列翻譯
26
26
 
27
- 對於指令稿或 CI/CD 管線中的自動化,請使用命令列旗標來控制翻譯過程。此方法適合開發人員和進階使用者。
27
+ 對於腳本或 CI/CD 管線中的自動化,請使用命令列旗標來控制翻譯流程。此方法適合開發人員和進階使用者。
28
28
 
29
- ### 指令參數
29
+ ### 命令參數
30
30
 
31
- <x-field data-name="--langs" data-type="string" data-required="false" data-desc="指定一個目標語言。此旗標可多次使用以包含多種語言(例如,--langs zh --langs ja)。"></x-field>
32
- <x-field data-name="--docs" data-type="string" data-required="false" data-desc="指定要翻譯的文件的路徑。此旗標也可多次使用以進行批次翻譯。"></x-field>
33
- <x-field data-name="--feedback" data-type="string" data-required="false" data-desc="向 AI 提供建議以引導翻譯品質(例如,--feedback &quot;使用正式語氣&quot;)。"></x-field>
34
- <x-field data-name="--glossary" data-type="string" data-required="false" data-desc="使用 Markdown 格式的詞彙表檔案,以確保特定術語的術語一致性(例如,--glossary @path/to/glossary.md)。"></x-field>
31
+ <x-field-group>
32
+ <x-field data-name="--langs" data-type="string" data-required="false" data-desc="指定一種目標語言。此旗標可多次使用以包含多種語言(例如:--langs zh --langs ja)。"></x-field>
33
+ <x-field data-name="--docs" data-type="string" data-required="false" data-desc="指定要翻譯的文件的路徑。此旗標也可多次使用以進行批次翻譯。"></x-field>
34
+ <x-field data-name="--feedback" data-type="string" data-required="false" data-desc=" AI 提供建議以引導翻譯品質(例如:--feedback &quot;使用正式語氣&quot;)。"></x-field>
35
+ <x-field data-name="--glossary" data-type="string" data-required="false" data-desc="使用 Markdown 格式的詞彙表檔案,以確保特定術語的一致性(例如:--glossary @path/to/glossary.md)。"></x-field>
36
+ </x-field-group>
35
37
 
36
38
  ### 範例
37
39
 
38
40
  #### 翻譯特定文件
39
41
 
40
- 若要將 `overview.md` 和 `examples.md` 翻譯成中文和日文,請執行:
42
+ 要將 `overview.md` 和 `examples.md` 翻譯成中文和日文,請執行:
41
43
 
42
44
  ```bash
43
45
  aigne doc translate --langs zh --langs ja --docs overview.md --docs examples.md
@@ -48,31 +50,31 @@ aigne doc translate --langs zh --langs ja --docs overview.md --docs examples.md
48
50
  為確保品牌名稱和技術術語翻譯正確,您可以提供一個詞彙表檔案。您也可以提供回饋來改善翻譯風格。
49
51
 
50
52
  ```bash
51
- aigne doc translate --glossary @glossary.md --feedback "Use technical terminology consistently" --docs overview.md --langs de
53
+ aigne doc translate --glossary @path/to/glossary.md --feedback "Use technical terminology consistently" --docs overview.md --langs de
52
54
  ```
53
55
 
54
56
  ## 支援的語言
55
57
 
56
- DocSmith 支援以下語言的自動翻譯:
57
-
58
- | 語言 | 代碼 |
59
- |---|---|
60
- | 英文 | en |
61
- | 簡體中文 | zh-CN |
62
- | 繁體中文 | zh-TW |
63
- | 日文 | ja |
64
- | 韓文 | ko |
65
- | 西班牙文 | es |
66
- | 法文 | fr |
67
- | 德文 | de |
68
- | 葡萄牙文 | pt-BR |
69
- | 俄文 | ru |
70
- | 義大利文 | it |
71
- | 阿拉伯文 | ar |
58
+ DocSmith 支援以下 12 種語言的自動翻譯:
59
+
60
+ | 語言 | 代碼 |
61
+ | -------------------- | ------- |
62
+ | 英文 | `en` |
63
+ | 簡體中文 | `zh-CN` |
64
+ | 繁體中文 | `zh-TW` |
65
+ | 日文 | `ja` |
66
+ | 韓文 | `ko` |
67
+ | 西班牙文 | `es` |
68
+ | 法文 | `fr` |
69
+ | 德文 | `de` |
70
+ | 葡萄牙文 | `pt-BR` |
71
+ | 俄文 | `ru` |
72
+ | 義大利文 | `it` |
73
+ | 阿拉伯文 | `ar` |
72
74
 
73
75
  ---
74
76
 
75
- 文件翻譯完成後,您就可以與世界分享了。
77
+ 文件翻譯完成後,您就可以與全世界分享了。
76
78
 
77
79
  <x-card data-title="下一步:發佈您的文件" data-icon="lucide:upload-cloud" data-href="/features/publish-your-docs" data-cta="閱讀更多">
78
80
  關於如何將您的文件發佈到公共平台或您自己的私人網站的指南。
@@ -1,10 +1,10 @@
1
1
  # 翻译文档
2
2
 
3
- AIGNE DocSmith 可以将您的文档翻译成 12 种不同的语言,使您的项目能够覆盖全球受众。该工具提供两种管理翻译的方式:用于引导式设置的交互模式和用于精确控制和自动化的命令行参数。
3
+ AIGNE DocSmith 可以将您的文档翻译成 12 种不同的语言,包括英语、中文和西班牙语,让您的项目能够触及全球受众。该工具提供两种管理翻译的方式:用于引导式设置的交互模式和用于精确控制与自动化的命令行参数。
4
4
 
5
5
  ## 交互式翻译
6
6
 
7
- 如需引导式体验,请运行不带任何参数的 `translate` 命令。这对于喜欢逐步操作的用户来说是理想的选择。
7
+ 如需引导式体验,请直接运行 `translate` 命令,无需任何参数。这非常适合偏好分步操作的用户。
8
8
 
9
9
  ```bash
10
10
  aigne doc translate
@@ -12,26 +12,28 @@ aigne doc translate
12
12
 
13
13
  此命令会启动一个交互式向导,引导您完成整个过程:
14
14
 
15
- 1. **选择要翻译的文档:** 您将看到一个现有文档的列表。使用空格键选择您想要翻译的文档。
15
+ 1. **选择要翻译的文档:** 系统将显示您现有文档的列表。使用空格键选择您想要翻译的文档。
16
16
 
17
17
  ![选择要翻译的文档](https://docsmith.aigne.io/image-bin/uploads/e2cf5fa45aa856c406a444fb4665ed2d.png)
18
18
 
19
- 2. **选择目标语言:** 选择文档后,从支持的选项列表中选择一种或多种目标语言。
19
+ 2. **选择目标语言:** 选择文档后,从支持的语言列表中选择一个或多个目标语言。
20
20
 
21
- ![选择要翻译成的语言](https://docsmith.aigne.io/image-bin/uploads/2e243a2488f2060a693fe0ac0c8fb5ad.png)
21
+ ![选择翻译的目标语言](https://docsmith.aigne.io/image-bin/uploads/2e243a2488f2060a693fe0ac0c8fb5ad.png)
22
22
 
23
23
  3. **确认并运行:** DocSmith 随后将处理翻译,为每个选定的语言生成所选文件的新版本。
24
24
 
25
25
  ## 命令行翻译
26
26
 
27
- 对于脚本或 CI/CD 管道中的自动化,请使用命令行标志来控制翻译过程。此方法适合开发人员和高级用户。
27
+ 对于脚本或 CI/CD 管道中的自动化,可使用命令行标志来控制翻译过程。此方法适合开发人员和高级用户。
28
28
 
29
29
  ### 命令参数
30
30
 
31
- <x-field data-name="--langs" data-type="string" data-required="false" data-desc="指定一个目标语言。此标志可以多次使用以包含多种语言(例如,--langs zh --langs ja)。"></x-field>
32
- <x-field data-name="--docs" data-type="string" data-required="false" data-desc="指定要翻译的文档的路径。此标志也可以多次使用以进行批量翻译。"></x-field>
33
- <x-field data-name="--feedback" data-type="string" data-required="false" data-desc="向 AI 提供建议以指导翻译质量(例如,--feedback &quot;使用正式语气&quot;)。"></x-field>
34
- <x-field data-name="--glossary" data-type="string" data-required="false" data-desc="使用 Markdown 格式的术语表文件,以确保特定术语的一致性(例如,--glossary @path/to/glossary.md)。"></x-field>
31
+ <x-field-group>
32
+ <x-field data-name="--langs" data-type="string" data-required="false" data-desc="指定一个目标语言。此标志可多次使用以包含多种语言(例如,--langs zh --langs ja)。"></x-field>
33
+ <x-field data-name="--docs" data-type="string" data-required="false" data-desc="指定要翻译的文档路径。此标志也可多次使用以进行批量翻译。"></x-field>
34
+ <x-field data-name="--feedback" data-type="string" data-required="false" data-desc=" AI 提供建议以指导翻译质量(例如,--feedback &quot;使用正式语气&quot;)。"></x-field>
35
+ <x-field data-name="--glossary" data-type="string" data-required="false" data-desc="使用 Markdown 格式的术语表文件,以确保特定术语的一致性(例如,--glossary @path/to/glossary.md)。"></x-field>
36
+ </x-field-group>
35
37
 
36
38
  ### 示例
37
39
 
@@ -45,35 +47,35 @@ aigne doc translate --langs zh --langs ja --docs overview.md --docs examples.md
45
47
 
46
48
  #### 使用术语表和反馈
47
49
 
48
- 为确保品牌名称和技术术语翻译正确,您可以提供一个术语表文件。您还可以提供反馈以优化翻译风格。
50
+ 为确保品牌名称和技术术语翻译正确,您可以提供一个术语表文件。您还可以提供反馈来优化翻译风格。
49
51
 
50
52
  ```bash
51
- aigne doc translate --glossary @glossary.md --feedback "Use technical terminology consistently" --docs overview.md --langs de
53
+ aigne doc translate --glossary @path/to/glossary.md --feedback "Use technical terminology consistently" --docs overview.md --langs de
52
54
  ```
53
55
 
54
56
  ## 支持的语言
55
57
 
56
- DocSmith 支持以下语言的自动翻译:
58
+ DocSmith 支持以下 12 种语言的自动翻译:
57
59
 
58
60
  | 语言 | 代码 |
59
- |---|---|
60
- | 英语 | en |
61
- | 简体中文 | zh-CN |
62
- | 繁体中文 | zh-TW |
63
- | 日语 | ja |
64
- | 韩语 | ko |
65
- | 西班牙语 | es |
66
- | 法语 | fr |
67
- | 德语 | de |
68
- | 葡萄牙语 | pt-BR |
69
- | 俄语 | ru |
70
- | 意大利语 | it |
71
- | 阿拉伯语 | ar |
61
+ | -------------------- | ------- |
62
+ | 英语 | `en` |
63
+ | 简体中文 | `zh-CN` |
64
+ | 繁体中文 | `zh-TW` |
65
+ | 日语 | `ja` |
66
+ | 韩语 | `ko` |
67
+ | 西班牙语 | `es` |
68
+ | 法语 | `fr` |
69
+ | 德语 | `de` |
70
+ | 葡萄牙语 | `pt-BR` |
71
+ | 俄语 | `ru` |
72
+ | 意大利语 | `it` |
73
+ | 阿拉伯语 | `ar` |
72
74
 
73
75
  ---
74
76
 
75
77
  文档翻译完成后,您就可以与世界分享了。
76
78
 
77
79
  <x-card data-title="下一步:发布您的文档" data-icon="lucide:upload-cloud" data-href="/features/publish-your-docs" data-cta="阅读更多">
78
- 关于如何将您的文档发布到公共平台或您自己的私人网站的指南。
80
+ 关于如何将您的文档发布到公共平台或您自己的私有网站的指南。
79
81
  </x-card>