Aller au contenu

Ajouter un flux RSS

Astro prend en charge la génération rapide et automatique de flux RSS pour les blogs et autres sites web de contenu. Les flux RSS permettent aux utilisateurs de s’abonner facilement à votre contenu.

Le paquet @astrojs/rss fournit des aides pour générer des flux RSS en utilisant des points de terminaison d’API. . Cela débloque à la fois les constructions statiques et la génération à la demande lors de l’utilisation d’un adaptateur SSR.

  1. Installez @astrojs/rss en utilisant votre gestionnaire de paquets préféré :

    Fenêtre de terminal
    npm install @astrojs/rss
  2. Créez un fichier dans src/pages/ avec un nom de votre choix et l’extension .xml.js qui sera utilisé comme URL de sortie pour votre flux. Certains noms d’URL de flux RSS courants sont feed.xml ou rss.xml.

    Le fichier d’exemple ci-dessous src/pages/rss.xml.js créera un flux RSS à l’adresse site/rss.xml.

  3. Importez l’aide rss() du paquetage @astrojs/rss dans votre fichier .xml.js et exportez une fonction qui la retourne en utilisant les paramètres suivants :

    src/pages/rss.xml.js
    import rss from '@astrojs/rss';
    export function GET(context) {
    return rss({
    // `<title>` champ dans le fichier xml de sortie
    title: 'Blog de Buzz',
    // `<description>` champ dans le fichier xml de sortie
    description: "Le guide des étoiles d'un humble astronaute",
    // Insérez le "site" de votre projet dans le contexte du point de terminaison.
    // https://docs.astro.build/fr/reference/api-reference/#contextsite
    site: context.site,
    // Tableau des `<item>`s dans la sortie xml
    // Voir la section "Génération d'éléments" pour des exemples utilisant des collections de contenu et des importations globales.
    items: [],
    // (optional) injecter du xml personnalisé
    customData: `<language>fr-FR</language>`,
    });
    }

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().

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.

Pour créer un flux RSS de pages gérées dans les collections de contenu, 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.

src/pages/rss.xml.js
import rss from '@astrojs/rss';
import { getCollection } from 'astro:content';
export async function GET(context) {
const blog = await getCollection('blog');
return rss({
title: 'Blog de Buzz',
description: "Le guide des étoiles d'un humble astronaute",
site: context.site,
items: blog.map((post) => ({
title: post.data.title,
pubDate: post.data.pubDate,
description: post.data.description,
customData: post.data.customData,
// Calculer le lien RSS à partir de l'article `slug`
// Cet exemple suppose que tous les articles sont rendus sous forme de routes `/blog/[slug]`.
link: `/blog/${post.slug}/`,
})),
});
}

Facultatif : remplacez votre schéma de collection de blogs existant pour appliquer les propriétés RSS attendues.

Pour vous assurer que chaque entrée de blog produise un élément de flux RSS valide, vous pouvez éventuellement importer et appliquer rssSchema au lieu de définir chaque propriété individuelle de votre schéma.

src/content/config.ts
import { defineCollection } from 'astro:content';
import { rssSchema } from '@astrojs/rss';
const blog = defineCollection({
schema: rssSchema,
});
export const collections = { blog };

Ajouté à la version : @astrojs/rss@2.1.0

Pour créer un flux RSS à partir des documents contenus dans src/pages/, utilisez l’aide pagesGlobToRssItems(). Elle accepte un résultat import.meta.glob et produit un tableau d’éléments de flux RSS valides (voir plus d’informations sur l’écriture de motifs glob pour spécifier les pages à inclure).

src/pages/rss.xml.js
import rss, { pagesGlobToRssItems } from '@astrojs/rss';
export async function GET(context) {
return rss({
title: 'Blog de Buzz',
description: "Le guide des étoiles d'un humble astronaute",
site: context.site,
items: await pagesGlobToRssItems(
import.meta.glob('./blog/*.{md,mdx}'),
),
});
}

Inclure le contenu intégral de l’article

Titre de la section Inclure le contenu intégral de l’article

Ajouté à la version : astro@1.6.14

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.

