import Since from '/components/Since.astro'; import { Steps } from '@astrojs/starlight/components'; import PackageManagerTabs from '/components/tabs/PackageManagerTabs.astro';

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

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.

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.

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:

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

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.

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.

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

Usando glob imports

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).

:::caution 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. :::

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}'),    ),  });}

:::note[¿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

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.

:::tip 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:

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.

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

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.

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

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',  // ...});

:::tip 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

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={`${Astro.site}rss.xml`}/>

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

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

• Feeds RSS