Un glosario le da al motor de localización control preciso sobre términos específicos: ya sea para imponer una traducción exacta o para evitar por completo su traducción. Los términos del glosario tienen prioridad sobre el criterio del modelo, así que el motor los aplica de forma consistente en cada solicitud.
Un glosario es propiedad de la organización: un contenedor con nombre que almacena términos y se aplica a un motor de localización al adjuntarlo. Un mismo glosario puede regir 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 cantidad de términos. |
| Término | Idioma de origen, idioma de destino, texto de origen, texto de destino, tipo, pista. |
Cuando el motor procesa una solicitud de traducción, recupera términos relevantes de cada glosario adjunto mediante búsqueda semántica: relaciona el significado del texto de entrada con los términos de origen almacenados, no con 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, para elementos no traducibles) |
| Tipo | custom_translation o non_translatable |
| Sugerencia | Contexto opcional para desambiguar el término (p. ej., "sustantivo, función del producto") |
Los glosarios son propiedad de la organización#
| Acción | Efecto |
|---|---|
| Crear un glosario | Existe a nivel de organización y no se aplica a nada hasta que se adjunta |
| Adjuntarlo a un motor | Cada uno de sus términos puede recuperarse para las traducciones de ese motor |
| Adjuntarlo a varios motores | Los mismos términos rigen a todos: editas una vez y todos los motores lo siguen |
| Adjuntar varios glosarios a un motor | Sus términos se combinan en un solo 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 algún motor todavía lo aplique: primero desvincúlalo. Al eliminarlo, sus términos se eliminan con él. |
| Eliminar un motor | Los glosarios y los términos permanecen. Le pertenecen a la organización, no al motor. |
El orden de vinculación no significa nada. Cuando dos glosarios adjuntos definen el mismo texto de origen para el mismo par de idiomas, cualquiera de los dos puede prevalecer: mantén cada término en un solo lugar.
Administra los glosarios en Glossaries dentro de la barra lateral de la organización. La pestaña Glossary de un motor muestra los términos que aplica actualmente y te permite adjuntar o desvincular glosarios.
Idiomas de origen#
Un glosario declara qué idiomas de origen cubre. Un custom_translation cuyo idioma de origen no sea uno de ellos se rechaza al guardarlo, en cualquier ruta, incluido el dashboard, la API, una sugerencia del motor aplicada y el provisioning. La comprobación usa la misma coincidencia flexible de idioma que en tiempo de lectura, así que un glosario que cubre en acepta un término en-US.
Deja vacíos los idiomas de origen y el glosario aceptará cualquier idioma de origen.
Los no traducibles están exentos: no hay una traducción en el idioma de origen que vincular. Además, se almacenan una sola vez con un idioma de destino comodín, sin importar qué destino 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 específica 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 suele elegir el sinónimo equivocado
No traducibles#
Evita que un término se traduzca. El motor conserva el texto de origen tal cual, en cualquier idioma de destino.
| Texto de origen | Texto de destino | Tipo |
|---|---|---|
| Lingo.dev | Lingo.dev | non_translatable |
| OAuth | OAuth | non_translatable |
| GraphQL | GraphQL | non_translatable |
Usa elementos no traducibles para:
- Nombres de marca y de productos
- 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 relacionan 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 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 variante.
Campo de sugerencia
Usa el campo de pista para desambiguar términos con varios significados. Por ejemplo, un término para "bank" con la pista "financial institution" no coincidirá con "river bank" en el texto de entrada.
Idiomas comodín#
Configura el idioma de origen o de destino como * para aplicar un término en todos los pares de idiomas.
Patrones comunes:
| 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 específica al alemán 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 simple de. Idiomas hermanos como de-DE y de-AT nunca comparten términos. Cuando coinciden varios, gana 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 conocer el comportamiento completo, incluida la regla de seguridad de script para traducciones personalizadas.
Glosarios vs. reglas vs. voces de marca#
Cada uno cumple una función distinta dentro de la configuración del motor:
| Glosario | Regla | Voz de marca | |
|---|---|---|---|
| Controla | Términos individuales | 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: prevalece sobre el criterio del modelo | Media: orienta al modelo | Mínima: aporta contexto |
| Ejemplo | "Deploy" → "Bereitstellen" | "Abbreviate Straße to Str." | "Use informal du, technical tone" |
Los tres son contenedores propiedad de la organización que un motor aplica por vinculación: los glosarios contienen términos, los rulesets contienen reglas y una voz de marca contiene un texto por idioma.
Prioridad de reglas
Los términos del glosario tienen la prioridad más alta en la jerarquía del motor. Si un término del glosario entra en conflicto con una regla, gana el glosario. Diseña 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 destino, y los incluye en el prompt. No necesitas parámetros adicionales.
| Llamada | Propósito |
|---|---|
POST /glossaries | Crear un glosario para la organización |
GET /organizations/:id/glossaries | Listar los glosarios de la organización con el recuento de términos y motores |
GET /glossaries/:id/glossary-items | Listar los términos de un glosario, agrupados por texto de origen |
POST /glossary-items con glossaryId | Agregar un término a un glosario |
PUT /engines/:id/glossaries | Reemplazar 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 | Listar cada término que un motor aplica actualmente |
ownerEngineId en POST /glossary-items todavía funciona: 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; adjuntar uno a un motor también requiere engine:edit en ese motor. Un permiso por glosario le da a alguien acceso de lectura y edición sobre un solo glosario, en lugar de sobre todos los glosarios de la organización. Consulta Roles & Permissions.
Administrar glosarios con MCP#
Si usas el servidor MCP de Lingo.dev, tu asistente de programación con IA puede administrar glosarios y sus términos directamente:
"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."