@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.
- package/.aigne/doc-smith/config.yaml +2 -4
- package/.release-please-manifest.json +1 -1
- package/CHANGELOG.md +17 -2
- package/README.md +1 -1
- package/agents/clear/choose-contents.mjs +2 -2
- package/agents/clear/clear-document-structure.mjs +8 -8
- package/agents/clear/index.yaml +1 -1
- package/agents/evaluate/document-structure.yaml +1 -1
- package/agents/generate/check-d2-diagram-valid.mjs +26 -0
- package/agents/generate/check-document-structure.yaml +3 -3
- package/agents/generate/check-need-generate-structure.mjs +8 -8
- package/agents/generate/document-structure-tools/add-document.mjs +3 -3
- package/agents/generate/document-structure-tools/delete-document.mjs +2 -2
- package/agents/generate/document-structure-tools/move-document.mjs +3 -2
- package/agents/generate/document-structure-tools/update-document.mjs +2 -2
- package/agents/generate/generate-d2-diagram.yaml +23 -0
- package/agents/generate/generate-structure.yaml +1 -1
- package/agents/generate/merge-d2-diagram.yaml +39 -0
- package/agents/generate/update-document-structure.yaml +3 -3
- package/agents/generate/user-review-document-structure.mjs +10 -10
- package/agents/init/index.mjs +18 -10
- package/agents/publish/publish-docs.mjs +17 -20
- package/agents/update/batch-generate-document.yaml +1 -1
- package/agents/update/check-document.mjs +2 -2
- package/agents/update/generate-document.yaml +25 -0
- package/agents/utils/check-feedback-refiner.mjs +1 -1
- package/agents/utils/choose-docs.mjs +1 -1
- package/agents/utils/load-document-all-content.mjs +3 -3
- package/agents/utils/load-sources.mjs +1 -1
- package/agents/utils/save-docs.mjs +7 -28
- package/aigne.yaml +2 -2
- package/docs/_sidebar.md +1 -1
- package/docs/advanced-how-it-works.md +3 -3
- package/docs/advanced-quality-assurance.md +1 -1
- package/docs/cli-reference.ja.md +151 -80
- package/docs/cli-reference.md +126 -55
- package/docs/cli-reference.zh-TW.md +133 -62
- package/docs/cli-reference.zh.md +143 -72
- package/docs/configuration-interactive-setup.md +1 -1
- package/docs/configuration-language-support.md +1 -1
- package/docs/configuration-preferences.md +1 -1
- package/docs/configuration.ja.md +104 -48
- package/docs/configuration.md +58 -2
- package/docs/configuration.zh-TW.md +99 -42
- package/docs/configuration.zh.md +78 -21
- package/docs/features-generate-documentation.ja.md +63 -44
- package/docs/features-generate-documentation.md +54 -35
- package/docs/features-generate-documentation.zh-TW.md +67 -48
- package/docs/features-generate-documentation.zh.md +61 -41
- package/docs/features-publish-your-docs.ja.md +69 -46
- package/docs/features-publish-your-docs.md +65 -42
- package/docs/features-publish-your-docs.zh-TW.md +73 -50
- package/docs/features-publish-your-docs.zh.md +67 -44
- package/docs/features-translate-documentation.ja.md +35 -33
- package/docs/features-translate-documentation.md +24 -22
- package/docs/features-translate-documentation.zh-TW.md +32 -30
- package/docs/features-translate-documentation.zh.md +29 -27
- package/docs/features-update-and-refine.ja.md +120 -66
- package/docs/features-update-and-refine.md +110 -56
- package/docs/features-update-and-refine.zh-TW.md +116 -62
- package/docs/features-update-and-refine.zh.md +118 -64
- package/docs/getting-started.ja.md +22 -22
- package/docs/getting-started.md +1 -1
- package/docs/getting-started.zh-TW.md +16 -16
- package/docs/getting-started.zh.md +28 -28
- package/docs/overview.md +3 -3
- package/docs-mcp/analyze-docs-relevance.yaml +6 -6
- package/docs-mcp/docs-search.yaml +1 -1
- package/package.json +3 -3
- package/prompts/common/document-structure/conflict-resolution-guidance.md +3 -3
- package/prompts/common/document-structure/document-structure-rules.md +2 -2
- package/prompts/detail/{d2-chart/rules.md → d2-diagram/rules-system.md} +41 -5
- package/prompts/detail/d2-diagram/rules-user.md +4 -0
- package/prompts/detail/document-rules.md +3 -4
- package/prompts/detail/generate-document.md +8 -2
- package/prompts/detail/update-document.md +0 -2
- package/prompts/evaluate/document-structure.md +6 -6
- package/prompts/structure/check-document-structure.md +10 -10
- package/prompts/structure/document-rules.md +2 -2
- package/prompts/structure/generate-structure-system.md +3 -3
- package/prompts/structure/structure-example.md +1 -1
- package/prompts/structure/structure-getting-started.md +1 -1
- package/prompts/structure/update-document-structure.md +9 -9
- package/prompts/utils/feedback-refiner.md +1 -1
- package/tests/agents/clear/choose-contents.test.mjs +1 -1
- package/tests/agents/clear/clear-document-structure.test.mjs +36 -30
- package/tests/agents/evaluate/generate-report.test.mjs +1 -1
- package/tests/agents/generate/check-need-generate-structure.test.mjs +1 -1
- package/tests/agents/generate/document-structure-tools/add-document.test.mjs +2 -2
- package/tests/agents/generate/document-structure-tools/delete-document.test.mjs +4 -4
- package/tests/agents/generate/document-structure-tools/move-document.test.mjs +3 -3
- package/tests/agents/generate/document-structure-tools/update-document.test.mjs +3 -3
- package/tests/agents/generate/user-review-document-structure.test.mjs +7 -5
- package/tests/agents/init/init.test.mjs +25 -19
- package/tests/agents/publish/publish-docs.test.mjs +99 -0
- package/tests/agents/update/check-document.test.mjs +1 -1
- package/tests/agents/utils/check-detail-result.test.mjs +2 -15
- package/tests/agents/utils/format-document-structure.test.mjs +5 -5
- package/tests/agents/utils/load-sources.test.mjs +4 -4
- package/tests/agents/utils/save-docs.test.mjs +1 -1
- package/tests/utils/auth-utils.test.mjs +1 -1
- package/tests/utils/conflict-detector.test.mjs +1 -1
- package/tests/utils/d2-utils.test.mjs +4 -4
- package/tests/utils/deploy.test.mjs +3 -10
- package/tests/utils/docs-finder-utils.test.mjs +8 -8
- package/tests/utils/kroki-utils.test.mjs +5 -5
- package/tests/utils/preferences-utils.test.mjs +5 -3
- package/tests/utils/save-value-to-config.test.mjs +3 -1
- package/types/document-structure-schema.mjs +9 -9
- package/utils/auth-utils.mjs +4 -0
- package/utils/conflict-detector.mjs +1 -1
- package/utils/constants/index.mjs +7 -4
- package/utils/d2-utils.mjs +11 -6
- package/utils/deploy.mjs +4 -20
- package/utils/docs-finder-utils.mjs +11 -11
- package/utils/kroki-utils.mjs +5 -4
- package/utils/markdown-checker.mjs +1 -21
- /package/prompts/detail/{d2-chart → d2-diagram}/official-examples.md +0 -0
|
@@ -1,10 +1,10 @@
|
|
|
1
1
|
# ドキュメントの翻訳
|
|
2
2
|
|
|
3
|
-
AIGNE DocSmith
|
|
3
|
+
AIGNE DocSmithは、ドキュメントを英語、中国語、スペイン語など12の異なる言語に翻訳し、プロジェクトを世界中のオーディエンスに届けることができます。このツールは、ガイド付きセットアップのためのインタラクティブモードと、正確な制御と自動化のためのコマンドライン引数の2つの翻訳管理方法を提供します。
|
|
4
4
|
|
|
5
|
-
##
|
|
5
|
+
## インタラクティブ翻訳
|
|
6
6
|
|
|
7
|
-
|
|
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
|

