--- name: sitemap description: Sitemap knowledge base - XML sitemap generation, XSL styling, hreflang, sitemap index for Next.js. Use when creating or improving XML sitemaps, adding hreflang sitemap entries, or implementing sitemap index files. version: 1.0.0 --- # Sitemap Skill Knowledge base per generazione sitemap XML ottimizzate con XSL styling. ## Sitemap Next.js (App Router) ### Sitemap Base ```typescript // app/sitemap.ts import type { MetadataRoute } from 'next'; const BASE_URL = process.env.NEXT_PUBLIC_SITE_URL || 'https://example.com'; const locales = ['it', 'en', 'cs']; export default async function sitemap(): Promise { const staticRoutes = ['', '/chi-siamo', '/servizi', '/contatti']; const legalRoutes = ['/privacy', '/cookie-policy', '/terms']; // Static pages per locale const staticPages = locales.flatMap(locale => staticRoutes.map(route => ({ url: `${BASE_URL}/${locale}${route}`, lastModified: new Date(), changeFrequency: 'weekly' as const, priority: route === '' ? 1.0 : 0.8, alternates: { languages: Object.fromEntries( locales.map(l => [l, `${BASE_URL}/${l}${route}`]) ), }, })) ); // Legal pages (lower priority) const legalPages = locales.flatMap(locale => legalRoutes.map(route => ({ url: `${BASE_URL}/${locale}${route}`, lastModified: new Date(), changeFrequency: 'yearly' as const, priority: 0.3, })) ); // Dynamic pages from CMS const dynamicPages = await getDynamicPages(); return [...staticPages, ...legalPages, ...dynamicPages]; } async function getDynamicPages(): Promise { // Fetch from Payload CMS const payload = await getPayloadClient(); // Blog posts const { docs: posts } = await payload.find({ collection: 'posts', where: { status: { equals: 'published' } }, limit: 1000, }); return locales.flatMap(locale => posts.map(post => ({ url: `${BASE_URL}/${locale}/blog/${post.slug}`, lastModified: new Date(post.updatedAt), changeFrequency: 'weekly' as const, priority: 0.6, alternates: { languages: Object.fromEntries( locales.map(l => [l, `${BASE_URL}/${l}/blog/${post.slug}`]) ), }, })) ); } ``` ### Sitemap con XSL Styling Per una sitemap leggibile da umani, usa un foglio XSL: ```xml Sitemap — [SITE NAME]

Sitemap

URLs

URL	Priority	Change Freq	Last Modified

``` **Nota**: Next.js `MetadataRoute.Sitemap` non supporta nativamente XSL. Per aggiungere il processing instruction, usa un Route Handler custom: ```typescript // app/sitemap.xml/route.ts import { getPayloadClient } from '@/lib/payload'; export async function GET() { const entries = await buildSitemapEntries(); const xml = ` ${entries.map(entry => ` ${entry.url} ${entry.lastModified} ${entry.changeFrequency} ${entry.priority} ${entry.alternates ? Object.entries(entry.alternates).map(([lang, url]) => ` ` ).join('\n') : ''} `).join('\n')} `; return new Response(xml, { headers: { 'Content-Type': 'application/xml', 'Cache-Control': 'public, max-age=3600, s-maxage=3600', }, }); } ``` --- ## Sitemap Index (per siti grandi) Se il sito ha >50.000 URL, usa un sitemap index: ```typescript // app/sitemap.xml/route.ts export async function GET() { const xml = ` ${BASE_URL}/sitemap-pages.xml ${new Date().toISOString()} ${BASE_URL}/sitemap-blog.xml ${new Date().toISOString()} `; return new Response(xml, { headers: { 'Content-Type': 'application/xml' }, }); } ``` --- ## Robots.txt + Sitemap Reference ```typescript // app/robots.ts import type { MetadataRoute } from 'next'; export default function robots(): MetadataRoute.Robots { return { rules: [ { userAgent: '*', allow: '/', disallow: ['/api/', '/admin/'] }, ], sitemap: `${BASE_URL}/sitemap.xml`, }; } ``` --- ## Checklist Sitemap - [ ] sitemap.ts o sitemap.xml/route.ts creato - [ ] Tutte le pagine statiche incluse - [ ] Pagine dinamiche dal CMS incluse - [ ] Hreflang alternates per ogni locale - [ ] Priority corrette (home=1.0, pages=0.8, blog=0.6, legal=0.3) - [ ] robots.ts con riferimento a sitemap - [ ] Sitemap registrata in Google Search Console - [ ] XSL styling per leggibilità umana (opzionale) - [ ] Cache headers per performance