自動翻訳

General Translation の CLI(コマンドラインインターフェイス)ツールを使ってプロジェクトを自動翻訳する方法

npx gtx-cli@latest

概要

General Translation の CLI ツール(gtx-cli)を使用すると、プロジェクトを任意の対応言語に自動翻訳できます。

このツールは、プロジェクトでの gt-nextgt-react を強力にサポートし、翻訳対象コンテンツのスキャン、プロジェクトの翻訳、翻訳データの JSON ファイル生成を行えます。

CLI ツールは、next-intli18next といったサードパーティの i18n ライブラリ向けに翻訳を生成することもできます。

さらに、CLI ツールは JSON、Markdown、MDX、JS、TS ファイルの翻訳にも使用できます。

translate コマンドの実行には本番用の APIキー が必要です。無料で generaltranslation.com から取得できます。


把握しておくべき主要なコマンドは 2 つあります: inittranslate です。

  • init コマンドは、プロジェクトのセットアップに使用します。国際化のための設定を行うステップバイステップの ウィザードを提供し、次を含みます:
  • プラグインと React プロバイダのセットアップ
    • API Keys の生成
    • プロジェクトの対応ロケールとファイル構成の設定
  • translate コマンドは、CI/CD パイプラインに追加して使用することを想定しています。 プロジェクト内の翻訳対象コンテンツをスキャンします。 その後、コンテンツは CDN(コンテンツ配信ネットワーク)にアップロードされるか、実行時に使用できるようアプリのバンドルに追加されます。

はじめに

プロジェクトで使用している i18n ライブラリに合わせて、以下のいずれかのチュートリアルに従ってください。

使い方

コマンド説明
npx gtx-cli initGT のセットアップウィザードを実行します。
npx gtx-cli configureプロジェクトの GT 設定を行います。
npx gtx-cli translateGT の API を介してプロジェクトを翻訳します。
npx gtx-cli authプロジェクト用の APIキー とプロジェクト ID を発行します。
npx gtx-cli generate新しい翻訳データ用の JSON ファイルを生成します。ライブラリを単体で使用する場合に実行します。

このガイドはいかがですか?

このページについて