<%= t(".unread", count: @count) %>
``` Seleccionar español no traduce este archivo. Con las alternativas de respaldo en inglés activadas, los lectores en español siguen viendo "Inbox" y "You have 3 unread messages". Rails necesita un catálogo en español para poder mostrar textos en español. Cada mensaje en inglés que se añade o se edita genera el mismo trabajo en cada idioma. La gema [rails-i18n](https://github.com/svenfuchs/rails-i18n) proporciona los formatos de cada configuración regional y las reglas de plural. [i18n-tasks](/kb/general-translation-vs-i18n-tasks) detecta las claves y formas plurales que faltan. General Translation proporciona los mensajes traducidos que usan esas herramientas. ## Traducir archivos de configuración regional de Rails con General Translation Sigue usando Rails I18n para las búsquedas y deja que General Translation genere los demás archivos de configuración regional. La CLI `gt` se ejecuta en Node.js, traduce YAML y conserva tus claves. En este ejemplo de inglés a español, guarda los mensajes en `translations/en.yml` sin la clave externa `en:`: ```yaml title="translations/en.yml" inbox: show: title: "Inbox" unread: one: "You have %{count} unread message." other: "You have %{count} unread messages." ``` Configura `gt.config.json` para que apunte a estos archivos de trabajo. Un breve paso de exportación añade las claves de configuración regional de Rails y genera los catálogos que carga la aplicación: ```json title="gt.config.json" { "defaultLocale": "en", "locales": [ "es" ], "files": { "yaml": { "include": [ "translations/[locale].yml" ] } } } ``` Configura `GT_PROJECT_ID` y `GT_API_KEY` como se describe en [Generar traducciones](/docs/cli/guides/generating-translations). Si ya tienes traducciones para este catálogo, guárdalas en `translations/es.yml` sin la clave raíz `es:` y ejecuta [`npx gt upload`](/docs/cli/reference/commands/upload) antes de generar traducciones nuevas. ```ruby title="script/export_rails_locales.rb" require "json" require "yaml" require "fileutils" config = JSON.parse(File.read("gt.config.json")) locales = ([config.fetch("defaultLocale")] + config.fetch("locales")).uniq catalogs = locales.to_h do |locale| messages = YAML.safe_load_file("translations/#{locale}.yml", aliases: true) raise "Expected a message map for #{locale}" unless messages.is_a?(Hash) [locale, { locale => messages }.to_yaml] end FileUtils.mkdir_p("config/locales") catalogs.each do |locale, catalog| File.write("config/locales/#{locale}.yml", catalog) end ``` ```bash npx gt translate && ruby script/export_rails_locales.rb ``` La exportación genera los archivos `config/locales/en.yml` y `config/locales/es.yml` de este catálogo. Sigue editando los archivos de trabajo en `translations/`; la aplicación carga las copias exportadas. Sincroniza las ediciones de la traducción local con [`npx gt save-local`](/docs/cli/reference/commands/save-local) antes de la siguiente ejecución de traducción. General Translation traduce cada archivo con el [glosario y los prompts personalizados](/docs/platform/dashboard/guides/defining-context-for-translations) de tu proyecto, de modo que el nombre de un producto o un tono formal se mantienen en todos los archivos de configuración regional, y tu equipo puede [revisar y editar las traducciones](/docs/platform/dashboard/guides/reviewing-translations) en el panel de control. Las entradas sin cambios reutilizan las traducciones anteriores, así que, si ejecutas la CLI en CI con cada fusión, solo se traduce lo que ha cambiado. Ejecuta `i18n-tasks missing` e `i18n-tasks check-consistent-interpolations` antes del lanzamiento para comprobar las claves, las formas plurales y los marcadores de posición `%{count}` de los catálogos exportados. ## Rails I18n frente a General Translation de un vistazo | Característica | Rails I18n | General Translation | | ---------------------------------------------- | ------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------- | | Qué es | Biblioteca de Ruby para buscar traducciones y darles formato | Plataforma de traducción con una CLI, bibliotecas para JavaScript y Python, y un panel de control | | Renderiza traducciones en una aplicación Rails | Sí, en vistas, controladores y mailers | Proporciona catálogos para las mismas llamadas de Rails I18n | | Escribe traducciones | No | Sí, archivos YAML con [`npx gt translate`](/docs/cli/reference/commands/translate) | | Reglas de plural | Reglas del inglés de forma predeterminada; reglas de CLDR con rails-i18n | Traduce las formas de origen configuradas; Rails elige la adecuada en tiempo de ejecución | | Coherencia entre archivos | Depende de tus traductores | Glosario y prompts personalizados aplicados a todos los archivos | | Revisión | Tu proceso de pull requests | Panel de control, además de tu proceso de pull requests | | Costo | Gratis, MIT | [Según el uso](https://generaltranslation.com/pricing) | Usa solo Rails I18n si tus traductores o un proveedor ya te entregan los archivos de configuración regional, o si das soporte a uno o dos idiomas y los editas a mano. Añade General Translation si el texto en inglés cambia con frecuencia y quieres que todos los archivos de configuración regional se regeneren en CI, con una terminología coherente, en lugar de esperar a que se complete un ciclo de traducción. ## Puntos clave * Rails I18n renderiza traducciones desde `config/locales` y da formato a fechas y números; rails-i18n añade reglas de plural y datos de configuración regional. Ninguno de los dos genera traducciones. * General Translation traduce archivos YAML con tu glosario y tus prompts personalizados, y mantiene las traducciones al día a medida que cambia el texto en inglés. * Mantén los catálogos editables en `translations/` y, después de ejecutar [`npx gt translate`](/docs/cli/reference/commands/translate), expórtalos a las raíces de configuración regional de Rails. ## Related questions - [General Translation vs. i18n-tasks: ¿cuál deberías usar?](https://generaltranslation.com/es/kb/general-translation-vs-i18n-tasks.mdx): i18n-tasks es una gema de Ruby que detecta claves de Rails I18n faltantes y sin usar, ordena los archivos de configuración regional y puede completar las claves faltantes mediante Google Translate, DeepL, OpenAI, Yandex o watsonx. General Translation traduce archivos de configuración regional completos con tu glosario, tus prompts personalizados y la revisión en el panel de control. Cumplen funciones distintas, y muchos equipos pueden usar ambas. - [General Translation vs. Mobility: ¿cuál deberías usar?](https://generaltranslation.com/es/kb/general-translation-vs-mobility.mdx): Mobility almacena los atributos traducidos de los modelos en tu base de datos. General Translation genera esas traducciones a través de su API, usando tu glosario y tus prompts personalizados. Usa ambos para traducir fichas de productos, publicaciones y otro contenido de la base de datos sin renunciar a tus modelos de Rails. - [General Translation vs. i18next, react-intl y next-intl: ¿qué biblioteca de i18n deberías usar?](https://generaltranslation.com/es/kb/general-translation-vs-i18n-libraries.mdx): Las bibliotecas de código abierto como i18next, react-intl y next-intl no traducen nada. Muestran las traducciones que tú proporcionas en un archivo de catálogo para cada idioma, escritas por ti, por tus traductores o por un servicio externo. Las bibliotecas de General Translation también son de código abierto y cumplen la misma función, pero además General Translation se encarga de traducir, usando tu código como contexto. - [¿Por qué usar General Translation en lugar de un TMS (Smartling, Lokalise, Phrase, Crowdin o Transifex)?](https://generaltranslation.com/es/kb/general-translation-vs-tms.mdx): Un sistema de gestión de traducciones (TMS) como Smartling, Lokalise, Phrase, Crowdin o Transifex coordina a los traductores, pero los ingenieros siguen teniendo que extraer las cadenas, enviarlas, esperar las traducciones y volver a integrarlas en el producto. General Translation traduce el contenido de tu código junto con su contexto, incluye todos los idiomas en cada lanzamiento y funciona con bibliotecas de código abierto, sin dependencia de proveedor. - [¿Cuál es el mejor software de localización para desarrolladores?](https://generaltranslation.com/es/kb/best-localization-software.mdx): Busca un único sistema que cubra todo el flujo, desde la biblioteca de i18n en tu código hasta la traducción y la entrega, en lugar de ir uniendo por separado una biblioteca, un sistema de gestión de traducciones y un proveedor de traducción. ## Previous and next questions - Previous question: [General Translation vs. Paraglide JS: ¿cuál deberías usar?](https://generaltranslation.com/es/kb/general-translation-vs-paraglide.mdx) - Next question: [General Translation vs. Symfony Translation: ¿cuál deberías usar?](https://generaltranslation.com/es/kb/general-translation-vs-symfony-translation.mdx) ## Sitemap See the [Knowledge Base sitemap](https://generaltranslation.com/es/kb/sitemap.md) for every article.