仕組み - Lingo.dev CLI

Lingo.dev CLIは、複雑なローカライゼーション処理ワークフローをエレガントなコマンドラインインターフェースの背後にカプセル化します。

npx lingo.dev@latest runを実行すると、CLIは標準のi18n.json設定ファイルを読み込み、以下の5つのステップを実行します。

1. コンテンツの検出

Lingo.dev CLIは、プロジェクトを信頼できる情報源として扱います。バケット設定に基づいて、翻訳のソースファイルとターゲットファイルをプロジェクト内で再帰的にスキャンし、処理のためにメモリに読み込みます。

検出フェーズでは以下を考慮します：

すべてのコンテンツが翻訳を必要とするわけではありません。本番アプリケーションには、数値、ブール値、日付、UUID、コードスニペットなど、通常は言語間で変更されないものが含まれています。

Lingo.dev CLIは以下を賢くフィルタリングします：

このフィルタリングにより、翻訳可能なコンテンツのみに焦点を当てることで、LLM推論コストを削減し、処理速度を向上させます。

変更されていないコンテンツは再翻訳すべきではありません。Lingo.dev CLIは、以下を行う高度なバージョン管理システムを実装しています：

この増分アプローチにより、実行ごとにコンテンツライブラリ全体ではなく、新規または変更されたものに対してのみ料金を支払うことになります。

ローカライゼーションは、不安定なインターネット接続やLLMプロバイダーの障害があっても信頼できるものでなければなりません。このステップで、Lingo.dev CLIは差分を取得し、設定された翻訳バックエンドに送信します。

CLIは以下を実装しています：

各翻訳リクエストには、プロジェクト全体で一貫性と品質を確保するためのコンテキスト情報が含まれています。

クリーンでレビュー可能な変更セットを維持するため、Lingo.dev CLIはソースコンテンツが存在する正確な位置に翻訳を注入します。このアプローチは以下を実現します：

その結果、手作業で作成されたかのようなローカライズファイルが生成され、コードレビューとデプロイの準備が整います。

これら5つのステップは通常、2種類の変更を生成します：

両方ともリポジトリにコミットする必要があります。手動またはCI/CD統合を通じて自動的に行うことができます。

このアーキテクチャにより、Lingo.dev CLIは、数個の文字列を翻訳する単一の開発者から、数十の言語にわたって数百万語を管理するチームまで、効率的にスケールすることが保証されます。

Lingo.dev CLIの内部動作を理解したので、次のことができます：

コミュニティに参加する：Discord — Lingo.dev CLIを使用している他の開発者とつながり、フィードバックを共有し、ローカライゼーションの課題についてサポートを受けることができます。
プロジェクトに貢献する：Open issues — Lingo.dev CLIはオープンソースであり、貢献を歓迎しています。オープンイシューを閲覧し、機能を提案し、またはプルリクエストを送信して、すべての人のためにツールを改善するのを手伝ってください。

さあ、始めましょう！最初のプロジェクトを設定するには、npx lingo.dev@latest init を実行してください。