仕組み

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

npx lingo.dev@latest i18nを実行すると、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を使用している他の開発者とつながり、フィードバックを共有し、ローカリゼーションの課題に関するヘルプを得る
プロジェクトに貢献する：課題を開く — Lingo.dev CLIはオープンソースであり、貢献を歓迎しています。オープンな課題を閲覧し、機能を提案したり、プルリクエストを提出して、すべての人のためにツールの改善を支援したりできます。