RSS

Astro proporciona una generación rápida y automática de feeds RSS para blogs u otros sitios web con mucho contenido. Los feeds RSS proporcionan una forma fácil para que los usuarios se suscriban a tu contenido.

Configurando @astrojs/rss

Sección titulada Configurando @astrojs/rss

El paquete @astrojs/rss provee helpers para generar RSS feeds utilizando API endpoints. Esto desbloquea la generación de RSS feeds para builds estáticos y on-demand para cuando utilizamos un adaptador SSR.

1. Instala @astrojs/rss utilizando tu gestor de paquetes favorito:

   npm

   npm install @astrojs/rss

   pnpm

   pnpm add @astrojs/rss

   Yarn

   yarn add @astrojs/rss

   Consejo

   Asegurate de haber configurado un site en el astro.config de tu proyecto. Lo usarás para generar links a tus artículos RSS.

2. Crea un archivo en src/pages/ con un nombre de tu elección y la extensión .xml.js para ser utilizado como la URL de salida de tu feed. Algunos nombres comunes de URL de feed RSS son feed.xml o rss.xml.

   El archivo de ejemplo a continuación src/pages/rss.xml.js creará un feed RSS en site/rss.xml.

3. Importa el helper rss() del paquete @astrojs/rss en tu archivo .xml.js y exporta una función que lo devuelve utilizando los siguientes parámetros:

   src/pages/rss.xml.js

   import rss from '@astrojs/rss';
   
   export function GET(context) {
     return rss({
       // `<title>` campo en el xml generado
       title: 'Blog de Buzz',
       // `<description>` campo en el xml generado
       description: 'Guía de un humilde astronauta a las estrellas',
       // Usa el "site" desde el contexto del endpoint
       // https://docs.astro.build/en/reference/api-reference/#contextsite
       site: context.site,
       // Array de `<item>`s en el xml generado
       // Consulta la sección "Generando `items`" para ejemplos utilizando colecciones de contenido y glob imports
       items: [],
       // (opcional) inyecta xml personalizado
       customData: `<language>es</language>`,
     });
   }

Generando items

Sección titulada Generando items

El campo items acepta una lista de objetos de feed RSS, que pueden ser generados a partir de las entradas de colecciones de contenido utilizando getCollection() o desde tus archivos de página utilizando pagesGlobToRssItems().

El formato estándar de RSS feed incluye los siguientes valores para cada item publicado:

• title: El título de la entrada. Opcional solo si se establece una description. De lo contrario, requerido.
• description: Un breve extracto de o describiendo la entrada. Opcional solo si se establece un title. De lo contrario, requerido.
• link: Una URL a la fuente original de la entrada. (opcional)
• pubDate: La fecha de publicación de la entrada. (opcional)
• content: El contenido completo de tu post. (opcional)
• customData: Un campo para incluir cualquier dato extra, como otras propiedades de frontmatter de tus posts de blog.

Usando colecciones de contenido

Sección titulada Usando colecciones de contenido

Para crear un RSS feed de páginas manejadas en colecciones de contenido, utiliza la función getCollection() para recuperar la lista de tus artículos. Necesitarás especificar los valores para cada propiedad deseada (ej. title, description) de los datos devueltos.

src/pages/rss.xml.js

export async function GET(context) {
  const blog = await getCollection('blog');
  return rss({
    title: 'Blog de Buzz',
    description: 'Guía de un humilde astronauta a las estrellas',
    site: context.site,
    items: blog.map((post) => ({
      title: post.data.title,
      pubDate: post.data.pubDate,
      description: post.data.description,
      customData: post.data.customData,
      // Calcula el link RSS desde el `slug` del post
      // Este ejemplo asume que todos los posts son renderizados como rutas `/blog/[slug]`
      link: `/blog/${post.slug}/`,
    })),
  });
}

Opcional: reemplaza tu esquema de colección de blog existente para cumplir con las propiedades de RSS esperadas.

Para asegurarte de que cada entrada de blog produzca un elemento de feed RSS válido, puedes importar y aplicar opcionalmente rssSchema en lugar de definir cada propiedad individual de tu esquema.

src/content/config.ts

import { rssSchema } from '@astrojs/rss';
const blog = defineCollection({
  schema: rssSchema,
});

export const collections = { blog };

Usando glob imports

Sección titulada Usando glob imports

Agregado en: @astrojs/rss@2.1.0

Para crear un RSS feed de documentos en src/pages/, utiliza la función pagesGlobToRssItems(). Esta acepta un resultado de import.meta.glob y devuelve un array de items RSS válidos (consulta más sobre escribir patrones glob para especificar qué páginas incluir).

Precaución

Esta función asume, pero no verifica, que todas las propiedades RSS necesarias están presentes en el frontmatter de cada documento. Si encuentras errores, verifica manualmente el frontmatter de cada página.

src/pages/rss.xml.js

import rss, { pagesGlobToRssItems } from '@astrojs/rss';
export async function GET(context) {
  return rss({
    title: 'Blog de Buzz',
    description: 'Guía de un humilde astronauta a las estrellas',
    site: context.site,
    items: await pagesGlobToRssItems(
      import.meta.glob('./blog/*.{md,mdx}'),
    ),
  });
}

