ドキュメント / スタートガイド
機械翻訳されたページ
技術スタックを選ぶ
使っているフレームワークを見つけて、verbatra を設定するフォーマット ID と init コマンドをコピーします。ロケールファイルの一般的な配置も載せています。
以下から使っているフレームワークを見つけ、クイックスタートのコマンドの代わりに、そのフレームワークの init コマンドを使います。各ファイルの配置は、ロケールファイルが見つからないときに init が書き込むパターンです。ファイルがすでにある場合は、init が場所を検出します。パターンを自分で指定するには --path を使います。各フォーマットの動作の詳細はフォーマットにあります。一部の技術スタックには、手順ごとのクイックスタートもあります。そのリンクは、各セクションの末尾にあります。
i18next を使う React
i18next、react-i18next、next-i18next のプロジェクト向けです。
- フォーマット:
i18next-json - ファイル:
locales/{locale}.json
npx @verbatra/cli init --format i18next-json --provider gemini --yes詳細:4 つの JSON フォーマット。
手順ごとの説明:React クイックスタート。
next-intl を使う Next.js
next-intl のメッセージファイル向けです。値は ICU メッセージです。
- フォーマット:
next-intl-json - ファイル:
messages/{locale}.json
npx @verbatra/cli init --format next-intl-json --provider gemini --yes詳細:4 つの JSON フォーマット。
手順ごとの説明:Next.js クイックスタート。
vue-i18n を使う Vue と Nuxt
Nuxt I18n を含む vue-i18n 向けです。プレースホルダーは波括弧 1 つ、複数形はパイプで区切ります。
- フォーマット:
vue-i18n-json - ファイル:
src/locales/{locale}.json
npx @verbatra/cli init --format vue-i18n-json --provider gemini --yes詳細:4 つの JSON フォーマット。
手順ごとの説明:Vue クイックスタート。
ngx-translate を使う Angular
ngx-translate の JSON 向けです。フラットでも入れ子でも使えます。
- フォーマット:
ngx-translate-json - ファイル:
src/assets/i18n/{locale}.json
npx @verbatra/cli init --format ngx-translate-json --provider gemini --yes詳細:4 つの JSON フォーマット。
手順ごとの説明:Angular クイックスタート。
Flutter
Flutter の Application Resource Bundle 向けです。init は localeStyle: "posix" も設定します。そのため pt-BR は app_ と書かれ、flutter gen-l10n はこの名前を読みます。
- フォーマット:
arb - ファイル:
lib/l10n/app_{locale}.arb
npx @verbatra/cli init --format arb --provider gemini --yes詳細:ARB。
手順ごとの説明:Flutter クイックスタート。
Android
strings.xml リソース向けです。init は localeStyle: "android" も設定します。そのためプレースホルダー {locale} は、ソースでは values、ドイツ語では values-de に展開されます。
- フォーマット:
android-xml - ファイル:
app/src/main/res/{locale}/strings.xml
npx @verbatra/cli init --format android-xml --provider gemini --yesiOS と macOS
プロジェクトが文字列をどう保存しているかに応じて、2 つのフォーマットがあります。.strings ファイルと、その .stringsdict の複数形を使う場合は次のとおりです。
- フォーマット:
apple-strings - ファイル:
{locale}.lproj/Localizable.strings
npx @verbatra/cli init --format apple-strings --provider gemini --yesXcode の String Catalog を使う場合、カタログはすべてのロケールを 1 つのファイルに含みます。先に Xcode でカタログを作成してください。verbatra はカタログに書き込みますが、作成はしません。
- フォーマット:
apple-xcstrings - ファイル:
{locale}Localizable.xcstrings
パターンには {locale} プレースホルダーが必要ですが、String Catalog では空文字列に展開されます。すべてのロケールが、1 つのファイル Localizable.xcstrings を読み書きします。
npx @verbatra/cli init --format apple-xcstrings --provider gemini --yes詳細:Apple .strings と Xcode String Catalogs。
gettext
.po カタログと、その .pot テンプレート向けです。Python、PHP、C のプロジェクトで使われます。init は localeStyle: "posix" も設定します。そのため pt-BR は pt_ と書かれます。
- フォーマット:
gettext-po - ファイル:
locales/{locale}/LC_MESSAGES/messages.po
npx @verbatra/cli init --format gettext-po --provider gemini --yes詳細:gettext .po/.pot。
Java と Spring
.properties のメッセージバンドル向けです。init は localeStyle: "posix" も設定します。そのため pt-BR は messages_ と書かれます。
- フォーマット:
properties - ファイル:
src/main/resources/messages_{locale}.properties
npx @verbatra/cli init --format properties --provider gemini --yes詳細:Properties。
.NET
.resx リソースファイル向けです。画像、アイコン、デザイナーのエントリには手を加えません。
- フォーマット:
resx - ファイル:
Resources/Strings.{locale}.resx
npx @verbatra/cli init --format resx --provider gemini --yes詳細:.NET .resx。
YAML
i18next と同じ {{double-brace}} プレースホルダーを使う、入れ子の YAML ロケールファイル向けです。
- フォーマット:
yaml - ファイル:
locales/{locale}.yml
npx @verbatra/cli init --format yaml --provider gemini --yes詳細:YAML。
XLIFF
Angular の ng extract-i18n、CAT ツール(翻訳支援ツール)、翻訳会社から受け取る、XLIFF 1.2 と 2.0 のドキュメント向けです。
- フォーマット:
xliff - ファイル:
locales/{locale}.xlf
npx @verbatra/cli init --format xliff --provider gemini --yes詳細:XLIFF。
INI
従来の INI ファイル向けです。[section] ヘッダーは 1 階層に対応します。
- フォーマット:
ini - ファイル:
locales/{locale}.ini
npx @verbatra/cli init --format ini --provider gemini --yes詳細:INI。
その他のフォーマット
verbatra が標準で提供していないフォーマットも、自分で書いたアダプターを通せば翻訳できます。カスタムフォーマットアダプターを書くを参照してください。
GitHub で編集