From 3a2fcef990e5ec048b436011daba745b486f968d Mon Sep 17 00:00:00 2001
From: "locadex-agent[bot]"
<217277504+locadex-agent[bot]@users.noreply.github.com>
Date: Wed, 26 Nov 2025 03:16:52 +0000
Subject: [PATCH] docs(locadex): update translations
---
es/api-playground/mdx-setup.mdx | 32 +-
es/api-playground/overview.mdx | 8 +-
es/customize/custom-scripts.mdx | 2 +-
es/customize/react-components.mdx | 17 +-
es/deploy/ci.mdx | 108 ++--
es/deploy/personalization-setup.mdx | 24 +-
es/editor.mdx | 18 +-
es/guides/migrating-from-mdx.mdx | 28 +-
es/installation.mdx | 4 +-
es/migration.mdx | 86 +--
es/organize/navigation.mdx | 4 +-
es/organize/pages.mdx | 6 +-
es/organize/settings.mdx | 30 +-
fr/api-playground/mdx-setup.mdx | 42 +-
fr/api-playground/overview.mdx | 12 +-
fr/customize/custom-scripts.mdx | 2 +-
fr/customize/react-components.mdx | 19 +-
fr/deploy/ci.mdx | 110 ++--
fr/deploy/personalization-setup.mdx | 22 +-
fr/editor.mdx | 22 +-
fr/guides/migrating-from-mdx.mdx | 34 +-
fr/installation.mdx | 6 +-
fr/migration.mdx | 76 +--
fr/organize/navigation.mdx | 8 +-
fr/organize/pages.mdx | 4 +-
fr/organize/settings.mdx | 36 +-
gt-lock.json | 947 ++++++++++++++++------------
zh/api-playground/mdx-setup.mdx | 36 +-
zh/api-playground/overview.mdx | 14 +-
zh/customize/custom-scripts.mdx | 2 +-
zh/customize/react-components.mdx | 15 +-
zh/deploy/ci.mdx | 148 +++--
zh/deploy/personalization-setup.mdx | 24 +-
zh/editor.mdx | 16 +-
zh/guides/migrating-from-mdx.mdx | 30 +-
zh/installation.mdx | 6 +-
zh/migration.mdx | 84 +--
zh/organize/navigation.mdx | 4 +-
zh/organize/pages.mdx | 4 +-
zh/organize/settings.mdx | 34 +-
40 files changed, 1127 insertions(+), 997 deletions(-)
diff --git a/es/api-playground/mdx-setup.mdx b/es/api-playground/mdx-setup.mdx
index 2d593d26c..7a3930b65 100644
--- a/es/api-playground/mdx-setup.mdx
+++ b/es/api-playground/mdx-setup.mdx
@@ -1,18 +1,18 @@
---
-title: "Crear páginas de API manualmente"
-description: "Documenta endpoints de API manualmente con archivos MDX."
+title: "Crear páginas de API manuales"
+description: "Documenta endpoints de la API manualmente con archivos MDX."
keywords: ["Documentación de API", "Documentación de endpoints"]
---
-Puedes definir endpoints de API manualmente en páginas individuales. Este enfoque es útil para API pequeñas o para prototipos.
+Puedes definir endpoints de API manualmente en páginas MDX individuales. Este enfoque es útil para APIs pequeñas o para crear prototipos.
## Configuración
-
- En tu archivo `docs.json`, define la URL base y el método de autenticación.
+
+ En tu archivo `docs.json`, define tu URL base y el método de autenticación.
```json
"api": {
@@ -26,7 +26,7 @@ Puedes definir endpoints de API manualmente en páginas individuales. Este enfoq
}
```
- Si quieres ocultar el playground de la API, establece el campo `display` en `none`. No necesitas incluir un método de autenticación si ocultas el playground.
+ Si quieres ocultar el área de pruebas de la API, establece el campo `display` en `none`. No necesitas incluir un método de autenticación si ocultas el área de pruebas.
```json
"api": {
@@ -39,8 +39,8 @@ Puedes definir endpoints de API manualmente en páginas individuales. Este enfoq
Consulta la lista completa de configuraciones de la API en [Settings](/es/organize/settings#api-configurations).
-
- Crea un archivo `MDX` para cada endpoint. Define `title` y `api` en el frontmatter:
+
+ Crea un archivo MDX para cada endpoint. Define el `title` y la `api` en el frontmatter:
```mdx
---
@@ -49,7 +49,7 @@ Puedes definir endpoints de API manualmente en páginas individuales. Este enfoq
---
```
- Especifica los parámetros de ruta envolviéndolos entre `{}`:
+ Especifica los parámetros de ruta rodeándolos con `{}`:
```bash
https://api.example.com/v1/endpoint/{userId}
@@ -59,7 +59,7 @@ Puedes definir endpoints de API manualmente en páginas individuales. Este enfoq
Si tienes un campo `server` configurado en `docs.json`, puedes usar rutas relativas como `/v1/endpoint`.
- Para anular el modo de visualización global del playground en una página específica, agrega `playground` al frontmatter:
+ Para sobrescribir el modo de visualización global del área de pruebas para una página específica, agrega `playground` al frontmatter:
```mdx
---
@@ -71,13 +71,13 @@ Puedes definir endpoints de API manualmente en páginas individuales. Este enfoq
Opciones:
- * `playground: 'interactive'` - Muestra el playground interactivo (predeterminado)
- * `playground: 'simple'` - Muestra un endpoint copiable sin playground
- * `playground: 'none'` - Oculta el playground por completo
+ * `playground: 'interactive'` - Muestra el área de pruebas interactiva (predeterminado)
+ * `playground: 'simple'` - Muestra un endpoint que se puede copiar sin área de pruebas
+ * `playground: 'none'` - Oculta completamente el área de pruebas
- Usa los [campos de parámetros y respuestas](/es/components/fields) para documentar los parámetros y valores de retorno de tu endpoint.
+ Usa [parameter and response fields](/es/components/fields) para documentar los parámetros de tu endpoint y los valores de retorno.
```mdx
@@ -98,8 +98,8 @@ Puedes definir endpoints de API manualmente en páginas individuales. Este enfoq
```
-
- Agrega las páginas de endpoints a la navegación actualizando el campo `pages` en tu `docs.json`. Obtén más información sobre cómo estructurar tu documentación en [Navigation](/es/organize/navigation).
+
+ Agrega las páginas de tus endpoints a la navegación actualizando el campo `pages` en tu `docs.json`. Obtén más información sobre cómo estructurar tu documentación en [Navigation](/es/organize/navigation).
diff --git a/es/api-playground/overview.mdx b/es/api-playground/overview.mdx
index 0e46ffe1c..c85f2134d 100644
--- a/es/api-playground/overview.mdx
+++ b/es/api-playground/overview.mdx
@@ -149,17 +149,17 @@ Este ejemplo configura el área de pruebas de la API para que sea interactiva, c
### Páginas de endpoints personalizadas
-Cuando necesites más control sobre la documentación de tu API, usa la extensión `x-mint` en tu especificación de OpenAPI o crea páginas `MDX` individuales para tus endpoints.
+Cuando necesites más control sobre la documentación de tu API, usa la extensión `x-mint` en tu especificación OpenAPI o crea páginas MDX individuales para tus endpoints.
Ambas opciones te permiten:
-* Personalizar los metadatos de la página
+* Personalizar el metadata de la página
* Agregar contenido adicional, como ejemplos
* Controlar el comportamiento del playground por página
-Se recomienda la extensión `x-mint` para que toda la documentación de tu API se genere automáticamente a partir de tu especificación de OpenAPI y se mantenga en un solo archivo.
+Se recomienda la extensión `x-mint` para que toda la documentación de tu API se genere automáticamente a partir de tu especificación OpenAPI y se mantenga en un solo archivo.
-Se recomiendan las páginas `MDX` individuales para APIs pequeñas o cuando quieras probar cambios por página.
+Las páginas MDX individuales se recomiendan para APIs pequeñas o cuando quieras experimentar con cambios página por página.
## Lecturas adicionales
diff --git a/es/customize/custom-scripts.mdx b/es/customize/custom-scripts.mdx
index 182556120..19f1152af 100644
--- a/es/customize/custom-scripts.mdx
+++ b/es/customize/custom-scripts.mdx
@@ -29,7 +29,7 @@ Los valores arbitrarios de Tailwind CSS no están admitidos. Para valores person
## CSS personalizado
-Agrega archivos CSS a tu repositorio y los nombres de clase definidos se aplicarán y estarán disponibles en todos tus archivos `MDX`.
+Añade archivos CSS a tu repositorio y los nombres de clase que definas en ellos se aplicarán y estarán disponibles en todos tus archivos MDX.
### Agregar `style.css`
diff --git a/es/customize/react-components.mdx b/es/customize/react-components.mdx
index 082247b90..9c19da076 100644
--- a/es/customize/react-components.mdx
+++ b/es/customize/react-components.mdx
@@ -8,12 +8,11 @@ import { ColorGenerator } from "/snippets/color-generator.jsx";
Los [componentes de React](https://react.dev) son una forma eficaz de crear elementos interactivos y reutilizables en tu documentación.
-
## Uso de componentes de React
-Puedes construir componentes de React directamente en tus archivos `MDX` con [React hooks](https://react.dev/reference/react/hooks).
+Puedes crear componentes de React directamente en tus archivos MDX mediante [hooks de React](https://react.dev/reference/react/hooks).
### Ejemplo
@@ -99,15 +98,13 @@ El contador se representa como un componente interactivo de React.
## Importar componentes
-Para importar componentes de React en tus archivos `MDX`, los archivos de los componentes deben estar en la carpeta `snippets`. Luego puedes importarlos en cualquier página `MDX` de tu documentación. Más información en [fragmentos reutilizables](/es/create/reusable-snippets).
+Para importar componentes de React en tus archivos MDX, los archivos de los componentes deben estar ubicados en la carpeta `snippets`. Luego puedes importarlos en cualquier página MDX de tu documentación. Más información sobre [snippets reutilizables](/es/create/reusable-snippets).
-
- ### Ejemplo
-
+### Ejemplo
-Este ejemplo declara un componente `ColorGenerator` que utiliza varios hooks de React y luego lo emplea en un archivo `MDX`.
+Este ejemplo declara un componente `ColorGenerator` que usa varios hooks de React y luego lo utiliza en un archivo MDX.
-Crea el archivo `color-generator.jsx` en la carpeta `snippets`:
+Crea un archivo llamado `color-generator.jsx` en la carpeta `snippets`:
```mdx /snippets/color-generator.jsx [expandable]
export const ColorGenerator = () => {
@@ -222,7 +219,7 @@ export const ColorGenerator = () => {
}
```
-Importa el componente `ColorGenerator` y úsalo en un archivo `MDX`:
+Importa el componente `ColorGenerator` y úsalo en un archivo MDX:
```mdx
import { ColorGenerator } from "/snippets/color-generator.jsx"
@@ -230,7 +227,7 @@ import { ColorGenerator } from "/snippets/color-generator.jsx"
```
-El generador de colores se renderiza como un componente interactivo de React.
+El generador de colores se renderiza como un componente de React interactivo.
diff --git a/es/deploy/ci.mdx b/es/deploy/ci.mdx
index 82d2bac75..b1568ac43 100644
--- a/es/deploy/ci.mdx
+++ b/es/deploy/ci.mdx
@@ -45,15 +45,15 @@ Para ver los resultados de esta verificación, visita la página de resultados d
### Vale
-[Vale](https://vale.sh/) es un linter de prosa de código abierto basado en reglas que admite una variedad de tipos de documentos, incluidos Markdown y MDX.
+[Vale](https://vale.sh/) es un linter de prosa de código abierto basado en reglas que admite una variedad de tipos de documentos, incluidos Markdown y MDX. Usa Vale para comprobar la coherencia del estilo y el tono en tu documentación.
-Mintlify permite ejecutar Vale automáticamente en una verificación de CI y mostrar los resultados como un estado de comprobación.
+Mintlify admite ejecutar Vale automáticamente en una comprobación de CI y mostrar los resultados como un estado de comprobación.
#### Configuración
-Si tienes un archivo `.vale.ini` en el directorio raíz de contenido de tu implementación, la verificación de Vale CI utiliza ese archivo de configuración y cualquier archivo de configuración en el `stylesPath` que especifiques.
+Si tienes un archivo `.vale.ini` en el directorio raíz de contenido de tu implementación, la verificación de Vale CI usa ese archivo de configuración y cualquier archivo de configuración en el `stylesPath` que especifiques.
Si no tienes un archivo de configuración de Vale, se cargará automáticamente la configuración predeterminada.
@@ -61,21 +61,22 @@ Si no tienes un archivo de configuración de Vale, se cargará automáticamente
# Estilos de nivel superior
StylesPath = /app/styles
MinAlertLevel = suggestion
+# Etiquetas HTML en línea a ignorar (code/tt para fragmentos de código, img/url para enlaces/imágenes, a para etiquetas ancla)
IgnoredScopes = code, tt, img, url, a
-SkippedScopes = script, style, pre, figure, code
+SkippedScopes = script, style, pre, figure
# Vocabularios
Vocab = Mintlify
-# Esto es necesario ya que Vale no soporta oficialmente MDX
-[formats]
-mdx = md
+# Paquetes
+Packages = MDX
-# Soporte para MDX
+# Coincidir solo con MDX
[*.mdx]
BasedOnStyles = Vale
Vale.Terms = NO # Aplica reglas de mayúsculas muy estrictas, mantener desactivado
+# Ignorar patrones de sintaxis específicos de JSX/MDX
# `import ...`, `export ...`
# ``
# `...`
@@ -84,14 +85,14 @@ TokenIgnores = (?sm)((?:import|export) .+?$), \
(?)(?!`), \
(<[A-Z]\w+>.+?<\/[A-Z]\w+>)
-# Excluir:
+# Excluir JSX multilínea y llaves
# ``
BlockIgnores = (?sm)^(<\w+\n .*\s\/>)$, \
(?sm)^({.+.*})
-
-CommentDelimiters = {/*, */}
```
+El vocabulario predeterminado de Vale incluye las siguientes palabras.
+
```text Default Vale vocabulary expandable
Mintlify
mintlify
@@ -362,64 +363,67 @@ next
toc
```
+Para agregar tu propio vocabulario a la configuración predeterminada, crea un directorio `styles/config/vocabularies/Mintlify` con los archivos `accept.txt` y `reject.txt`.
+
+* `accept.txt`: Palabras que deben ser ignoradas por el linter Vale. Por ejemplo, nombres de productos o términos poco comunes.
+* `reject.txt`: Palabras que deben marcarse como errores. Por ejemplo, jerga o palabras que no son apropiadas para el tono de tu documentación.
+
```text Example Vale file structure
- - docs.json
- - .vale.ini
- - styles/...
- - text.md
+/your-project
+ |- docs.json
+ |- .vale.ini
+ |- styles/
+ |- config/
+ |- vocabularies/
+ |- Mintlify/
+ |- accept.txt
+ |- reject.txt
+ |- example-page.mdx
```
```text Example monorepo Vale file structure
- - main.ts
- - docs/
- - docs.json
- - .vale.ini
- - styles/...
- - text.md
- - test/
+/your-monorepo
+ |- main.ts
+ |- docs/
+ |- docs.json
+ |- .vale.ini
+ |- styles/
+ |- config/
+ |- vocabularies/
+ |- Mintlify/
+ |- accept.txt
+ |- reject.txt
+ |- example-page.mdx
+ |- test/
```
- Ten en cuenta que, por razones de seguridad, no se admiten `stylesPath` absolutos ni `stylesPath` que incluyan `..`. Usa rutas relativas e incluye el `stylesPath` en tu repositorio.
+ Por razones de seguridad, no se admite el uso de un `stylesPath` absoluto ni de un `stylesPath` que incluya `..`.
+
+ Usa rutas relativas e incluye el `stylesPath` en tu repositorio.
#### Paquetes
-Vale admite una variedad de [paquetes](https://vale.sh/docs/keys/packages) que se pueden usar para detectar errores ortográficos y de estilo.
-Cualquier paquete que incluyas en tu repositorio dentro del `stylesPath` correcto se instalará automáticamente y se usará en tu configuración de Vale.
+Vale es compatible con una variedad de [paquetes](https://vale.sh/docs/keys/packages), que puedes usar para detectar errores ortográficos y de estilo. Cualquier paquete que incluyas en tu repositorio bajo el `stylesPath` correcto se instala automáticamente y se utiliza en tu configuración de Vale.
-Para los paquetes que no estén incluidos en tu repositorio, puedes especificar cualquiera del [registro de paquetes de Vale](https://vale.sh/explorer); se descargarán automáticamente y se usarán en tu configuración de Vale.
+Para los paquetes que no estén incluidos en tu repositorio, puedes especificar cualquiera del [registro de paquetes de Vale](https://vale.sh/explorer); se descargarán automáticamente y se utilizarán en tu configuración de Vale.
- Ten en cuenta que, por razones de seguridad, no se admite la descarga automática de paquetes que no provengan del [registro de paquetes de Vale](https://vale.sh/explorer).
+ Por motivos de seguridad, **no** se admite la descarga automática de paquetes que no provengan del [registro de paquetes de Vale](https://vale.sh/explorer).
#### Vale con `MDX`
-Vale no admite `MDX` de forma nativa, pero el autor de Vale ha proporcionado una [extensión personalizada](https://github.com/errata-ai/MDX) para darle soporte.
-
-Si prefieres no usar esta extensión, puedes agregar las siguientes líneas al archivo `.vale.ini` configurado:
-
-```ini
-[formats]
-mdx = md
-
-[*.mdx]
-CommentDelimiters = {/*, */}
-
-TokenIgnores = (?sm)((?:import|export) .+?$), \
-(?)(?!`), \
-(<[A-Z]\w+>.+?<\/[A-Z]\w+>)
-
-BlockIgnores = (?sm)^(<\w+\n .*\s\/>)$, \
-(?sm)^({.+.*})
-```
+
+ La compatibilidad nativa con MDX requiere Vale 3.10.0 o posterior. Comprueba tu versión de Vale con `vale --version`.
+
-Para usar los comentarios en el documento de Vale, utiliza comentarios con estilo MDX `{/* ... */}`. Si en tu configuración usas el [ajuste](https://vale.sh/docs/keys/commentdelimiters) `CommentDelimiters = {/*, */}`, Vale interpretará automáticamente estos comentarios durante el análisis. Esto significa que puedes aprovechar fácilmente las funciones integradas de Vale, como omitir líneas o secciones.
+Para usar los comentarios dentro del documento de Vale en archivos MDX, utiliza comentarios al estilo MDX `{/* ... */}`:
```mdx
{/* vale off */}
@@ -429,14 +433,4 @@ Este texto es ignorado por Vale
{/* vale on */}
```
-Si decides no usar `CommentDelimiters` pero aun así usar los comentarios de Vale, debes envolver cualquier comentario de Vale en comentarios de MDX `{/* ... */}`. Por ejemplo:
-
-```mdx
-{/* */}
-
-Este texto es ignorado por Vale
-
-{/* */}
-```
-
-Estas etiquetas de comentario no son compatibles dentro de los componentes de Mintlify, pero funcionan correctamente en cualquier lugar del nivel base de un documento.
+Vale reconoce y respeta automáticamente estos comentarios en los archivos MDX sin necesidad de configuración adicional. Usa los comentarios para omitir líneas o secciones que el linter deba ignorar.
diff --git a/es/deploy/personalization-setup.mdx b/es/deploy/personalization-setup.mdx
index 621344779..f1822c987 100644
--- a/es/deploy/personalization-setup.mdx
+++ b/es/deploy/personalization-setup.mdx
@@ -49,10 +49,10 @@ groups: ["admin"]
- ## Formato de datos del usuario
+ ## Formato de datos de usuario
-Al implementar la personalización, tu sistema devuelve los datos del usuario en un formato específico que permite la personalización del contenido. Estos datos pueden enviarse como un objeto JSON sin procesar o dentro de un JWT (JSON Web Token) firmado, según el método de autenticación que utilices. La estructura de los datos es la misma en ambos casos.
+Al implementar la personalización, tu sistema devuelve los datos de usuario en un formato específico que permite la personalización del contenido. Estos datos se pueden enviar como un objeto JSON bruto o dentro de un JWT firmado, según tu método de handshake. La estructura de los datos es la misma en ambos casos.
```tsx
type User = {
@@ -69,8 +69,8 @@ type User = {
```
- Tiempo de expiración de la sesión en **segundos desde el epoch**. Si el usuario carga una página después de este momento, sus datos almacenados se eliminan automáticamente y debe volver a autenticarse.
- Para intercambios con JWT: Esto difiere del atributo `exp` del JWT, que determina cuándo se considera inválido un JWT. Por seguridad, establece el `exp` del JWT en una duración corta (10 segundos o menos). Usa `expiresAt` para la duración real de la sesión (de horas a semanas).
+ Tiempo de expiración de la sesión en **segundos desde la época Unix**. Si el usuario carga una página después de este tiempo, sus datos almacenados se eliminan automáticamente y debe volver a autenticarse.
+ Para intercambios con JWT: Esto es distinto del claim `exp` del JWT, que determina cuándo un JWT se considera inválido. Por seguridad, configura el claim `exp` del JWT con una duración corta (10 segundos o menos). Usa `expiresAt` para la duración real de la sesión (de horas a semanas).
@@ -80,7 +80,7 @@ type User = {
- Datos personalizados accesibles en tu contenido `MDX` mediante la variable `user`. Úsalos para personalizar dinámicamente tu documentación.
+ Datos personalizados accesibles en tu contenido MDX a través de la variable `user`. Úsalos para realizar personalización dinámica en toda tu documentación.
**Ejemplo básico**:
@@ -88,18 +88,18 @@ type User = {
{ "firstName": "Ronan", "company": "Acme Corp", "plan": "Enterprise" }
```
- **Uso en `MDX`**:
+ **Uso en MDX**:
```mdx
Welcome back, {user.firstName}! Your {user.plan} plan includes...
```
- Con los datos de `user` del ejemplo, se mostraría como: Welcome back, Ronan! Your Enterprise plan includes...
+ Con el ejemplo de datos de `user`, esto se renderizaría como: Welcome back, Ronan! Your Enterprise plan includes...
**Renderizado condicional avanzado**:
```jsx
- La autenticación es una función de Enterprise. {
+ Authentication is an enterprise feature. {
user.org === undefined
? <>To access this feature, first create an account at the Mintlify dashboard.
: user.org.plan !== 'enterprise'
@@ -109,12 +109,12 @@ type User = {
```
- La información en `user` solo está disponible para usuarios con sesión iniciada. Para los usuarios que no han iniciado sesión, el valor de `user` será `{}`. Para evitar que la página falle con usuarios desconectados, usa siempre el encadenamiento opcional en los campos de `user`. Por ejemplo, `{user.org?.plan}`.
+ La información en `user` solo está disponible para usuarios con sesión iniciada. Para usuarios sin iniciar sesión, el valor de `user` será `{}`. Para evitar que la página falle para usuarios sin iniciar sesión, usa siempre encadenamiento opcional en los campos de `user`. Por ejemplo, `{user.org?.plan}`.
- Valores específicos del usuario que rellenan por adelantado los campos del área de pruebas de la API. Ahorra tiempo a los usuarios al autocompletar sus datos cuando prueban APIs.
+ Valores específicos del usuario que rellenan previamente los campos del área de pruebas de la API. Ahorra tiempo a los usuarios al autocompletar sus datos cuando prueban APIs.
**Ejemplo**:
@@ -126,9 +126,9 @@ type User = {
}
```
- Si un usuario realiza solicitudes en un subdomain específico, puedes enviar `{ server: { subdomain: 'foo' } }` como un campo `apiPlaygroundInputs`. Este valor se rellenará por adelantado en cualquier página de la API con el valor `subdomain`.
+ Si un usuario realiza solicitudes en un subdominio específico, puedes enviar `{ server: { subdomain: 'foo' } }` como un campo `apiPlaygroundInputs`. Este valor se rellenará previamente en cualquier página de la API con el valor `subdomain`.
- Los campos `header`, `query` y `cookie` solo se rellenarán por adelantado si forman parte de tu [esquema de seguridad de OpenAPI](https://swagger.io/docs/specification/authentication/). Si un campo está en las secciones `Authorization` o `Server`, se rellenará por adelantado. Crear un parámetro de encabezado estándar llamado `Authorization` no habilitará esta función.
+ Los campos `header`, `query` y `cookie` solo se rellenarán previamente si forman parte de tu [esquema de seguridad de OpenAPI](https://swagger.io/docs/specification/authentication/). Si un campo está en las secciones `Authorization` o `Server`, se rellenará previamente. Crear un parámetro de encabezado estándar llamado `Authorization` no habilitará esta función.
diff --git a/es/editor.mdx b/es/editor.mdx
index acee71178..a47c448bd 100644
--- a/es/editor.mdx
+++ b/es/editor.mdx
@@ -72,15 +72,15 @@ El modo visual ofrece una experiencia WYSIWYG (what you see is what you get) en
- ### Modo Markdown
+ ### Markdown mode
-Modo Markdown proporciona acceso directo al código `MDX` subyacente de tu documentación. Este modo es ideal cuando necesitas un control preciso sobre las propiedades de los componentes o cuando prefieres escribir con la sintaxis de Markdown.
+Markdown mode ofrece acceso directo a los archivos que conforman tu documentación. Este modo es ideal cuando necesitas tener un control preciso sobre las propiedades de los componentes o cuando prefieres escribir con la sintaxis de MDX.
-
+
-
+
@@ -179,9 +179,9 @@ En este ejemplo, creaste una nueva página titulada Temas y quieres agregarla al
### Editar contenido
-Realiza cambios en tus páginas usando el modo visual o el Modo Markdown en el editor.
+Realiza cambios en tus páginas usando el modo visual o Markdown mode en el editor.
-En el modo visual, presiona / para abrir el menú de componentes. Agrega bloques de contenido, avisos, bloques de código y otros componentes para personalizar tu documentación.
+En el modo visual, presiona / para abrir el menú de componentes. Agrega bloques de contenido, notas, bloques de código y otros componentes para personalizar tu documentación.
@@ -189,13 +189,13 @@ En el modo visual, presiona / para abrir el menú de componentes. Agr
-En el Modo Markdown, editas directamente el `MDX` de tus páginas. Esto puede ser útil cuando necesitas:
+En Markdown mode, puedes editar directamente el MDX de tus páginas. Esto puede ser útil cuando necesitas:
* Definir propiedades específicas de los componentes
* Trabajar con componentes anidados complejos
-* Copiar y pegar contenido `MDX` de otras fuentes
+* Copiar y pegar contenido MDX desde otras fuentes
-Consulta [Formatear texto](/es/create/text) y [Formatear código](/es/create/code) para obtener más información sobre cómo escribir con la sintaxis de Markdown.
+Consulta [Formatear texto](/es/create/text) y [Formatear código](/es/create/code) para obtener más información sobre cómo escribir usando la sintaxis de MDX.
## Publica tus cambios
diff --git a/es/guides/migrating-from-mdx.mdx b/es/guides/migrating-from-mdx.mdx
index 3a00a1446..492bd0012 100644
--- a/es/guides/migrating-from-mdx.mdx
+++ b/es/guides/migrating-from-mdx.mdx
@@ -1,13 +1,13 @@
---
-title: "Migrar páginas de API en MDX a la navigation de OpenAPI"
+title: "Migrar páginas de API en MDX a navegación de OpenAPI"
sidebarTitle: "Migrar de MDX a OAS"
-description: "Migra a la generación automatizada de OpenAPI con navigation flexible."
-keywords: ["Migración de API", "mint migrate-mdx", "Migración a OpenAPI", "extensión x-mint"]
+description: "Migra a la generación automatizada de OpenAPI con una navegación flexible."
+keywords: ["Migración de API", "mint migrate-mdx", "Migración de OpenAPI", "Extensión x-mint"]
---
-Si actualmente usas páginas individuales en `MDX` para tus endpoints de API, puedes migrar a la generación automática de páginas a partir de tu especificación de OpenAPI, manteniendo la personalización de cada página. Esto puede ayudarte a reducir la cantidad de archivos que debes mantener y mejorar la coherencia de tu documentación de API.
+Si actualmente estás usando páginas MDX individuales para tus endpoints de API, puedes migrar a la generación automática de páginas a partir de tu especificación de OpenAPI, sin perder la posibilidad de personalizar cada página. Esto puede ayudarte a reducir la cantidad de archivos que necesitas mantener y a mejorar la coherencia de la documentación de tu API.
-Puedes definir metadata y contenido para cada endpoint en tu especificación de OpenAPI y organizar los endpoints donde quieras dentro de tu navigation.
+Puedes definir metadata y contenido para cada endpoint en tu especificación de OpenAPI y organizar los endpoints donde quieras dentro de tu navegación.
## Migración con la CLI
@@ -59,19 +59,19 @@ Este comando:
- Asegúrate de que tu especificación de OpenAPI sea válida e incluya todos los endpoints que deseas documentar.
+ Asegúrate de que tu especificación de OpenAPI sea válida e incluya todos los endpoints que quieras documentar.
- Para cualquier endpoint cuyo metadata o contenido quieras personalizar, añade la extensión `x-mint` al endpoint. Consulta [extensión x-mint](/es/api-playground/openapi-setup#x-mint-extension) para más detalles.
+ Para cualquier endpoint en el que quieras personalizar los metadatos o el contenido, agrega la extensión `x-mint` al endpoint. Consulta la [extensión x-mint](/es/api-playground/openapi-setup#x-mint-extension) para más detalles.
- Para cualquier endpoint que quieras excluir de tu documentación, añade la extensión `x-hidden` al endpoint.
+ Para cualquier endpoint que quieras excluir de tu documentación, agrega la extensión `x-hidden` al endpoint.
- Valida tu archivo de OpenAPI usando el [Swagger Editor](https://editor.swagger.io/) o la [CLI de Mint](https://www.npmjs.com/package/mint).
+ Valida tu archivo OpenAPI usando el [Swagger Editor](https://editor.swagger.io/) o la [CLI de Mint](https://www.npmjs.com/package/mint).
- Reemplaza las referencias a páginas `MDX` por endpoints de OpenAPI en tu `docs.json`.
+ Reemplaza las referencias a páginas MDX con endpoints de OpenAPI en tu `docs.json`.
```json
"navigation": {
@@ -96,7 +96,7 @@ Este comando:
- Después de verificar que tu nueva navegación funciona correctamente, elimina los archivos de endpoint `MDX` que ya no necesites.
+ Después de verificar que tu nueva navegación funciona correctamente, elimina los archivos MDX de endpoints que ya no necesites.
@@ -151,13 +151,13 @@ Organiza distintas versiones de la API usando pestañas o groups:
```
-Considera mantener páginas individuales de `MDX` cuando necesites:
+Considera mantener páginas MDX individuales cuando necesites:
* Contenido personalizado extenso por endpoint, como componentes de React o ejemplos largos.
* Diseños de página únicos.
* Enfoques de documentación experimentales para endpoints específicos.
-Para la mayoría de los casos de uso, la navegación de OpenAPI ofrece mejor facilidad de mantenimiento y coherencia.
\ No newline at end of file
+Para la mayoría de los casos de uso, la navigation de OpenAPI ofrece una mejor mantenibilidad y coherencia.
\ No newline at end of file
diff --git a/es/installation.mdx b/es/installation.mdx
index 29c4d7931..f5fd6cf2b 100644
--- a/es/installation.mdx
+++ b/es/installation.mdx
@@ -189,10 +189,10 @@ mint migrate-mdx
Este comando convierte páginas individuales de endpoints en MDX en páginas autogeneradas definidas en tu `docs.json`, mueve el contenido de MDX a la extensión `x-mint` en tu especificación de OpenAPI y actualiza tu navegación. Consulta [Migración desde MDX](/es/guides/migrating-from-mdx) para obtener información detallada.
- ## Formateo
+ ## Formato
-Al desarrollar localmente, recomendamos usar extensiones en tu IDE para reconocer y dar formato a archivos `MDX`.
+Durante el desarrollo local, recomendamos usar extensiones en tu IDE para reconocer y dar formato a archivos MDX.
Si usas Cursor, Windsurf o VS Code, recomendamos la [extensión MDX para VS Code](https://marketplace.visualstudio.com/items?itemName=unifiedjs.vscode-mdx) para el resaltado de sintaxis y [Prettier](https://marketplace.visualstudio.com/items?itemName=esbenp.prettier-vscode) para el formateo de código.
diff --git a/es/migration.mdx b/es/migration.mdx
index 426516b5e..3251e26d5 100644
--- a/es/migration.mdx
+++ b/es/migration.mdx
@@ -21,8 +21,8 @@ Esta guía te ayuda a trasladar tu documentación existente a Mintlify. Elige la
-
- Migra tu documentación utilizando el [paquete @mintlify/scraping](https://www.npmjs.com/package/@mintlify/scraping). El paquete extrae tu contenido y lo convierte para utilizar componentes de Mintlify.
+
+ Migra tu documentación usando el [paquete @mintlify/scraping](https://www.npmjs.com/package/@mintlify/scraping). El paquete extrae tu contenido y lo convierte para usar componentes de Mintlify.
### Plataformas compatibles
@@ -31,70 +31,70 @@ Esta guía te ayuda a trasladar tu documentación existente a Mintlify. Elige la
title="Docusaurus"
icon={}
@@ -115,7 +115,7 @@ Esta guía te ayuda a trasladar tu documentación existente a Mintlify. Elige la
### Instalación del scraper
- Instala el paquete `@mintlify/scraping` para comenzar.
+ Instala el paquete `@mintlify/scraping` para empezar.
```bash
npm install @mintlify/scraping@latest -g
@@ -123,33 +123,33 @@ Esta guía te ayuda a trasladar tu documentación existente a Mintlify. Elige la
### Extracción de páginas y secciones
- La herramienta de migración detecta automáticamente tu plataforma de documentación y convierte el contenido. Los archivos preparados se almacenan localmente en `./docs` de forma predeterminada.
+ La herramienta de migración detecta automáticamente tu plataforma de documentación y convierte tu contenido. Los archivos preparados se almacenan localmente en `./docs` de forma predeterminada.
- Para sitios de documentación grandes, migra secciones más pequeñas de forma progresiva en lugar de migrar todo el sitio de una sola vez.
+ Para sitios de documentación grandes, migra secciones más pequeñas de forma gradual en lugar de migrar todo el sitio de una sola vez.
- **Migra secciones completas:**
+ **Migrar secciones completas:**
```bash
mintlify-scrape section https://your-docs-site.com/docs
```
- **Migra páginas individuales:**
+ **Migrar páginas individuales:**
```bash
mintlify-scrape page https://your-docs-site.com/docs/getting-started
```
- **Migra las especificaciones OpenAPI:**
+ **Migrar especificaciones OpenAPI:**
```bash
- mintlify-scrape openapi-file [nombreArchivoOpenApi]
+ mintlify-scrape openapi-file [openApiFilename]
```
- ### Añade contenido preparado a tu proyecto de Mintlify
+ ### Añade el contenido preparado a tu proyecto de Mintlify
Después de extraer el contenido de tu plataforma de documentación existente, estás listo para crear tu documentación en Mintlify.
- Confirma que todas tus páginas se han migrado y luego añade estos archivos al repositorio de documentación que creaste durante el proceso de incorporación. Normalmente, este es un repositorio de GitHub.
+ Confirma que todas tus páginas se hayan migrado y luego agrega estos archivos al repositorio de documentación que creaste durante el proceso de incorporación. Por lo general, este es un repositorio de GitHub.
@@ -159,18 +159,22 @@ Esta guía te ayuda a trasladar tu documentación existente a Mintlify. Elige la
Para migrar tu contenido a Mintlify, necesitarás:
- * Un `docs.json` válido para la configuración de tu sitio y la navegación. Consulta [Configuración global](/es/organize/settings) y [Navegación](/es/organize/navigation) para obtener más información.
- * Un archivo `MDX` para cada página de tu documentación. Consulta [Páginas](/es/organize/pages) para obtener más información.
- * (Opcional) Una especificación OpenAPI para las páginas de endpoints de tu API. Consulta [Configuración de OpenAPI](/es/api-playground/openapi-setup) para obtener más información.
+ * Un `docs.json` válido para la configuración de tu sitio y la navegación. Consulta [Configuración global](/es/organize/settings) y [Navegación](/es/organize/navigation) para más información.
+ * Un archivo Markdown (`.md` o `.mdx`) para cada página de tu documentación. MDX es el formato recomendado. Consulta [Páginas](/es/organize/pages) para más información.
+ * (Opcional) Una especificación de OpenAPI para las páginas de endpoints de tu API. Consulta [Configuración de OpenAPI](/es/api-playground/openapi-setup) para más información.
- 1. Si tu contenido ya está en formato `MDX`, copia las páginas a tu proyecto de Mintlify. De lo contrario, convierte tu contenido al formato `MDX`.
- 2. Crea tu `docs.json` haciendo referencia a las rutas de tus páginas `MDX`.
+ 1. Si tu contenido ya está en formato Markdown, copia el contenido a tu proyecto de Mintlify. De lo contrario, convierte tu contenido al formato MDX.
+ 2. Crea tu `docs.json` haciendo referencia a las rutas de tus páginas Markdown.
3. Si tienes especificaciones OpenAPI, añádelas a tu `docs.json` y configura el área de pruebas de la API.
+
+ Si migras tu contenido como archivos `.md`, conviértelos a `.mdx` para habilitar funciones interactivas como componentes de React.
+
+
### Migración de recursos
- 1. Copia los recursos en el directorio `images/` de tu repositorio.
- 2. Actualiza las referencias en tus archivos `MDX`:
+ 1. Copia los recursos al directorio `images/` de tu repositorio.
+ 2. Actualiza las referencias en tus archivos Markdown:
```mdx
```
diff --git a/es/organize/navigation.mdx b/es/organize/navigation.mdx
index fdb13d649..1fabbeee7 100644
--- a/es/organize/navigation.mdx
+++ b/es/organize/navigation.mdx
@@ -12,13 +12,13 @@ Con una configuración de navegación adecuada, puedes organizar tu contenido pa
## Páginas
-Las páginas son el componente de navegación más fundamental. Las páginas corresponden a los archivos MDX que conforman tu documentación.
+Las páginas son el componente más fundamental de la navegación. Cada página es un archivo MDX en el repositorio de tu documentación.
-En el objeto `navigation`, `pages` es un arreglo en el que cada entrada debe hacer referencia a la ruta de un [archivo de página](/es/organize/pages).
+En el objeto `navigation`, `pages` es un array donde cada entrada debe hacer referencia a la ruta de un [archivo de página](/es/organize/pages).
```json
{
diff --git a/es/organize/pages.mdx b/es/organize/pages.mdx
index a1bb19f37..e3cf7e628 100644
--- a/es/organize/pages.mdx
+++ b/es/organize/pages.mdx
@@ -1,10 +1,10 @@
---
title: "Páginas"
-description: "Configura los metadatos de la página, los títulos y las propiedades de frontmatter."
-keywords: ["tags", "tag", "frontmatter", "metadata", "layout"]
+description: "Configura la metadata de la página, los títulos y las propiedades de frontmatter."
+keywords: ["etiquetas", "etiqueta", "frontmatter", "metadata", "diseño"]
---
-Cada página es un archivo MDX, que combina contenido en Markdown con componentes de React para permitirte crear documentación completa e interactiva.
+Cada página es un archivo Markdown. Tanto `.mdx` como `.md` son tipos de archivo compatibles. Recomendamos usar MDX, que combina Markdown con componentes de React para crear documentación enriquecida e interactiva. El Markdown plano (`.md`) se admite para facilitar la migración desde otras plataformas, pero se debería actualizar a MDX para obtener todas las funcionalidades.
## Metadatos de la página
diff --git a/es/organize/settings.mdx b/es/organize/settings.mdx
index d7934089a..b02cf5026 100644
--- a/es/organize/settings.mdx
+++ b/es/organize/settings.mdx
@@ -727,7 +727,7 @@ Esta sección contiene la referencia completa del archivo `docs.json`.
- Archivos de especificación OpenAPI para generar la documentación de la API. Puede ser una única URL/ruta o una matriz de URL/rutas.
+ Archivos de especificación OpenAPI para generar la documentación de la API. Puede ser una única URL/ruta o un array de URLs/rutas.
@@ -737,7 +737,7 @@ Esta sección contiene la referencia completa del archivo `docs.json`.
- Directorio en el que buscar archivos OpenAPI.
+ Directorio donde buscar archivos OpenAPI.
No incluyas una barra inicial.
@@ -745,7 +745,7 @@ Esta sección contiene la referencia completa del archivo `docs.json`.
- Archivos de especificación AsyncAPI para generar la documentación de la API. Puede ser una única URL/ruta o una matriz de URL/rutas.
+ Archivos de especificación AsyncAPI para generar la documentación de la API. Puede ser una única URL/ruta o un array de URLs/rutas.
@@ -755,7 +755,7 @@ Esta sección contiene la referencia completa del archivo `docs.json`.
- Directorio en el que buscar archivos AsyncAPI.
+ Directorio donde buscar archivos AsyncAPI.
No incluyas una barra inicial.
@@ -763,11 +763,11 @@ Esta sección contiene la referencia completa del archivo `docs.json`.
- Configuración de visualización de los parámetros de la API.
+ Configuración de visualización para los parámetros de la API.
- Indica si se deben expandir todos los parámetros de forma predeterminada. El valor predeterminado es `closed`.
+ Indica si se expanden todos los parámetros de forma predeterminada. El valor predeterminado es `closed`.
@@ -781,31 +781,31 @@ Esta sección contiene la referencia completa del archivo `docs.json`.
- Indica si las solicitudes de la API deben pasar por un servidor proxy. El valor predeterminado es `true`.
+ Indica si se envían las solicitudes de la API a través de un servidor proxy. El valor predeterminado es `true`.
- Configuración para los ejemplos de API autogenerados.
+ Configuración para los ejemplos de API generados automáticamente.
- Lenguajes para los fragmentos de API autogenerados
+ Idiomas de ejemplo para los fragmentos de API generados automáticamente.
- Indica si se deben mostrar los parámetros opcionales en los ejemplos de la API. El valor predeterminado es `all`.
+ Indica si se muestran los parámetros opcionales en los ejemplos de API. El valor predeterminado es `all`.
- Indica si se debe rellenar previamente el área de pruebas de la API con datos de ejemplos de esquemas. Cuando está habilitado, el área de pruebas completa automáticamente los campos de la solicitud con valores de ejemplo de tu especificación OpenAPI. El valor predeterminado es `false`.
+ Indica si se precarga el área de pruebas de la API con datos de ejemplos de esquemas. Cuando está habilitado, el área de pruebas rellena automáticamente los campos de solicitud con valores de ejemplo de tu especificación OpenAPI. El valor predeterminado es `false`.
- Configuración para páginas de la API generadas a partir de archivos `MDX`.
+ Configuración para las páginas de API generadas a partir de archivos MDX.
@@ -813,17 +813,17 @@ Esta sección contiene la referencia completa del archivo `docs.json`.
- Método de autenticación para solicitudes de API.
+ Método de autenticación para las solicitudes de la API.
- Nombre de autenticación para solicitudes de API.
+ Nombre de autenticación para las solicitudes de la API.
- Configuración del servidor para solicitudes de API.
+ Configuración del servidor para las solicitudes de la API.
diff --git a/fr/api-playground/mdx-setup.mdx b/fr/api-playground/mdx-setup.mdx
index 23f2f6075..eddff3d71 100644
--- a/fr/api-playground/mdx-setup.mdx
+++ b/fr/api-playground/mdx-setup.mdx
@@ -1,18 +1,18 @@
---
-title: "Créer des pages d’API manuellement"
-description: "Décrivez manuellement des points de terminaison d’API dans des fichiers MDX."
-keywords: ["documentation d’API", "documentation de points de terminaison"]
+title: "Créer manuellement des pages d'API"
+description: "Documentez manuellement les endpoints d'API avec des fichiers MDX."
+keywords: ["documentation d'API", "documentation d'endpoint"]
---
-Vous pouvez définir manuellement des points de terminaison d’API dans des pages individuelles. Cette approche est utile pour les petites API ou le prototypage.
+Vous pouvez définir manuellement des endpoints d'API dans des pages MDX individuelles. Cette approche est particulièrement utile pour de petites API ou pour le prototypage.
## Configuration
-
- Dans votre fichier `docs.json`, définissez l’URL de base et la méthode d’authentification.
+
+ Dans votre fichier `docs.json`, définissez votre URL de base et votre méthode d'authentification.
```json
"api": {
@@ -26,7 +26,7 @@ Vous pouvez définir manuellement des points de terminaison d’API dans des pag
}
```
- Pour masquer le bac à sable API, définissez le champ `display` sur `none`. Vous n’avez pas besoin d’inclure de méthode d’authentification si vous masquez le bac à sable.
+ Si vous souhaitez masquer le bac à sable d’API, définissez le champ `display` sur `none`. Vous n'avez pas besoin d'inclure une méthode d'authentification si vous masquez le bac à sable.
```json
"api": {
@@ -36,11 +36,11 @@ Vous pouvez définir manuellement des points de terminaison d’API dans des pag
}
```
- Retrouvez la liste complète des configurations de l’API dans [Settings](/fr/organize/settings#api-configurations).
+ Retrouvez la liste complète des configurations d'API dans [Settings](/fr/organize/settings#api-configurations).
-
- Créez un fichier `MDX` pour chaque endpoint. Définissez `title` et `api` dans le front matter :
+
+ Créez un fichier MDX pour chaque endpoint. Définissez `title` et `api` dans le frontmatter :
```mdx
---
@@ -59,7 +59,7 @@ Vous pouvez définir manuellement des points de terminaison d’API dans des pag
Si vous avez un champ `server` configuré dans `docs.json`, vous pouvez utiliser des chemins relatifs comme `/v1/endpoint`.
- Pour remplacer le mode d’affichage global du bac à sable pour une page spécifique, ajoutez `playground` au front matter :
+ Pour remplacer le mode d'affichage global du bac à sable pour une page spécifique, ajoutez `playground` au frontmatter :
```mdx
---
@@ -71,35 +71,35 @@ Vous pouvez définir manuellement des points de terminaison d’API dans des pag
Options :
- * `playground: 'interactive'` - Afficher le bac à sable interactif (par défaut)
- * `playground: 'simple'` - Afficher un endpoint copiable sans bac à sable
- * `playground: 'none'` - Masquer complètement le bac à sable
+ * `playground: 'interactive'` - Affiche le bac à sable interactif (valeur par défaut)
+ * `playground: 'simple'` - Affiche un endpoint copiable sans bac à sable
+ * `playground: 'none'` - Masque complètement le bac à sable
-
+
Utilisez les [champs de paramètres et de réponses](/fr/components/fields) pour documenter les paramètres et les valeurs de retour de votre endpoint.
```mdx
- Identifiant unique de l’utilisateur
+ Identifiant unique de l'utilisateur
- Adresse e-mail de l’utilisateur
+ Adresse e-mail de l'utilisateur
- Identifiant unique de l’utilisateur nouvellement créé
+ Identifiant unique de l'utilisateur nouvellement créé
- Adresse e-mail de l’utilisateur
+ Adresse e-mail de l'utilisateur
```
-
- Ajoutez les pages d’endpoint à la navigation en mettant à jour le champ `pages` dans votre `docs.json`. Pour en savoir plus sur la structuration de votre documentation, consultez [Navigation](/fr/organize/navigation).
+
+ Ajoutez les pages de vos endpoints à la navigation en mettant à jour le champ `pages` dans votre `docs.json`. Pour en savoir plus sur la structuration de votre documentation, consultez [Navigation](/fr/organize/navigation).
diff --git a/fr/api-playground/overview.mdx b/fr/api-playground/overview.mdx
index 9e0bac94b..65e46c42b 100644
--- a/fr/api-playground/overview.mdx
+++ b/fr/api-playground/overview.mdx
@@ -149,17 +149,17 @@ Cet exemple configure l’aire de test de l’API pour être interactive, avec d
### Pages d’endpoint personnalisées
-Lorsque vous avez besoin de plus de contrôle sur votre documentation d’API, utilisez l’extension `x-mint` dans votre spécification OpenAPI ou créez des pages `MDX` individuelles pour vos endpoints.
+Lorsque vous avez besoin d’un contrôle plus fin sur votre documentation d’API, utilisez l’extension `x-mint` dans votre spécification OpenAPI ou créez des pages MDX individuelles pour vos endpoints.
-Ces deux options vous permettent de :
+Les deux options vous permettent de :
-* Personnaliser les métadonnées de la page
+* Personnaliser la metadata de la page
* Ajouter du contenu supplémentaire, comme des exemples
-* Contrôler le comportement du playground par page
+* Contrôler le comportement du playground pour chaque page
-L’extension `x-mint` est recommandée afin que toute votre documentation d’API soit automatiquement générée à partir de votre spécification OpenAPI et centralisée dans un seul fichier.
+L’extension `x-mint` est recommandée afin que toute votre documentation d’API soit automatiquement générée à partir de votre spécification OpenAPI et maintenue dans un seul fichier.
-Les pages `MDX` individuelles sont recommandées pour les petites API ou lorsque vous souhaitez expérimenter des modifications au cas par cas.
+Les pages MDX individuelles sont recommandées pour les petites API ou lorsque vous souhaitez expérimenter des modifications page par page.
## Pour aller plus loin
diff --git a/fr/customize/custom-scripts.mdx b/fr/customize/custom-scripts.mdx
index 62336a2fc..00ebc8a47 100644
--- a/fr/customize/custom-scripts.mdx
+++ b/fr/customize/custom-scripts.mdx
@@ -29,7 +29,7 @@ Les valeurs arbitraires de Tailwind CSS ne sont pas prises en charge. Pour des v
## CSS personnalisé
-Ajoutez des fichiers CSS à votre référentiel : les classes qu’ils définissent seront appliquées et disponibles dans tous vos fichiers `MDX`.
+Ajoutez des fichiers CSS à votre référentiel ; les noms de classes qu’ils définissent seront alors appliqués et disponibles dans tous vos fichiers MDX.
### Ajout de `style.css`
diff --git a/fr/customize/react-components.mdx b/fr/customize/react-components.mdx
index 09dd30db4..5578c199e 100644
--- a/fr/customize/react-components.mdx
+++ b/fr/customize/react-components.mdx
@@ -8,12 +8,11 @@ import { ColorGenerator } from "/snippets/color-generator.jsx";
[Les composants React](https://react.dev) constituent un moyen puissant de créer des éléments interactifs et réutilisables dans votre documentation.
-
- ## Utiliser des composants React
+ ## Utilisation de composants React
-Vous pouvez créer des composants React directement dans vos fichiers `MDX` à l’aide des [hooks React](https://react.dev/reference/react/hooks).
+Vous pouvez créer des composants React directement dans vos fichiers MDX en utilisant les [hooks React](https://react.dev/reference/react/hooks).
### Exemple
@@ -96,16 +95,14 @@ Le compteur est rendu sous la forme d’un composant React interactif.
- ## Importation de composants
+ ## Importer des composants
-Pour importer des composants React dans vos fichiers `MDX`, les fichiers des composants doivent être placés dans le dossier `snippets`. Vous pouvez ensuite les importer dans n’importe quelle page `MDX` de votre documentation. En savoir plus sur les [extraits réutilisables](/fr/create/reusable-snippets).
+Pour importer des composants React dans vos fichiers MDX, les fichiers de composants doivent être placés dans le dossier `snippets`. Vous pouvez ensuite les importer dans n'importe quelle page MDX de votre documentation. Pour en savoir plus, consultez les [extraits réutilisables](/fr/create/reusable-snippets).
-
- ### Exemple
-
+### Exemple
-Cet exemple déclare un composant `ColorGenerator` qui utilise plusieurs hooks React, puis l’emploie dans un fichier `MDX`.
+Cet exemple déclare un composant `ColorGenerator` qui utilise plusieurs hooks React, puis l'utilise dans un fichier MDX.
Créez le fichier `color-generator.jsx` dans le dossier `snippets` :
@@ -222,7 +219,7 @@ export const ColorGenerator = () => {
}
```
-Importez le composant `ColorGenerator` et utilisez-le dans un fichier `MDX` :
+Importez le composant `ColorGenerator` et utilisez-le dans un fichier MDX :
```mdx
import { ColorGenerator } from "/snippets/color-generator.jsx"
@@ -230,7 +227,7 @@ import { ColorGenerator } from "/snippets/color-generator.jsx"
```
-Le générateur de couleurs se présente sous la forme d’un composant React interactif.
+Le générateur de couleurs s'affiche sous la forme d’un composant React interactif.
diff --git a/fr/deploy/ci.mdx b/fr/deploy/ci.mdx
index 9ff5a03b2..96b82247b 100644
--- a/fr/deploy/ci.mdx
+++ b/fr/deploy/ci.mdx
@@ -45,37 +45,38 @@ Pour consulter les résultats de cette vérification, rendez-vous sur la page de
### Vale
-[Vale](https://vale.sh/) est un linter de prose open source basé sur des règles, compatible avec divers types de documents, dont Markdown et MDX.
+[Vale](https://vale.sh/) est un linter de prose open source basé sur des règles qui prend en charge un large éventail de types de documents, y compris Markdown et MDX. Utilisez Vale pour vérifier la cohérence du style et du ton de votre documentation.
-Mintlify prend en charge l’exécution automatique de Vale dans une vérification CI et l’affichage des résultats sous forme d’état de vérification.
+Mintlify permet d’exécuter automatiquement Vale dans un contrôle CI et d’afficher les résultats comme statut de contrôle.
#### Configuration
-Si vous avez un fichier `.vale.ini` à la racine du répertoire content de votre déploiement, le contrôle Vale CI utilise ce fichier de configuration ainsi que tout fichier de configuration présent dans le `stylesPath` que vous avez spécifié.
+Si vous avez un fichier `.vale.ini` à la racine du répertoire de contenu de votre déploiement, la vérification Vale CI utilise ce fichier de configuration ainsi que tous les fichiers de configuration présents dans le `stylesPath` que vous avez spécifié.
-Si vous n’avez pas de fichier de configuration Vale, la configuration par défaut est chargée automatiquement.
+Si vous n’avez pas de fichier de configuration Vale, la configuration par défaut est automatiquement chargée.
```mdx Default vale.ini configuration expandable
# Styles de niveau supérieur
StylesPath = /app/styles
MinAlertLevel = suggestion
+# Balises HTML en ligne à ignorer (code/tt pour les extraits de code, img/url pour les liens/images, a pour les balises d'ancrage)
IgnoredScopes = code, tt, img, url, a
-SkippedScopes = script, style, pre, figure, code
+SkippedScopes = script, style, pre, figure
# Vocabulaires
Vocab = Mintlify
-# Requis car Vale ne prend pas officiellement en charge MDX
-[formats]
-mdx = md
+# Packages
+Packages = MDX
-# Prise en charge de MDX
+# Correspondre uniquement aux fichiers MDX
[*.mdx]
BasedOnStyles = Vale
Vale.Terms = NO # Applique des règles de capitalisation très strictes, laisser désactivé
+# Ignorer les motifs de syntaxe spécifiques à JSX/MDX
# `import ...`, `export ...`
# ``
# `...`
@@ -84,14 +85,14 @@ TokenIgnores = (?sm)((?:import|export) .+?$), \
(?)(?!`), \
(<[A-Z]\w+>.+?<\/[A-Z]\w+>)
-# Exclure :
+# Exclure le JSX multiligne et les accolades
# ``
BlockIgnores = (?sm)^(<\w+\n .*\s\/>)$, \
(?sm)^({.+.*})
-
-CommentDelimiters = {/*, */}
```
+Le vocabulaire par défaut de Vale comprend les mots suivants.
+
```text Default Vale vocabulary expandable
Mintlify
mintlify
@@ -362,64 +363,67 @@ next
toc
```
+Pour ajouter votre propre vocabulaire à la configuration par défaut, créez un répertoire `styles/config/vocabularies/Mintlify` contenant les fichiers `accept.txt` et `reject.txt`.
+
+* `accept.txt` : Mots à ignorer par le linter Vale. Par exemple, des noms de produits ou des termes peu courants.
+* `reject.txt` : Mots qui doivent être signalés comme des erreurs. Par exemple, du jargon ou des mots qui ne sont pas appropriés au ton de votre documentation.
+
```text Example Vale file structure
- - docs.json
- - .vale.ini
- - styles/...
- - text.md
+/votre-projet
+ |- docs.json
+ |- .vale.ini
+ |- styles/
+ |- config/
+ |- vocabularies/
+ |- Mintlify/
+ |- accept.txt
+ |- reject.txt
+ |- page-exemple.mdx
```
```text Example monorepo Vale file structure
- - main.ts
- - docs/
- - docs.json
- - .vale.ini
- - styles/...
- - text.md
- - test/
+/your-monorepo
+ |- main.ts
+ |- docs/
+ |- docs.json
+ |- .vale.ini
+ |- styles/
+ |- config/
+ |- vocabularies/
+ |- Mintlify/
+ |- accept.txt
+ |- reject.txt
+ |- example-page.mdx
+ |- test/
```
- Pour des raisons de sécurité, les `stylesPath` absolus ou contenant `..` ne sont pas pris en charge. Utilisez des chemins relatifs et incluez le `stylesPath` dans votre référentiel.
+ Pour des raisons de sécurité, les `stylesPath` absolus ou les `stylesPath` contenant `..` ne sont pas pris en charge.
+
+ Utilisez des chemins relatifs et incluez le `stylesPath` dans votre référentiel.
#### Packages
-Vale prend en charge un éventail de [packages](https://vale.sh/docs/keys/packages), qui peuvent être utilisés pour détecter les fautes d’orthographe et les erreurs de style.
-Tous les packages que vous incluez dans votre référentiel sous le `stylesPath` approprié sont automatiquement installés et pris en compte dans votre configuration Vale.
+Vale prend en charge une gamme de [packages](https://vale.sh/docs/keys/packages), qui peuvent être utilisés pour détecter les fautes d’orthographe et les erreurs de style. Tous les packages que vous ajoutez à votre référentiel sous le `stylesPath` approprié sont automatiquement installés et utilisés dans votre configuration Vale.
-Pour les packages qui ne figurent pas dans votre référentiel, vous pouvez spécifier n’importe quels packages depuis le [registre de packages Vale](https://vale.sh/explorer) ; ils sont alors automatiquement téléchargés et utilisés dans votre configuration Vale.
+Pour les packages qui ne sont pas inclus dans votre référentiel, vous pouvez spécifier n’importe quel package du [registre de packages Vale](https://vale.sh/explorer), qui sera automatiquement téléchargé et utilisé dans votre configuration Vale.
- Veuillez noter que, pour des raisons de sécurité, le téléchargement automatique de packages ne provenant pas du [registre de packages Vale](https://vale.sh/explorer) n’est pas pris en charge.
+ Pour des raisons de sécurité, le téléchargement automatique de packages qui ne proviennent pas du [registre de packages Vale](https://vale.sh/explorer) n’est **pas** pris en charge.
#### Vale avec `MDX`
-Vale ne prend pas en charge `MDX` nativement, mais l’auteur de Vale a fourni une [extension personnalisée](https://github.com/errata-ai/MDX) pour l’ajouter.
-
-Si vous préférez ne pas utiliser cette extension, vous pouvez ajouter les lignes suivantes au fichier `.vale.ini` configuré :
-
-```ini
-[formats]
-mdx = md
-
-[*.mdx]
-CommentDelimiters = {/*, */}
-
-TokenIgnores = (?sm)((?:import|export) .+?$), \
-(?)(?!`), \
-(<[A-Z]\w+>.+?<\/[A-Z]\w+>)
-
-BlockIgnores = (?sm)^(<\w+\n .*\s\/>)$, \
-(?sm)^({.+.*})
-```
+
+ La prise en charge native de MDX nécessite Vale 3.10.0 ou une version ultérieure. Vérifiez votre version de Vale avec `vale --version`.
+
-Pour utiliser les commentaires dans le document de Vale, utilisez des commentaires au format MDX `{/* ... */}`. Si vous utilisez le [paramètre](https://vale.sh/docs/keys/commentdelimiters) `CommentDelimiters = {/*, */}` dans votre configuration, Vale interprétera automatiquement ces commentaires lors de l’analyse. Cela signifie que vous pouvez facilement utiliser les fonctionnalités intégrées de Vale, comme ignorer des lignes ou des sections.
+Pour utiliser les commentaires intégrés de Vale dans les fichiers MDX, utilisez les commentaires au format MDX `{/* ... */}` :
```mdx
{/* vale off */}
@@ -429,14 +433,4 @@ Ce texte est ignoré par Vale
{/* vale on */}
```
-Si vous choisissez de ne pas utiliser `CommentDelimiters` tout en utilisant les commentaires de Vale, vous devez entourer tous les commentaires de Vale de commentaires MDX `{/* ... */}`. Par exemple :
-
-```mdx
-{/* */}
-
-Ce texte est ignoré par Vale
-
-{/* */}
-```
-
-Ces balises de commentaire ne sont pas prises en charge dans les composants Mintlify, mais elles fonctionneront correctement partout au niveau de base d’un document.
+Vale reconnaît et respecte automatiquement ces commentaires dans les fichiers MDX sans configuration supplémentaire. Utilisez les commentaires pour ignorer les lignes ou sections qui doivent être ignorées par le linter.
diff --git a/fr/deploy/personalization-setup.mdx b/fr/deploy/personalization-setup.mdx
index 69727d5a2..0ccecea8e 100644
--- a/fr/deploy/personalization-setup.mdx
+++ b/fr/deploy/personalization-setup.mdx
@@ -52,7 +52,7 @@ groups: ["admin"]
## Format des données utilisateur
-Lors de la mise en œuvre de la personnalisation, votre système renvoie des données utilisateur dans un format spécifique qui permet d’adapter le contenu. Ces données peuvent être envoyées soit sous la forme d’un objet JSON brut, soit dans un JWT (JSON Web Token) signé, selon votre méthode d’échange. La structure des données est identique dans les deux cas.
+Lors de l’implémentation de la personnalisation, votre système renvoie les données utilisateur dans un format spécifique qui permet de personnaliser le contenu. Ces données peuvent être envoyées soit sous forme d’objet JSON brut, soit encapsulées dans un JWT signé, selon votre méthode de négociation. La structure des données est identique dans les deux cas.
```tsx
type User = {
@@ -69,32 +69,32 @@ type User = {
```
- Durée d’expiration de la session en **secondes depuis l’époque Unix**. Si l’utilisateur charge une page après ce moment, ses données stockées sont automatiquement supprimées et il doit se réauthentifier.
- Pour les échanges JWT : Cela diffère de la revendication `exp` du JWT, qui détermine quand un JWT est considéré invalide. Par sécurité, définissez la revendication `exp` du JWT sur une durée courte (10 secondes ou moins). Utilisez `expiresAt` pour la durée réelle de la session (de quelques heures à plusieurs semaines).
+ Durée d’expiration de la session en **secondes depuis l’époque Unix**. Si l’utilisateur charge une page après ce délai, ses données stockées sont automatiquement supprimées et il doit se réauthentifier.
+ Pour les handshakes JWT : Cela diffère de la claim `exp` du JWT, qui détermine le moment où un JWT est considéré comme invalide. Par mesure de sécurité, définissez la claim `exp` du JWT sur une courte durée (10 secondes ou moins). Utilisez `expiresAt` pour la durée réelle de la session (de quelques heures à plusieurs semaines).
- Liste des groupes dont l’utilisateur est membre. Les pages dont le frontmatter contient des `groups` correspondants sont visibles pour cet utilisateur.
+ Liste des groupes auxquels l’utilisateur appartient. Les pages dont le champ `groups` dans leur frontmatter correspond sont visibles par cet utilisateur.
**Exemple** : Un utilisateur avec `groups: ["admin", "engineering"]` peut accéder aux pages étiquetées avec le groupe `admin` ou `engineering`.
- Données personnalisées accessibles dans votre contenu `MDX` via la variable `user`. Utilisez-les pour une personnalisation dynamique dans l’ensemble de votre documentation.
+ Données personnalisées accessibles dans votre contenu MDX via la variable `user`. Utilisez ces données pour une personnalisation dynamique dans toute votre documentation.
- **Exemple de base** :
+ **Exemple simple** :
```json
{ "firstName": "Ronan", "company": "Acme Corp", "plan": "Enterprise" }
```
- **Utilisation dans `MDX`** :
+ **Utilisation dans MDX** :
```mdx
Welcome back, {user.firstName}! Your {user.plan} plan includes...
```
- Avec l’exemple de données `user`, le rendu serait : Welcome back, Ronan! Your Enterprise plan includes...
+ Avec les données d’exemple de `user`, le rendu serait : Welcome back, Ronan! Your Enterprise plan includes...
**Rendu conditionnel avancé** :
@@ -109,7 +109,7 @@ type User = {
```
- Les informations dans `user` ne sont disponibles que pour les utilisateurs connectés. Pour les utilisateurs déconnectés, la valeur de `user` sera `{}`. Pour éviter que la page ne plante pour les utilisateurs déconnectés, utilisez toujours l’opérateur d’enchaînement optionnel sur vos champs `user`. Par exemple, `{user.org?.plan}`.
+ Les informations dans `user` ne sont disponibles que pour les utilisateurs connectés. Pour les utilisateurs déconnectés, la valeur de `user` sera `{}`. Pour éviter que la page ne plante pour les utilisateurs déconnectés, utilisez toujours l’optional chaining sur vos champs `user`. Par exemple, `{user.org?.plan}`.
@@ -126,9 +126,9 @@ type User = {
}
```
- Si un utilisateur effectue des requêtes sur un sous-domaine spécifique, vous pouvez envoyer `{ server: { subdomain: 'foo' } }` comme champ `apiPlaygroundInputs`. Cette valeur sera préremplie sur toute page d’API qui utilise la valeur `subdomain`.
+ Si un utilisateur effectue des requêtes sur un sous-domaine spécifique, vous pouvez envoyer `{ server: { subdomain: 'foo' } }` en tant que champ `apiPlaygroundInputs`. Cette valeur sera préremplie sur toute page d’API utilisant le champ `subdomain`.
- Les champs `header`, `query` et `cookie` ne seront préremplis que s’ils font partie de votre [schéma de sécurité OpenAPI](https://swagger.io/docs/specification/authentication/). Si un champ se trouve dans les sections `Authorization` ou `Server`, il sera prérempli. La création d’un paramètre d’en-tête standard nommé `Authorization` n’activera pas cette fonctionnalité.
+ Les champs `header`, `query` et `cookie` ne seront préremplis que s’ils font partie de votre [schéma de sécurité OpenAPI](https://swagger.io/docs/specification/authentication/). Si un champ se trouve dans les sections `Authorization` ou `Server`, il sera prérempli. Créer un paramètre d’en-tête standard nommé `Authorization` n’activera pas cette fonctionnalité.
diff --git a/fr/editor.mdx b/fr/editor.mdx
index b80402a2c..2abbd89d3 100644
--- a/fr/editor.mdx
+++ b/fr/editor.mdx
@@ -74,12 +74,12 @@ Le mode visuel offre une expérience WYSIWYG (What You See Is What You Get) dans
### Mode Markdown
-Le mode Markdown offre un accès direct au code `MDX` sous-jacent de votre documentation. Ce mode est idéal lorsque vous avez besoin d’un contrôle précis sur les propriétés des composants ou lorsque vous préférez écrire en syntaxe Markdown.
+Le mode Markdown offre un accès direct aux fichiers qui composent votre documentation. Ce mode est idéal lorsque vous avez besoin d’un contrôle précis sur les propriétés des composants ou lorsque vous préférez écrire en syntaxe MDX.
-
+
-
+
@@ -178,23 +178,23 @@ Dans cet exemple, vous avez créé une nouvelle page intitulée Thèmes et vous
### Modifier le contenu
-Apportez des modifications à vos pages à l’aide du mode visuel ou du Mode Markdown dans l’éditeur.
+Apportez des modifications à vos pages à l'aide du mode visuel ou du mode Markdown dans l'éditeur.
-En mode visuel, appuyez sur / pour ouvrir le menu des composants. Ajoutez des blocs de contenu, des encadrés, des blocs de code et d’autres composants pour personnaliser votre documentation.
+En mode visuel, appuyez sur / pour ouvrir le menu des composants. Ajoutez des blocs de contenu, des encadrés, des blocs de code et d'autres composants pour personnaliser votre documentation.
-
+
-
+
-En Mode Markdown, vous modifiez directement le `MDX` de vos pages. Cela peut être utile lorsque vous devez :
+En mode Markdown, vous pouvez modifier directement le MDX de vos pages. Cela peut être utile lorsque vous devez :
-* Définir des propriétés spécifiques de composants
+* Définir des propriétés spécifiques pour les composants
* Travailler avec des composants imbriqués complexes
-* Copier-coller du contenu `MDX` depuis d’autres sources
+* Copier et coller du contenu MDX à partir d'autres sources
-Consultez [Mettre en forme le texte](/fr/create/text) et [Mettre en forme le code](/fr/create/code) pour plus d’informations sur la rédaction avec la syntaxe Markdown.
+Consultez [Formater le texte](/fr/create/text) et [Formater le code](/fr/create/code) pour plus d'informations sur la rédaction avec la syntaxe MDX.
## Publier vos modifications
diff --git a/fr/guides/migrating-from-mdx.mdx b/fr/guides/migrating-from-mdx.mdx
index 486dd89d2..ccc84f5a6 100644
--- a/fr/guides/migrating-from-mdx.mdx
+++ b/fr/guides/migrating-from-mdx.mdx
@@ -1,13 +1,13 @@
---
-title: "Migration des pages API MDX vers la navigation OpenAPI"
-sidebarTitle: "Migrer de MDX à OAS"
-description: "Migrez vers la génération OpenAPI automatisée avec une navigation flexible."
-keywords: ["Migration d'API", "mint migrate-mdx", "Migration OpenAPI", "extension x-mint"]
+title: "Migrer les pages d’API MDX vers la navigation OpenAPI"
+sidebarTitle: "Migrer de MDX vers OAS"
+description: "Migrer vers la génération OpenAPI automatisée avec une navigation flexible."
+keywords: ["Migration d’API", "mint migrate-mdx", "Migration OpenAPI", "extension x-mint"]
---
-Si vous utilisez actuellement des pages `MDX` distinctes pour vos endpoints d’API, vous pouvez migrer vers l’autogénération de pages à partir de votre spécification OpenAPI tout en conservant la possibilité de personnaliser chaque page. Cela peut vous aider à réduire le nombre de fichiers à maintenir et à améliorer la cohérence de votre documentation d’API.
+Si vous utilisez actuellement des pages MDX individuelles pour vos endpoints d’API, vous pouvez migrer vers la génération automatique de pages à partir de votre spécification OpenAPI, tout en conservant la possibilité de personnaliser chaque page individuellement. Cela peut vous aider à réduire le nombre de fichiers à maintenir et à améliorer la cohérence de votre documentation d’API.
-Vous pouvez définir des metadata et du content pour chaque endpoint dans votre spécification OpenAPI et organiser les endpoints où vous le souhaitez dans votre navigation.
+Vous pouvez définir les champs metadata et content pour chaque endpoint dans votre spécification OpenAPI, et organiser les endpoints où vous le souhaitez dans votre navigation.
## Migration via la CLI
@@ -61,23 +61,23 @@ Cette commande :
Assurez-vous que votre spécification OpenAPI est valide et inclut tous les endpoints que vous souhaitez documenter.
- Pour les endpoints dont vous souhaitez personnaliser la metadata ou le content, ajoutez l’extension `x-mint` à l’endpoint. Voir [x-mint extension](/fr/api-playground/openapi-setup#x-mint-extension) pour plus de détails.
+ Pour chaque endpoint pour lequel vous souhaitez personnaliser les métadonnées ou le contenu, ajoutez l’extension `x-mint` à l’endpoint. Consultez l’[extension x-mint](/fr/api-playground/openapi-setup#x-mint-extension) pour plus de détails.
- Pour les endpoints que vous souhaitez exclure de votre documentation, ajoutez l’extension `x-hidden` à l’endpoint.
+ Pour chaque endpoint que vous souhaitez exclure de votre documentation, ajoutez l’extension `x-hidden` à l’endpoint.
- Validez votre fichier OpenAPI à l’aide de [Swagger Editor](https://editor.swagger.io/) ou de la [Interface en ligne de commande (CLI) Mint](https://www.npmjs.com/package/mint).
+ Validez votre fichier OpenAPI à l’aide de [Swagger Editor](https://editor.swagger.io/) ou de l’[interface en ligne de commande (CLI) Mint](https://www.npmjs.com/package/mint).
-
- Remplacez les références de pages `MDX` par des endpoints OpenAPI dans votre `docs.json`.
+
+ Remplacez les références de pages MDX par des endpoints OpenAPI dans votre `docs.json`.
```json
"navigation": {
"groups": [
{
- "group": "API Reference",
+ "group": "Référence d’API",
"openapi": "/path/to/openapi.json",
"pages": [
"overview",
@@ -96,7 +96,7 @@ Cette commande :
- Après avoir vérifié que votre nouvelle navigation fonctionne correctement, supprimez les fichiers d’endpoint `MDX` dont vous n’avez plus besoin.
+ Après avoir vérifié que votre nouvelle navigation fonctionne correctement, supprimez les fichiers MDX correspondant aux endpoints dont vous n’avez plus besoin.
@@ -151,13 +151,13 @@ Organisez différentes versions d’API à l’aide d’Onglets ou de groups :
```
- ## Quand utiliser des pages `MDX` individuelles
+ ## Quand utiliser des pages MDX individuelles
-Envisagez de conserver des pages `MDX` individuelles lorsque vous avez besoin de :
+Envisagez de conserver des pages MDX individuelles lorsque vous avez besoin de :
-* Contenu personnalisé conséquent par endpoint, comme des composants React ou des exemples détaillés.
+* Contenu très personnalisé et volumineux par endpoint, comme des composants React ou des exemples détaillés.
* Mises en page uniques.
* Approches de documentation expérimentales pour des endpoints spécifiques.
-Pour la plupart des cas d’usage, la navigation OpenAPI offre une meilleure maintenabilité et une plus grande cohérence.
\ No newline at end of file
+Pour la plupart des cas d’utilisation, la navigation OpenAPI offre une meilleure maintenabilité et une plus grande cohérence.
\ No newline at end of file
diff --git a/fr/installation.mdx b/fr/installation.mdx
index a93990a2d..fe1000dad 100644
--- a/fr/installation.mdx
+++ b/fr/installation.mdx
@@ -192,11 +192,11 @@ Cette commande convertit les pages MDX d’endpoint individuelles en pages gén
## Mise en forme
-Lors du développement en local, nous recommandons d’utiliser des extensions dans votre IDE pour reconnaître et formater les fichiers `MDX`.
+Lors du développement en local, nous recommandons d'utiliser des extensions pour votre IDE afin de reconnaître et de formater les fichiers MDX.
-Si vous utilisez Cursor, Windsurf ou VS Code, nous recommandons l’[extension MDX pour VS Code](https://marketplace.visualstudio.com/items?itemName=unifiedjs.vscode-mdx) pour la coloration syntaxique, ainsi que [Prettier](https://marketplace.visualstudio.com/items?itemName=esbenp.prettier-vscode) pour le formatage du code.
+Si vous utilisez Cursor, Windsurf ou VS Code, nous recommandons l’[extension MDX pour VS Code](https://marketplace.visualstudio.com/items?itemName=unifiedjs.vscode-mdx) pour la coloration syntaxique, et [Prettier](https://marketplace.visualstudio.com/items?itemName=esbenp.prettier-vscode) pour le formatage du code.
-Si vous utilisez JetBrains, nous recommandons le [plug-in MDX pour IntelliJ IDEA](https://plugins.jetbrains.com/plugin/14944-mdx) pour la coloration syntaxique, ainsi que la configuration de [Prettier](https://prettier.io/docs/webstorm) pour le formatage du code.
+Si vous utilisez JetBrains, nous recommandons le [plugin MDX pour IntelliJ IDEA](https://plugins.jetbrains.com/plugin/14944-mdx) pour la coloration syntaxique, ainsi que la configuration de [Prettier](https://prettier.io/docs/webstorm) pour le formatage du code.
## Dépannage
diff --git a/fr/migration.mdx b/fr/migration.mdx
index 9e5889d5b..139befe9a 100644
--- a/fr/migration.mdx
+++ b/fr/migration.mdx
@@ -22,7 +22,7 @@ Ce guide vous aide à migrer votre documentation existante vers Mintlify. Optez
- Migrez votre documentation à l'aide du [package @mintlify/scraping](https://www.npmjs.com/package/@mintlify/scraping). Ce package extrait votre contenu et le convertit pour utiliser les composants Mintlify.
+ Migrez votre documentation en utilisant le [package @mintlify/scraping](https://www.npmjs.com/package/@mintlify/scraping). Ce package extrait votre contenu et le convertit pour utiliser les composants Mintlify.
### Plateformes prises en charge
@@ -31,70 +31,70 @@ Ce guide vous aide à migrer votre documentation existante vers Mintlify. Optez
title="Docusaurus"
icon={}
@@ -125,7 +125,7 @@ Ce guide vous aide à migrer votre documentation existante vers Mintlify. Optez
L'outil de migration détecte automatiquement votre plateforme de documentation et convertit votre contenu. Les fichiers préparés sont stockés localement dans `./docs` par défaut.
- Pour les sites de documentation volumineux, migrez de petites sections à la fois plutôt que le site entier d'un seul coup.
+ Pour les sites de documentation volumineux, migrez des sections plus petites progressivement plutôt que l'ensemble du site d'un seul coup.
**Migrer des sections entières :**
@@ -145,32 +145,36 @@ Ce guide vous aide à migrer votre documentation existante vers Mintlify. Optez
mintlify-scrape openapi-file [openApiFilename]
```
- ### Ajoutez le contenu préparé à votre projet Mintlify
+ ### Ajouter le contenu préparé à votre projet Mintlify
Après avoir extrait le contenu de votre plateforme de documentation existante, vous êtes prêt à créer votre documentation sur Mintlify.
- Confirmez que toutes vos pages ont été migrées, puis ajoutez ces fichiers au référentiel de documentation que vous avez créé lors du processus d'intégration. Il s'agit généralement d'un référentiel GitHub.
+ Vérifiez que toutes vos pages ont bien été migrées, puis ajoutez ces fichiers au référentiel de documentation que vous avez créé lors de la configuration initiale. Il s'agit généralement d'un référentiel GitHub.
- Migrez votre documentation depuis n’importe quelle plateforme en gardant un contrôle total sur le processus.
+ Migrez votre documentation depuis n'importe quelle plateforme en gardant un contrôle total sur le processus.
### Migration du contenu
- Pour migrer votre contenu vers Mintlify, vous aurez besoin de :
+ Pour migrer votre contenu vers Mintlify, vous aurez besoin de :
- * Un `docs.json` valide pour les paramètres de votre site et la navigation. Voir [Paramètres globaux](/fr/organize/settings) et [Navigation](/fr/organize/navigation) pour plus d’informations.
- * Un fichier `MDX` pour chaque page de votre documentation. Voir [Pages](/fr/organize/pages) pour plus d’informations.
- * (Facultatif) Une spécification OpenAPI pour les pages de vos points de terminaison d’API. Voir [Configuration OpenAPI](/fr/api-playground/openapi-setup) pour plus d’informations.
+ * D'un `docs.json` valide pour les paramètres de votre site et la navigation. Voir [Paramètres globaux](/fr/organize/settings) et [Navigation](/fr/organize/navigation) pour plus d'informations.
+ * D'un fichier Markdown (`.md` ou `.mdx`) pour chaque page de votre documentation. MDX est le format recommandé. Voir [Pages](/fr/organize/pages) pour plus d'informations.
+ * (Facultatif) D'une spécification OpenAPI pour les pages d'endpoints de votre API. Voir [OpenAPI setup](/fr/api-playground/openapi-setup) pour plus d'informations.
- 1. Si votre contenu est déjà au format `MDX`, copiez les pages dans votre projet Mintlify. Sinon, convertissez votre contenu au format `MDX`.
- 2. Créez votre `docs.json` en y référant les chemins vers vos pages `MDX`.
- 3. Si vous disposez de spécifications OpenAPI, ajoutez-les à votre `docs.json` et configurez le bac à sable d’API.
+ 1. Si votre contenu est déjà au format Markdown, copiez-le dans votre projet Mintlify. Sinon, convertissez votre contenu au format MDX.
+ 2. Créez votre `docs.json` en y faisant référence aux chemins vers vos pages Markdown.
+ 3. Si vous avez des spécifications OpenAPI, ajoutez-les à votre `docs.json` et configurez le bac à sable d’API.
+
+
+ Si vous migrez votre contenu sous forme de fichiers `.md`, convertissez-les en `.mdx` pour prendre en charge les fonctionnalités interactives comme les composants React.
+
### Migration des ressources
1. Copiez les ressources dans le répertoire `images/` de votre référentiel.
- 2. Mettez à jour les références dans vos fichiers `MDX` :
+ 2. Mettez à jour les références dans vos fichiers Markdown :
```mdx
```
diff --git a/fr/organize/navigation.mdx b/fr/organize/navigation.mdx
index 720c46bf4..a40d6f6e0 100644
--- a/fr/organize/navigation.mdx
+++ b/fr/organize/navigation.mdx
@@ -12,13 +12,13 @@ Avec une configuration de navigation adéquate, vous pouvez organiser votre cont
## Pages
-Les pages sont le composant de navigation le plus fondamental. Elles correspondent aux fichiers MDX qui composent votre documentation.
+Les pages sont le composant de navigation le plus élémentaire. Chaque page est un fichier MDX dans votre référentiel de documentation.
-
+
-
+
-Dans l’objet `navigation`, `pages` est un tableau dans lequel chaque entrée doit référencer le chemin d’accès vers un [fichier de page](/fr/organize/pages).
+Dans l'objet `navigation`, `pages` est un tableau dont chaque entrée doit référencer le chemin d’accès à un [fichier de page](/fr/organize/pages).
```json
{
diff --git a/fr/organize/pages.mdx b/fr/organize/pages.mdx
index aa8a09c58..b8abfb041 100644
--- a/fr/organize/pages.mdx
+++ b/fr/organize/pages.mdx
@@ -1,10 +1,10 @@
---
title: "Pages"
-description: "Configurer les metadata des pages, les titres et les propriétés de frontmatter."
+description: "Configurer les metadata de la page, les titres et les propriétés de frontmatter."
keywords: ["tags", "tag", "frontmatter", "metadata", "layout"]
---
-Chaque page est un fichier MDX qui combine du contenu Markdown avec des composants React, afin de vous permettre de créer une documentation riche et interactive.
+Chaque page est un fichier Markdown. Les types de fichiers `.mdx` et `.md` sont tous deux pris en charge. Nous recommandons d'utiliser MDX, qui combine Markdown avec des composants React pour créer une documentation riche et interactive. Le Markdown simple (`.md`) est pris en charge pour faciliter la migration depuis d'autres plateformes, mais il doit être mis à jour vers MDX pour bénéficier de toutes les fonctionnalités.
## Métadonnées de page
diff --git a/fr/organize/settings.mdx b/fr/organize/settings.mdx
index 3598890a7..9af6f7c16 100644
--- a/fr/organize/settings.mdx
+++ b/fr/organize/settings.mdx
@@ -723,21 +723,21 @@ Cette section présente la référence complète du fichier `docs.json`.
+ 
+ 
@@ -189,13 +189,13 @@ En el modo visual, presiona / para abrir el menú de componentes. Agr
-En el Modo Markdown, editas directamente el `MDX` de tus páginas. Esto puede ser útil cuando necesitas:
+En Markdown mode, puedes editar directamente el MDX de tus páginas. Esto puede ser útil cuando necesitas:
* Definir propiedades específicas de los componentes
* Trabajar con componentes anidados complejos
-* Copiar y pegar contenido `MDX` de otras fuentes
+* Copiar y pegar contenido MDX desde otras fuentes
-Consulta [Formatear texto](/es/create/text) y [Formatear código](/es/create/code) para obtener más información sobre cómo escribir con la sintaxis de Markdown.
+Consulta [Formatear texto](/es/create/text) y [Formatear código](/es/create/code) para obtener más información sobre cómo escribir usando la sintaxis de MDX.
-En el objeto `navigation`, `pages` es un arreglo en el que cada entrada debe hacer referencia a la ruta de un [archivo de página](/es/organize/pages).
+En el objeto `navigation`, `pages` es un array donde cada entrada debe hacer referencia a la ruta de un [archivo de página](/es/organize/pages).
```json
{
diff --git a/es/organize/pages.mdx b/es/organize/pages.mdx
index a1bb19f37..e3cf7e628 100644
--- a/es/organize/pages.mdx
+++ b/es/organize/pages.mdx
@@ -1,10 +1,10 @@
---
title: "Páginas"
-description: "Configura los metadatos de la página, los títulos y las propiedades de frontmatter."
-keywords: ["tags", "tag", "frontmatter", "metadata", "layout"]
+description: "Configura la metadata de la página, los títulos y las propiedades de frontmatter."
+keywords: ["etiquetas", "etiqueta", "frontmatter", "metadata", "diseño"]
---
-Cada página es un archivo MDX, que combina contenido en Markdown con componentes de React para permitirte crear documentación completa e interactiva.
+Cada página es un archivo Markdown. Tanto `.mdx` como `.md` son tipos de archivo compatibles. Recomendamos usar MDX, que combina Markdown con componentes de React para crear documentación enriquecida e interactiva. El Markdown plano (`.md`) se admite para facilitar la migración desde otras plataformas, pero se debería actualizar a MDX para obtener todas las funcionalidades.