fix: revise SEO with canonical and hreflang

Author: xiaohanyu

src/app/[language]/(home)/blog/[slug]/page.tsx

@@ -4,6 +4,7 @@ import Link from 'next/link'
 import { notFound } from 'next/navigation'
 
 import { getMDXComponents } from '@/components'
+import { defaultLanguage, languages } from '@/i18n'
 import { getLocalizedSources } from '@/lib'
 
 export const revalidate = false
@@ -112,9 +113,25 @@ export async function generateMetadata(props: {
 
   const image = `/api/og/blog/${slug}/open-graph.png?language=${language}`
 
+  // Build canonical URL
+  const canonicalPath =
+    language === defaultLanguage ? `/blog/${slug}` : `/${language}/blog/${slug}`
+
+  // Build hreflang alternates for all languages
+  const languagesAlternates: Record<string, string> = {}
+  for (const lang of languages) {
+    const langPath =
+      lang === defaultLanguage ? `/blog/${slug}` : `/${lang}/blog/${slug}`
+    languagesAlternates[lang] = langPath
+  }
+
   return {
     title: page.data.title,
     description: page.data.description,
+    alternates: {
+      canonical: canonicalPath,
+      languages: languagesAlternates,
+    },
     openGraph: {
       images: image,
     },

src/app/[language]/(home)/blog/page.tsx

@@ -1,4 +1,5 @@
 import type { Metadata } from 'next'
+import { defaultLanguage, languages } from '@/i18n'
 import { getLocalizedSources } from '@/lib'
 import { BlogList } from './components'
 
@@ -35,9 +36,24 @@ export async function generateMetadata({
 }): Promise<Metadata> {
   const { language } = await params
 
+  // Build canonical URL
+  const canonicalPath =
+    language === defaultLanguage ? '/blog' : `/${language}/blog`
+
+  // Build hreflang alternates for all languages
+  const languagesAlternates: Record<string, string> = {}
+  for (const lang of languages) {
+    languagesAlternates[lang] =
+      lang === defaultLanguage ? '/blog' : `/${lang}/blog`
+  }
+
   return {
     title: 'Blog',
     description: 'Latest updates and insights from the YAMLResume team',
+    alternates: {
+      canonical: canonicalPath,
+      languages: languagesAlternates,
+    },
     openGraph: {
       images: `/api/og/blog/open-graph.png?language=${language}`,
     },

src/app/[language]/(home)/page.tsx

@@ -1,4 +1,6 @@
+import type { Metadata } from 'next'
 import 'react-medium-image-zoom/dist/styles.css'
+import { defaultLanguage, languages } from '@/i18n'
 import {
   BuyMeACoffeeSection,
   ComparisonSection,
@@ -32,3 +34,27 @@ export default function HomePage() {
     </main>
   )
 }
+
+export async function generateMetadata({
+  params,
+}: {
+  params: Promise<{ language: string }>
+}): Promise<Metadata> {
+  const { language } = await params
+
+  // Build canonical URL
+  const canonicalPath = language === defaultLanguage ? '/' : `/${language}`
+
+  // Build hreflang alternates for all languages
+  const languagesAlternates: Record<string, string> = {}
+  for (const lang of languages) {
+    languagesAlternates[lang] = lang === defaultLanguage ? '/' : `/${lang}`
+  }
+
+  return {
+    alternates: {
+      canonical: canonicalPath,
+      languages: languagesAlternates,
+    },
+  }
+}

src/app/[language]/docs/[[...slug]]/page.tsx

@@ -9,7 +9,7 @@ import {
 import type { Metadata } from 'next'
 import { notFound } from 'next/navigation'
 import { getMDXComponents, LLMCopyButton, ViewOptions } from '@/components'
-import { defaultLanguage } from '@/i18n'
+import { defaultLanguage, languages } from '@/i18n'
 import { getLocalizedSources } from '@/lib'
 
 export const revalidate = false
@@ -124,9 +124,32 @@ export async function generateMetadata({
   if (!page) notFound()
 
   const image = `/api/og/docs/${slug.join('/')}/open-graph.png?language=${language}`
+
+  // Build canonical URL
+  const slugPath = slug.length > 0 ? `/${slug.join('/')}` : ''
+  const canonicalPath =
+    language === defaultLanguage
+      ? `/docs${slugPath}`
+      : `/${language}/docs${slugPath}`
+
+  // Build hreflang alternates for all languages
+  const languagesAlternates: Record<string, string> = {}
+  for (const lang of languages) {
+    const langSlugPath = slug.length > 0 ? `/${slug.join('/')}` : ''
+    const langPath =
+      lang === defaultLanguage
+        ? `/docs${langSlugPath}`
+        : `/${lang}/docs${langSlugPath}`
+    languagesAlternates[lang] = langPath
+  }
+
   return {
     title: page.data.title,
     description: page.data.description,
+    alternates: {
+      canonical: canonicalPath,
+      languages: languagesAlternates,
+    },
     openGraph: {
       images: image,
     },

src/app/robots.ts

@@ -0,0 +1,12 @@
+import type { MetadataRoute } from 'next'
+import { siteConfig } from '@/config/site'
+
+export default function robots(): MetadataRoute.Robots {
+  return {
+    rules: {
+      userAgent: '*',
+      allow: '/',
+    },
+    sitemap: `${siteConfig.url}/sitemap.xml`,
+  }
+}

src/app/sitemap.ts

@@ -43,65 +43,91 @@ export default async function sitemap(): Promise<MetadataRoute.Sitemap> {
     ...blogSourcePt.getPages(),
   ]
 
+  const now = new Date()
+
   return [
     {
       url: url('/'),
+      lastModified: now,
       changeFrequency: 'monthly',
       priority: 1,
     },
     {
       url: url('/blog'),
+      lastModified: now,
       changeFrequency: 'monthly',
       priority: 0.8,
     },
     {
       url: url('/docs'),
+      lastModified: now,
       changeFrequency: 'monthly',
       priority: 0.8,
     },
     // Add locale-specific home pages
     {
       url: url('/zh-cn'),
+      lastModified: now,
       changeFrequency: 'monthly',
       priority: 0.9,
     },
     {
       url: url('/zh-tw'),
+      lastModified: now,
       changeFrequency: 'monthly',
       priority: 0.9,
     },
     {
       url: url('/ja'),
+      lastModified: now,
       changeFrequency: 'monthly',
       priority: 0.9,
     },
     {
       url: url('/es'),
+      lastModified: now,
+      changeFrequency: 'monthly',
+      priority: 0.9,
+    },
+    {
+      url: url('/pt'),
+      lastModified: now,
+      changeFrequency: 'monthly',
+      priority: 0.9,
+    },
+    {
+      url: url('/fr'),
+      lastModified: now,
       changeFrequency: 'monthly',
       priority: 0.9,
     },
     {
       url: url('/developer/cli/index.html'),
+      lastModified: now,
       changeFrequency: 'monthly',
       priority: 0.8,
     },
     {
       url: url('/developer/core/index.html'),
+      lastModified: now,
       changeFrequency: 'monthly',
       priority: 0.8,
     },
     {
       url: url('/developer/create-yamlresume/index.html'),
+      lastModified: now,
       changeFrequency: 'monthly',
       priority: 0.8,
     },
     {
       url: url('/developer/json2yamlresume/index.html'),
+      lastModified: now,
       changeFrequency: 'monthly',
       priority: 0.8,
     },
     {
       url: url('/developer/playground/index.html'),
+      lastModified: now,
       changeFrequency: 'monthly',
       priority: 0.8,
     },

src/i18n/index.ts

@@ -1,4 +1,4 @@
-export { defaultLanguage, i18nConfig, type Language } from './config'
+export { defaultLanguage, i18nConfig, type Language, languages } from './config'
 export { useTranslations } from './hooks'
 export { getTranslations } from './translations'
 export { getLocalizedUrl } from './url'