# General Translation Integrations: Configuración URL: https://generaltranslation.com/es/docs/integrations/mintlify/reference/config.mdx --- title: Configuración description: Referencia del archivo gt.config.json que General Translation genera para un proyecto de Mintlify. Referencia de la configuración de la integración de Mintlify. --- # Configuración 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 generada depende del ajuste **Ocultar la configuración regional predeterminada en las rutas de URL** (consulta [Configuring Mintlify](/docs/integrations/mintlify/guides/configuring-mintlify)). 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 predeterminada. | Clave | Descripción | Ocultar configuración regional predeterminada | Mostrar configuración regional predeterminada | | --------------------------------------------------- | ---------------------------------------------------------------------------------------- | ------------------------------------------------------------ | --------------------------------------------------------------------------------- | | [`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)* | ## 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)). 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. * `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. * `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`. * `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. * `generateRedirects` — `./docs.json`. Genera redirecciones en `docs.json` para que los enlaces existentes sigan funcionando después de reestructurar la navegación. * `experimentalLocalizeStaticImports` — `true`. Localiza las rutas de importación estáticas (como los fragmentos). * `experimentalLocalizeStaticUrls` — `true`. Localiza las URL estáticas internas para que los enlaces sigan dentro del idioma del lector. * `experimentalLocalizeRelativeAssets` — `true`. Localiza las referencias relativas a recursos. * `experimentalAddHeaderAnchorIds` — `'mintlify'`. Añade ID de anclaje estables a los encabezados para que los enlaces dentro de la página sigan funcionando en todos los idiomas. * `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. ## Ejemplo [#example] La configuración generada para un proyecto con la configuración regional predeterminada oculta (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" // más archivos del repositorio como README.md, LICENSE.md, CHANGELOG.md ] } }, "defaultLocale": "en", "locales": ["es", "fr"], "options": { "mintlify": { "inferTitleFromFilename": true }, "jsonSchema": { "./docs.json": { "preset": "mintlify-hide-default" } }, "docsUrlPattern": "/[locale]", "docsImportPattern": "/snippets/[locale]", "generateRedirects": "./docs.json", "experimentalLocalizeStaticImports": true, "experimentalLocalizeStaticUrls": true, "experimentalLocalizeRelativeAssets": 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.*