Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
48 changes: 26 additions & 22 deletions es/api-playground/openapi-setup.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -521,39 +521,43 @@ El scraper genera:
</Steps>

<div id="create-mdx-files-for-openapi-schemas">
### Crear archivos `MDX` para esquemas de OpenAPI
### Crea archivos `MDX` para esquemas de OpenAPI
</div>

Puedes crear páginas individuales para cualquier esquema de OpenAPI definido en el campo `components.schema` de un documento de OpenAPI:
Puedes crear páginas individuales para cualquier esquema de OpenAPI definido en el campo `components.schemas` de un documento de OpenAPI:

<CodeGroup>
```mdx Ejemplo
---
openapi-schema: OrderItem
---
```

```mdx Formato
---
openapi-schema: "schema-key"
---
```
```mdx Ejemplo
---
openapi-schema: OrderItem
---
```

```mdx Formato
---
openapi-schema: "schema-key"
---
```

</CodeGroup>

Si tienes esquemas con el mismo nombre en varios archivos, también puedes especificar el archivo de OpenAPI:

<CodeGroup>
```mdx Ejemplo
---
openapi-schema: en-schema.json OrderItem
---
```

```mdx Formato
---
openapi-schema: "path-to-schema-file schema-key"
---
```
```mdx Ejemplo
---
openapi-schema: en-schema.json OrderItem
---
```

```mdx Formato
---
openapi-schema: "path-to-schema-file schema-key"
---
```

</CodeGroup>

<div id="webhooks">
Expand Down
14 changes: 9 additions & 5 deletions es/create/files.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -3,11 +3,15 @@ title: "Archivos"
description: "Sirve recursos estáticos desde tu documentación"
---

Mintlify sirve automáticamente recursos estáticos desde el repositorio de tu documentación en la ruta correspondiente de tu domain. Por ejemplo, si tienes `/images/my-logo.png` en tu repositorio, el archivo de imagen estará disponible en `https://docs.your-project.com/images/my-logo.png`.
Mintlify sirve automáticamente recursos estáticos desde el repositorio de tu documentación en la ruta correspondiente de tu dominio. Por ejemplo, si tienes `/images/my-logo.png` en tu repositorio, el archivo de imagen estará disponible en `https://docs.your-project.com/images/my-logo.png`.

Puedes poner a disposición de tus usuarios cualquier tipo de archivo compatible, incluidas especificaciones OpenAPI, imágenes, videos y más.

Los archivos deben ser de menos de 20 MB para imágenes y 100 MB para otros tipos de archivos.
Los archivos deben pesar menos de 20 MB en el caso de las imágenes y 100 MB para otros tipos de archivo.

<Note>
La entrega de archivos no es compatible para sitios de documentación con la autenticación habilitada. Si tu sitio requiere autenticación, los archivos estáticos no serán accesibles en sus URL directas.
</Note>

<div id="supported-file-types">
## Tipos de archivos compatibles
Expand Down Expand Up @@ -67,7 +71,7 @@ Los archivos deben ser de menos de 20 MB para imágenes y 100 MB para otros tipo
### Formatos de documentos
</div>

<Note>Los formatos de documento solo están disponibles en los planes Enterprise.</Note>
<Note>Los formatos de documentos solo están disponibles en planes Custom y no son compatibles cuando la autenticación está habilitada.</Note>

- `.pdf`
- `.txt`
Expand All @@ -81,7 +85,7 @@ Los archivos deben ser de menos de 20 MB para imágenes y 100 MB para otros tipo
### Formatos de datos
</div>

<Note>Los formatos de datos solo están disponibles en los planes Enterprise.</Note>
<Note>Los formatos de datos solo están disponibles en los planes personalizados y no son compatibles cuando la autenticación está habilitada.</Note>

- `.csv`
- `.tsv`
Expand All @@ -91,7 +95,7 @@ Los archivos deben ser de menos de 20 MB para imágenes y 100 MB para otros tipo
### Formatos de archivo comprimido
</div>

<Note>Los formatos de archivo comprimido solo están disponibles en los planes Enterprise.</Note>
<Note>Los formatos de archivo comprimido solo están disponibles en los planes Custom y no son compatibles cuando la autenticación está habilitada.</Note>

