自動翻訳
General Translation の CLI(コマンドラインインターフェイス)ツールを使ってプロジェクトを自動翻訳する方法
npx gtx-cli@latest概要
General Translation の CLI ツール(gtx-cli)を使用すると、プロジェクトを任意の対応言語に自動翻訳できます。
このツールは、プロジェクトでの gt-next と gt-react を強力にサポートし、翻訳対象コンテンツのスキャン、プロジェクトの翻訳、翻訳データの JSON ファイル生成を行えます。
CLI ツールは、next-intl や i18next といったサードパーティの i18n ライブラリ向けに翻訳を生成することもできます。
さらに、CLI ツールは JSON、Markdown、MDX、JS、TS ファイルの翻訳にも使用できます。
translate コマンドの実行には本番用の APIキー が必要です。無料で generaltranslation.com から取得できます。
把握しておくべき主要なコマンドは 2 つあります: init と translate です。
initコマンドは、プロジェクトのセットアップに使用します。国際化のための設定を行うステップバイステップの ウィザードを提供し、次を含みます:
- プラグインと React プロバイダのセットアップ
- API Keys の生成
- プロジェクトの対応ロケールとファイル構成の設定
translateコマンドは、CI/CD パイプラインに追加して使用することを想定しています。 プロジェクト内の翻訳対象コンテンツをスキャンします。 その後、コンテンツは CDN(コンテンツ配信ネットワーク)にアップロードされるか、実行時に使用できるようアプリのバンドルに追加されます。
はじめに
プロジェクトで使用している i18n ライブラリに合わせて、以下のいずれかのチュートリアルに従ってください。
使い方
| コマンド | 説明 |
|---|---|
npx gtx-cli init | GT のセットアップウィザードを実行します。 |
npx gtx-cli configure | プロジェクトの GT 設定を行います。 |
npx gtx-cli translate | GT の API を介してプロジェクトを翻訳します。 |
npx gtx-cli auth | プロジェクト用の APIキー とプロジェクト ID を発行します。 |
npx gtx-cli generate | 新しい翻訳データ用の JSON ファイルを生成します。ライブラリを単体で使用する場合に実行します。 |
このガイドはいかがですか?