feat: create @islands/feed module to generate RSS, Atom, and JSON feeds

ElMassimo commented 2 years ago

Description 📖

This pull request adds a new @islands/feed module powered by feed:

📻 supports RSS, Atom, and JSON feeds
⚡️ HMR during development to debug the result
💪🏼 type autocompletion

Usage 🚀

To generate a feed, create a Vue SFC and specify a path with the appropriate extension:

<page>
path: /feed.atom
</page>

<script setup lang="ts">
import type { FeedOptions, FeedItem } from '@islands/feed'

const { site } = usePage()

const url = site.url

const options: FeedOptions = {
  title: 'The Vue Point',
  description: 'The official blog for the Vue.js project',
  id: url,
  link: url,
  language: 'en',
  image: 'https://vuejs.org/images/logo.png',
  copyright: 'Copyright (c) 2021-present',
}

const posts = Object.values(import.meta.globEagerDefault('./posts/**/*.mdx'))

const items = posts.map<FeedItem>(post => ({
  link: `${url}${post.href}`,
  date: new Date(post.date),
  title: post.title,
  description: post.description,
  content: post,
}))
</script>

<template>
  <RenderFeed format="atom" :options="options" :items="items"/>
</template>

Check the feed documentation for more information.