Skip to content
Closed
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
858 changes: 429 additions & 429 deletions .gt/downloaded-versions.json

Large diffs are not rendered by default.

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
8 changes: 4 additions & 4 deletions es/create/files.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -67,7 +67,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 los planes Enterprise (excepto cuando se usa autenticación).</Note>

- `.pdf`
- `.txt`
Expand All @@ -81,17 +81,17 @@ 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 están disponibles únicamente en los planes Enterprise (excepto cuando se usa autenticación).</Note>

- `.csv`
- `.tsv`
- `.xml`

<div id="archive-formats">
### Formatos de archivo comprimido
### Formatos de archivo
</div>

<Note>Los formatos de archivo comprimido solo están disponibles en los planes Enterprise.</Note>
<Note>Los formatos de archivo solo están disponibles para planes Enterprise (excepto cuando se usa autenticación).</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
6 changes: 3 additions & 3 deletions fr/create/files.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -67,7 +67,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 que pour les offres Enterprise (sauf lors de l’authentification).</Note>

- `.pdf`
- `.txt`
Expand All @@ -81,7 +81,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 uniquement disponibles avec les offres Enterprise (sauf en cas d’authentification).</Note>

- `.csv`
- `.tsv`
Expand All @@ -91,7 +91,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 ne sont disponibles que pour les plans Enterprise (sauf en cas d’authentification).</Note>

- `.zip`
- `.rar`
Expand Down
42 changes: 22 additions & 20 deletions fr/create/reusable-snippets.mdx
Original file line number Diff line number Diff line change
@@ -1,33 +1,33 @@
---
title: 'Extraits réutilisables'
description: 'Extraits personnalisés réutilisables pour garder le contenu synchronisé'
title: "Extraits réutilisables"
description: "Extraits personnalisés et réutilisables pour maintenir le contenu synchronisé"
---

L’un des principes fondamentaux du développement logiciel est DRY (Don&#39;t Repeat Yourself), qui s’applique aussi à la documentation. Si vous répétez le même contenu à plusieurs endroits, créez un extrait personnalisé pour garder votre contenu synchronisé.
L’un des principes fondamentaux du développement logiciel est DRY (Don’t Repeat
Yourself), qui s’applique aussi à la documentation. Si vous vous retrouvez à répéter le même contenu à plusieurs endroits, créez un extrait personnalisé pour maintenir votre contenu synchronisé.

<div id="creating-a-custom-snippet">
## Créer un extrait personnalisé
</div>

**Prérequis** : vous devez créer votre fichier d’extrait dans le répertoire `snippets` pour que l’import fonctionne.
**Condition préalable** : vous devez créer votre fichier d’extrait dans le répertoire `snippets` pour que l’import fonctionne.

Toute page située dans le répertoire `snippets` sera traitée comme un extrait et ne sera pas
rendue en page autonome. Si vous souhaitez créer une page autonome
à partir de l’extrait, importez l’extrait dans un autre fichier et utilisez-le comme
rendue en tant que page autonome. Si vous souhaitez créer une page autonome
à partir de l’extrait, importez l’extrait dans un autre fichier et appelez-le en tant que
composant.

<div id="default-export">
### Export par défaut
</div>

1. Ajoutez du contenu au fichier d’extrait que vous souhaitez réutiliser. Vous pouvez éventuellement ajouter des variables qui seront renseignées via des props
lors de l’import de l’extrait. Dans cet exemple, notre variable est word.
1. Ajoutez du contenu à votre fichier d’extrait que vous souhaitez réutiliser.

```typescript snippets/my-snippet.mdx
Bonjour le monde ! Voici mon contenu que je souhaite réutiliser sur plusieurs pages.
Bonjour le monde ! Voici mon contenu que je souhaite réutiliser sur plusieurs pages.
```

2. Importez l’extrait dans le fichier de destination.
2. Importez le snippet dans votre fichier de destination.

```typescript destination-file.mdx
---
Expand Down Expand Up @@ -77,15 +77,15 @@ Lorem ipsum dolor sit amet.
### Variables réutilisables
</div>

1. Exportez une variable depuis votre fichier d’extrait :
1. Exportez une variable depuis votre fichier de fragment :

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

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

2. Importez l’extrait depuis votre fichier cible et utilisez la variable :
2. Importez l’extrait depuis votre fichier de destination et utilisez la variable :

```typescript destination-file.mdx
---
Expand All @@ -102,23 +102,25 @@ Bonjour, je m'appelle {myName} et j'aime {myObject.fruit}.
### Extraits JSX
</div>

1. Exportez un composant JSX depuis votre fichier d’extraits. (Voir [Composants React](/fr/customize/react-components) pour plus d’informations)
1. Exportez un composant JSX depuis votre fichier d’extraits. (Voir [Composants React](/fr/customize/react-components) pour en savoir plus) :

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

<Note>
Important : Lors de la création d’extraits JSX, utilisez la syntaxe de fonction fléchée (`=>`) plutôt que des déclarations de fonction. Le mot-clé `function` n’est pas pris en charge dans ce contexte.
Important : lors de la création d&#39;extraits JSX, utilisez la syntaxe de fonction fléchée (`=>`)
plutôt que des déclarations de fonction. Le mot‑clé `function` n&#39;est pas pris en charge dans ce
contexte.
</Note>

2. Importez lextrait depuis votre fichier cible et utilisez le composant :
2. Importez l&#39;extrait depuis votre fichier de destination et utilisez le composant :

```typescript destination-file.mdx
---
Expand Down
Loading