Documentación

Localización

Consulta el estado de los idiomas de cada proyecto, localiza las cadenas que necesitan trabajo y mantén las traducciones actualizadas con cada cambio.

Coroid traduce tu producto con el mismo motor que utiliza para sus propios trece idiomas. Tus catálogos permanecen como archivos en tu repositorio. Cualquier cambio en ellos llega como una tarea y un pull request, y solo las cadenas nuevas, modificadas o con errores se envían al modelo.

La opción Localización tiene su propia ubicación en el menú principal. Muestra los idiomas de cada Proyecto en una sola página y proporciona un área de trabajo para cada Proyecto. Los Proyectos que aún no son multilingües comienzan con la Asistente de internacionalización.

Todos los Proyectos en una sola página

Localización se abre mostrando los Proyectos que puedes consultar. Cada fila indica el idioma fuente del Proyecto, cuántos idiomas tiene, cuántas cadenas contiene y una barra que muestra el porcentaje de traducción en todos sus idiomas.

El pequeño globo junto a cada Proyecto muestra una cuenta de color por cada idioma: verde cuando el idioma está completo, un anillo verde azulado cuando faltan cadenas o hay cambios, y ámbar cuando algunas cadenas presentan errores.

Localización

Haga que cada proyecto hable los idiomas de sus usuarios y mantenga esa coherencia mientras el producto evoluciona.

Internacionalizar un proyecto2 proyectos · 6 idiomas · 135 cadenas pendientes
  • Tienda online
    inglés fuente · 5 idiomas · 1240 cadenas
    97,2 %
    135 cadenas pendientes
  • Centro de ayuda
    sueco fuente · 2 idiomas · 318 cadenas
    100 %
    Todos los idiomas completos
  • Aplicación de reservas
    Aún no internacionalizado
    Iniciar el asistente

Localización: los idiomas de cada proyecto aparecen como cuentas en un pequeño globo terráqueo, mostrando cuánto se ha traducido y qué aún necesita trabajo. Datos ilustrativos.

Un Proyecto sin traducciones indica Aún no internacionalizado. Los Propietarios y administradores inician el asistente desde esa fila, o desde Internacionalizar un Proyecto en la parte superior de la página.

El área de trabajo

Al abrir un Proyecto se muestra su área de trabajo: las secciones a la izquierda y la sección abierta junto a ellas.

SecciónPara qué sirve
ResumenEl estado de cada idioma y la acción necesaria para traducir lo que falta
CadenasTodas las cadenas en cada idioma, filtradas según el trabajo pendiente.
SugerenciasCorrecciones realizadas por colaboradores, a la espera de una decisión.
IntercambioArchivos para agencias, herramientas de traducción y hojas de cálculo, así como sus traducciones correspondientes.
ColaboradoresQuiénes pueden proponer redacción y en qué idiomas.
AutomatizacionesLas correcciones se aplican todas las noches y las cadenas traducidas se fusionan fuera de Coroid.
ConfiguraciónIdiomas, la comprobación de traducciones, acceso y gastos, y el archivo de configuración.

Las Sugerencias, Colaboradores y Automatizaciones se tratan en Mantener las traducciones mediante sugerencias.

El área de trabajo lee los catálogos en tu rama predeterminada. Cuando estos cambian, Coroid los vuelve a leer la próxima vez que alguien abra el Proyecto; hasta entonces, el Resumen indicará que los está leyendo. Coroid nunca ejecuta el código de tu repositorio para hacer esto. Los catálogos que utilizan un adaptador personalizado no se muestran; sus cadenas siguen procesándose en las tareas.

Resumen: una línea por idioma

El Resumen comienza con cuatro totales: cadenas de texto, idiomas, porcentaje traducido y cuántas cadenas necesitan trabajo. Debajo de ellos, cada idioma se muestra en una línea a través de tres etapas:

  1. Internacionalizar. El catálogo del idioma existe y contiene las cadenas de texto.
  2. Localizar. Cada cadena de texto se traduce a partir del texto fuente actual.
  3. Verificar. Ninguna cadena está dañada: todas se pueden analizar, conservan los marcadores de posición del origen y tienen las formas plurales que requiere el idioma.

El siguiente paso de un idioma es donde termina su línea. Un punto verde indica que está listo, un anillo verde azulado señala que necesita trabajo, y uno ámbar indica que hay cadenas rotas.

Localización
Tienda online
inglés origen · 5 idiomas · verificado hace 2 horas en 3f2c9a1
  • Vista general
  • Cadenas
  • Sugerencias
  • Intercambiar
  • Colaboradores
  • Automatizaciones
  • Configuración
Resumen

