Traducir archivos YAML y TOML
Traduce archivos .yaml, .yml y .toml de hasta 4 MB a uno o varios idiomas. Las claves, la jerarquía y el orden se conservan. Ejemplos de instrucciones para Rails, Hugo y archivos de configuración.
Se aceptan archivos YAML (.yaml, .yml) y TOML (.toml) de hasta 4 MB. Solo se modifican los valores de texto: las claves, los niveles de anidación, las tablas y el orden de las claves se conservan. Entre los usos habituales están los archivos de idioma de Rails y Symfony, el contenido para sitios estáticos y las tablas i18n de Hugo.
Qué se traduce y qué se deja intacto
| Se traduce | Se deja intacto | |
|---|---|---|
| YAML | Valores de texto, incluido el contenido en prosa de los bloques multilínea | Claves, jerarquía, orden de las claves, números y valores booleanos |
| TOML | Valores de texto, cada uno sustituido en su propia línea | Tablas, claves, orden, comentarios, números, fechas y rutas |
Los marcadores de posición, como %{name} (Rails), {name} y %s, están protegidos y se conservan en el texto traducido.
Qué puedes pedir
Un idioma, con los marcadores de interpolación y todas las claves intactos.
Traduce los valores al francés. Mantén %{name} y %{count} sin cambios y no modifiques ninguna clave.
Para un archivo YAML que ya tiene una sección por idioma: varios idiomas en un solo trabajo.
Completa las secciones fr y de vacías a partir de la sección en.
Para un sitio estático: traduce el texto y deja intactos los ajustes.
Traduce solo los campos title, description y body al italiano. Deja intactos los slugs, las fechas, los diseños y las URLs.
Para TOML: conserva las claves que utilizan las plantillas.
Traduce las cadenas al portugués. Mantén exactamente todas las claves y los nombres de las tablas.
Para YAML: devuelve únicamente las claves que se hayan editado.
Traduce los valores al francés y devuelve solo las claves que hayas cambiado.
Deja intactos los ajustes.
Traduce solo los mensajes y las etiquetas que leen las personas al alemán. Deja intactos los ajustes, identificadores, rutas y números.
Conviene saber
- Varios idiomas en un mismo trabajo. TOML admite varios idiomas: el plan añade junto a cada clave original otra clave con un sufijo de idioma, como
hello_fr. YAML admite varios idiomas cuando el archivo ya tiene una sección para cada uno (en:,fr:,de:). Un archivo típico de Rails con una única raízen:requiere un idioma por subida. Si pides más, puede que el plan no se pueda preparar. Procesa el archivo una vez por idioma: tu glosario se conserva. - Filtro de salida. Disponible para YAML («solo las claves que hayas cambiado»). TOML devuelve el archivo completo.
- Los comentarios YAML no se conservan. El archivo se lee como datos y se vuelve a escribir como YAML limpio: se eliminan los comentarios y la sangría y las comillas se normalizan a dos espacios. Conserva el archivo original con comentarios como referencia. Los anclajes siguen siendo válidos, aunque sus nombres pueden cambiar.
- Normalmente, los comentarios TOML se conservan, porque cada cadena se sustituye en su propia línea. Si un valor no se puede colocar así, por ejemplo, si está dentro de una tabla en línea, el archivo se vuelve a escribir con un formato normalizado y se eliminan los comentarios. El plan te avisa cuando esto ocurre.
- Límite. 4 MB.
Relacionado
- JSON, ARB y JSON Lines y Java, INI, Fluent y PHP para otros formatos de configuración y archivos de idioma.
- Markdown para el contenido junto a la configuración.
- Todos los formatos de archivo