# General Translation Knowledge Base: ¿Cómo traduzco un sitio de documentación de Mintlify? URL: https://generaltranslation.com/es/kb/translate-mintlify-docs.mdx Docs index: https://generaltranslation.com/llms.txt Description: Crea una copia traducida de cada página en una carpeta por idioma y añade cada idioma a la navegación de docs.json. El agente de IA de General Translation, Locadex, abre un pull request que añade las páginas traducidas y la navegación por idioma, y después traduce los cambios posteriores. Category: Herramientas para flujos de trabajo Last updated: 2026-10-21 Authors: Kevin Liu, Kevin Wu Published: 2026-10-21 Traducir un sitio de documentación de Mintlify implica crear una copia de cada página en una carpeta por idioma y añadir cada idioma a la lista `languages` de la navegación de `docs.json`. Las páginas combinan prosa con bloques de código, componentes MDX, frontmatter y enlaces, así que hay que traducir la prosa y los campos `title` y `description`, mantener intactos el código y los componentes, y hacer que los enlaces internos apunten a páginas en el idioma del lector. Además, cada vez que se edita una página de origen, sus traducciones quedan desactualizadas hasta que alguien las rehace. ## Video The video is narrated in English, with English captions. [How do I translate a Mintlify docs site?](https://caxecubb9c64cezv.public.blob.vercel-storage.com/films/kb-translate-mintlify-docs.mp4) (47 s) General Translation lets you choose languages, and Locadex opens a translation pull request. Authorize the General Translation app on GitHub, choose your docs repository in the Dashboard, create an automation from the Generate translations and push template for Mintlify, run its setup with your languages, and merge the pull request that adds a navigation entry per language and the translated pages. ## Formas de traducir un sitio de Mintlify | Enfoque | Qué hace bien | Qué te deja a ti | | ------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | La navegación `languages` de Mintlify, con traducción manual | Genera un selector de idioma y un árbol de páginas por idioma a partir de `docs.json` | Escribir cada página traducida en la carpeta de su idioma, escribir una navegación completa para cada idioma y llevar el control de qué traducciones quedaron desactualizadas tras cada edición del origen | | Google Translate | Traduce la página que pegues, sin configuración inicial | Traduce cada fragmento de forma aislada; separar la prosa del código y los componentes, así como escribir las carpetas y la navegación, corre por tu cuenta | | Un script sobre una API de IA (OpenAI API, Claude API) | Se le puede indicar que traduzca la prosa y no toque los bloques de código ni los componentes | Un script que proteja la sintaxis MDX, mantenga coherentes los términos del producto entre páginas, escriba las carpetas y la navegación, y se vuelva a ejecutar cuando cambien las páginas | | General Translation (Locadex) | Abre una pull request con las páginas traducidas, la navegación por idioma y los enlaces localizados, y luego traduce cada cambio según el disparador que elijas | Revisar y fusionar la pull request de configuración inicial, y después revisar las pull requests posteriores o activar **Auto-merge** | Usa la navegación de Mintlify con traducción manual cuando los traductores se encarguen de unas pocas páginas que rara vez cambian; usa Google Translate o un script puntual sobre una API de IA para hacer una única pasada por un sitio pequeño y estable. Usa General Translation cuando la documentación cambie en cada lanzamiento y todos los idiomas tengan que mantenerse al día. ## Traduce la documentación de Mintlify con Locadex General Translation traduce la documentación de Mintlify con Locadex, su agente de IA, que requiere un plan Starter o un Plan empresarial. 1. En el panel de control, conecta GitHub en **Project > Integrations > Catalog**. 2. En **Project > Automations**, crea una automatización a partir de **Generate translations and push** con **Mintlify** como framework. 3. Haz clic en **Run setup** y elige tus idiomas. 4. Revisa y fusiona el pull request que abre Locadex. El pull request añade un `gt.config.json`, una entrada de navegación en `docs.json` por cada idioma y las páginas traducidas. En ellas, el código y los componentes conservan su estructura, y los enlaces a páginas traducidas mantienen al lector en su idioma. El cuadro de diálogo **Run setup** para Mintlify incluye el interruptor **Hide default locale in URL paths**, activado de forma predeterminada: las páginas de origen conservan sus rutas actuales y cada idioma traducido tiene su propia carpeta de configuración regional, como `/es/...`. Si desactivas el interruptor, las páginas de origen también pasan a una carpeta de configuración regional (las páginas en inglés se trasladan a `/en/...`), lo que cambia sus URL. ## Mantén las traducciones actualizadas A partir de ese momento, Locadex se ejecuta cada vez que cambia un pull request (opción predeterminada) o cuando se hace push de un commit. Cada ejecución aplica los grupos de contexto asignados al proyecto (glosario y prompts personalizados), que tu aplicación puede compartir, para que los nombres de producto coincidan en ambos lados. Consulta el [Inicio rápido de Mintlify](/docs/integrations/mintlify/quickstart) para ver todos los pasos. ## Related questions - [¿Qué hace el agente Locadex?](https://generaltranslation.com/es/kb/what-is-locadex.mdx): Locadex es el agente de IA de General Translation que internacionaliza tu código y traduce tu contenido en tu repositorio de GitHub. Sus automatizaciones se ejecutan cuando se abre un pull request, cuando se hace push de un commit o cuando tú las inicias, y cada cambio llega como un pull request. - [¿Cómo traduzco contenido en Sanity?](https://generaltranslation.com/es/kb/translate-sanity-content.mdx): Almacena cada idioma como un documento propio o como un valor por configuración regional en cada campo y, después, traduce el origen a cada configuración regional de destino. El plugin gt-sanity de General Translation añade una acción Translate a Sanity Studio y, de forma predeterminada, importa cada traducción como un borrador para que lo revises y lo publiques. - [¿Cómo traduzco contenido en Storyblok?](https://generaltranslation.com/es/kb/translate-storyblok-content.mdx): En Storyblok, agrega tus idiomas de destino al espacio y asigna a cada campo traducible un valor por idioma. La integración de Storyblok de General Translation rellena esos valores desde el panel de control con Sincronizar y aplicar, como borradores que luego revisas y publicas en Storyblok. - [¿Cómo reviso y edito traducciones?](https://generaltranslation.com/es/kb/review-translations.mdx): Compara cada traducción con su texto de origen y con las demás configuraciones regionales, y corrige lo que no suene bien. Con General Translation, editas las traducciones en la Página de traducciones del panel de control y haces seguimiento de la revisión con etiquetas y comentarios. Después, la siguiente ejecución de traducción de Locadex, su Agente de IA, incorpora los cambios en un pull request. ## Previous and next questions - Previous question: [¿Cómo traduzco Google Slides?](https://generaltranslation.com/es/kb/translate-google-slides.mdx) - Next question: [¿Cómo traduzco una aplicación de Node.js?](https://generaltranslation.com/es/kb/translate-node-app.mdx) ## Sitemap See the [Knowledge Base sitemap](https://generaltranslation.com/es/kb/sitemap.md) for every article.