Cada idioma pasa por tres fases. El siguiente paso se determina según en qué etapa se encuentre.

Traducir 135 cadenas
Cadenas de texto1240en 3 catálogos
Idiomas4más 1 derivados
Traducidas97,2 %1020 revisado por personas
Requieren trabajo135entre 3 idiomas
  1. Englishinglés · en · Origen

    1240 cadenas de texto en 3 catálogos

  2. Deutschalemán · de
    100 %
    Completar
    Aprobado
  3. Françaisfrancés · fr
    98 %
    18 cadenas ausentes
    Aprobado
  4. 日本語japonés · ja
    96,3 %
    42 cadenas ausentes
    3 cadenas rotas
  5. العربيةárabe · ar
    94,6 %
    64 cadenas ausentes
    Aprobado
  6. British Englishinglés británico · en-GB · Derivado de inglés
    100 %
    Derivado y actualizado
    Aprobado

La vista general del área de trabajo: cada idioma en su línea a través de las fases de Internacionalizar, Localizar y Verificar, indicando la brecha que lo detiene. Datos ilustrativos.

La barra debajo de Localizar muestra desde el inicio: verde oscuro para las cadenas revisadas por personas, verde claro para las generadas por el modelo, ámbar para las que requieren atención, y la parte vacía para las que faltan. El texto bajo la barra indica la brecha, como 42 cadenas faltantes, y abre exactamente esas cadenas.

Los idiomas derivados de otro mediante reglas, como el inglés británico del inglés estadounidense, muestran Derivado y actualizado cuando dichas reglas se han aplicado a todas las cadenas.

Traducir lo que falta

Los propietarios y administradores ven una acción en la parte superior del Resumen: Traducir con el número de cadenas que necesitan trabajo: faltantes, modificadas en el origen o dañadas. Las traduce en el entorno de trabajo, en dos pasos:

  1. Memoria de traducción. Una cadena que otro proyecto de su organización ya haya traducido, con exactamente el mismo texto fuente, reutiliza esa traducción. Las traducciones humanas prevalecen sobre las automáticas. Esto evita llamadas al modelo y no genera coste alguno.
  2. El modelo Traductor. El motor almacenado en su repositorio traduce el resto a través de la puerta de enlace de traducción, comprobando cada respuesta respecto a los marcadores de posición y las formas plurales.

Mientras se ejecuta, un panel bajo los totales muestra cuántas cadenas se han generado y cuánto ha costado la ejecución; además, la barra de cada idioma se llena con tinta rayada a medida que llegan sus cadenas. Detener traducción finaliza la ejecución; lo que se ha generado permanece.

Localización
Tienda online
inglés origen · 5 idiomas · verificado hace 2 horas en 3f2c9a1
  • Vista general
  • Cadenas
  • Sugerencias
  • Intercambiar
  • Colaboradores
  • Automatizaciones
  • Configuración
Resumen

Cada idioma pasa por tres fases. El siguiente paso se determina según en qué etapa se encuentre.

Detener la traducción
La traducción automática está en curso

Cadenas escritas hasta ahora: 71 de 133

Reutilizado de la memoria de traducción sin coste: 26 · 0,04 US$ gastados del límite de 5,00 US$

  1. Deutschalemán · de
    Completar
  2. Françaisfrancés · fr
    Las traducciones están listas para confirmar: 24
  3. 日本語japonés · ja
    Traduciendo: 28 de 45 escritos
  4. العربيةárabe · ar
    Traduciendo: 19 de 64 escritos

La vista general durante la ejecución de la traducción automática: la prensa funciona, cada idioma se llena de tinta rayada a medida que llegan las cadenas de texto, y la memoria de traducción reproduce lo que ya han dicho otros proyectos. Datos ilustrativos.

Las traducciones no van directamente a su repositorio. Esperan a que Confirmar junto con el resto de sus cambios, marcados como traducciones automáticas, para que pueda revisarlos en Cadenas primero. Una cadena que ya haya sido editada o sugerida por un colaborador queda bajo su responsabilidad.

Cadenas

Cadenas muestra cada cadena con su texto fuente y su valor en un idioma concreto. Se abre en Requiere trabajo: las cadenas que faltan, cuyo texto fuente ha cambiado, que están dañadas o que siguen siendo idénticas al texto fuente. Seleccione otro idioma, un catálogo o busque por claves y texto.

EstadoSignificado
FaltanteLa cadena no tiene traducción
Texto fuente modificadoEl texto fuente cambió después de traducir la cadena
DañadaNo se puede analizar, sus marcadores difieren del texto fuente o sus formas plurales no son válidas para el idioma
Idéntica al texto fuenteEs idéntica al texto fuente
AutomáticaUn modelo la generó y nadie la ha revisado
RevisadaUna persona la escribió o corrigió
DerivadaLas reglas la generaron a partir de otro idioma

