Flux RSS
Astro prend en charge la gĂ©nĂ©ration rapide et automatique de flux RSS pour les blogs et autres contenus. Pour plus dâinformations sur les flux RSS en gĂ©nĂ©ral, voir aboutfeeds.com.
Mise en place dâ@astrojs/rss
Section titled Mise en place dâ@astrojs/rssLe package @astrojs/rss
fournit des fonctions dâaide pour la gĂ©nĂ©ration de flux RSS en utilisant des âAPI endpointsâ (ou points dâarrĂȘt API). Cela permet de dĂ©bloquer Ă la fois les builds statiques et la gĂ©nĂ©ration Ă la demande lors de lâutilisation dâun adaptateur SSR.
Pour commencer, installez @astrojs/rss
en utilisant votre gestionnaire de Package préféré :
Ensuite, assurez-vous que vous avez configuré la valeur site
dans le fichier astro.config
de votre projet. Vous lâutiliserez pour gĂ©nĂ©rer des liens vers vos articles RSS.
Maintenant que tout est prĂȘt, gĂ©nĂ©rons notre premier flux RSS ! CrĂ©ez un fichier rss.xml.js
dans votre répertoire src/pages/
. rss.xml
sera lâURL de sortie, donc nâhĂ©sitez pas Ă le renommer si vous prĂ©fĂ©rez.
Ensuite, importez lâHelper rss
du Package @astrojs/rss
et appelez-le avec les paramĂštres suivants :
Génération des items
Section titled Génération des itemsLe champ items
accepte un tableau dâobjets de flux RSS, chacun avec un link
, title
, pubDate
, et des champs optionnels description
, content
, et customData
. Vous pouvez gĂ©nĂ©rer ce tableau Ă partir dâune collection de contenu ou en utilisant des importations globales.
Utilisation des collections de contenu
Section titled Utilisation des collections de contenuPour créer un flux RSS des pages gérées dans les collections de contenus (EN), vous utilisez la fonction getCollection()
pour récupérer le tableau de vos items.
Vous pouvez configurer votre schéma de collection pour appliquer ces propriétés RSS attendues. Importez et appliquez rssSchema
pour vous assurer que chaque entrée de la collection produit un item de flux RSS valide.
Utilisation des importations globales
Section titled Utilisation des importations globales@astrojs/rss@2.1.0
Pour créer un flux RSS depuis les documents dans /src/pages
, utilisez lâHelper pagesGlobToRssItems()
. Elle accepte un résultat import.meta.glob
et produit un tableau dâitems de flux RSS valides (en savoir plus Ă propos de lâĂ©criture des patterns globaux pour spĂ©cifier les pages Ă inclure).
Cette fonction suppose, mais ne vérifie pas, que toutes les propriétés de flux requises sont présentes dans le frontmatter de chaque document. Si vous rencontrez des erreurs, vérifiez le frontmatter de chaque page manuellement.
Incluant le contenu complet de la publication
Section titled Incluant le contenu complet de la publicationastro@1.6.14
La clé content
contient le contenu complet du post au format HTML. Cela vous permet de mettre lâintĂ©gralitĂ© du contenu de votre post Ă la disposition des lecteurs du flux RSS.
Quand vous utilisez des collections de contenu, rendez le post body
en utilisant un parser Markdown standard comme markdown-it
et nettoyez le résultat :
Quand vous utilisez les imports globaux avec Markdown, nous vous suggĂ©rons dâutiliser lâHelper compiledContent()
pour rĂ©cupĂ©rer le HTML rendu afin de le nettoyer. Note : cette fonctionnalitĂ© nâest pas supportĂ©e pour les fichiers MDX.
Ajout dâune feuille de style
Section titled Ajout dâune feuille de styleVous pouvez styliser votre flux RSS pour une expĂ©rience utilisateur plus agrĂ©able lors de la visualisation du fichier dans votre navigateur.
Utilisez lâoption stylesheet
de la fonction rss
pour spécifier un chemin absolu vers votre feuille de style.
Si vous nâavez pas de feuille de style RSS en tĂȘte, nous recommandons la feuille de style par dĂ©faut Pretty Feed v3, que vous pouvez tĂ©lĂ©charger depuis GitHub et sauvegarder dans le rĂ©pertoire public/
de votre projet.
More recipes
-
Partage d'Ătat
Learn how to share state across components â and frameworks! â with Nano Stores.
-
Flux RSS
Une introduction aux flux RSS avec Astro.
-
Installing a Vite or Rollup plugin
Learn how you can import YAML data by adding a Rollup plugin to your project.
-
Build Forms With API Routes
Learn how to use JavaScript to send form submissions to an API Route
-
Build HTML Forms in Astro Pages
Learn how to build HTML forms and handle submissions in your frontmatter
-
Use Bun with Astro
Learn how to use Bun with your Astro site.
-
Call endpoints from the server
Learn how to call endpoints from the server in Astro.
-
Verify a Captcha
Learn how to create an API route and fetch it from the client.
-
Build your Astro Site with Docker
Learn how to build your Astro site using Docker.
-
Add icons to external links
Learn how to install a rehype plugin to add icons to external links in your Markdown files
-
Add i18n features
Use dynamic routing and content collections to add internationalization support to your Astro site.
-
Add Last Modified Time
Build a remark plugin to add the last modified time to your Markdown and MDX.
-
Add Reading Time
Build a remark plugin to add reading time to your Markdown or MDX files.
-
Share State Between Astro Components
Learn how to share state across Astro components with Nano Stores.