|
|
18
18
|
|
|
19
|
-
2.
|
|
19
|
+
2. **ターゲット言語を選択:** ドキュメントを選択した後、サポートされているオプションのリストから1つ以上のターゲット言語を選びます。
|
|
20
20
|
|
|
21
21
|

|
|
22
22
|
|
|
23
|
-
3.
|
|
23
|
+
3. **確認して実行:** DocSmithは翻訳を処理し、選択した各言語に対して選択したファイルの新しいバージョンを生成します。
|
|
24
24
|
|
|
25
|
-
##
|
|
25
|
+
## コマンドライン翻訳
|
|
26
26
|
|
|
27
27
|
スクリプトやCI/CDパイプラインでの自動化には、コマンドラインフラグを使用して翻訳プロセスを制御します。この方法は、開発者や上級ユーザーに適しています。
|
|
28
28
|
|
|
29
29
|
### コマンドパラメータ
|
|
30
30
|
|
|
31
|
-
<x-field
|
|
32
|
-
<x-field data-name="--
|
|
33
|
-
<x-field data-name="--
|
|
34
|
-
<x-field data-name="--
|
|
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 "フォーマルなトーンを使用する")。"></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
|
-
|
|
|
59
|
-
|
|
60
|
-
| 英語
|
|
61
|
-
| 簡体字中国語
|
|
62
|
-
| 繁体字中国語
|
|
63
|
-
| 日本語
|
|
64
|
-
| 韓国語
|
|
65
|
-
| スペイン語
|
|
66
|
-
| フランス語
|
|
67
|
-
| ドイツ語
|
|
68
|
-
| ポルトガル語
|
|
69
|
-
| ロシア語
|
|
70
|
-
| イタリア語
|
|
71
|
-
| アラビア語
|
|
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="
|
|
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
|
|
32
|
-
<x-field data-name="--
|
|
33
|
-
<x-field data-name="--
|
|
34
|
-
<x-field data-name="--
|
|
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 "Use a formal tone")."></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
|
|
59
|
-
|
|
60
|
-
| English
|
|
61
|
-
| Simplified Chinese
|
|
62
|
-
| Traditional Chinese
|
|
63
|
-
| Japanese
|
|
64
|
-
| Korean
|
|
65
|
-
| Spanish
|
|
66
|
-
| French
|
|
67
|
-
| German
|
|
68
|
-
| Portuguese
|
|
69
|
-
| Russian
|
|
70
|
-
| Italian
|
|
71
|
-
| Arabic
|
|
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
|
-
|
|
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
|

