# General Translation Integrations: Configuración
URL: https://generaltranslation.com/es/docs/integrations/mintlify/reference/config.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: Revisa el `gt.config.json` generado para un proyecto de Mintlify. Referencia para la configuración de la integración de Mintlify.

General Translation genera un `gt.config.json` para tu proyecto de Mintlify durante la configuración inicial; no tienes que escribirlo a mano. Esta página documenta qué contiene ese archivo para que puedas revisarlo o ajustarlo después de que se integre la pull request de configuración.

La configuración es un archivo de configuración estándar del CLI de General Translation. Cada clave compartida se documenta una sola vez en la [referencia de configuración del CLI](/docs/cli/reference/config); esta página solo cubre las opciones específicas de Mintlify y los dos modos que genera la integración.

## Modos [#modes]

La configuración iniciada desde **Project > Automations** genera el modo show-default-locale, en el que cada idioma usa una ruta con prefijo de configuración regional. Los proyectos existentes pueden usar el modo hide-default-locale, en el que las páginas de origen conservan sus rutas originales. Ambos modos traducen `docs.json` y todas las páginas `.mdx`/`.md`; la diferencia está en cómo se organizan los archivos y cómo se sirve la configuración regional de origen.

| Clave                                               | Descripción                                                                                   | hide-default-locale                                          | show-default-locale                                                               |
| --------------------------------------------------- | --------------------------------------------------------------------------------------------- | ------------------------------------------------------------ | --------------------------------------------------------------------------------- |
| [`files.mdx.include`](#files)                       | Patrones glob de las páginas que se traducirán.                                               | `./**/*.mdx`, `./**/*.md` (traducidos en el mismo documento) | `./[locale]/**/*.mdx`, `./snippets/[locale]/**/*.mdx` y sus equivalentes en `.md` |
| [`files.mdx.transform`](#files)                     | Reescribe las rutas de origen en carpetas de configuración regional.                          | `{ match: "^(snippets/)?(.*)$", replace: "$1{locale}/$2" }`  | *(ninguno)*                                                                       |
| [`options.jsonSchema`](#options)                    | Preajuste usado para localizar `docs.json`.                                                   | `mintlify-hide-default`                                      | `mintlify`                                                                        |
| [`options.docsHideDefaultLocaleImport`](#options)   | Oculta la configuración regional predeterminada en las importaciones.                         | `true`                                                       | *(omitido)*                                                                       |
| [`options.experimentalHideDefaultLocale`](#options) | Sirve la configuración regional predeterminada sin un prefijo de configuración regional.      | `true`                                                       | *(omitido)*                                                                       |
| [`options.experimentalClearLocaleDirs`](#options)   | Vacía los directorios de configuración regional generados antes de escribir las traducciones. | `true`                                                       | `true`                                                                            |

## Archivos [#files]

El bloque `files` le indica a la CLI de General Translation qué debe traducir. En un proyecto de Mintlify, siempre incluye `docs.json` y las páginas de documentación.

* `files.json.include` — siempre `['./docs.json']`. La navegación y las etiquetas de `docs.json` se localizan con el preajuste de `options.jsonSchema`.
* `files.mdx.include` — las páginas `.mdx` y `.md` que se deben traducir. En el modo hide-default-locale, esto abarca todo el árbol (`./**/*.mdx`, `./**/*.md`) y el transform mueve los archivos a carpetas de configuración regional; en el modo show-default-locale, apunta a las carpetas por configuración regional que ya existen.
* `files.mdx.transform` — en el modo hide-default-locale, reescribe cada ruta de origen en una carpeta `{locale}/` (manteniendo el prefijo inicial `snippets/` en su lugar). El modo show-default-locale omite el transform porque el contenido ya está en carpetas de configuración regional.
* `files.mdx.exclude` — las propias carpetas de configuración regional, además de archivos comunes del repositorio que nunca deben traducirse (consulta [Contenido admitido](/docs/integrations/mintlify/reference/supported-content#excluded)).

Cuando el repositorio contiene especificaciones OpenAPI 3.x en JSON o YAML, Locadex añade cada especificación de origen a `files.json` o `files.yaml`. También añade un transform que escribe la especificación traducida en el directorio de configuración regional correspondiente.

(Consulta la [referencia de configuración de la CLI](/docs/cli/reference/config) para ver la semántica completa de `files`, `include`, `exclude` y `transform`, y la [página de formato de MDX y Markdown](/docs/cli/reference/formats/mdx-md-files) y la [página de formato JSON](/docs/cli/reference/formats/json-files) para conocer el comportamiento específico de cada formato).

## Opciones [#options]

El bloque `options` configura el comportamiento específico de Mintlify. Estas claves se establecen para todos los proyectos de Mintlify, salvo que se indique que son específicas de un modo o condicionales.

* `mintlify.inferTitleFromFilename` — `true`. Obtiene el título de una página a partir de su nombre de archivo cuando la página no tiene un título explícito.
* [`mintlify.localizeRedirects`](#localized-redirects) — opcional y `false` de forma predeterminada. Las configuraciones generadas durante la preparación del proyecto lo omiten. Cuando está habilitado, agrega copias localizadas de las redirecciones para las páginas de origen renombradas o eliminadas en la ejecución actual de [`gt translate`](/docs/cli/reference/commands/translate).
* `mintlify.openapi.files` — rutas a las especificaciones OpenAPI 3.x detectadas *(cuando existen)*. Registra las especificaciones traducidas en Mintlify.
* `jsonSchema` — asigna `./docs.json` a un preajuste que sabe cómo localizar la navegación de Mintlify: `mintlify-hide-default` cuando la configuración regional predeterminada está oculta; de lo contrario, `mintlify`. Las especificaciones OpenAPI en JSON detectadas usan el preajuste `openapi`.
* `yamlSchema` — asigna las especificaciones OpenAPI en YAML detectadas al preajuste `openapi` *(cuando existen)*.
* `docsUrlPattern` — `/[locale]`. El patrón que se usa al localizar las URL de la documentación.
* `docsImportPattern` — `/snippets/[locale]`. El patrón que se usa al localizar las importaciones de fragmentos.
* `experimentalLocalizeStaticImports` — `true`. Localiza las rutas de importación estáticas (como los fragmentos).
* `experimentalLocalizeStaticUrls` — `{ "skipUntranslatedPages": true }`. Localiza las URL estáticas internas para que los enlaces sigan dentro del idioma del lector, pero conserva la URL original del enlace cuando la página de destino no tiene traducción.
* `experimentalLocalizeRelativeAssets` — `true`. Localiza las referencias relativas a recursos.
* `experimentalClearLocaleDirs` — `true`. Vacía los directorios de configuración regional generados antes de escribir las traducciones, para que las páginas de origen eliminadas no dejen atrás páginas traducidas obsoletas.
* `experimentalAddHeaderAnchorIds` — `'mintlify'`. Escribe la sintaxis nativa `{#id}` de Mintlify en cada encabezado traducido, usando el ID del encabezado original para que los enlaces dentro de la página mantengan el mismo destino en todos los idiomas. Los encabezados anidados en niveles profundos de JSX se desplazan al margen, porque Mintlify solo reconoce esta sintaxis con un máximo de tres espacios iniciales.
* `docsHideDefaultLocaleImport` — `true` *(solo en el modo hide-default-locale)*. Oculta la configuración regional predeterminada en las importaciones generadas.
* `experimentalHideDefaultLocale` — `true` *(solo en el modo hide-default-locale)*. Sirve la configuración regional predeterminada sin un prefijo de configuración regional.

### Redirecciones localizadas

**Tipo** `boolean` · **Opcional** · **Predeterminado** `false`

Establece `options.mintlify.localizeRedirects` en `true` para añadir copias por configuración regional de las entradas de redirección de la configuración regional de origen cuya página de origen se haya renombrado o eliminado en la misma ejecución de [`gt translate`](/docs/cli/reference/commands/translate). La CLI no modifica la redirección original, conserva su ancla y su valor `permanent`, y omite una configuración regional si la página de destino no tiene traducción.

Esta opción requiere que `options.docsUrlPattern` incluya la configuración regional en cada URL. `options.experimentalHideDefaultLocale` determina si la configuración regional de origen mantiene una ruta sin prefijo. Si falta `docsUrlPattern`, la CLI muestra una advertencia y no añade ninguna redirección.

## Ejemplo [#example]

El siguiente ejemplo muestra un proyecto existente configurado para ocultar la configuración regional de origen (inglés de origen; español y francés como destinos):

```json title="gt.config.json"
{
  "$schema": "https://assets.gtx.dev/config-schema.json",
  "files": {
    "json": {
      "include": ["./docs.json"]
    },
    "mdx": {
      "include": ["./**/*.mdx", "./**/*.md"],
      "transform": {
        "match": "^(snippets/)?(.*)$",
        "replace": "$1{locale}/$2"
      },
      "exclude": [
        "./[locales]/**/*.mdx",
        "./snippets/[locales]/**/*.mdx",
        "./[locales]/**/*.md",
        "./snippets/[locales]/**/*.md"
      ]
    }
  },
  "defaultLocale": "en",
  "locales": ["es", "fr"],
  "options": {
    "mintlify": {
      "inferTitleFromFilename": true,
      "localizeRedirects": true
    },
    "jsonSchema": { "./docs.json": { "preset": "mintlify-hide-default" } },
    "docsUrlPattern": "/[locale]",
    "docsImportPattern": "/snippets/[locale]",
    "experimentalLocalizeStaticImports": true,
    "experimentalLocalizeStaticUrls": {
      "skipUntranslatedPages": true
    },
    "experimentalLocalizeRelativeAssets": true,
    "experimentalClearLocaleDirs": true,
    "docsHideDefaultLocaleImport": true,
    "experimentalHideDefaultLocale": true,
    "experimentalAddHeaderAnchorIds": "mintlify"
  }
}
```

*Nota: después de la configuración inicial, la CLI sustituye el marcador de exclusión `[locales]` por sus configuraciones regionales de destino reales. Revise el `gt.config.json` generado y ajuste los archivos excluidos si su repositorio guarda contenido traducible en alguna de las rutas excluidas.*

## Sitemap

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