Seleccione una cadena para verla en todos los idiomas. Los marcadores y la sintaxis aparecen como chips bloqueados, ya que deben permanecer intactos durante la traducción. Para el idioma elegido, los detalles también indican quién escribió el valor, qué le ocurre y, en el caso de mensajes plurales, qué formas plurales necesita el idioma.

Localización
Tienda online
inglés origen · 5 idiomas · verificado hace 2 horas en 3f2c9a1
  • Vista general
  • Cadenas
  • Sugerencias
  • Intercambiar
  • Colaboradores
  • Automatizaciones
  • Configuración
Cadenas de texto

Todas las cadenas de texto en todos los idiomas. Los filtros permiten centrarse únicamente en el trabajo relevante.

日本語Todos los catálogosBuscar claves y texto…
Necesitan trabajo45Faltante42Origen modificado0Dañado3Igual que el origen0Máquina1035Revisado160Todos1240
Origen日本語
Total: {amount}合計: {price}Dañado
Your cart is emptyAún sin traducciónFaltante
Welcome back, {name}Aún sin traducciónFaltante
Prices include <b>VAT</b>価格には<b>消費税</b>が含まれますDañado
Weekly dealsAún sin traducciónFaltante
checkout.total
Catálogo ui · label
Origen · inglés
Total: {amount}
  1. 日本語 · japonésDañado
    合計: {price}

    Escrito por un modelo · Los marcadores de posición difieren del origen

  2. DeutschRevisado
    Gesamt: {amount}
  3. FrançaisMáquina
    Total : {amount}
  4. العربيةMáquina
    الإجمالي: {amount}
  5. British EnglishDerivado
    Total: {amount}

Cadenas de texto en el área de trabajo, filtradas para mostrar las cadenas en japonés que necesitan trabajo; la cadena abierta muestra sus marcadores de posición como chips bloqueados y el valor en cada idioma. Datos ilustrativos.

Editar y confirmar

Los propietarios y administradores corrigen las traducciones en Cadenas. Seleccione una cadena y elija Editar en un idioma y guarde el cambio. El editor muestra los marcadores del texto fuente como chips que puede insertar y verifica el cambio mientras escribe: los marcadores, las formas plurales que necesita el idioma, los términos de su glosario y la longitud. Coroid lo verifica nuevamente frente a la rama predeterminada al guardar.

Sugerir en el editor propone una traducción para esa cadena: desde la memoria de traducción si otro proyecto la utiliza; en caso contrario, desde el modelo de traductor. Elija Usar esta para introducirla en el editor; nada se guarda hasta que guarde el cambio.

Los cambios guardados esperan en una barra bajo las cadenas, donde puede revisar o descartar each uno. Confirmar convierte todos ellos, junto con las sugerencias aprobadas de colaboradores y las traducciones automáticas, en una única tarea. La tarea aplica exactamente esos valores con el motor específico y abre un pull request. Una confirmación puede incluir hasta 5.000 cambios; el resto esperará a la siguiente. Hasta que ese pull request se fusione, las cadenas mostrarán No confirmado o En proceso de aplicación.

Una traducción automática confirmada sigue siendo una traducción automática en la caché del motor, por lo que sigue contando como Automática hasta que una persona la revise.

Para editar es necesario activar las contribuciones en el archivo de configuración; Asistente de internacionalización las activa de forma predeterminada. Los colaboradores también pueden sugerir una redacción mejor en su propio sitio.

Intercambiar archivos

Bajo Intercambio, descargue las cadenas para una agencia, una herramienta de traducción o una hoja de cálculo e importe sus traducciones de vuelta.

FormatoIdiomas por archivoÚselo para
XLIFF 1.2 y 2.0UnoHerramientas y agencias de traducción; los marcadores llegan como etiquetas bloqueadas
Gettext POUnoPoedit, Weblate y otras herramientas gettext
CSV y ExcelTodos los idiomasHojas de cálculo, con todos los idiomas lado a lado
JSONUnoClaves y traducciones
Catálogo de cadenas de AppleTodos los idiomasXcode
Archivo .strings de AppleUnoProyectos Xcode
Archivo strings.xml de AndroidUnoAndroid Studio
ARB de FlutterUnoFlutter

Una exportación contiene las cadenas que requieren trabajo o todas las cadenas. Los marcadores y los mensajes plurales se transfieren tal cual se escribieron.