|
|
18
18
|
|
|
@@ -20,24 +20,26 @@ aigne doc translate
|
|
|
20
20
|
|
|
21
21
|

|
|
22
22
|
|
|
23
|
-
3. **確認並執行:**
|
|
23
|
+
3. **確認並執行:** DocSmith 接著會處理翻譯,為您選擇的每種語言生成所選文件的新版本。
|
|
24
24
|
|
|
25
25
|
## 命令列翻譯
|
|
26
26
|
|
|
27
|
-
|
|
27
|
+
對於腳本或 CI/CD 管線中的自動化,請使用命令列旗標來控制翻譯流程。此方法適合開發人員和進階使用者。
|
|
28
28
|
|
|
29
|
-
###
|
|
29
|
+
### 命令參數
|
|
30
30
|
|
|
31
|
-
<x-field
|
|
32
|
-
<x-field data-name="--
|
|
33
|
-
<x-field data-name="--
|
|
34
|
-
<x-field data-name="--
|
|
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 "使用正式語氣")。"></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
|
-
|
|
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
|
-
| 英文
|
|
61
|
-
| 簡體中文
|
|
62
|
-
| 繁體中文
|
|
63
|
-
| 日文
|
|
64
|
-
| 韓文
|
|
65
|
-
| 西班牙文
|
|
66
|
-
| 法文
|
|
67
|
-
| 德文
|
|
68
|
-
| 葡萄牙文
|
|
69
|
-
| 俄文
|
|
70
|
-
| 義大利文
|
|
71
|
-
| 阿拉伯文
|
|
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
|
-
|
|
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
|

|
|
18
18
|
|
|
19
|
-
2. **选择目标语言:**
|
|
19
|
+
2. **选择目标语言:** 选择文档后,从支持的语言列表中选择一个或多个目标语言。
|
|
20
20
|
|
|
21
|
-

|
|
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
|
|
32
|
-
<x-field data-name="--
|
|
33
|
-
<x-field data-name="--
|
|
34
|
-
<x-field data-name="--
|
|
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 "使用正式语气")。"></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>
|