Recopila traducciones para medirlas
Elige una fuente compatible y conserva el texto, las revisiones y el contexto necesarios para la medición.
Puedes empezar a medir las traducciones que tu equipo ya produce. Mantén el repositorio o el sistema de gestión de traducciones como lugar de referencia para el texto aceptado y elige cómo facilitar ese texto para las comprobaciones.
La unidad de trabajo útil es una versión identificable. Si un mensaje cambia después de evaluarlo, la respuesta anterior sigue refiriéndose a la redacción anterior. Conservar juntas las revisiones de origen y destino permite al equipo volver a las pruebas en lugar de reconstruirlas a partir del contenido más reciente.
Elige la fuente para tu flujo de trabajo #
| Punto de partida | Cómo medirlo |
|---|---|
| Actividad de Crowdin | Conecta Crowdin, configura una medición de eventos y examina el evento de Radar y la respuesta resultantes. Necesitas acceso a Radar para consultar sus pantallas. |
| Commits de GitHub | Conecta la GitHub App y configura las rutas de origen y destino. Los cambios en las claves de localización compatibles de la rama predeterminada se convierten en eventos. |
| Centro de ayuda de Zendesk | Conecta Zendesk. Los cambios en los artículos publicados se convierten en eventos del texto de origen o de la traducción en sus respectivos idiomas. |
| Archivos de traducción locales | Usa lingo score con un evaluador y un modelo configurados. Los resultados se guardan localmente, fuera del historial de eventos de Radar. |
| Traducciones de Lingo.dev | Cada localización completada ya constituye un evento. Revisión de traducciones de Lingo.dev explica cómo seleccionar motores, idiomas y una muestra. |
Si utilizas otra fuente, ponte en contacto con Lingo.dev para organizar la recopilación de eventos antes de automatizar la entrega.
Recopila la actividad de GitHub y Zendesk #
Para GitHub, instala la GitHub App en el repositorio que vayas a utilizar y conéctala a la organización de Lingo.dev. Incluye .lingo/config.json en un commit con el idioma de origen, los idiomas de destino y los patrones de los archivos de origen. Estas rutas permiten distinguir los cambios del texto de origen de los de las traducciones. Examina un evento después de que un commit en la rama predeterminada modifique una clave de localización configurada; un solo commit puede generar eventos para varias claves e idiomas.
La recopilación de actividad de GitHub admite archivos JSON, JSONC, YAML, YAML con una clave raíz, recursos de Android, .strings de Apple, ARB de Flutter, PHP y TypeScript. Cambios en el repositorio explica cómo los cambios se convierten en eventos.
Para Zendesk, autoriza la conexión con el centro de ayuda y activa sus idiomas. Radar registra por idioma la actividad de los artículos publicados. Abre el evento y contrasta la identidad del artículo, el idioma y el texto con los de Zendesk. Recopilar actividad no inicia por sí solo una sincronización de traducciones ni publica un nuevo artículo de destino.
Ambas conexiones mantienen las traducciones aceptadas en su sistema original. La medición examina los eventos registrados, sin actuar como paso de publicación.
Importa el historial del proveedor antes de medirlo #
Elige el historial del proveedor que necesites:
- GitHub: importa hasta los últimos 5000 commits de la rama predeterminada del repositorio. Cada commit se lee con la versión de
.lingo/config.jsonguardada en esa revisión. Los commits anteriores a la existencia de esa configuración no generan eventos. - Zendesk: importa las versiones publicadas actuales de los artículos, secciones y categorías existentes en cada idioma, con la fecha de su última actualización. Las revisiones anteriores y los borradores quedan fuera de esta recopilación.
Las nuevas conexiones de GitHub y Zendesk inician automáticamente la importación del historial. Sigue su progreso en la pestaña Configuración de la conexión. Para iniciar o reintentar una importación más adelante:
- En Studio, selecciona el repositorio o el centro de ayuda en Conectado y abre su pestaña Configuración.
- En Historial de commits para GitHub o Historial del centro de ayuda para Zendesk, selecciona Importar historial.
- Sigue el progreso de la importación, que muestra el número de elementos del proveedor en cola para su recopilación.
- Espera a que los eventos que quieras medir aparezcan en Radar → Registros y comprueba sus fechas, idiomas y texto.
Si la medición se ejecuta sobre eventos del proveedor, su pestaña Carga retroactiva también ofrece la opción Importar eventos, con los repositorios de GitHub y los centros de ayuda de Zendesk conectados. El historial se importa sin ejecutar mediciones. Cuando los eventos que necesites estén visibles, activa la medición e inicia una evaluación histórica para el intervalo correspondiente.
Si aparecen más eventos importados después de la evaluación histórica, vuelve a ejecutarla con la opción Solo eventos aún no medidos activada. Si la importación falla, comprueba su progreso y vuelve a intentarlo desde la misma pestaña Configuración. Comprueba la evaluación histórica y los resultados de la medición por separado de la importación.
Conserva la comparación #
Conserva juntos el ID del sistema de origen, el ID del contenido, el idioma de destino y la revisión de destino. Para comprobar el significado, añade la revisión de origen correspondiente. Para medir una edición, conserva el borrador a partir del cual se obtuvo el texto de destino editado.
Por ejemplo, en tu propio registro de seguimiento, la combinación de delivery.promise, el idioma fr y la revisión 42 identifica una entrada concreta del catálogo. La revisión 43 puede cambiar lo que se promete.
Registra quién o qué produjo la traducción cuando el flujo de trabajo facilite ese dato: una persona, un modelo, un proveedor de traducción automática o la reutilización de una memoria de traducción. Si el origen es desconocido, consérvalo como tal. Un usuario del proveedor que haya aprobado una traducción no es necesariamente la persona o el modelo que la escribió.
Aporta pruebas para la pregunta elegida #
El criterio determina qué hay que recopilar. Una comprobación ortográfica puede examinar solo el texto de destino. Una comprobación del significado necesita los textos de origen y destino emparejados, con contexto para resolver ambigüedades. Una comprobación terminológica necesita el término aplicable y sus límites de uso. Una comprobación de marcadores de posición necesita las reglas que estos deben cumplir, mientras que la distancia de edición requiere el par real de borrador y texto de destino.
Si una traducción no tiene su revisión de origen, déjala entre los casos pendientes de evaluación del significado y obtén el texto de origen antes de valorarla.
Verifica un evento recopilado #
- Configura la medición seleccionada antes de generar actividad de prueba en la fuente conectada.
- Busca el evento correspondiente. Compara su idioma, texto, procedencia y borrador disponible con tu propio registro.
- Abre la respuesta de la medición y lee el criterio junto al texto. Comprueba si la medición devolvió una respuesta, devolvió N/A o no llegó a completarse.
- Conserva los identificadores del evento y de la medición junto con las revisiones evaluadas. Aplica las correcciones aceptadas en el sistema donde se mantiene el texto.
Para la evaluación local, examina en su lugar el resultado guardado junto con los archivos de entrada y la configuración del evaluador; esta vía no crea ningún evento de Radar.
Si el flujo de trabajo se repite, conserva un registro de lo seleccionado, recopilado y medido. Medir traducciones desde tu proceso automatizado explica la recopilación y la recuperación, incluidos los reintentos y las revisiones modificadas.