Localiza una aplicación Rails
Traduce archivos YAML de Rails con el idioma en la raíz y comprueba la búsqueda, la interpolación, las formas de plural y la selección del idioma en cada petición.
Rails ya asigna nombres estables a los mensajes mediante t y I18n.t. Lingo.dev puede traducir el YAML asociado a esos nombres mientras Rails sigue gestionando la búsqueda, la interpolación y la selección del idioma. Empieza con un saludo y un recuento de notificaciones, y compruébalos con los mismos métodos auxiliares que utiliza la aplicación.
Añade los mensajes de origen a un archivo de idioma de Rails #
Crea o amplía config/locales/en.yml:
en:
home:
index:
welcome: "Welcome, %{name}!"
cta: "Create an account"
notifications:
unread:
one: "One unread notification"
other: "%{count} unread notifications"En app/views/home/index.html.erb, el saludo puede utilizar una búsqueda relativa a la vista:
<h1><%= t(".welcome", name: @user_name) %></h1>
<p><%= t("notifications.unread", count: @unread_count) %></p>La ruta de la vista proporciona a .welcome la clave completa home.index.welcome. El código que lo invoca aporta name y count; la traducción debe conservar esos nombres de interpolación. Las claves de plural, como one y other, identifican las ramas y se mantienen sin cambios.
A medida que amplíes la cobertura, traslada las etiquetas de las vistas, los textos de los correos y los errores de los modelos que aún estén definidos directamente en el código a los espacios de nombres de idioma correspondientes. Traducir un archivo solo afecta al código que carga sus mensajes.
Selecciona YAML con el idioma en la raíz #
Rails lee el idioma de la raíz del YAML. Si cambias el nombre de en.yml a es.yml pero mantienes en:, los mensajes siguen definidos en inglés. Usa el gestor yaml-root-key para traducir los valores y cambiar el nombre de la raíz en la misma operación.
Instala y vincula la CLI desde la raíz del proyecto:
npm install --global @lingo.dev/cli
lingo login
lingo init --source en --targets es,fr --files 'config/locales/en.yml' --yes
lingo linkConserva los ID de la organización y del motor de localización guardados en .lingo/config.json. Configura su matriz files con las entradas de origen que utiliza tu proyecto:
[
{ "pattern": "config/locales/en.yml", "format": "yaml-root-key" },
{ "pattern": "config/locales/*.en.yml", "format": "yaml-root-key" }
]La segunda entrada incluye archivos separados por funcionalidad, como mailers.en.yml, sin seleccionar sus equivalentes traducidos. Elimínala si el proyecto no tiene archivos de este tipo. Especifica el formato de forma explícita: el YAML genérico conserva todas las raíces, mientras que la detección de la CLI exige elegir un formato explícito para los archivos de origen YAML. YAML con el idioma en la raíz describe el requisito de un mapa con una única raíz y cómo se reconstruye el archivo.
Traduce e inspecciona los valores cargados #
Para los archivos de destino que falten, ejecuta:
lingo push --backfill-missing --waitCuando termine la ejecución, abre config/locales/es.yml y confirma que la raíz sea es:. Comprueba que las claves anidadas y los nombres de interpolación coincidan con los del origen. Revisa los comentarios, las anclas y los alias después de la serialización. Una estructura de origen distinta puede necesitar una ruta de destino explícita.
Carga el resultado en la consola de Rails o en las pruebas de la aplicación, seleccionando el idioma de forma explícita:
I18n.with_locale(:es) do
puts I18n.t("home.index.welcome", name: "Alex", raise: true)
[0, 1, 2, 20].each do |count|
puts I18n.t("notifications.unread", count: count, raise: true)
end
endConfigura :en, :es y :fr como idiomas disponibles antes de esta comprobación. El ejemplo pone a prueba la búsqueda y la interpolación; revisa que el texto exprese el saludo y el recuento de notificaciones previstos. Los idiomas de destino pueden necesitar reglas y ramas de plural adicionales a las formas del inglés de origen. Repite la comprobación para el francés y para los espacios de nombres de correo y validación de la aplicación a medida que se añadan.
Haz que las peticiones seleccionen el mismo idioma #
Declara los idiomas admitidos y un idioma predeterminado en la configuración de Rails. Encapsula la gestión de las peticiones en I18n.with_locale con un valor elegido entre los idiomas admitidos, para que el estado del idioma no se conserve de una petición a otra.
Para URL como /es, configura tanto el ámbito de la ruta como el controlador que lee params[:locale]. Conserva el idioma en los enlaces generados. Si la aplicación también negocia Accept-Language, analiza los pesos de calidad y las etiquetas regionales en lugar de extraer una subcadena de dos letras. Cuando la aplicación permita al usuario elegir un idioma de forma explícita, esa elección debe tener prioridad.
Decide cómo debe funcionar el idioma de reserva. Este recurso puede mantener una página utilizable y, a la vez, ocultar que falta un mensaje en español, así que comprueba las entradas de destino necesarias sin depender de él. Cuando corresponda, usa el método auxiliar l de Rails para localizar fechas y horas en lugar de traducir como texto una fecha ya formateada.
Abre una página en el idioma de destino tanto directamente como a través de la navegación. Confirma que Rails selecciona el espacio de nombres de destino, muestra los valores interpolados previstos y admite textos más largos. lingo check no comprueba que el YAML de Rails esté completo; mantén las comprobaciones de carga y renderizado de Rails, junto con la revisión lingüística, en el proceso de aceptación.
Mantén las traducciones al actualizar el origen #
Mantén juntos los archivos de origen, las traducciones de destino aceptadas, la configuración y .lingo/lock.json. Después de cambiar un mensaje, ejecuta lingo push --wait para procesar los cambios habituales y compara el mensaje modificado con otro cercano que no haya cambiado. Para hacer una corrección puntual en un texto cuyo origen no ha cambiado, edita el destino directamente: el ámbito de clave YAML puede reutilizar la traducción existente. Para regenerar las traducciones tras cambiar las directrices, guarda las traducciones de destino aceptadas antes de sustituir archivos completos dentro de un ámbito delimitado, como se describe en ámbitos de traducción.
Si las correcciones locales del destino necesitan protección frente a divergencias, envía sin --wait, inspecciona lingo pull --dry-run y recupera el resultado en el checkout desde el que se hizo el envío. La escritura de los resultados tras la espera no incluye esa nueva comprobación de conflictos. Los demás checkouts reciben las traducciones confirmadas a través del control de versiones. Consulta Conservar las traducciones revisadas.
Cuando el ciclo local funcione, elige la GitHub App o la automatización de CI. Ejecuta las mismas comprobaciones de Rails sobre los recursos generados antes de fusionar los cambios de traducción.