CLIツール

概要

これは、General Translation CLIツールに関するリファレンスドキュメントです。 gtx-cliについての詳細はこちらを参照してください。

ステップバイステップガイドについては、本番環境へのデプロイガイドをチェックしてください。

インストール

npm i gtx-cli --save-dev

CLIツールは何をしますか？

CLIツールは、プロジェクトと翻訳を管理するために使用されます。 知っておくべき主なコマンドは2つあります：translateとsetupです。

• translateコマンドはCDパイプラインに追加することを目的としています。 プロジェクト内の翻訳対象のコンテンツをスキャンするために使用されます。 コンテンツはCDNにアップロードされるか、実行時に使用するためにアプリバンドルに追加されます。
• setupコマンドは、General Translationライブラリをプロジェクトに自動的に統合するために使用されます。 プロジェクトをスキャンし、すべてのJSXコンテンツを<T>コンポーネントでラップします。

翻訳

CLIツールを使用するには、プロジェクトのルートから次のコマンドを実行します：

npx gtx-cli translate

フラグ

CLIツールを初めて実行すると、プロジェクトのルートにgt.config.jsonファイルを作成しようとします。 このファイルには、コンテンツを翻訳するために使用されるプロジェクトに関するメタデータが含まれています。

セットアップ

さらに、CLI ツールはプロジェクトを自動的にスキャンして翻訳のセットアップを行うことができます。 初めて General Translation を使用する場合は、セットアップを実行して開始することをお勧めします。

npx gtx-cli setup

このコマンドを実行すると、翻訳可能なコンテンツを含む JSX 要素の最上位に <T> コンポーネントがラップされます。

また、非静的なコンテンツには <Var> コンポーネントがラップされます。

スキャンが変換する例をいくつか示します：

<div>Hello, World!</div>

<T id="">Hello, World!</T>

CLI は JSX 要素内の直接の子要素のみをラップします。他の JSX 要素はそれぞれ独自の <T> コンポーネントで別々にラップされます。

フラグ