文档 / 入门
机器翻译页面
选择技术栈
找到你的框架,复制配置 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_,这正是 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 --yesiOS 和 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_。
- 格式:
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
适用于嵌套的 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 上编辑