各ガイドでは、Lingo.devでローカライゼーションエンジンを設定するところから、本番環境に翻訳済みコンテンツを反映するところまで、特定のローカライゼーションシナリオを一通り解説します。すべてのガイドは、組織と少なくとも1つの設定済みローカライゼーションエンジンがあることを前提としています。
ガイドの進め方#
プロダクトごとに、ローカライゼーションが必要になる対象は異なります。Webアプリには翻訳されたUI文字列が必要です。APIにはローカライズされたレスポンスが必要です。ドキュメントサイトには翻訳済みのMarkdownファイルが必要です。どの対象も同じローカライゼーションエンジンにつながりますが、連携方法はそれぞれ異なります。
これらのガイドでは、7つの連携パターンを取り上げます。
| 対象 | ローカライズ対象 | 連携方法 |
|---|---|---|
| 翻訳API | キーと値のデータ、動的コンテンツ | HTTP API呼び出し |
| Webアプリ | UI文字列、コンポーネント内テキスト | CLI + フレームワーク連携 |
| モバイルアプリ | iOS .strings、Android .xml | CLI + モバイル向けビルドパイプライン |
| iOSアプリ | Xcode String Catalogs .xcstrings | CLI + GitHub Actions |
| Androidアプリ | Android strings.xml | CLI + GitHub Actions |
| Markdoc対応Next.js | MarkdocページとJSONのUI文字列 | CLI + GitHub Actions |
| i18n対応Rails | Rails config/locales YAML | CLI + GitHub Actions |
| メール | トランザクションメールとマーケティングテンプレート | テンプレート形式に応じてAPIまたはCLI |
| 静的コンテンツ | Markdown、JSON、YAMLファイル | ファイルベース翻訳対応CLI |
| CI/CDワークフロー | 上記すべてを自動化 | GitHub Actions、GitLab CI、Bitbucket Pipelines |
前提条件
すべてのガイドで、APIキーと設定済みのローカライゼーションエンジンが必要です。まだ準備ができていない場合は、まずドキュメントをご覧ください。
ガイドを選ぶ#
翻訳API
キーと値のデータをローカライゼーションAPIに送信し、翻訳結果をプログラムから受け取れます
Webアプリ
CLIを使ってReact、Next.js、その他のWebフレームワークをローカライズ
モバイルアプリ
ロケールごとのモデル選択で、iOSとAndroidアプリをローカライズ
String Catalogs対応iOS
CLIとGitHub Actionsで実現する、Xcode .xcstringsのエンドツーエンドローカライゼーション
strings.xml対応Android
CLIとGitHub Actionsで実現する、Android XMLのエンドツーエンドローカライゼーション
i18n対応Rails
CLIとGitHub Actionsで実現する、Rails config/locales YAMLのエンドツーエンドローカライゼーション
メール
ブランドボイスを反映して、トランザクションメールとマーケティングメールのテンプレートを翻訳
静的コンテンツ
リポジトリ内のMarkdown、JSON、その他の静的ファイルを翻訳
CI/CDワークフロー
GitHub Actions、GitLab CI、Bitbucketを使って、プッシュのたびにローカライゼーションを自動化
MCPを使ったエンジン設定
Lingo.dev MCPサーバー経由でAIコーディングアシスタントを使い、ローカライゼーションエンジンを設定
Jiraトリアージ
AIを活用した提案で、ローカライゼーションとの関連性に応じてJiraチケットを自動でトリアージ