¿Estás usando una versión anterior?

En versiones de @astrojs/rss anteriores a la v2.1.0, pasa tu resultado de glob directamente a items sin el wrapper pagesGlobToRssItems():

items: import.meta.glob('./blog/*.{md,mdx}'),

Este método es obsoleto para todas las versiones de Astro desde la v2.1.0 y no puede ser utilizado en proyectos modernos.

Incluyendo contenido completo de un artículo

Sección titulada Incluyendo contenido completo de un artículo

Agregado en: astro@1.6.14

La llave content contiene el contenido completo del post como HTML. Esto te permite hacer disponible todo el contenido del post a los lectores de RSS.

Consejo

Un paquete como sanitize-html se asegurará de que tu contenido esté correctamente sanitizado, escapado y codificado. En el proceso, este paquete podría remover algunos elementos y atributos inofensivos, así que asegurate de verificar la salida y configurar el paquete de acuerdo a tus necesidades.

Cuando utilices colecciones de contenido, renderiza el body del post usando un parser de Markdown estándar como markdown-it y desinfecta el resultado, incluyendo cualquier etiqueta (e.g. <img>) necesaria para renderizar tu componente:

src/pages/rss.xml.js

import rss from '@astrojs/rss';
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: 'Guía de las estrellas para un humilde astronauta',
    site: context.site,
    items: blog.map((post) => ({
      link: `/blog/${post.slug}/`,
      // Nota: esto no procesará componentes ni expresiones JSX en archivos MDX.
      content: sanitizeHtml(parser.render(post.body), {
        allowedTags: sanitizeHtml.defaults.allowedTags.concat(['img'])
      }),
      ...post.data,
    })),
  });
}

Cuando utilices imports glob con Markdown, puedes utilizar el helper compiledContent() para recuperar el HTML renderizado para desinfectarlo. Nota: esta función no es compatible con archivos 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: 'Guía de un humilde astronauta a las estrellas',
    site: context.site,
    items: posts.map((post) => ({
      link: post.url,
      content: sanitizeHtml(post.compiledContent()),
      ...post.frontmatter,
    })),
  });
}

Eliminando las barras diagonales finales

Sección titulada Eliminando las barras diagonales finales

El feed RSS de Astro produce enlaces con una barra diagonal al final por defecto, sin importar el valor que hayas configurado para trailingSlash. Esto significa que los enlaces de tu RSS pueden no coincidir exactamente con las URLs de tus posts.

Si has configurado trailingSlash: "never" en tu astro.config.mjs, establece trailingSlash: false en el helper rss() para que tu feed coincida con la configuración de tu proyecto.

src/pages/rss.xml.js

import rss from '@astrojs/rss';

export function GET(context) {
  const posts = Object.values(postImportResult);
  return rss({
    title: 'Blog de Buzz',
    description: 'Guía de un humilde astronauta a las estrellas',
    site: context.site,
    trailingSlash: false,
    items: posts.map((post) => ({
      link: post.url,
      ...post.frontmatter,
    })),
  });
}

Añadiendo una hoja de estilos

Sección titulada Añadiendo una hoja de estilos

Puedes estilar tu RSS feed para proveer una experiencia de usuario más placentera a la hora de ver el archivo en el navegador.

Utiliza la opción stylesheet de la helper function rss para especificar un path absoluto a tu hoja de estilos.

rss({
  // ej. utiliza tus estilos de "public/rss/styles.xsl"
  stylesheet: '/rss/styles.xsl',
  // ...
});

Consejo

Si prefieres no crear tu propia hoja de estilos, puedes utilizar una hoja de estilos predefinida como la hoja de estilos predeterminada de Pretty Feed v3. Descarga la hoja de estilos desde GitHub y guárdala en el directorio public/ de tu proyecto.

Detección automática de fuentes RSS

Sección titulada Detección automática de fuentes RSS

RSS autodiscovery permite a los navegadores y otros programas encontrar automáticamente el canal RSS de un sitio a partir de la URL principal.

Para habilitarlo, agregue una etiqueta <link> con los siguientes atributos al elemento head de su sitio.

<link
    rel="alternate"
    type="application/rss+xml"
    title="Título de su sitio web"
    href={new URL("rss.xml", Astro.site)}
/>

Con esta etiqueta, los lectores de tu blog pueden introducir la URL base de tu sitio en su lector RSS para suscribirse a tus entradas sin necesidad de la URL específica de tu canal RSS.

Siguientes pasos

Sección titulada Siguientes pasos

Después de visitar tu feed en el navegador en your-domain.com/rss.xml y confirmar que puedes ver datos para cada una de tus publicaciones, ahora puedes promocionar tu feed en tu sitio web. Agregar el icono estándar de RSS a tu sitio informa a tus lectores que pueden suscribirse a tus publicaciones en su propio lector de feeds.

Recursos

Sección titulada Recursos

• Feeds RSS