# General Translation Integrations: Configuración URL: https://generaltranslation.com/es/docs/integrations/mintlify/reference/config.mdx Docs index: https://generaltranslation.com/llms.txt Description: Referencia para el `gt.config.json` que General Translation genera 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)* | ## 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'`. 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. ## 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" // 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.* ## Sitemap See the full [sitemap](https://generaltranslation.com/sitemap.md) for all pages.