ローカライゼーションガイド

各ガイドでは、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