Índice
Cómo AI Context y la gestión de Glossary mantienen la coherencia de su marca en todos los idiomas
La terminología de su producto es parte de su marca. Cuando un usuario ve "workspace" en inglés, "espacio de trabajo" en una pantalla en español y "área de trabajo" en otra, esta inconsistencia erosiona la confianza. Multiplíquelo en 15 idiomas y cientos de términos, y tendrá un problema de coherencia de marca que ninguna revisión manual puede resolver.
Este tutorial recorre las funciones de AI Context y gestión de Glossary de better-i18n — desde el análisis automatizado de sitios web hasta los flujos de trabajo de aprobación de términos y la sincronización con DeepL — para que pueda aplicar la consistencia de la terminología de marca a escala.
Lo que construirá
Al final de este tutorial, tendrá:
- Un perfil de contexto construido a partir del contenido real de su sitio web
- Un Glossary de términos de marca extraídos automáticamente y refinados por su equipo
- Un flujo de trabajo de aprobación que evita que los términos no aprobados lleguen a producción
- Una sincronización con DeepL que aplica su Glossary en las traducciones automáticas
Paso 1: Analice su sitio web con el Context Crawler
La forma más rápida de inicializar su Glossary de traducción es dejar que la AI analice lo que ya ha publicado.
Ejecutar un análisis de sitio web
En el panel de su proyecto de better-i18n, navegue a AI Context y seleccione Website Analysis. Ingrese la URL del sitio de marketing de su producto — por ejemplo, https://yourproduct.com.
El Context Crawler usa la API de Firecrawl para renderizar y extraer contenido de sus páginas. A diferencia de los simples scrapers HTML, Firecrawl maneja contenido renderizado con JavaScript, aplicaciones de una sola página y secciones cargadas dinámicamente. Sigue enlaces internos para construir un mapa completo del contenido de su sitio.
Lo que produce el análisis
Después del rastreo, la AI analiza el contenido extraído e identifica:
- Términos de marca — Nombres de productos, nombres de funciones y vocabulario acuñado (p. ej., "Workstream," "Sprint Board," "FlowMetrics")
- Vocabulario de navegación — Etiquetas de menú, CTAs y texto de migas de pan que los usuarios encuentran repetidamente
- Lenguaje específico del dominio — Términos del sector que usa su producto y que necesitan traducciones precisas y consistentes
- Señales de tono — Si su contenido es formal, informal o técnico, ayudando a la AI a traducir con el registro correcto
Cada término detectado incluye las URL de origen donde se encontró, una definición sugerida y datos de frecuencia que muestran con qué frecuencia aparece en su sitio.
Paso 2: Analice su repositorio para obtener contexto del framework
El análisis del sitio web captura su terminología pública. El análisis del repositorio captura el contexto técnico que hace las traducciones de AI más precisas.
Conecte su repositorio de GitHub
En la sección AI Context, seleccione Repository Analysis y proporcione la URL de su repositorio de GitHub. El analizador admite repositorios públicos directamente y repositorios privados a través de su integración con GitHub.
Lo que detecta el análisis del repositorio
El analizador examina su base de código para identificar:
- Framework y biblioteca i18n — ¿React con next-intl? ¿Vue con vue-i18n? ¿Flutter con archivos ARB? El stack detectado le indica a la AI qué sintaxis de interpolación, formato de pluralización y convenciones de mensajes usar.
- Estructura de namespace — Cómo su proyecto organiza las claves de traducción, para que las nuevas traducciones sigan los patrones existentes.
- Terminología existente — Términos ya utilizados en su base de código que deberían estar en el Glossary pero que quizás no lo estén.
- Patrones de cadenas — Formatos de fecha, formatos de números y enfoques de pluralización que informan las reglas de traducción.
Este contexto se adjunta a su proyecto y se usa automáticamente en cada trabajo de traducción de AI — sin necesidad de ingeniería de prompts manual.
Paso 3: Revisar y aprobar términos del Glossary
Ambos modos de análisis producen términos candidatos que ingresan a su Glossary como borradores. Aquí es donde el flujo de trabajo de términos se vuelve crítico.
El ciclo de vida del término
Cada término del Glossary sigue un ciclo de vida de cuatro etapas:
| Estado | Significado | ¿Aplicado en traducción? |
|---|---|---|
| Borrador | Recién creado o importado. Visible pero no aplicado. | No |
| Enviado | Listo para revisión. Indica completitud. | No |
| Aprobado | Revisado y aceptado. Activo en todos los flujos de trabajo. | Sí |
| Rechazado | No aceptado. Puede revisarse y volver a enviarse. | No |
Solo los términos aprobados se inyectan en los prompts de traducción de AI y se resaltan en el editor de revisión. Esto evita el problema común de gestión de Glossary donde los términos a medio terminar o disputados causan más inconsistencia de la que resuelven.
Revisión de términos propuestos
Después de un análisis de sitio web o repositorio, navegue a su Glossary y filtre por estado Borrador. Para cada término propuesto:
- Verifique el término de origen — ¿Es realmente un término de marca que necesita traducción controlada, o es un lenguaje genérico?
- Agregue o edite traducciones — El rastreador puede proponer traducciones basadas en patrones detectados. Revíselas y corríjalas para cada idioma de destino.
- Establezca reglas — Marque los términos como nunca-traducir si deben pasar sin cambios (nombres de productos, nombres de marca, identificadores técnicos).
- Envíe para aprobación — Una vez que esté satisfecho con la definición del término y las traducciones, envíelo para revisión del equipo.
- Apruebe o rechace — Un revisor (usted o un miembro del equipo) aprueba el término para su aplicación o lo rechaza con comentarios.
Ejemplo práctico
Suponga que su análisis de sitio web encuentra que "FlowMetrics" aparece 47 veces en su sitio. El rastreador lo propone como un término de marca con una marca de nunca-traducir. Usted lo revisa, confirma que la marca es correcta, agrega una definición ("Nuestro panel de análisis propietario") y lo aprueba. A partir de este momento:
- La traducción de AI nunca traducirá "FlowMetrics" en ningún idioma
- Los revisores humanos lo verán resaltado si lo traducen accidentalmente
- DeepL (después de la sincronización) lo preservará sin cambios
Paso 4: Importación masiva de términos existentes
Si está migrando desde otra herramienta de localización o tiene una hoja de cálculo con terminología aprobada, no necesita ingresar los términos uno por uno.
Importación JSON
Prepare un archivo JSON con sus términos estructurados como una matriz de objetos. Cada objeto incluye el término de origen, las traducciones de destino por idioma y metadatos opcionales (definición, parte del discurso, etiqueta de dominio, marca de nunca-traducir).
Suba el archivo a través de la función Import del Glossary. El importador:
- Valida las entradas contra los idiomas configurados de su proyecto
- Deduplica contra los términos del Glossary existentes
- Reporta conflictos antes de aplicar cambios
- Crea todos los términos importados con estado borrador
Después de la importación, ejecute el flujo de trabajo de aprobación para activar los términos.
Exportación JSON
Puede exportar su Glossary en cualquier momento como JSON estructurado — útil para copias de seguridad, migración, alimentar terminología en pipelines de documentación externos o compartir con agencias de traducción que trabajan fuera de better-i18n.
Paso 5: Sincronice su Glossary con DeepL
Si su pipeline de traducción incluye DeepL — ya sea a través de la traducción de AI de better-i18n o llamadas directas a la API de DeepL — la sincronización del Glossary garantiza que sus reglas de terminología se apliquen a nivel de proveedor.
Cómo funciona la sincronización
- Navegue a la configuración de su Glossary y seleccione Sync to Provider.
- better-i18n convierte sus términos aprobados al formato de Glossary de DeepL, mapeando automáticamente su Glossary multilingüe en la estructura de pares de idiomas que requiere DeepL.
- El Glossary se carga en DeepL a través de su API.
- Todas las traducciones posteriores de DeepL para sus pares de idiomas configurados respetarán su terminología.
Cuándo volver a sincronizar
Vuelva a sincronizar después de cualquier lote de cambios en el Glossary — nuevos términos aprobados, traducciones actualizadas o entradas eliminadas. La sincronización es idempotente: reemplaza el Glossary de DeepL anterior con el estado actual de sus términos aprobados.
Paso 6: Verifique la aplicación en la práctica
Con su Glossary aprobado y sincronizado, ejecute una traducción de prueba para ver la aplicación en acción.
Prueba de traducción de AI
Cree una cadena de prueba que incluya varios términos del Glossary. Ejecute la traducción de AI e inspeccione el resultado:
- Los términos aprobados deben aparecer exactamente como se definen en su Glossary
- Los términos de nunca-traducir deben pasar sin cambios
- El validador de consistencia debe mostrar cero violaciones del Glossary
Prueba en el editor de revisión
Abra el editor de revisión para una traducción que contenga términos del Glossary:
- Los términos del Glossary deben estar resaltados en línea
- Escribir una variante no aprobada debe activar una sugerencia de autocompletado con la traducción aprobada
- Los términos usados incorrectamente deben estar subrayados con un tooltip que explique el término aprobado
Mantenimiento de su Glossary a lo largo del tiempo
Un Glossary no es una herramienta que se configura y se olvida. Su producto evoluciona, y su terminología evoluciona con él.
Re-rastreo periódico
Ejecute el análisis del sitio web trimestralmente (o después de lanzamientos importantes de productos) para detectar nueva terminología. Los nuevos términos ingresan como borradores, manteniendo su Glossary actualizado sin interrumpir la aplicación existente.
Re-análisis del repositorio
Cuando adopte un nuevo framework, agregue una nueva biblioteca i18n o reestructure su jerarquía de namespace, ejecute el análisis del repositorio nuevamente para actualizar el perfil de contexto de su proyecto.
Retiro de términos
Cuando se cambia el nombre o se retira una función del producto, actualice o elimine el término del Glossary correspondiente. El flujo de trabajo de términos garantiza que los cambios pasen por revisión antes de afectar las traducciones.
Exportar para auditoría
Exporte periódicamente su Glossary como JSON para auditorías de cumplimiento, incorporación de agencias de traducción o copias de seguridad. La exportación incluye todos los metadatos de términos, traducciones e información de estado.
Conclusiones clave
- Comience con el análisis, no con la entrada manual. El análisis de sitios web y repositorios del Context Crawler puede inicializar un Glossary en horas en lugar de semanas.
- Use el flujo de trabajo de aprobación. El ciclo de vida de borrador a aprobado evita la contaminación del Glossary y garantiza que solo se apliquen los términos verificados.
- Sincronice con DeepL para la aplicación a nivel de proveedor. Sus reglas de terminología deben viajar con el motor de traducción, no solo con la herramienta de traducción.
- Mantenga continuamente. El re-rastreo y re-análisis periódicos mantienen su Glossary alineado con su producto en evolución.
La gestión del Glossary de traducción no se trata de crear un documento de referencia que los traductores puedan consultar. Se trata de construir un sistema de aplicación activo que haga que la consistencia de la terminología de marca sea automática en todos los idiomas, traductores y motores de traducción que usa su producto.
Comience con better-i18n y cree su primer Glossary impulsado por AI hoy — o explore las páginas de funciones de Glossary Management y Context Crawler para obtener detalles técnicos más profundos.
