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
16 changes: 12 additions & 4 deletions src/content/docs/fr/guides/rss.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -67,14 +67,20 @@ Le paquet [`@astrojs/rss`](https://github.com/withastro/astro/tree/main/packages

## Générer des `items`

Le champ `items` accepte une liste d'objets de flux RSS, chacun avec un `link`, un `title` et un `pubDate` obligatoires. Trois valeurs optionnelles peuvent également être incluses : `description` (un court extrait), `content` (le contenu complet de votre article), et un champ `customData` pour inclure des données supplémentaires, telles que d'autres propriétés de vos articles de blog.
Le champ `items` accepte une liste d'objets de flux RSS, qui peuvent être générés à partir des entrées des collections de contenu en utilisant `getCollection()` ou à partir des fichiers de vos pages en utilisant `pagesGlobToRssItems()`.

Vous pouvez générer ce tableau à partir d'un schéma de collection de contenu ou en utilisant [glob imports](/fr/guides/imports/#astroglob) pour les articles de blog situés dans `src/pages/`.
Le format standard des flux RSS comprend les valeurs suivantes pour chaque élément publié :

- `title` : Le titre de l'entrée. Facultatif seulement si une `description` est définie. Sinon, obligatoire.
- `description` : Un court extrait ou une description de l'entrée. Facultatif seulement si un `titre` est défini. Sinon, obligatoire.
- `link` : Une URL vers la source originale de l'entrée. (optionnel)
- `pubDate` : La date de publication de l'entrée. (optionnel)
- `content` : Le contenu complet de l'article. (optionnel)
- `customData` : Un champ pour inclure des données supplémentaires, telles que d'autres propriétés de la page d'accueil de vos articles de blog.

### Utilisation des collections de contenu

Pour créer un flux RSS de pages gérées dans [les collections de contenu](/fr/guides/content-collections/), utilisez la fonction `getCollection()` pour récupérer la liste de vos éléments.
Pour créer un flux RSS de pages gérées dans [les collections de contenu](/fr/guides/content-collections/), utilisez la fonction `getCollection()` pour récupérer les données nécessaires à votre tableau `items`. Vous devrez spécifier les valeurs de chaque propriété désirée (par exemple `title`, `description`) à partir des données retournées.


```js title="src/pages/rss.xml.js" "items:" "const blog = await getCollection('blog');"
Expand Down Expand Up @@ -145,6 +151,8 @@ Dans les versions de `@astrojs/rss` antérieures à v2.1.0, passez le résultat
```js
items: import.meta.glob('./blog/*.{md,mdx}'),
```

Cette méthode est obsolète pour toutes les versions d'Astro depuis la version 2.1.0, et ne peut pas être utilisée dans les projets modernes.
:::

### Inclure le contenu intégral de l'article
Expand All @@ -154,7 +162,7 @@ items: import.meta.glob('./blog/*.{md,mdx}'),
La clé `content` contient le contenu complet de l'article en HTML. Cela vous permet de mettre l'intégralité du contenu de votre article à la disposition des lecteurs de flux RSS.

:::tip
Un paquet comme [`sanitize-html`](https://www.npmjs.com/package/sanitize-html) s'assurera que votre contenu est correctement assaini, échappé et encodé.
Un paquet comme [`sanitize-html`](https://www.npmjs.com/package/sanitize-html) s'assurera que votre contenu est correctement assaini, échappé et encodé. Au cours de ce processus, un tel paquet peut également supprimer certains éléments et attributs inoffensifs. Veillez donc à vérifier le résultat et à configurer le paquet en fonction de vos besoins.
:::

Lorsque vous utilisez des collections de contenu, rendez le `body` du message en utilisant un analyseur Markdown standard comme [`markdown-it`](https://github.com/markdown-it/markdown-it) et désinfectez le résultat :
Expand Down