Un glosario da al motor de localización un control preciso sobre términos concretos: puede imponer una traducción exacta o impedir que se traduzcan por completo. Los términos del glosario tienen prioridad sobre el criterio del propio modelo, así que el motor los aplica de forma coherente en cada solicitud.
Un glosario pertenece a la organización: es un contenedor con nombre que almacena términos y se aplica a un motor de localización mediante su vinculación. Un único glosario puede gobernar todos los motores que lo necesiten, y un motor puede aplicar varios.
Cómo funciona#
| Objeto | Campos |
|---|---|
| Glosario | Nombre, descripción y los idiomas de origen que cubre. Puede contener cualquier número de términos. |
| Término | Idioma de origen, idioma de destino, texto de origen, texto de destino, tipo e indicación. |
Cuando el motor procesa una solicitud de traducción, recupera términos relevantes de todos los glosarios vinculados mediante búsqueda semántica: compara el significado del texto de entrada con los términos de origen almacenados, no cadenas exactas.
| Campo | Descripción |
|---|---|
| Idioma de origen | El idioma del texto de origen, o * para cualquier origen |
| Idioma de destino | El idioma del texto de destino, o * para cualquier destino |
| Texto de origen | El término en el idioma de origen |
| Texto de destino | La traducción obligatoria (o el mismo término, si no debe traducirse) |
| Tipo | custom_translation o non_translatable |
| Pista | Contexto opcional para desambiguar el término (p. ej., "sustantivo, la funcionalidad del producto") |
Los glosarios pertenecen a la organización#
| Acción | Efecto |
|---|---|
| Crear un glosario | Existe a nivel de organización y no se aplica a nada hasta que se vincula |
| Vincularlo a un motor | Todos sus términos pueden recuperarse para las traducciones de ese motor |
| Vincularlo a varios motores | Los mismos términos gobiernan todos ellos: editas una vez y todos los motores lo siguen |
| Vincular varios glosarios a un motor | Sus términos se combinan en un único conjunto de recuperación |
| Desvincularlo de un motor | El motor deja de aplicarlo. El glosario y sus términos se conservan. |
| Eliminar un glosario | Se rechaza mientras haya algún motor que aún lo aplique: desvincúlalo primero. Al eliminarlo, sus términos se eliminan con él. |
| Eliminar un motor | Los glosarios y los términos se conservan. Pertenecen a la organización, no al motor. |
El orden de vinculación no tiene ningún significado. Cuando dos glosarios vinculados definen el mismo texto de origen para el mismo par de idiomas, cualquiera de los dos puede imponerse: mantén cada término en un único lugar.
Gestiona los glosarios en Glossaries desde la barra lateral de la organización. La pestaña Glossary de un motor muestra los términos que aplica en ese momento y te permite vincular o desvincular glosarios.
Idiomas de origen#
Un glosario define qué idiomas de origen cubre. Un custom_translation cuyo idioma de origen no sea uno de ellos se rechaza al escribirlo, por cualquier vía, incluido el panel, la API, una sugerencia del motor aplicada y el aprovisionamiento. La comprobación usa la misma coincidencia flexible de idioma que en tiempo de lectura, así que un glosario que cubra en acepta un término en-US.
Si dejas vacíos los idiomas de origen, el glosario acepta cualquier idioma de origen.
Los no traducibles están exentos: no hay ninguna traducción del idioma de origen que vincular. Además, se almacenan una sola vez con un idioma de destino comodín, independientemente del destino que envíes: el término queda protegido en todos los idiomas, así que las copias por idioma serían duplicados.
Tipos de glosario#
Traducciones personalizadas#
Fuerza una traducción concreta para un término. El motor siempre usa tu traducción en lugar de la del modelo.
| Texto de origen | Texto de destino | Idioma de origen | Idioma de destino |
|---|---|---|---|
| Deploy | Bereitstellen | en | de |
| 911 | 112 | en | de |
| workspace | espace de travail | en | fr |
Usa traducciones personalizadas para:
- Terminología de producto con traducciones ya establecidas
- Adaptaciones culturales (números de emergencia, unidades de medida)
- Términos en los que el modelo elige sistemáticamente el sinónimo equivocado
No traducibles#
Evita que se traduzca un término. El motor mantiene el texto de origen tal cual en todos los idiomas de destino.
| Texto de origen | Texto de destino | Tipo |
|---|---|---|
| Lingo.dev | Lingo.dev | non_translatable |
| OAuth | OAuth | non_translatable |
| GraphQL | GraphQL | non_translatable |
Usa no traducibles para:
- Nombres de marca y de producto
- Protocolos y estándares técnicos
- Nombres propios que deben mantenerse en el idioma de origen
Coincidencia semántica#
Los términos del glosario se emparejan por significado, no por comparación exacta de cadenas. Cuando el motor recibe una solicitud de traducción, genera embeddings para el texto de entrada y encuentra términos con un texto de origen semánticamente similar.
Esto significa que un término para "Deploy" también coincide con "Deploying", "deployment" y "deploy your application", sin necesidad de crear entradas separadas para cada variación.
Campo de pista
Usa el campo de indicación para desambiguar términos con varios significados. Por ejemplo, un término para "bank" con la indicación "financial institution" no coincidirá con "river bank" en el texto de entrada.
Idiomas comodín#
Establece el idioma de origen o de destino en * para aplicar un término a todos los pares de idiomas.
Patrones habituales:
| Texto de origen | Idioma de origen | Idioma de destino | Caso de uso |
|---|---|---|---|
| Lingo.dev | * | * | No traduzcas nunca el nombre de la marca en ningún idioma |
| API | en | * | Mantén "API" sin traducir en todos los idiomas de destino |
| Deploy | en | de | Usa una traducción alemana concreta para este término en inglés |
Los términos comodín y los términos específicos por idioma se combinan; no se anulan entre sí.
Coincidencia de idiomas#
Los términos del glosario coinciden entre variantes regionales, no solo entre códigos de idioma exactos. Un término de se aplica a de-DE; un término de-DE se aplica a una solicitud genérica de. Idiomas hermanos como de-DE y de-AT nunca comparten términos. Cuando coinciden varios, prevalece la región predeterminada de CLDR. Las mismas reglas rigen las voces de marca, las reglas y las configuraciones de modelo. Consulta Locale Resolution para ver el comportamiento completo, incluida la regla de seguridad de script para traducciones personalizadas.
Glosario vs. reglas vs. voces de marca#
Cada uno cumple una función distinta en la configuración del motor:
| Glosario | Regla | Voz de marca | |
|---|---|---|---|
| Controla | Términos concretos | Convenciones lingüísticas | Tono y estilo generales |
| Granularidad | Por término | Por regla | Texto por idioma |
| Coincidencia | Semántica (por significado) | Se incluyen todas las reglas coincidentes | El único texto con mejor coincidencia |
| Prioridad | Máxima: anula el criterio del modelo | Media: guía al modelo | Mínima: aporta contexto |
| Ejemplo | "Deploy" → "Bereitstellen" | "Abrevia Straße como Str." | "Usa du informal, tono técnico" |
Los tres son contenedores que pertenecen a la organización y que un motor aplica mediante vinculación: los glosarios contienen términos, los rulesets contienen reglas y una voz de marca contiene un texto por idioma.
Prioridad de las reglas
Los términos del glosario tienen la máxima prioridad en la jerarquía del motor. Si un término del glosario entra en conflicto con una regla, el glosario se impone. Diseña las reglas para complementar el glosario, no para duplicarlo.
Uso de glosarios con la API#
Los términos del glosario se aplican automáticamente cuando llamas al localize endpoint. El motor recupera de los glosarios que aplica los términos semánticamente relevantes para el par de idioma de origen y de destino, y los incluye en el prompt. No hacen falta parámetros adicionales.
| Llamada | Propósito |
|---|---|
POST /glossaries | Crear un glosario para la organización |
GET /organizations/:id/glossaries | Mostrar los glosarios de la organización con el recuento de términos y motores |
GET /glossaries/:id/glossary-items | Mostrar los términos de un glosario, agrupados por texto de origen |
POST /glossary-items con glossaryId | Añadir un término a un glosario |
PUT /engines/:id/glossaries | Sustituir el conjunto de glosarios que aplica un motor |
DELETE /engines/:id/glossaries/:glossaryId | Dejar de aplicar un glosario a un motor |
GET /engines/:id/glossary-items | Mostrar todos los términos que un motor aplica en ese momento |
ownerEngineId en POST /glossary-items sigue funcionando: escribe en el glosario predeterminado del motor. Es preferible usar glossaryId.
Acceso#
org:glossary:read y org:glossary:edit rigen los glosarios y los términos que contienen; vincular uno a un motor también requiere engine:edit en ese motor. Un permiso por glosario permite a alguien leer y editar un único glosario en lugar de todos los glosarios de la organización. Consulta Roles & Permissions.
Gestión de glosarios con MCP#
Si usas el servidor MCP de Lingo.dev, tu asistente de programación con IA puede gestionar directamente los glosarios y sus términos:
"Create a glossary called Product terms covering English, and
apply it to the web engine.""Add a term: translate 'workspace' to 'espace de travail'
for English to French.""Mark 'GraphQL' as non-translatable for all locales."