Traduce tu documentación MDX

Un solo comando traduce todas las páginas MDX de tu documentación en minutos y mantiene tus componentes intactos

Empezar

content/docs/en-US/platform/locadex/quickstart.mdx

  1. ---
  2. title: Quickstart
  3. description: Use Locadex, the AI agent which connects your codebase, translations, and content sources. It’s the fastest way to run General Translation's full-stack localization.
  4. ---
  5. Locadex is the General Translation AI agent which connects your codebase, translations, and content sources.
  6. After setup, Locadex can configure your project and automatically translate it into the languages you choose.
  7. Locadex currently supports **Next.js**, **Mintlify**, **Fern**, and **Docusaurus** projects, along with React applications built with Vite, Gatsby, Redwood, React Router, TanStack Start, Bazel, esbuild, Rollup, Rolldown, or webpack.
  8. ## How Locadex works [#locadex-works]
  9. Locadex works inside your GitHub repository and automatically opens or updates PRs with generated changes. Three automation templates keep your localization up to date:
  10. - **Generate code** wraps source code with the right internationalization (i18n) library calls, such as `t()` and the `T` component.
  11. - **Generate translations and push** translates source content into every target language and updates translation files.
  12. - **Keep locales in sync** updates project files when languages are added or removed.

npx gt translatees, fr, ja

Traduce tu documentación a cualquier idioma en solo unos pasos

Solo dos comandos, sin modificar código ni configurar nada a mano

  1. Ejecuta el asistente de configuración inicial

    Ejecuta npx gt init en tu repositorio de documentación, elige MDX como formato de archivo y selecciona los idiomas de destino.

  2. Indica la ubicación de tus archivos

    El asistente añade a gt.config.json un patrón glob para tus archivos .mdx, con una carpeta [locale] para cada idioma. No necesitas modificar el código.

  3. Traduce y publica

    Ejecuta npx gt translate y la CLI traducirá el texto de cada archivo manteniendo intactos la sintaxis y los componentes de MDX. Incluye los archivos traducidos en un commit y publícalos junto con tu sitio de documentación.

¿Cómo mantengo las traducciones actualizadas en cada despliegue?

Transcripción

In Montreal, your French page shows the line you added this week in English. Your build script runs next build alone, so the line was never translated. General Translation keeps translations current when your CI runs npx gt translate before the build. Create an API key for CI with the file, context and translation queue permissions. Store it and your project ID as secrets in your CI provider. Add npx gt translate to your build script, before the build command. Run that build on every push to main, for example with a GitHub Actions workflow. Each build then ships current translations in Spanish, Japanese and French.

Las mejores empresas del mundo confían en nosotros

General Translation desarrolla una plataforma completa de localización para que los desarrolladores trabajen sin complicaciones

  • Más de 11 locales en el panel de control, la página de inicio e iOS

  • Más de 14 locales en la web y la documentación

  • Más de 47 locales en la plataforma y la documentación

  • Más de 2 locales en la web, iOS y Android

  • Más de 7 locales en la web y GTM

  • Bibliotecas de i18n de código abierto
  • Traducción sensible al contexto
  • Plataforma de revisión en equipo
  • Integraciones de contenido
  • Locadex Agent

Traducciones de nivel nativo con todo el contexto

Traducciones de la máxima calidad que tienen en cuenta tu producto y se contrastan con todo tu sitio de documentación

Contexto en cada capa

Las traducciones respetan tu voz y tus reglas de estilo, y tienen en cuenta el contexto y la lógica de tu producto.

Coherencia en todas las páginas

Cada página se revisa y se compara con el contenido de origen para comprobar su precisión y su coherencia con las demás páginas.

Revisa y edita con tu equipo

Puedes editar cada línea en el panel de control, con los idiomas en paralelo, historial y comentarios.

Traducción continua a medida que publicas actualizaciones

Ejecuta npx gt translate antes de compilar tu documentación. Cada ejecución traduce solo lo que ha cambiado, para que cada despliegue incluya todos los idiomas

  1. Sube un cambio en la documentación
  2. Tu compilación ejecuta la CLInpx gt translate
  3. Solo se traducen los cambios
  4. Desplegado en todos los idiomas

Conecta y localiza toda tu gama de productos

General Translation integra tu código, contenido, traducciones y procesos de revisión en una sola plataforma

Preguntas frecuentes

¿Traducir mi documentación es lo mismo que localizarla?

