Sugerencias
← TIL
~3 min de lectura
#astro#i18n#seo#automation

Automatizando sitemaps i18n en Astro

Automatizando sitemaps i18n en Astro#

Automatizá tu sitemap i18n en Astro usando la integración oficial @astrojs/sitemap. Al configurar la propiedad i18n dentro de astro.config.mjs, Astro genera automáticamente las etiquetas hreflang en tu XML, asegurando que Google indexe correctamente las versiones en distintos idiomas de tus páginas sin intervención manual.

El Problema#

Gestionar sitemaps para sitios multi-idioma suele ser un dolor de cabeza: tenés que mapear manualmente cada URL con su alternativa en otro idioma (hreflang), lo que aumenta el riesgo de errores de indexación y contenido duplicado si te olvidás de una ruta. En mi experiencia, mantener esto a mano en un sitio con más de 50 páginas es una receta para el desastre en Search Console.

La Solución#

Aprovechá la integración oficial @astrojs/sitemap. Solo tenés que pasarle el objeto i18n con tu configuración de locales para que el plugin haga el trabajo sucio por vos.

astro.config.mjs
JS
import { defineConfig } from "astro/config";
import sitemap from "@astrojs/sitemap";

export default defineConfig({
  site: "<https://campa.dev>",
  i18n: {
    defaultLocale: "es",
    locales: ["es", "en"],
    routing: { prefixDefaultLocale: true },
  },
  integrations: [
    sitemap({
      i18n: {
        defaultLocale: "es",
        locales: {
          es: "es-PY", // Mapeo a códigos de región específicos
          en: "en-US",
        },
      },
    }),
  ],
});

Esto va a generar un XML que incluye las etiquetas xhtml:link apuntando a las versiones alternativas de cada página, algo vital para que Google entienda la estructura de tu sitio internacional.

Por qué funciona#

Astro 5.x tiene un sistema de i18n nativo de primer nivel. La integración de sitemap consume los metadatos de las rutas generadas por el framework y aplica la lógica de mapeo de locales definida, inyectando los atributos necesarios para el SEO técnico de forma automática durante el build.

Esto complementa perfectamente otras tareas de optimización en Astro 5+ para lograr un sitio ultra-rápido y bien indexado.

Referencias#

g CO₂
Enlace copiado al portapapeles