ドキュメントを多言語で利用できるようにすることは、グローバルなオーディエンスにリーチするために不可欠です。このガイドでは、aigne doc localize コマンドを使用してコンテンツをサポートされている12言語のいずれかにローカライズするためのステップバイステップのプロセスを提供し、世界中のユーザーがドキュメントにアクセスし、簡単に理解できるようにします。
翻訳プロセスの概要
ドキュメントを翻訳するための主要なコマンドは aigne doc localize です。このコマンドは、インタラクティブモードまたは非インタラクティブモード（コマンドラインフラグを使用）の2つのモードで実行できます。どちらの方法も直感的になるように設計されており、単一または多言語の翻訳を効率的に管理できます。
インタラクティブモード (ベータ)
ガイド付きのエクスペリエンスを利用するには、引数なしでコマンドを実行します。これは、翻訳機能を初めて使用するユーザーや、ステップバイステップのプロセスを好むユーザーに推奨されるアプローチです。
aigne doc localizeこのコマンドを実行すると、DocSmithはインタラクティブセッションを開始します：
- まず、プロジェクトで利用可能なすべてのドキュメントファイルのリストから、ローカライズしたい特定のドキュメントを選択するように求められます。
- 次に、ターゲット言語を選択するように求められます。システムは12言語をサポートしており、以前に選択した言語はプロセスを効率化するために事前にチェックされています。
ドキュメントを選択した後、利用可能な言語のリストが表示され、そこから選択します。
選択が確定すると、DocSmithは選択した各ドキュメントを各言語に翻訳するプロセスを開始します。
コマンドラインの使用法
自動化、スクリプティング、またはより直接的な制御のためには、コマンドラインで直接引数を指定できます。
aigne doc localize [options]オプション
localize コマンドは、ドキュメント、言語、その他の設定を指定するために以下のオプションを受け付けます。
- --docs
array— 翻訳する1つ以上のドキュメントパスを指定します。このオプションを省略すると、ツールはドキュメント選択のためのインタラクティブモードに入ります。 - --langs
array— ターゲット言語コードのリスト（例：zh、ja、de）。指定しない場合、インタラクティブに言語を選択するように求められます。 - --glossary
string— 用語集ファイルへのパス（例：@/path/to/glossary.md）。このファイルは、すべての翻訳で特定の用語について一貫した用語を維持するのに役立ちます。 - --feedback
string— AIに特定の指示を与えて翻訳スタイルをガイドします（例：「フォーマルなトーンを使用し、技術用語は英語のままにしてください」）。このフィードバックは、将来の参照のためにドキュメントの履歴にも記録されます。 - --diagram
boolean— ドキュメントの内容を翻訳せずに、図の画像のみを翻訳します。ドキュメントの本文を変更せずに、図のテキストラベルを更新する場合にこのオプションを使用します。
例
- 特定のドキュメントを複数の言語に翻訳する:
overview.mdとgetting-started.mdを中国語と日本語に翻訳するには、次のコマンドを使用します：bash aigne doc localize --docs overview.md --docs getting-started.md --langs zh ja - 用語集とスタイルに関するフィードバックを使用して翻訳する:
overview.mdをドイツ語に翻訳し、一貫した用語とフォーマルなトーンを確保するには、--glossaryと--feedbackオプションを含めることができます：bash aigne doc localize --docs overview.md --langs de --feedback "Use a formal tone" --glossary @/path/to/glossary.md
サポートされている言語
DocSmithは、12言語のプロフェッショナルレベルの翻訳を提供します。--langs フラグを使用する際は、以下の表の言語コードを使用してください。
| Language | Code |
|---|---|
| English | en |
| 简体中文 | zh |
| 繁體中文 | zh-TW |
| 日本語 | ja |
| 한국어 | ko |
| Español | es |
| Français | fr |
| Deutsch | de |
| Português | pt |
| Русский | ru |
| Italiano | it |
| العربية | ar |
まとめ
このガイドでは、aigne doc localize コマンドを使用してドキュメントをグローバルなオーディエンスにアクセス可能にする方法について説明しました。ガイド付きのプロセスにはインタラクティブモードを、自動化と精度のためにはコマンドラインオプションを使用できます。
ドキュメントが翻訳されたら、次のステップはそれらを公開することです。このプロセスの詳細な手順については、ドキュメントの公開ガイドを参照してください。