Add file-based routing /w dynamic paths (#1010)

* wip: add file-based routing

* add pagination tests and nested pagination support

1 files changed, 42 insertions, 0 deletions

diff --git a/docs/src/pages/guides/rss.md b/docs/src/pages/guides/rss.md
new file mode 100644
index 000000000..d4ac14d5f
--- /dev/null
+++ b/docs/src/pages/guides/rss.md
@@ -0,0 +1,42 @@
+---
+layout: ~/layouts/MainLayout.astro
+title: RSS
+---
+
+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.