本文へスキップ
本文へスキップ

ドキュメント / スタートガイド

機械翻訳されたページ

このページは自動翻訳のため、誤りや不自然な表現が含まれている可能性があります。正式な内容は英語版です。英語の原文を読む。

技術スタックを選ぶ

使っているフレームワークを見つけて、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_pt_BR.arb と書かれ、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 --yes

詳細:Android strings.xml。

iOS と macOS

プロジェクトが文字列をどう保存しているかに応じて、2 つのフォーマットがあります。.strings ファイルと、その .stringsdict の複数形を使う場合は次のとおりです。

  • フォーマット:apple-strings
  • ファイル:{locale}.lproj/Localizable.strings
npx @verbatra/cli init --format apple-strings --provider gemini --yes

Xcode の 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_BR と書かれます。

  • フォーマット: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_pt_BR.properties と書かれます。

  • フォーマット: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 で編集

このページの内容