Skip to content
Merged
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
66 changes: 66 additions & 0 deletions src/content/docs/fr/guides/content-collections.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -569,6 +569,72 @@ const { Content } = await render(post);
Explorez le dossier `src/pages/` du [code de démonstration du tutoriel du blog sur GitHub](https://github.com/withastro/blog-tutorial-demo/tree/content-collections/src/pages) pour voir des exemples complets de création de pages à partir de vos collections pour des fonctionnalités de blog telles qu'une liste d'articles de blog, des pages de balises, etc.
:::

## Schémas JSON de collection

<p><Since v="4.13.0" /></p>

Astro génère automatiquement des fichiers de [schéma JSON](https://json-schema.org/) pour les collections, que vous pouvez utiliser dans votre éditeur pour obtenir IntelliSense et la vérification de type pour les fichiers de données.

Un fichier de schéma au format JSON est généré pour chaque collection de votre projet et envoyé dans le répertoire `.astro/collections/`. Par exemple, si vous avez deux collections, l'une nommée `authors` et l'autre `posts`, Astro générera `.astro/collections/authors.schema.json` et `.astro/collections/posts.schema.json`.

### Utiliser des schémas JSON dans les fichiers JSON

Vous pouvez pointer manuellement vers un schéma généré par Astro en définissant le champ `$schema` dans votre fichier JSON.
La valeur doit être un chemin d'accès au schéma relatif au fichier de données.
Dans l'exemple suivant, un fichier de données dans `src/data/authors/` utilise le schéma généré pour la collection `authors` :

```json title="src/data/authors/armand.json" ins={2}
{
"$schema": "../../../.astro/collections/authors.schema.json",
"name": "Armand",
"skills": ["Astro", "Starlight"]
}
```

#### Utiliser un schéma pour un groupe de fichiers JSON dans VS Code

Dans VS Code, vous pouvez configurer un schéma applicable à tous les fichiers d'une collection grâce au [paramètre `json.schemas`](https://code.visualstudio.com/docs/languages/json#_json-schemas-and-settings).
Dans l'exemple suivant, tous les fichiers du répertoire `src/data/authors/` utiliseront le schéma généré pour la collection `authors` :

```json
{
"json.schemas": [
{
"fileMatch": ["/src/data/authors/**"],
"url": "./.astro/collections/authors.schema.json"
}
]
}
```

### Utiliser des schémas dans les fichiers YAML dans VS Code

Dans VS Code, vous pouvez ajouter la prise en charge des schémas JSON dans les fichiers YAML grâce à l'extension [Red Hat YAML](https://marketplace.visualstudio.com/items?itemName=redhat.vscode-yaml).
Une fois cette extension installée, vous pouvez référencer un schéma dans un fichier YAML à l'aide d'une syntaxe de commentaire spécifique :

```yaml title="src/data/authors/armand.yml" ins={1}
# yaml-language-server: $schema=../../../.astro/collections/authors.schema.json
name: Armand
skills:
- Astro
- Starlight
```

#### Utiliser des schémas pour un groupe de fichiers YAML dans VS Code

Avec l'extension Red Hat YAML, vous pouvez configurer un schéma applicable à tous les fichiers YAML d'une collection grâce au paramètre `yaml.schemas`.
Dans l'exemple suivant, tous les fichiers YAML du répertoire `src/data/authors/` utiliseront le schéma généré pour la collection `authors` :

```json
{
"yaml.schemas": {
"./.astro/collections/authors.schema.json": ["/src/content/authors/*.yml"]
}
}
```

Consultez [« Association de schémas »](https://marketplace.visualstudio.com/items?itemName=redhat.vscode-yaml#associating-schemas) dans la documentation de l'extension Red Hat YAML pour plus de détails.

## Quand créer une collection

Vous pouvez [créer une collection](#définition-des-collections) à chaque fois que vous disposez d'un groupe de données ou de contenus associés qui partagent une structure commune.
Expand Down