Cómo traducir archivos YAML en línea

Traducir archivos de localización YAML es sencillo con nuestra herramienta con IA. Siga estos pasos para obtener un archivo YAML totalmente traducido en minutos:

1. Pegue el contenido de su archivo .yaml o .yml en el editor de arriba.
2. Establezca el idioma de origen (o déjelo en blanco para la detección automática) e introduzca el código de idioma de destino (p. ej., es, de, ja, zh).
3. Haga clic en Traducir y espere mientras la IA procesa su contenido YAML. La traducción puede tardar hasta unos minutos para archivos grandes.
4. Copie la salida traducida o descárguela como un archivo .yaml listo para confirmar en su repositorio.

¿Qué es un archivo YAML?

YAML (YAML Ain't Markup Language) es un formato de serialización de datos legible por humanos ampliamente utilizado para archivos de configuración y localización en el desarrollo de software moderno. Su sintaxis limpia basada en sangrías hace que sea fácil de leer y escribir en comparación con JSON o XML.

Los archivos YAML utilizan la extensión .yaml o .yml y son el formato de localización estándar para Ruby on Rails, Symfony (PHP), Vue i18n, Flutter ARB, Spring Boot y muchos otros frameworks. Un solo archivo YAML normalmente contiene todas las cadenas traducidas para un idioma.

Debido a que YAML admite claves anidadas, listas y comentarios en línea, es especialmente adecuado para organizar grandes conjuntos de cadenas de interfaz de usuario en una estructura jerárquica que refleja el árbol de componentes de la aplicación.

Estructura de archivo YAML para localización

Un archivo de localización YAML típico utiliza pares clave-valor anidados para organizar las cadenas por función o componente. Aquí hay un ejemplo de una estructura YAML común:

# Application configuration
app:
  name: "My Application"
  version: "2.0.0"
  description: "A powerful tool for managing your workflow"

navigation:
  home: "Home"
  about: "About Us"
  contact: "Contact"
  login: "Sign In"
  logout: "Sign Out"

messages:
  welcome: "Welcome back, {{name}}!"
  error: "An unexpected error occurred. Please try again."
  success: "Your changes have been saved successfully."

buttons:
  save: "Save"
  cancel: "Cancel"
  delete: "Delete"
  confirm: "Confirm"

• Pares clave-valor — la base de YAML: key: "Cadena traducida".
• Claves anidadas — agrupe cadenas relacionadas bajo un padre común: button.save: "Guardar".
• Listas — secuencias ordenadas de valores utilizando el prefijo -.
• Comentarios — las líneas que comienzan con # proporcionan contexto para los traductores y se conservan opcionalmente.
• Marcadores de posición de interpolación — variables como {{name}} o %{count} se conservan tal cual y nunca se traducen.

Ejemplo de archivo de localización YAML

A continuación se muestra un archivo de localización YAML realista que muestra claves anidadas, interpolación y uso de comentarios como se encuentra en proyectos de producción de Rails y Vue i18n:

# en/messages.yaml
user:
  greeting: "Hello, {{name}}!"
  farewell: "Goodbye, {{name}}. See you soon!"
  profile:
    title: "Your Profile"
    subtitle: "Manage your account settings"
    avatar: "Profile Picture"

errors:
  notFound: "The page you are looking for does not exist."
  unauthorized: "You are not authorized to view this page."
  serverError: "A server error occurred. Please contact support."

forms:
  required: "This field is required."
  email: "Please enter a valid email address."
  minLength: "Must be at least {{min}} characters."

Nuestra IA traduce todos los valores de cadena mientras deja las claves, las variables de interpolación y la sangría estructural completamente sin cambios. El resultado es un archivo de reemplazo directo para su idioma de destino.

Archivos YAML en la localización de software

YAML es uno de los formatos más populares para la localización de software porque logra el equilibrio adecuado entre legibilidad humana y analizabilidad por máquina. Los desarrolladores pueden editar archivos YAML directamente sin herramientas especiales, mientras que las canalizaciones automatizadas pueden procesarlos de forma fiable.

En un flujo de trabajo de localización típico, usted mantiene un archivo YAML por idioma (p. ej., en.yml, de.yml, ja.yml) dentro de un directorio de locales o i18n. El archivo de idioma de origen se trata como referencia y se generan copias traducidas para cada configuración regional de destino.

Frameworks y herramientas que utilizan YAML para la localización

Los archivos de localización YAML son compatibles con una amplia gama de frameworks populares en múltiples idiomas y plataformas:

• Ruby on Rails — utiliza YAML como su formato de i18n nativo (config/locales/en.yml). La gema i18n de Rails admite claves anidadas, pluralización e interpolación de forma inmediata.
• Symfony (PHP) — admite archivos de traducción YAML junto con XLIFF. Los archivos YAML en translations/messages.en.yaml impulsan el componente de traducción de Symfony.
• Spring Boot (Java) — aunque Spring normalmente utiliza archivos .properties, el soporte de YAML de Spring en application.yml y las bibliotecas comunitarias como i18n4java extienden YAML a la localización.
• Flutter / Dart — el paquete easy_localization y bibliotecas de i18n de Flutter similares utilizan archivos YAML para gestionar traducciones para aplicaciones móviles y de escritorio.
• Vue i18n — el plugin oficial de internacionalización de Vue.js admite archivos de mensajes YAML. Vite-plugin-vue-i18n permite importar archivos .yaml directamente como componentes Vue.
• React / Next.js — bibliotecas como next-i18next y react-i18next pueden cargar archivos de traducción YAML a través de backends personalizados, lo que los convierte en una opción popular para la localización de Next.js.

Generación de glosario con IA para traducciones YAML

Nuestra función de generación de glosario con IA le ayuda a mantener una terminología consistente en todos sus archivos de localización YAML. Habilite el guardado y la reutilización activando Generar y guardar glosario en las opciones de traducción:

• Terminología consistente — la IA analiza su YAML de origen y las traducciones de destino existentes para crear un glosario de términos clave, asegurando que los nombres de productos, etiquetas de interfaz de usuario y términos técnicos se traduzcan de la misma manera en toda su aplicación.
• Términos específicos del dominio — proporcione una muestra de contenido YAML ya traducido en el campo de cadenas de destino. La IA aprende su terminología preferida y la aplica a las nuevas cadenas automáticamente.
• Cómo usarlo — pegue su contenido YAML traducido en el campo opcional de cadenas de destino que aparece cuando se habilita la generación de glosario. La IA extraerá términos recurrentes y los utilizará como guía de traducción. Si no se proporcionan cadenas de destino, la IA genera entradas de glosario solo a partir del contenido de origen, lo que aún puede mejorar la consistencia.

¿Por qué usar L10n.dev para la traducción de YAML?

• Precisión con IA — nuestro motor de traducción entiende el contexto de localización de YAML, no solo texto sin formato. Traduce cadenas legibles por humanos mientras ignora claves, anclajes, alias y sintaxis estructural.
• Preservación de la estructura — la sangría, el anidamiento y la jerarquía de YAML siempre se conservan. El archivo traducido es un documento YAML válido que se puede analizar sin modificaciones.
• Soporte de interpolación — marcadores de posición como {{name}}, %{count}, :variable y variables de formato de mensaje ICU se detectan y se dejan intactos durante la traducción.
• Conciencia de claves anidadas — la IA entiende la estructura jerárquica de archivos YAML profundamente anidados y mantiene un contexto preciso para cada cadena según su posición en el árbol.
• Compatibilidad con múltiples frameworks — la salida es compatible con Ruby on Rails, Symfony, Vue i18n, Flutter, Spring Boot y cualquier otro framework que consuma archivos de localización YAML estándar.
• Traduzca hasta 10,000 caracteres gratis. Los planes de pago ofrecen precios escalables para proyectos más grandes. Ver precios
• Optimizado para archivos grandes — para archivos YAML muy grandes (cientos de kilobytes), utilice la página de Traducción de archivos I18N que admite subidas de archivos de hasta 5 MB.

Casos de uso comunes de traducción YAML

La traducción de YAML se utiliza en una amplia gama de tipos de aplicaciones y flujos de trabajo de desarrollo:

• Aplicaciones Ruby on Rails — traduzca config/locales/en.yml a archivos de idioma adicionales para aplicaciones Rails multilingües.
• Proyectos Symfony PHP — localice translations/messages.en.yaml y archivos de traducción específicos del dominio para sitios web y API basados en Symfony.
• Aplicaciones Vue.js / Nuxt.js — traduzca archivos de mensajes YAML de Vue i18n para agregar soporte de idioma a aplicaciones de página única Vue y sitios estáticos Nuxt.js.
• Aplicaciones móviles Flutter — traduzca archivos de localización assets/lang/en.yaml para aplicaciones Flutter multiplataforma dirigidas a múltiples mercados.
• Contenido de configuración y CMS — traduzca archivos de configuración YAML utilizados por generadores de sitios estáticos como Jekyll, Hugo o Gatsby para contenido de sitios en varios idiomas.
• Generadores de sitios estáticos — Jekyll utiliza archivos YAML en _data/ para cadenas de todo el sitio, Hugo utiliza archivos YAML en i18n/ y Gatsby admite YAML a través de gatsby-plugin-react-i18next.
• Canalizaciones de CI/CD y DevOps — integre la traducción de YAML en su canalización de implementación utilizando la API REST de L10n.dev para automatizar la localización como parte de su flujo de trabajo de versión.

YAML vs JSON para localización

Tanto YAML como JSON se utilizan ampliamente para archivos de localización, pero tienen diferentes puntos fuertes. La sintaxis legible por humanos de YAML, el soporte para comentarios y las cadenas multilínea compactas hacen que sea preferido en comunidades como Ruby y PHP donde los desarrolladores editan frecuentemente los archivos de traducción a mano.

JSON es más universalmente compatible en los ecosistemas de JavaScript (React, Angular, Vue) y es más fácil de analizar mediante programación. Si su proyecto utiliza ambos formatos, L10n.dev admite ambos: puede traducir archivos JSON en la página de traducción de JSON y archivos YAML aquí.

Para la mayoría de los proyectos, la elección del formato viene dictada por el framework que utilice. Si utiliza Rails, Symfony o Vue i18n, YAML es la opción natural. Si utiliza Angular i18next, React i18next o Next.js, JSON es más común. L10n.dev maneja ambos igual de bien.

Preguntas frecuentes

¿Qué partes de mi archivo YAML se conservan durante la traducción?

Todos los elementos estructurales de YAML se conservan: claves, sangría, anidamiento, anclajes (&), alias (*), comentarios (#) y sintaxis de lista (-). Los marcadores de posición de interpolación como {{variable}}, %{name} y :symbol siempre se dejan sin cambios. Solo se traducen los valores de cadena legibles por humanos.

¿Son seguras las variables de interpolación y los marcadores de posición durante la traducción?

Sí. Nuestra IA detecta patrones de interpolación comunes utilizados por Rails (%{name}), Vue i18n ({name}), Symfony (%variable%), Flutter ({name}) y el formato de mensaje ICU. Estas variables se conservan exactamente como están escritas y nunca se traducen ni modifican.

¿Cómo traduzco un archivo YAML?

Pegue el contenido de su archivo .yaml o .yml en el editor de arriba, establezca el código de idioma de destino (p. ej., fr, de, ja, zh) y haga clic en Traducir. La IA devuelve un archivo YAML totalmente traducido con todas las claves y la estructura preservadas. Descargue el resultado como un archivo .yaml.

¿Cómo ayuda la generación de glosario con IA con la traducción YAML?

Habilitar Generar y guardar glosario le permite pegar contenido YAML traducido existente junto con su archivo de origen. La IA extrae términos recurrentes y los utiliza como guía de traducción, asegurando que los nombres de productos, etiquetas de funciones y términos del dominio se traduzcan de forma consistente en todo el archivo y en futuras traducciones.

¿Puedo traducir archivos de localización YAML grandes?

Esta página funciona bien para archivos YAML individuales de hasta unos cientos de kilobytes. Para la traducción masiva de YAML o archivos muy grandes, utilice la página de Traducción de archivos I18N que admite subidas de archivos de hasta 5 MB y proporciona una entrega más fiable para proyectos de localización a gran escala.