Una importación muestra todas las filas antes de conservar nada. Las nuevas traducciones y cambios pueden ser aceptados. Coroid omite una clave que el proyecto no posee, una traducción realizada a partir de un origen que ha cambiado posteriormente, marcadores de posición rotos y mensajes plurales que carecen de la forma requerida por el idioma. Las filas aceptadas se convierten en cambios pendientes de Confirmar, como las ediciones realizadas en Cadenas.

JSON, los archivos .strings y los archivos de Android no indican qué idioma contienen. Coroid lo extrae del nombre del archivo, como storefront-de.json, o pregunta.

Revisar cada cambio

El Traducciones La comprobación en Control de Calidad se ejecuta en la fase de QA de la tarea y en las solicitudes de incorporación de cambios, y solo analiza las cadenas afectadas por un cambio. El asistente la activa de forma predeterminada una vez que se fusiona su pull request; Configuración muestra si está activada y la abre en Control de Calidad. En el Resumen, Ver la última comprobación bajo Verificar abre la ejecución más reciente.

Cada problema se convierte en un hallazgo con un código de incidencia:

CódigoSignificadoBloquea de forma predeterminada
missingLa cadena no tiene traducciónSí
invalid_syntaxLa traducción no se puede analizar, por ejemplo, por marcadores de posición rotosSí
placeholder_mismatchLos marcadores de posición difieren del origenSí
plural_categoriesFalta una forma plural requerida por el idiomaSí
staleEl origen cambió después de traducir la cadenaNo

Usted elige qué códigos bloquean en la configuración de la comprobación. El glosario y las reglas de longitud y de términos prohibidos informan sus propios códigos cuando su archivo de configuración los establece.

Traducir el texto del proceso de pagoTarea
Se han detectado incidencias
  • Abrirui · checkout.total · fr: missingTraducciones · No traducido
  • Abrirui · nav.deals · de: staleTraducciones · El origen cambió desde la traducción
  • En proceso de correcciónui · cart.items · ja: placeholder_mismatchTraducciones · Los marcadores diferén del origen
  • Corregidoui · cart.count · ar: plural_categoriesTraducciones · Faltan formas plurales para este locale

Hallazgos de calidad del control de traducciones, un código de incidencia por hallazgo. Datos ilustrativos.

Cuando un hallazgo de traducción bloquea una tarea, el agente desarrollador lo repara siempre de la misma manera: abre una sesión de traducción para la tarea y ejecuta el motor sobre las cadenas modificadas. Nunca edita los catálogos de destino manualmente.

El modelo Traductor

La traducción tiene su propio rol en los perfiles de AI, Traductor, junto a Arquitecto, Desarrollador, QA y Revisor. Por defecto utiliza Hy-MT2, un modelo de traducción, con GPT-6 Luna como respaldo, cuando la política de su organización lo permite. Cambie la asignación en un perfil de AI como cualquier otro rol.

El motor también agrupa las cadenas por tamaño, valida cada respuesta según sus marcadores de posición y reglas plurales, y reintenta o escala una cadena que falle.

Costos

Las traducciones están disponibles en todos los planes. Las llamadas de traducción pasan por la puerta de enlace de traducción de Coroid y se facturan como uso del modelo a su organización, igual que las ejecuciones de agentes. Las tareas de traducción cuentan hacia las horas de agente de su plan como cualquier otra tarea.

Con la ruta de Traductor predeterminada, traducir cuesta aproximadamente dos centavos por cada 1.000 cadenas por idioma. Traducir un catálogo de 2.000 cadenas a diez idiomas costó alrededor de 0,33 $ según nuestras mediciones.

  • Solo los cambios generan costos. El motor mantiene una caché indexada por el texto de origen, por lo que las cadenas sin cambios nunca se envían de nuevo.
  • Cada tarea y cada ejecución tienen un límite de traducción. La sesión de una tarea se detiene en su límite de gasto, 1 $ por defecto; una Traducir ejecución en el entorno de trabajo se detiene en 5 $. Un proyecto puede establecer un límite inferior en Configuración → Acceso y gasto.
  • La memoria de traducción no genera costos. Las cadenas que su organización ya haya traducido en otros lugares se reutilizan sin realizar una llamada al modelo.
  • La lectura no genera costos. El entorno de trabajo y la comprobación de Traducciones leen sus catálogos; no realizan llamadas al modelo.

Traducir fuera de Coroid

El motor es una herramienta de línea de comandos, coroid-i18n. Su propio CI puede ejecutar la misma versión fija con su propia clave de OpenRouter. Dentro de Coroid, las tareas siempre utilizan la puerta de enlace de traducción, por lo que los gastos y límites se gestionan en un único lugar.