Actualiza una clave o un término de forma segura
Vuelve a traducir una parte seleccionada, conserva el contenido adyacente y revisa tanto la corrección prevista como el contenido que quedó sin cambios.
Una corrección acotada cumple su objetivo de dos maneras: mejora el contenido seleccionado y mantiene intacto el contenido aceptado que no está relacionado. Guarda la traducción existente y la revisión de su fuente para poder verificar ambas.
Usa esta guía para una clave o un término conocidos. Para los cambios habituales en la fuente, consulta conservación durante las actualizaciones. Si el trabajo ya se envió, revisa su estado de recuperación antes de solicitar más.
Incluye contenido adyacente aceptado en la comparación #
Un catálogo de ejemplo podría contener:
{
"account": {
"invitation": "Approval is required before access is granted.",
"support": "Contact support"
}
}Supongamos que solo necesitas corregir la redacción de la traducción de account.invitation. Guarda la traducción y la revisión de la fuente, incluida la redacción aceptada de account.support que quieres conservar.
Elige cómo corregir la redacción #
Para una corrección puntual y exacta, edita directamente el valor traducido, verifícalo en la aplicación y guarda el catálogo revisado en un commit. Las actualizaciones habituales de la fuente pueden conservar esa edición mientras el texto fuente del mensaje no cambie.
Para regenerar la traducción, primero proporciona la información necesaria para obtener un resultado diferente. Agrega un término aprobado al glosario del motor, corrige una instrucción recurrente en sus reglas o aclara el contexto JSONC de un mensaje. Luego actualiza las claves afectadas. Regenerar sin cambiar la fuente ni las indicaciones puede producir la misma redacción.
Delimita el significado del término antes de seleccionar mensajes #
Define el significado del término antes de seleccionar los mensajes. Por ejemplo, el “espacio de trabajo” de un producto puede referirse a un área compartida para proyectos, mientras que otro pasaje describe un espacio de trabajo físico. Registra en el glosario el significado previsto para el producto y el término traducido aprobado por el equipo; luego selecciona solo los mensajes que lo usen con ese significado. Límites de los términos profundiza en esa decisión.
Selecciona una clave de destino existente con la CLI #
En un proyecto configurado que usa esa fuente JSON en locales/en/account.json:
lingo push "locales/en/account.json" --key "account.invitation" --waitPara JSON, --key regenera las unidades seleccionadas incluso cuando el texto fuente no cambia. Actualiza esas claves en cada idioma configurado que ya tenga un archivo de destino e integra los nuevos valores en ese archivo.
Guarda las correcciones existentes antes de actualizar: la traducción capturada por este push puede reemplazarse en las claves seleccionadas. Para detectar cambios en la traducción realizados después del envío, omite --wait y revisa lingo pull --dry-run antes de recuperar los resultados. Consulta Clasificación de ediciones locales de pull para gestionar los conflictos.
Una actualización de claves mantiene intacta la versión de referencia de toda la fuente, tanto si push --wait recupera los resultados como si lo hace un pull separado. Por lo tanto, los cambios habituales pendientes en la fuente se seguirán enviando en un push posterior sin opciones adicionales.
Los patrones de claves admiten claves exactas, prefijos de objetos y comodines * que abarcan segmentos completos. auth.login puede incluir auth.login.title sin coincidir con auth.login_url. Pon los comodines entre comillas y repite --key para indicar varios patrones.
JSONC, TypeScript y PHP tienen el mismo comportamiento de actualización acotada. YAML y YAML con raíz por idioma pueden conservar las traducciones seleccionadas que no hayan cambiado; edita directamente la traducción para una corrección exacta o guarda las traducciones aceptadas antes de regenerar todo el archivo. Alcances de la CLI detalla el comportamiento de cada formato y define cómo escribir las claves.
Encuentra las claves o los archivos afectados por un término #
Encuentra los mensajes fuente que usan el término con el significado previsto y revisa su contexto. Selecciona las claves compatibles de esos mensajes con --key, usando el comando anterior. Para los formatos que requieren regenerar todo el archivo, guarda las traducciones aceptadas y actualiza los archivos fuente afectados, por ejemplo:
lingo push 'docs/en/workspaces.md' --force --waitUsa una ruta de la fuente que ya esté seleccionada en tu configuración. Esto reemplaza las traducciones de ese archivo para los idiomas de destino configurados. Compara el mensaje o archivo reescrito completo, incluido el texto que rodea al término.
Verifica los cambios, la conservación y el uso #
Compara cada ruta de destino modificada con la versión guardada. En el ejemplo, la invitación debe conservar el requisito de aprobación antes de permitir el acceso, y el mensaje de soporte debe coincidir con su versión de referencia aceptada. Si falta contenido adyacente o hay reescrituras inesperadas, revisa el alcance y la versión de referencia antes de aceptar los resultados.
Verifica las variables y los controles de claves: el bloqueo copia el texto fuente, la conservación mantiene un valor traducido y la opción de ignorar elimina contenido de la salida de un formato que admita esa función.
Carga la salida en el entorno de ejecución que la utiliza. Para los documentos, revisa el pasaje modificado, los enlaces y los componentes. Resuelve los conflictos de pull antes de reemplazar las ediciones locales; luego guarda en un commit las traducciones aceptadas junto con la revisión de su fuente y el Lockfile.