# 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).

## Elige la estructura de URL de la configuración regional predeterminada [#default-locale-url]

La configuración iniciada desde **Project &gt; Automations** crea una estructura con prefijo de configuración regional para cada idioma, incluida la configuración regional de origen. Por ejemplo, las páginas de origen en inglés se sirven en `/en/...`.

Los proyectos existentes configurados para ocultar la configuración regional de origen siguen sirviendo las páginas de origen en sus rutas originales. Ese comportamiento queda registrado en el archivo `gt.config.json` generado; consulta la [referencia de configuración](/docs/integrations/mintlify/reference/config#options).

La estructura cambia la forma en que Locadex reestructura los archivos y la navegación de `docs.json`. Revisa la pull request de configuración antes de fusionarla.

## 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.
