Actualiza una clave o un término de forma segura
Vuelve a traducir una parte seleccionada, conserva el contenido que la rodea y revisa tanto la corrección prevista como el contenido que queda sin cambios.
Una corrección acotada cumple dos objetivos: mejora el contenido seleccionado y mantiene intacto el contenido ya aceptado que no está relacionado. Guarda la traducción existente y la revisión del origen correspondiente para poder comprobar ambos aspectos.
Usa esta guía para una clave o un término concretos. Para los cambios habituales en el origen, consulta la conservación durante las actualizaciones. Si el trabajo ya se ha enviado, revisa su estado de recuperación antes de solicitar más.
Incluye contenido contiguo ya 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 hay que corregir la redacción de destino de account.invitation. Guarda la traducción y la revisión del origen, incluida la redacción ya 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 de destino, compruébalo en la aplicación y crea un commit con el catálogo revisado. Las actualizaciones habituales del origen pueden conservar esa edición mientras el texto de origen del mensaje no cambie.
Para regenerar las traducciones, proporciona primero la información necesaria para obtener un resultado distinto. Añade un término aprobado al glosario del motor, corrige una instrucción recurrente en sus reglas o aclara el contexto JSONC de un mensaje. Después, actualiza las claves afectadas. Si regeneras sin cambiar el origen ni las indicaciones, puedes obtener la misma redacción.
Delimita el significado del término antes de seleccionar mensajes #
Define el significado del término antes de seleccionar mensajes. Por ejemplo, el «espacio de trabajo» de un producto puede referirse a un área compartida para un proyecto, 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 de destino aprobado por el equipo. Después, selecciona solo los mensajes que lo usan con ese significado. En Límites de los términos se profundiza en esta decisión.
Selecciona una clave de destino existente con la CLI #
En un proyecto configurado que use ese origen JSON en locales/en/account.json:
lingo push "locales/en/account.json" --key "account.invitation" --waitEn JSON, --key regenera las unidades seleccionadas aunque el texto de origen no haya cambiado. 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: esta operación de push puede sustituir los valores de destino que haya capturado para las claves seleccionadas. Para detectar cambios en el destino realizados después del envío, omite --wait y revisa lingo pull --dry-run antes de recoger los resultados. Consulta la clasificación de ediciones locales de pull para gestionar los conflictos.
Una actualización de claves no modifica la versión de referencia del origen completo, tanto si la recoge push --wait como una operación de pull independiente. Por tanto, los cambios habituales pendientes en el origen se incluirán igualmente en una operación de push normal posterior.
Los patrones de clave admiten claves exactas, prefijos de objeto y comodines * de segmento completo. auth.login puede incluir auth.login.title sin coincidir con auth.login_url. Escribe los comodines entre comillas y repite --key para indicar varios patrones.
JSONC, TypeScript y PHP se comportan igual en las actualizaciones acotadas. YAML y YAML con el idioma en la raíz pueden conservar sin cambios las traducciones seleccionadas; edita directamente el destino para hacer una corrección exacta o guarda las traducciones aceptadas antes de regenerar el archivo completo. En Ámbitos de la CLI se detalla el comportamiento de cada formato y se define cómo escribir las claves.
Encuentra las claves o los archivos afectados por un término #
Busca los mensajes de origen que usan el término con el significado previsto y revisa su contexto. Selecciona las claves compatibles con --key mediante el comando anterior. En los formatos que requieren regenerar el archivo completo, guarda las traducciones aceptadas y actualiza los archivos de origen afectados, por ejemplo:
lingo push 'docs/en/workspaces.md' --force --waitUsa una ruta de origen que ya esté seleccionada en tu configuración. Esta operación sustituye las traducciones de ese archivo en los idiomas de destino configurados. Compara el mensaje o el archivo reescrito en su totalidad, incluido el texto que rodea al término.
Comprueba 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 seguir exigiendo aprobación antes de conceder acceso, y el mensaje de asistencia debe coincidir con su versión de referencia aceptada. Si falta contenido contiguo o hay reescrituras inesperadas, revisa el ámbito y la versión de referencia antes de aceptar los cambios.
Comprueba las variables y los controles de claves: el bloqueo copia el texto de origen, la conservación mantiene un valor de destino y la opción de ignorar elimina contenido de la salida de los formatos que la admiten.
Carga la salida en el entorno de ejecución que la utiliza. En los documentos, revisa el pasaje modificado, los enlaces y los componentes. Resuelve los conflictos de pull antes de sustituir las ediciones locales. Después, crea un commit con las traducciones aceptadas, su revisión del origen y el Lockfile.