跳到正文
跳到正文

文档 / 入门

机器翻译页面

本页面为自动翻译,可能有错误或表述不够自然。内容以英文版本为准。阅读英文原文。

选择技术栈

找到你的框架,复制配置 verbatra 所需的格式 id 和 init 命令,并查看常见的语言文件布局。

在下方找到你的框架,用它的 init 命令代替快速上手中的那一条。每种文件布局都是 init 在找不到语言文件时写入的路径模式;文件已经存在时,init 会检测它们的位置,也可以用 --path 自行设置路径模式。每种格式的完整行为见格式。部分技术栈还有分步的快速上手,链接放在它们各自小节的末尾。

React 搭配 i18next

适用于 i18next、react-i18next 和 next-i18next 项目。

  • 格式:i18next-json
  • 文件:locales/{locale}.json
npx @verbatra/cli init --format i18next-json --provider gemini --yes

详情:四种 JSON 格式。

分步指引:React 快速上手。

Next.js 搭配 next-intl

适用于 next-intl 的消息文件,其值是 ICU 消息。

  • 格式:next-intl-json
  • 文件:messages/{locale}.json
npx @verbatra/cli init --format next-intl-json --provider gemini --yes

详情:四种 JSON 格式。

分步指引:Next.js 快速上手。

Vue 和 Nuxt 搭配 vue-i18n

适用于 vue-i18n(包括 Nuxt I18n),使用单花括号占位符和竖线分隔的复数。

  • 格式:vue-i18n-json
  • 文件:src/locales/{locale}.json
npx @verbatra/cli init --format vue-i18n-json --provider gemini --yes

详情:四种 JSON 格式。

分步指引:Vue 快速上手。

Angular 搭配 ngx-translate

适用于 ngx-translate 的 JSON,扁平或嵌套均可。

  • 格式:ngx-translate-json
  • 文件:src/assets/i18n/{locale}.json
npx @verbatra/cli init --format ngx-translate-json --provider gemini --yes

详情:四种 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",所以该占位符对源语言环境展开为 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

有两种格式,取决于你的项目如何存放字符串。对于带有 .stringsdict 复数的 .strings 文件:

  • 格式:apple-strings
  • 文件:{locale}.lproj/Localizable.strings
npx @verbatra/cli init --format apple-strings --provider gemini --yes

对于 Xcode String Catalog,即一个包含所有语言环境的文件。先在 Xcode 中创建该 String Catalog:verbatra 会写入其中,但从不创建它。

  • 格式:apple-xcstrings
  • 文件:{locale}Localizable.xcstrings

路径模式需要 {locale} 占位符,但对 String Catalog 它展开为空:所有语言环境都读写同一个文件 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

适用于嵌套的 YAML 语言文件,使用 i18next 风格的 {{double-brace}} 占位符。

  • 格式: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] 标题。

  • 格式:ini
  • 文件:locales/{locale}.ini
npx @verbatra/cli init --format ini --provider gemini --yes

详情:INI。

其他格式

verbatra 未内置的格式,仍然可以通过你自己编写的适配器来翻译。见编写自定义格式适配器。

在 GitHub 上编辑

本页内容