Saltar al contenido

Docs / Primeros pasos

Página traducida automáticamente

Esta página se tradujo automáticamente, así que puede contener errores o sonar un poco rara. La versión en inglés es la fuente de la verdad. Leer el original en inglés.

Elige tu stack

Encuentra tu framework y copia el id de formato y el comando init que configuran verbatra para él, junto con la estructura habitual de archivos de locale.

Busca tu framework abajo y usa su comando init en lugar del de Inicio rápido. Cada estructura de archivos es el patrón que escribe init cuando no encuentra archivos de locale; si tus archivos ya existen, init detecta dónde están, y con --path fijas tú el patrón. El comportamiento completo de cada formato está en Formatos. Algunos stacks tienen además un inicio rápido paso a paso, enlazado al final de su sección.

React con i18next

Para proyectos con i18next, react-i18next y next-i18next.

  • Formato: i18next-json
  • Archivos: locales/{locale}.json
npx @verbatra/cli init --format i18next-json --provider gemini --yes

Detalles: Los cuatro formatos JSON.

Paso a paso: Inicio rápido con React.

Next.js con next-intl

Para archivos de mensajes de next-intl, cuyos valores son mensajes ICU.

  • Formato: next-intl-json
  • Archivos: messages/{locale}.json
npx @verbatra/cli init --format next-intl-json --provider gemini --yes

Detalles: Los cuatro formatos JSON.

Paso a paso: Inicio rápido con Next.js.

Vue y Nuxt con vue-i18n

Para vue-i18n, también en Nuxt I18n, con marcadores de posición entre llaves simples y plurales separados por barra vertical.

  • Formato: vue-i18n-json
  • Archivos: src/locales/{locale}.json
npx @verbatra/cli init --format vue-i18n-json --provider gemini --yes

Detalles: Los cuatro formatos JSON.

Paso a paso: Inicio rápido con Vue.

Angular con ngx-translate

Para JSON de ngx-translate, plano o anidado.

  • Formato: ngx-translate-json
  • Archivos: src/assets/i18n/{locale}.json
npx @verbatra/cli init --format ngx-translate-json --provider gemini --yes

Detalles: Los cuatro formatos JSON.

Paso a paso: Inicio rápido con Angular.

Flutter

Para los Application Resource Bundles de Flutter. init también fija localeStyle: "posix", así que pt-BR se escribe como app_pt_BR.arb, el nombre que lee flutter gen-l10n.

  • Formato: arb
  • Archivos: lib/l10n/app_{locale}.arb
npx @verbatra/cli init --format arb --provider gemini --yes

Detalles: ARB.

Paso a paso: Inicio rápido con Flutter.

Android

Para recursos strings.xml. init también fija localeStyle: "android", así que el token se expande a values para el origen y a values-de para el alemán.

  • Formato: android-xml
  • Archivos: app/src/main/res/{locale}/strings.xml
npx @verbatra/cli init --format android-xml --provider gemini --yes

Detalles: Android strings.xml.

iOS y macOS

Dos formatos, según cómo guarde tu proyecto sus textos. Para archivos .strings con sus plurales en .stringsdict:

  • Formato: apple-strings
  • Archivos: {locale}.lproj/Localizable.strings
npx @verbatra/cli init --format apple-strings --provider gemini --yes

Para un Xcode String Catalog, un único archivo con todos los locales. Crea primero el catálogo en Xcode: verbatra escribe en él, pero nunca lo crea.

  • Formato: apple-xcstrings
  • Archivos: {locale}Localizable.xcstrings

El patrón necesita el token {locale}, pero en un String Catalog se expande a nada: cada locale lee y escribe el único archivo Localizable.xcstrings.

npx @verbatra/cli init --format apple-xcstrings --provider gemini --yes

Detalles: Apple .strings y Xcode String Catalogs.

gettext

Para catálogos .po y sus plantillas .pot, como los que usan los proyectos en Python, PHP y C. init también fija localeStyle: "posix", así que pt-BR se escribe como pt_BR.

  • Formato: gettext-po
  • Archivos: locales/{locale}/LC_MESSAGES/messages.po
npx @verbatra/cli init --format gettext-po --provider gemini --yes

Detalles: gettext .po/.pot.

Java y Spring

Para bundles de mensajes .properties. init también fija localeStyle: "posix", así que pt-BR se escribe como messages_pt_BR.properties.

  • Formato: properties
  • Archivos: src/main/resources/messages_{locale}.properties
npx @verbatra/cli init --format properties --provider gemini --yes

Detalles: Properties.

.NET

Para archivos de recursos .resx. Las imágenes, los iconos y las entradas del diseñador no se tocan.

  • Formato: resx
  • Archivos: Resources/Strings.{locale}.resx
npx @verbatra/cli init --format resx --provider gemini --yes

Detalles: .NET .resx.

YAML

Para archivos de locale YAML anidados con marcadores de posición al estilo de i18next, {{double-brace}}.

  • Formato: yaml
  • Archivos: locales/{locale}.yml
npx @verbatra/cli init --format yaml --provider gemini --yes

Detalles: YAML.

XLIFF

Para documentos XLIFF 1.2 y 2.0 generados por ng extract-i18n de Angular, por una herramienta TAO o por una agencia.

  • Formato: xliff
  • Archivos: locales/{locale}.xlf
npx @verbatra/cli init --format xliff --provider gemini --yes

Detalles: XLIFF.

INI

Para archivos INI clásicos, con un nivel de encabezados [section].

  • Formato: ini
  • Archivos: locales/{locale}.ini
npx @verbatra/cli init --format ini --provider gemini --yes

Detalles: INI.

Otra cosa

Un formato que verbatra no incluye se puede traducir igualmente con un adaptador que escribas tú. Consulta Escribe un adaptador de formato propio.

Editar en GitHub

En esta página