Glosario
La pestaña Glosario edita su CSV de glosario de usuario (glossary.userGlossary en la configuración). Las entradas aquí son sugerencias de terminología para translate-ui, proofread-ui y translate-docs (a través del glosario compartido). Las abreviaturas compactas de etiquetas de interfaz de usuario (por ejemplo, Size → Tam / Tam.) se mantienen para la traducción de la interfaz de usuario, pero se omiten al crear las indicaciones del documento, para que no empujen a los modelos hacia tokens {{…}} inventados en markdown/MDX.
La pestaña está oculta cuando glossary.userGlossary no está configurado.
Columnas CSV
| Columna | Significado |
|---|---|
| Cadena de idioma original | Término o frase de origen |
| locale | Configuración regional de destino, o * para todas las configuraciones regionales |
| Traducción | Traducción preferida |
| Contexto | Explicación opcional en el idioma de origen del significado o uso previsto. Se envía solo cuando este término coincide con el lote actual. |
| Forzar | Cuando está marcada, el término debe traducirse exactamente como se indica |
Añadir una fila
Utilice el formulario en la parte superior de la pestaña:
- Introduzca Original, idioma (
*o un código de idioma de destino) y Traducción. - Opcionalmente, añada Contexto (notas de uso) y marque Forzar.
- Haga clic en Añadir.
El archivo CSV se crea la primera vez que se añade si aún no existe.
Editar o eliminar
- Edición en línea — cambie los campos directamente en la tabla y haga clic en Guardar en esa fila.
- Eliminar — elimine una fila con el control de eliminación.
Los cambios surten efecto en la siguiente ejecución de translate-ui, proofread-ui, translate-docs o sync. La edición de una nota de Contexto (o glossary.contextFiles en la configuración) actualiza automáticamente las traducciones en caché para el idioma afectado; no necesita --force.
Exclusiones de verificación de etiquetas
Debajo de la tabla CSV, Exclusiones de verificación de etiquetas edita glossary.labelCheckSkips en la configuración del proyecto. Cada fila desactiva la verificación de etiquetas de interfaz de usuario bloqueadas para un término en inglés y una o más configuraciones regionales. Los globs de archivo opcionales limitan la exclusión a los documentos coincidentes. El término permanece como una sugerencia de aviso.
Añada una fila desde este panel, o use Añadir omisión en una fila de Fallos cuyo error sea Glossary label missing. Guardar escribe la configuración y deja un .backup.json con marca de tiempo a su lado. La siguiente ejecución de translate-docs o sync usa la lista. Una fila de caché marcada se reintenta con --recheck-glossary-warnings.
Mantén los archivos de contexto como resúmenes concisos en Markdown o texto plano fuera de los árboles docs[] traducidos. El texto se envía al LLM en cada solicitud coincidente; no incluyas secretos ni datos personales. Cómo se crean esos archivos y el CSV se explica en Glosario.
Filtros
Filtre por texto original, idioma (incluido *), texto de traducción o subcadena de Contexto, y luego haga clic en Aplicar.
Ediciones del panel y adición automática al glosario
Cuando corrige una cadena de interfaz de usuario en la pestaña Cadenas de interfaz de usuario o Plurales de interfaz de usuario, la siguiente ejecución de translate-ui puede añadir esa corrección al glosario automáticamente si glossary.autoAddUserEditedToGlossary es true. Utilice la pestaña Glosario para revisar, ajustar o eliminar esas filas añadidas automáticamente.