Control de deriva de claves de traducción

Usar cadenas en inglés como claves de traducción resulta cómodo hasta que alguien edita el inglés. La clave deja de coincidir, cada idioma cae de vuelta a la clave y la página se muestra en inglés sin error, sin aviso y sin ningún test fallido. La regresión es invisible hasta que la detecta un hablante nativo.

El archivo de la habilidad

---
name: translation-key-drift-guard
description: Úselo en cualquier sitio cuyas claves de traducción sean el texto original en inglés, donde editar un titular revierte en silencio todos los demás idiomas.
---

# Control de deriva de claves de traducción

Usar cadenas en inglés como claves de traducción resulta cómodo hasta que alguien edita el inglés. La clave deja de coincidir, cada idioma cae de vuelta a la clave y la página se muestra en inglés sin error, sin aviso y sin ningún test fallido. La regresión es invisible hasta que la detecta un hablante nativo.

## Qué necesitas antes

- El árbol de código que contiene las llamadas de traducción
- Los ficheros de idioma

## Método

1. Extraiga cada literal pasado a la función de traducción en plantillas y código de aplicación, contemplando ambos estilos de comillas.
2. Compare ese conjunto con las claves presentes en cada fichero de idioma. Todo lo que esté en el código pero falte en un idioma es una cadena que se mostrará en inglés en silencio.
3. Compruebe la paridad de placeholders en ambos sentidos: una clave con un placeholder con nombre cuya traducción lo ha perdido produce una frase rota en tiempo de ejecución, no un error.
4. Informe como huérfanas de las claves presentes en un idioma pero ausentes del código: se pueden podar sin riesgo y son señal de que se editó una cadena en inglés.
5. Integre la comprobación en el proceso de publicación para que termine con código distinto de cero. Una comprobación que nadie ejecuta no es una comprobación.
6. Demuestre que falla: borre una clave, confirme que la ejecución se rompe y restáurela. Una aserción que nunca se ha visto fallar no es de fiar.

## Qué produce esto

Un informe por idioma de claves ausentes, discrepancias de placeholders y huérfanas, con una salida distinta de cero capaz de bloquear un despliegue.

## Dónde falla esto

- Construir la comprobación pero no verificar nunca que realmente falla ante una regresión real
- Ignorar la paridad de placeholders, que rompe frases en lugar de limitarse a revertirlas
- Tratar las claves huérfanas como ruido cuando suelen ser la prueba de que se editó el texto en inglés sin actualizar los idiomas

---

De la biblioteca de habilidades de QuQi - https://www.quqi.io/es/skills/translation-key-drift-guard

Qué necesitas antes

• El árbol de código que contiene las llamadas de traducción
• Los ficheros de idioma

Método

1. 01 Extraiga cada literal pasado a la función de traducción en plantillas y código de aplicación, contemplando ambos estilos de comillas.
2. 02 Compare ese conjunto con las claves presentes en cada fichero de idioma. Todo lo que esté en el código pero falte en un idioma es una cadena que se mostrará en inglés en silencio.
3. 03 Compruebe la paridad de placeholders en ambos sentidos: una clave con un placeholder con nombre cuya traducción lo ha perdido produce una frase rota en tiempo de ejecución, no un error.
4. 04 Informe como huérfanas de las claves presentes en un idioma pero ausentes del código: se pueden podar sin riesgo y son señal de que se editó una cadena en inglés.
5. 05 Integre la comprobación en el proceso de publicación para que termine con código distinto de cero. Una comprobación que nadie ejecuta no es una comprobación.
6. 06 Demuestre que falla: borre una clave, confirme que la ejecución se rompe y restáurela. Una aserción que nunca se ha visto fallar no es de fiar.

Qué produce esto

Un informe por idioma de claves ausentes, discrepancias de placeholders y huérfanas, con una salida distinta de cero capaz de bloquear un despliegue.

Dónde falla esto

• Construir la comprobación pero no verificar nunca que realmente falla ante una regresión real
• Ignorar la paridad de placeholders, que rompe frases en lugar de limitarse a revertirlas
• Tratar las claves huérfanas como ruido cuando suelen ser la prueba de que se editó el texto en inglés sin actualizar los idiomas

Más en SEO internacional