- `.zip`
- `.rar`
Expand Down
39 changes: 19 additions & 20 deletions es/create/reusable-snippets.mdx
Original file line number Diff line number Diff line change
@@ -1,30 +1,29 @@
---
title: 'Fragmentos reutilizables'
description: 'Fragmentos personalizados reutilizables para mantener el contenido sincronizado'
title: "Fragmentos reutilizables"
description: "Fragmentos personalizados y reutilizables para mantener el contenido sincronizado"
---

Uno de los principios fundamentales del desarrollo de software es DRY (Don&#39;t Repeat Yourself), que también aplica a la documentación. Si te encuentras repitiendo el mismo contenido en varios lugares, crea un fragmento personalizado para mantener tu contenido sincronizado.
Uno de los principios fundamentales del desarrollo de software es DRY (Dont Repeat Yourself), que también se aplica a la documentación. Si te encuentras repitiendo el mismo contenido en varios lugares, crea un fragmento personalizado para mantener tu contenido sincronizado.

<div id="creating-a-custom-snippet">
## Creación de un fragmento personalizado
## Creación de un snippet personalizado
</div>

**Requisito previo**: Debes crear tu archivo de fragmento en el directorio `snippets` para que la importación funcione.
**Requisito previo**: Debes crear el archivo del snippet en el directorio `snippets` para que la importación funcione.

Cualquier página en el directorio `snippets` se tratará como un fragmento y no
se renderizará como una página independiente. Si deseas crear una página independiente
a partir del fragmento, importa el fragmento en otro archivo e invócalo como un
Cualquier página en el directorio `snippets` se tratará como un snippet y no se
renderizará como una página independiente. Si deseas crear una página independiente
a partir del snippet, importa el snippet en otro archivo y utilízalo como un
componente.

<div id="default-export">
### Exportación por defecto
### Exportación predeterminada
</div>

1. Agrega contenido al archivo del fragmento que quieras reutilizar. Opcionalmente, puedes agregar variables que se puedan completar mediante props
cuando importes el fragmento. En este ejemplo, nuestra variable es word.
1. Agrega contenido al archivo de fragmento que quieras reutilizar.

```typescript snippets/my-snippet.mdx
¡Hola mundo! Este es mi contenido que quiero reutilizar en todas las páginas.
¡Hola mundo! Este es mi contenido que quiero reutilizar en varias páginas.
```

2. Importa el fragmento en tu archivo de destino.
Expand All @@ -39,7 +38,7 @@ import MySnippet from '/snippets/path/to/my-snippet.mdx';

## Encabezado

Lorem ipsum dolor sit amet.
Lorem impsum dolor sit amet.

<MySnippet/>

Expand Down Expand Up @@ -80,12 +79,12 @@ Lorem ipsum dolor sit amet.
1. Exporta una variable desde tu archivo de fragmento:

```typescript snippets/path/to/custom-variables.mdx
export const myName = 'mi nombre';
export const myName = "mi nombre";

export const myObject = { fruit: 'fresas' };
export const myObject = { fruit: "fresas" };
```

2. Importa el fragmento desde el archivo de destino y usa la variable:
2. Importa el fragmento desde tu archivo de destino y usa la variable:

```typescript destination-file.mdx
---
Expand All @@ -102,23 +101,23 @@ Hola, mi nombre es {myName} y me gusta {myObject.fruit}.
### Fragmentos de JSX
</div>

1. Exporta un componente JSX desde tu archivo de fragmento. (Consulta [Componentes de React](/es/customize/react-components) para obtener más información):
1. Exporta un componente de JSX desde tu archivo de fragmentos. (Consulta [Componentes de React](/es/customize/react-components) para obtener más información):

```js icon=square-js snippets/my-jsx-snippet.jsx
export const MyJSXSnippet = () => {
return (
<div>
<h1>¡Hola, mundo!</h1>
</div>
)
}
);
};
```

<Note>
Importante: Al crear fragmentos de JSX, usa la sintaxis de funciones flecha (`=>`) en lugar de declaraciones de función. La palabra clave `function` no es compatible en este contexto.
</Note>

2. Importa el fragmento desde tu archivo de destino y utiliza el componente:
2. Importa el fragmento desde tu archivo de destino y usa el componente:

```typescript destination-file.mdx
---
Expand Down
46 changes: 25 additions & 21 deletions fr/api-playground/openapi-setup.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -524,36 +524,40 @@ Le scraper génère :
### Créer des fichiers `MDX` pour les schémas OpenAPI
</div>

