# General Translation Integrations: Configurar Mintlify
URL: https://generaltranslation.com/es/docs/integrations/mintlify/guides/configuring-mintlify.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: Cómo conectar un repositorio de documentación de Mintlify a General Translation y configurar idiomas y activadores de traducción.

Conecta el repositorio de GitHub que contiene la documentación de Mintlify a General Translation y luego elige tus idiomas y cómo se ejecutan las traducciones. El [Quickstart](/docs/integrations/mintlify/quickstart) muestra la forma más rápida de hacerlo; esta guía explica las opciones de configuración con más detalle.

La integración funciona sobre [Locadex](/docs/platform/locadex/quickstart), por lo que su repositorio y automatización se configuran desde **Project &gt; Integrations** y **Project &gt; Automations** en el panel de control.

## Antes de empezar [#before-start]

* Un [project](/docs/platform/dashboard/get-started) de General Translation.
* Un repositorio de GitHub con un proyecto de Mintlify válido. Locadex comprueba que el repositorio contenga un `docs.json` cuyo `$schema` apunte a Mintlify. Rechaza los proyectos que todavía usan el archivo heredado `mint.json` (migra primero a `docs.json`) o que parecen una aplicación de Next.js.

## Conecta y vincula tu repositorio [#connect]

1. En el panel de control, abre **Project &gt; Integrations &gt; Catálogo**.
2. Conecta GitHub y autoriza la GitHub App de General Translation en el repositorio que contiene tu documentación de Mintlify.
3. Abre **Project &gt; Automations** y elige **Generar traducciones y hacer push**.
4. Selecciona el repositorio, el directorio de destino y el framework **Mintlify**.

## Configura el directorio de destino [#target-directory]

Si tu `docs.json` está en la raíz del repositorio, establece **Directorio de destino** en `.`. Si tu documentación está en un subdirectorio, como en un monorepo, establece **Directorio de destino** en esa ruta para que Locadex trabaje con la carpeta correcta. (Consulta [Usar Locadex en un monorepo](/docs/platform/locadex/guides/using-in-monorepos)).

## Elige idiomas [#languages]

Configura la **configuración regional de origen** (el idioma en el que está escrita tu documentación) y los **idiomas de destino** a los que quieres traducir.

Mintlify admite un conjunto fijo de códigos de idioma, y General Translation asigna las configuraciones regionales que elijas a esos códigos. Solo se pueden usar las configuraciones regionales que correspondan a un idioma compatible con Mintlify. (Consulta [Locales](/docs/integrations/mintlify/reference/locales)).

Para cambiar los idiomas más adelante, consulta [Gestionar traducciones](/docs/integrations/mintlify/guides/managing-translations).

## Elegir el layout de URL para la configuración regional predeterminada [#default-locale-url]

Cuando ejecutas la configuración inicial desde **Project &gt; Automatizaciones**, la opción **Hide configuración regional predeterminada in URL paths** está activada de forma predeterminada. Mantenla activada para servir las páginas de origen en sus rutas actuales y colocar solo las páginas traducidas en rutas con prefijo de configuración regional.

Desactívala para que todos los idiomas usen rutas con prefijo de configuración regional. Por ejemplo, las páginas de origen en inglés pasarán a estar en `/en/...`.

Tu elección queda registrada en el archivo `gt.config.json` generado. Esta opción determina cómo Locadex reestructura los archivos y la navegación de `docs.json`, así que revisa el pull request de configuración inicial antes de fusionarlo. (Consulta la [referencia de configuración](/docs/integrations/mintlify/reference/config#modes)).

## Configura cómo se ejecutan las traducciones [#triggers]

Locadex abre o actualiza pull requests con sus cambios. Reutiliza un PR abierto para la misma rama del workflow y abre uno nuevo después de que el PR anterior se fusiona o se cierra.

Las nuevas automatizaciones de traducción usan de forma predeterminada **Cambios en un pull request**, con **Auto-merge** desactivado. Elige **Se hace push de un commit** para traducir los cambios una vez que lleguen a la rama de destino y activa **Auto-merge** cuando las comprobaciones obligatorias fiables puedan proteger la rama. (Consulta [Auto-merging Locadex PRs](/docs/platform/locadex/guides/auto-merging-prs)).

## Next steps

- /docs/integrations/mintlify/guides/translating-content
- /docs/integrations/mintlify/guides/managing-translations
- /docs/integrations/mintlify/guides/using-translated-content

## Sitemap

See the full [sitemap](https://generaltranslation.com/sitemap.md) for all pages.
