summaryrefslogtreecommitdiff
path: root/docs/src/pages/guides/rss.md
diff options
context:
space:
mode:
Diffstat (limited to 'docs/src/pages/guides/rss.md')
-rw-r--r--docs/src/pages/guides/rss.md43
1 files changed, 0 insertions, 43 deletions
diff --git a/docs/src/pages/guides/rss.md b/docs/src/pages/guides/rss.md
deleted file mode 100644
index 7581377a2..000000000
--- a/docs/src/pages/guides/rss.md
+++ /dev/null
@@ -1,43 +0,0 @@
----
-layout: ~/layouts/MainLayout.astro
-title: RSS
-description: An intro to RSS in Astro
----
-
-Astro supports fast, automatic RSS feed generation for blogs and other content websites.
-
-You can create an RSS feed from any Astro page that uses a `getStaticPaths()` function for routing. Only dynamic routes can use `getStaticPaths()` today (see [Routing](/core-concepts/routing)).
-
-> We hope to make this feature available to all other pages before v1.0. As a workaround, you can convert a static route to a dynamic route that only generates a single page. See [Routing](/core-concepts/routing) for more information about dynamic routes.
-
-Create an RSS Feed by calling the `rss()` function that is passed as an argument to `getStaticPaths()`. This will create an `rss.xml` file in your final build based on the data that you provide using the `items` array.
-
-```js
-// Example: /src/pages/posts/[...page].astro
-// Place this function inside your Astro component script.
-export async function getStaticPaths({rss}) {
- const allPosts = Astro.fetchContent('../post/*.md');
- const sortedPosts = allPosts.sort((a, b) => new Date(b.date) - new Date(a.date));
- // Generate an RSS feed from this collection
- rss({
- // The RSS Feed title, description, and custom metadata.
- title: 'Don\'s Blog',
- description: 'An example blog on Astro',
- customData: `<language>en-us</language>`,
- // The list of items for your RSS feed, sorted.
- items: sortedPosts.map(item => ({
- title: item.title,
- description: item.description,
- link: item.url,
- pubDate: item.date,
- })),
- // Optional: Customize where the file is written to.
- // Otherwise, defaults to "/rss.xml"
- dest: "/my/custom/feed.xml",
- });
- // Return your paths
- return [...];
-}
-```
-
-Note: RSS feeds will **not** be built during development. Currently, RSS feeds are only generated during your final build.