Lorsque vous utilisez des collections de contenu, rendez le post body en utilisant un parseur Markdown standard comme markdown-it et assainissez le résultat, en incluant toutes les balises supplémentaires (par exemple <img>) nécessaires pour afficher votre contenu :

src/pages/rss.xml.js
import rss from '@astrojs/rss';
import { getCollection } from 'astro:content';
import sanitizeHtml from 'sanitize-html';
import MarkdownIt from 'markdown-it';
const parser = new MarkdownIt();
export async function GET(context) {
const blog = await getCollection('blog');
return rss({
title: 'Blog de Buzz',
description: "Le guide des étoiles d'un humble astronaute",
site: context.site,
items: blog.map((post) => ({
link: `/blog/${post.slug}/`,
// Note : ceci ne traitera pas les composants ou les expressions JSX dans les fichiers MDX.
content: sanitizeHtml(parser.render(post.body), {
allowedTags: sanitizeHtml.defaults.allowedTags.concat(['img'])
}),
...post.data,
})),
});
}

Lorsque vous utilisez des importations globales avec Markdown, vous pouvez utiliser l’aide compiledContent() pour récupérer le HTML rendu pour l’assainissement. Note : cette fonctionnalité n’est pas supportée pour les fichiers MDX.

src/pages/rss.xml.js
import rss from '@astrojs/rss';
import sanitizeHtml from 'sanitize-html';
export function GET(context) {
const postImportResult = import.meta.glob('../posts/**/*.md', { eager: true });
const posts = Object.values(postImportResult);
return rss({
title: 'Blog de Buzz',
description: "Le guide des étoiles d'un humble astronaute",
site: context.site,
items: posts.map((post) => ({
link: post.url,
content: sanitizeHtml(post.compiledContent()),
...post.frontmatter,
})),
});
}

Le flux RSS d’Astro produit des liens avec une barre oblique par défaut, quelle que soit la valeur configurée pour trailingSlash. Cela signifie que vos liens RSS peuvent ne pas correspondre exactement aux URLs de vos articles.

Si vous avez configuré trailingSlash : « never » dans votre astro.config.mjs, configurez trailingSlash : false dans l’aide rss() pour que votre flux corresponde à la configuration de votre projet.

src/pages/rss.xml.js
import rss from '@astrojs/rss';
export function GET(context) {
const posts = Object.values(postImportResult);
return rss({
title: 'Le blog de Buzz',
description: "Le guide des étoiles d'un humble astronaute",
site: context.site,
trailingSlash: false,
items: posts.map((post) => ({
link: post.url,
...post.frontmatter,
})),
});
}

Stylez votre flux RSS pour une expérience utilisateur plus agréable lorsque vous visualisez le fichier dans votre navigateur.

Utilisez l’option stylesheet de la fonction rss pour spécifier un chemin absolu vers votre feuille de style.

rss({
// ex. utilisez votre feuille de style depuis "public/rss/styles.xsl"
stylesheet: '/rss/styles.xsl',
// ...
});

Activation de la découverte automatique des flux RSS

Titre de la section Activation de la découverte automatique des flux RSS

RSS autodiscovery permet aux navigateurs et autres logiciels de trouver automatiquement le flux RSS d’un site à partir de l’URL principale.

Pour l’activer, ajoutez une balise <link> avec les attributs suivants à l’élément head de votre site :

<link
rel="alternate"
type="application/rss+xml"
title="Votre titre de site"
href={new URL("rss.xml", Astro.site)}
/>

Grâce à cette balise, les lecteurs de votre blog peuvent saisir l’URL de base de votre site dans leur lecteur RSS pour s’abonner à vos articles sans avoir besoin de l’URL spécifique de votre flux RSS.

Après avoir consulté votre flux dans le navigateur à l’adresse votre-domaine.com/rss.xml et confirmé que vous pouvez voir les données de chacun de vos articles, vous pouvez maintenant promouvoir votre flux sur votre site web. L’ajout de l’icône RSS standard sur votre site permet à vos lecteurs de savoir qu’ils peuvent s’abonner à vos articles dans leur propre lecteur de flux.