No exactamente. La traducción convierte tu contenido de un idioma a otro. La localización es el término general que engloba la traducción de software. Adapta todo el producto a cada configuración regional e incluye la internacionalización (i18n), que prepara tu sitio para admitir varias configuraciones regionales mediante el enrutamiento, la navegación, los formatos de fecha, las monedas, los plurales y otras convenciones.

General Translation se encarga de forma continua de la configuración inicial y el mantenimiento tanto de la localización como de la traducción.

Para conocer todo el proceso de configuración inicial de la localización, consulta Localización de MDX.

¿No puedo simplemente traducir mi documentación con una API de IA?

Para una traducción puntual, sí. Pero publicar documentación fiable cada semana, en todos los idiomas, requiere un sistema que complemente al modelo.

Tus páginas no son solo texto. Los componentes MDX, las importaciones y los bloques de código deben conservarse exactamente como se escribieron; el frontmatter debe mantener sus claves y los identificadores de encabezado como {#configure-client} deben seguir asociados a sus encabezados para que los enlaces directos no se rompan.

Tu documentación es un sitio web, no una página. La navegación necesita una versión por idioma, los códigos de configuración regional deben ajustarse a los que admite tu plataforma y «workspace» debe traducirse igual en la página 1 y en la 400 (y en tu aplicación, para la que también ofrecemos localización).

Tu documentación cambia cada semana. Cada actualización debería traducir solo lo que ha cambiado, conservar las modificaciones manuales de tus revisores e incorporarse a tu repositorio como parte de la compilación. Añadir un idioma más adelante no debería causar problemas con los que ya tienes.

Los distintos miembros del equipo necesitan control y visibilidad: poder ver cada línea junto a su texto de origen, consultar el historial y los comentarios, y contar con roles y reglas de tono para cada idioma.

General Translation gestiona todo esto end-to-end. Nos encargamos de miles de PRs de localización para nuestros clientes, para que puedan centrarse en crear un producto que encante al mundo.

¿Pueden nuestros traductores y revisores editar las traducciones?

Sí. Los revisores comparan los idiomas en paralelo en la Página de traducciones, editan cualquier línea directamente y añaden etiquetas, notas y comentarios. No hay límite de usuarios, por lo que todo tu equipo puede participar.

¿Cuánto tarda la configuración inicial?

Solo unos minutos, sin necesidad de una migración. Ejecuta npx gt init, elige los idiomas y ejecuta npx gt translate; a partir de ahí, la traducción se ejecuta a gran escala (Ramp tradujo 40.000 claves, millones de palabras, en unos minutos). También puedes delegar la configuración inicial en tu agente de programación con el botón Configuración inicial para agentes.

¿Qué idiomas son compatibles?

Cualquiera de las más de 120 configuraciones regionales que admite General Translation, incluidas variantes regionales como pt-BR y zh-Hant e idiomas de derecha a izquierda como el árabe y el hebreo. Inclúyelas en gt.config.json y añade más cuando quieras. Consulta las configuraciones regionales compatibles.

¿Se mantendrán actualizadas las traducciones a medida que cambie mi documentación?

Sí, de forma continua. Ejecuta npx gt translate en CI antes de compilar tu documentación. Solo traduce el contenido cuyo texto de origen ha cambiado y conserva tus cambios locales, para que cada lanzamiento esté disponible en todos los idiomas desde el momento en que se incorporan los cambios.

¿Respetarán las traducciones nuestra voz y terminología?

General Translation te permite configurar prompts personalizados con tu tono y estilo, y un glosario que establece los nombres de productos y la terminología clave. El contexto se aplica de forma coherente a todas tus traducciones, incluidas las de tu aplicación, sitio web, documentación, diapositivas y archivos de diseño.

¿La traducción hará que mis componentes MDX dejen de funcionar?

No. La CLI conserva toda la sintaxis y el formato de MDX al traducir el contenido legible por humanos, y los identificadores de encabezado explícitos, como {#id}, permanecen asociados a sus encabezados.

¿Cuánto cuesta?

Facturación por uso, sin cargos por usuario ni suscripciones. En Starter, la plataforma es gratuita, con proyectos, usuarios e idiomas ilimitados y una cuota de uso gratuita para empezar. Consulta la página de precios para ver todas las tarifas.

Traduce tu documentación MDX para un público global

Empieza gratis, sin cuotas mensuales