quarto-dev/quarto-cli

¿Qué hace quarto-cli?

Útil al revisar un PR que añade o modifica un archivo de localización _language-<code>.yml en src/resources/language/. Ejecuta verificaciones estructurales que no requieren herramienta de traducción, más un control puntual opcional de TA cuando un MCP de traducción está conectado.

Uso

1. Verificación estructural automática (sin traducción):

   • Comprueba que el archivo YAML tenga todas las claves requeridas según la plantilla base.
   • Valida que los valores no estén vacíos ni tengan espacios superfluos.
   • Revisa que los marcadores de formato (como {{variable}}) coincidan con los del idioma base.
   • Informa de errores con la línea exacta y sugerencia de corrección.

2. Control puntual opcional de TA (con MCP de traducción):

   • Conecta un MCP de traducción (por ejemplo, DeepL o Google Translate).
   • Selecciona un subconjunto de cadenas (por ejemplo, las 5 primeras y las 5 últimas) para traducir automáticamente.
   • Compara la traducción automática con la propuesta en el archivo y señala diferencias significativas (por ejemplo, divergencia >30% en sentido semántico).
   • Marca las cadenas dudosas para revisión humana.

Requisitos

• Archivo de localización en src/resources/language/ con nombre _language-<code>.yml.
• (Opcional) Un MCP de traducción configurado para el control puntual.

Ejemplo de ejecución

# Verificación estructural
python scripts/check_locale.py src/resources/language/_language-es.yml

# Control puntual con MCP (ejemplo conceptual)
# (depende del MCP configurado)

Notas

• Las verificaciones estructurales son obligatorias para todos los PRs de localización.
• El control puntual de TA es una ayuda opcional; no reemplaza la revisión humana final.
• Para añadir un nuevo idioma, crear el archivo _language-<code>.yml basado en _language-en.yml.