Docs / Primeiros passos
Página traduzida automaticamente
Escolher sua stack
Encontre seu framework e copie o id do formato e o comando init que configuram o verbatra para ele, com o layout usual dos arquivos de locale.
Encontre seu framework abaixo e use o comando init dele no lugar do comando do Início rápido. Cada layout de arquivo é o padrão que o init grava quando não encontra arquivos de locale; quando seus arquivos já existem, o init detecta onde estão, e --path define o padrão manualmente. O comportamento completo de cada formato está em Formatos. Algumas stacks também têm um início rápido passo a passo, com link no fim da seção.
React com i18next
Para projetos com i18next, react-i18next e next-i18next.
- Formato:
i18next-json - Arquivos:
locales/{locale}.json
npx @verbatra/cli init --format i18next-json --provider gemini --yesDetalhes: Os quatro formatos JSON.
Passo a passo: Início rápido com React.
Next.js com next-intl
Para arquivos de mensagens do next-intl, cujos valores são mensagens ICU.
- Formato:
next-intl-json - Arquivos:
messages/{locale}.json
npx @verbatra/cli init --format next-intl-json --provider gemini --yesDetalhes: Os quatro formatos JSON.
Passo a passo: Início rápido com Next.js.
Vue e Nuxt com vue-i18n
Para o vue-i18n, incluindo o Nuxt I18n, com placeholders de chave simples { } e plurais separados por barra vertical.
- Formato:
vue-i18n-json - Arquivos:
src/locales/{locale}.json
npx @verbatra/cli init --format vue-i18n-json --provider gemini --yesDetalhes: Os quatro formatos JSON.
Passo a passo: Início rápido com Vue.
Angular com ngx-translate
Para JSON do ngx-translate, plano ou aninhado.
- Formato:
ngx-translate-json - Arquivos:
src/assets/i18n/{locale}.json
npx @verbatra/cli init --format ngx-translate-json --provider gemini --yesDetalhes: Os quatro formatos JSON.
Passo a passo: Início rápido com Angular.
Flutter
Para os Application Resource Bundles do Flutter. O init também define localeStyle: "posix", então pt-BR é gravado como app_, o nome que o flutter gen-l10n lê.
- Formato:
arb - Arquivos:
lib/l10n/app_{locale}.arb
npx @verbatra/cli init --format arb --provider gemini --yesDetalhes: ARB.
Passo a passo: Início rápido com Flutter.
Android
Para recursos strings.xml. O init também define localeStyle: "android", então o placeholder {locale} se expande para values na origem e para values-de no alemão.
- Formato:
android-xml - Arquivos:
app/src/main/res/{locale}/strings.xml
npx @verbatra/cli init --format android-xml --provider gemini --yesDetalhes: Android strings.xml.
iOS e macOS
Dois formatos, conforme o projeto guarda suas strings. Para arquivos .strings com seus plurais em .stringsdict:
- Formato:
apple-strings - Arquivos:
{locale}.lproj/Localizable.strings
npx @verbatra/cli init --format apple-strings --provider gemini --yesPara um Xcode String Catalog, um único arquivo que contém todos os locales. Crie o catálogo no Xcode primeiro: o verbatra grava nele, mas nunca o cria.
- Formato:
apple-xcstrings - Arquivos:
{locale}Localizable.xcstrings
O padrão precisa do placeholder {locale}, mas, em um String Catalog, ele se expande para uma string vazia: todos os locales são lidos e gravados no mesmo arquivo Localizable.xcstrings.
npx @verbatra/cli init --format apple-xcstrings --provider gemini --yesDetalhes: Apple .strings e Xcode String Catalogs (.xcstrings).
gettext
Para catálogos .po e seus modelos .pot, como os usados em projetos Python, PHP e C. O init também define localeStyle: "posix", então pt-BR é gravado como pt_.
- Formato:
gettext-po - Arquivos:
locales/{locale}/LC_MESSAGES/messages.po
npx @verbatra/cli init --format gettext-po --provider gemini --yesDetalhes: gettext .po/.pot.
Java e Spring
Para pacotes de mensagens .properties. O init também define localeStyle: "posix", então pt-BR é gravado como messages_.
- Formato:
properties - Arquivos:
src/main/resources/messages_{locale}.properties
npx @verbatra/cli init --format properties --provider gemini --yesDetalhes: Properties.
.NET
Para arquivos de recursos .resx. Imagens, ícones e entradas do designer não são alterados.
- Formato:
resx - Arquivos:
Resources/Strings.{locale}.resx
npx @verbatra/cli init --format resx --provider gemini --yesDetalhes: .NET .resx.
YAML
Para arquivos de locale YAML aninhados com placeholders {{double-brace}} no estilo do i18next.
- Formato:
yaml - Arquivos:
locales/{locale}.yml
npx @verbatra/cli init --format yaml --provider gemini --yesDetalhes: YAML.
XLIFF
Para documentos XLIFF 1.2 e 2.0 vindos do ng extract-i18n do Angular, de uma ferramenta CAT ou de uma agência.
- Formato:
xliff - Arquivos:
locales/{locale}.xlf
npx @verbatra/cli init --format xliff --provider gemini --yesDetalhes: XLIFF.
INI
Para arquivos INI clássicos, com um nível de cabeçalhos [section].
- Formato:
ini - Arquivos:
locales/{locale}.ini
npx @verbatra/cli init --format ini --provider gemini --yesDetalhes: INI.
Outra coisa
Um formato que o verbatra não traz pode ser traduzido por meio de um adaptador que você mesmo escreve. Veja Escrever um adaptador de formato personalizado.
Editar no GitHub