Docs / Primeros pasos
Página traducida automáticamente
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 --yesDetalles: 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 --yesDetalles: 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 --yesDetalles: 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 --yesDetalles: 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_, el nombre que lee flutter gen-l10n.
- Formato:
arb - Archivos:
lib/l10n/app_{locale}.arb
npx @verbatra/cli init --format arb --provider gemini --yesDetalles: 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 --yesDetalles: 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 --yesPara 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 --yesDetalles: 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_.
- Formato:
gettext-po - Archivos:
locales/{locale}/LC_MESSAGES/messages.po
npx @verbatra/cli init --format gettext-po --provider gemini --yesDetalles: 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_.
- Formato:
properties - Archivos:
src/main/resources/messages_{locale}.properties
npx @verbatra/cli init --format properties --provider gemini --yesDetalles: 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 --yesDetalles: .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 --yesDetalles: 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 --yesDetalles: 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 --yesDetalles: 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