Vous pouvez créer des pages distinctes pour tout schéma OpenAPI défini dans le champ `components.schema` d’un document OpenAPI :
Vous pouvez créer des pages distinctes pour tout schéma OpenAPI défini dans le champ `components.schemas` d’un document OpenAPI :

<CodeGroup>
```mdx Exemple
---
openapi-schema: OrderItem
---
```

```mdx Format
---
openapi-schema: "schema-key"
---
```
```mdx Exemple
---
openapi-schema: OrderItem
---
```

```mdx Format
---
openapi-schema: "schema-key"
---
```

</CodeGroup>

Si vous avez des schémas portant le même nom dans plusieurs fichiers, vous pouvez également préciser le fichier OpenAPI :

<CodeGroup>
```mdx Exemple
---
openapi-schema: en-schema.json OrderItem
---
```

```mdx Format
---
openapi-schema: "path-to-schema-file schema-key"
---
```
```mdx Exemple
---
openapi-schema: en-schema.json OrderItem
---
```

```mdx Format
---
openapi-schema: "path-to-schema-file schema-key"
---
```

</CodeGroup>

<div id="webhooks">
Expand Down
16 changes: 10 additions & 6 deletions fr/create/files.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -3,11 +3,15 @@ title: "Fichiers"
description: "Diffuser des ressources statiques depuis votre documentation"
---

Mintlify diffuse automatiquement les ressources statiques de votre référentiel de documentation au chemin approprié sur votre domain. Par exemple, si vous avez `/images/my-logo.png` dans votre référentiel, le fichier image est accessible à l’adresse `https://docs.your-project.com/images/my-logo.png`.
Mintlify diffuse automatiquement les ressources statiques depuis votre référentiel de documentation au chemin approprié sur votre domain. Par exemple, si vous avez `/images/my-logo.png` dans votre référentiel, le fichier image est disponible à l’URL `https://docs.your-project.com/images/my-logo.png`.

Vous pouvez mettre à disposition de vos utilisateurs tout type de fichier pris en charge, y compris les spécifications OpenAPI, les images, les vidéos, et plus encore.
Vous pouvez mettre à disposition de vos utilisateurs n’importe quel type de fichier pris en charge, notamment des spécifications OpenAPI, des images, des vidéos, et plus encore.

Les fichiers doivent peser moins de 20 Mo pour les images et moins de 100 Mo pour les autres types de fichiers.
Les fichiers doivent faire moins de 20 Mo pour les images et 100 Mo pour les autres types de fichiers.

<Note>
La diffusion de fichiers n’est pas prise en charge pour les sites de documentation avec authentification activée. Si votre site nécessite une authentification, les fichiers statiques ne seront pas accessibles via leurs URL directes.
</Note>

<div id="supported-file-types">
## Types de fichiers pris en charge
Expand Down Expand Up @@ -67,7 +71,7 @@ Les fichiers doivent peser moins de 20 Mo pour les images et moins de 100 Mo pou
### Formats de documents
</div>

<Note>Les formats de documents ne sont disponibles que pour les offres Enterprise.</Note>
<Note>Les formats de documents ne sont disponibles qu’avec les formules Custom et ne sont pas pris en charge lorsque l’authentification est activée.</Note>

- `.pdf`
- `.txt`
Expand All @@ -81,7 +85,7 @@ Les fichiers doivent peser moins de 20 Mo pour les images et moins de 100 Mo pou
### Formats de données
</div>

<Note>Les formats de données sont uniquement disponibles pour les offres Enterprise.</Note>
<Note>Les formats de données sont disponibles uniquement avec les offres Custom et ne sont pas pris en charge lorsque l’authentification est activée.</Note>

- `.csv`
- `.tsv`
Expand All @@ -91,7 +95,7 @@ Les fichiers doivent peser moins de 20 Mo pour les images et moins de 100 Mo pou
### Formats d’archive
</div>

<Note>Les formats d’archive sont uniquement disponibles avec les offres Enterprise.</Note>
<Note>Les formats d’archive sont disponibles uniquement avec les plans Custom et ne sont pas pris en charge lorsque l’authentification est activée.</Note>

- `.zip`
- `.rar`
Expand Down
Loading