Next.js 15 में 20 भाषाओं के लिए hreflang और canonical: मेटाडेटा एपीआई, साइटमैप और प्रकार की त्रुटियां
दो अलग-अलग कार्य
canonical और hreflang अक्सर भ्रमित होते हैं, और इस वजह से, अनुवाद अनुक्रमण टूट जाता है।
- कैनोनिकल कहता है: "समान पृष्ठों के समूह में से, यह मुख्य है।" अनुवाद समान पृष्ठ नहीं हैं.
- hreflang कहता है: "इस पृष्ठ के अन्य भाषाओं में संस्करण हैं, यहां उनके पते हैं।"
इसलिए मुख्य नियम: प्रत्येक भाषा संस्करण स्वयं को विहित बताता है। यदि /kk/blog/post विहित को /en/blog/post पर सेट करता है, तो Google कज़ाख संस्करण को अंग्रेजी संस्करण का डुप्लिकेट मानता है और इसे परिणामों में नहीं दिखाता है।
मार्कअप आवश्यकताएँ
- hreflang पारस्परिक: यदि पृष्ठ A, B से लिंक करता है, तो B को A से लिंक होना चाहिए। Google गैर-पारस्परिक लिंक को अनदेखा करता है।
- प्रत्येक पृष्ठ स्वयं को सेट में शामिल करता है।
- कोड - भाषा के लिए आईएसओ 639-1 और, यदि आवश्यक हो, एक हाइफ़न द्वारा अलग किए गए क्षेत्र के लिए आईएसओ 3166-1 अल्फा-2:
ru,kk,en,pt-BR। अंडरस्कोर (pt_BR) उपयुक्त नहीं है। x-default- उन उपयोगकर्ताओं के लिए पृष्ठ जिनकी भाषा सूची में नहीं मिलती है: आमतौर पर भाषा चयन या मुख्य संस्करण।- केवल पूर्ण यूआरएल, और बिल्कुल वे जो 200 लौटाते हैं और खुद को विहित मानते हैं। रीडायरेक्ट वाले पते का hreflang लिंक एक त्रुटि है।
सत्य का एकल स्रोत
किसी विशिष्ट पृष्ठ के लिए स्थानों की सूची और अनुवाद की उपलब्धता एक ही स्थान से ली जानी चाहिए:
// lib/i18n/config.ts
export const SITE = "https://example.com";
export const LOCALES = ["ru", "en", "kk", "uz", "tr", "de", "fr", "es", "pt-BR", "it",
"pl", "uk", "ar", "hi", "id", "ja", "ko", "zh", "vi", "th"] as const;
export type Locale = (typeof LOCALES)[number];
export const DEFAULT_LOCALE: Locale = "en";
export function localizedUrl(locale: Locale, path: string) {
return `${SITE}/${locale}${path === "/" ? "" : path}`;
}##जनरेटमेटाडेटा
// app/[locale]/blog/[slug]/page.tsx
import type { Metadata } from "next";
import { LOCALES, type Locale, localizedUrl, DEFAULT_LOCALE } from "@/lib/i18n/config";
import { getPostTranslations } from "@/lib/posts";
export async function generateMetadata({
params,
}: {
params: Promise<{ locale: Locale; slug: string }>;
}): Promise<Metadata> {
const { locale, slug } = await params;
const translations = await getPostTranslations(slug); // только реально переведённые локали
const path = `/blog/${slug}`;
const languages: Record<string, string> = {};
for (const l of LOCALES) {
if (translations.includes(l)) languages[l] = localizedUrl(l, path);
}
if (translations.includes(DEFAULT_LOCALE)) {
languages["x-default"] = localizedUrl(DEFAULT_LOCALE, path);
}
return {
alternates: {
canonical: localizedUrl(locale, path), // сама на себя
languages,
},
};
}Next.js 15 में, params एक वादा है, इसलिए await। यदि आप सापेक्ष पथों का उपयोग कर रहे हैं तो रूट लेआउट में metadataBase सेट करें; यहां पते पूर्ण हैं, और यह अधिक विश्वसनीय है।
अअनुवादित पन्ने
बहुभाषी साइटों के साथ सबसे आम समस्या: 5 का अनुवाद 20 भाषाओं के लिए किया जाता है, और शेष 15 पते /de/, /ja/ इत्यादि के अंतर्गत अंग्रेजी पाठ प्रदान करते हैं। यह प्रत्येक लेख के लिए 15 टेक है। विकल्प:
- 1.ऐसे मार्ग उत्पन्न न करें:
generateStaticParamsकेवल मौजूदा जोड़े लौटाता है, औरpage.tsxमें गायब जोड़े के लिए -notFound()देता है। - 2.यदि मार्ग मौजूद होना चाहिए (उदाहरण के लिए, सामान्य इंटरफ़ेस का अनुवाद किया गया है, लेकिन लेख नहीं है), तो पृष्ठ को
robots: { index: false }के साथ प्रस्तुत करें और इसे hreflang और साइटमैप में शामिल न करें।
उपरोक्त कोड पहले से ही इसे ध्यान में रखता है: translations के केवल स्थान languages में शामिल हैं।
विकल्पों के साथ साइटमैप
hreflang को साइटमैप में भी निर्दिष्ट किया जा सकता है - यह तब सुविधाजनक होता है जब बहुत सारे पृष्ठ हों:
// app/sitemap.ts
import type { MetadataRoute } from "next";
import { localizedUrl, type Locale } from "@/lib/i18n/config";
import { getAllPostsWithTranslations } from "@/lib/posts";
export default async function sitemap(): Promise<MetadataRoute.Sitemap> {
const posts = await getAllPostsWithTranslations();
return posts.flatMap((post) =>
post.locales.map((locale: Locale) => ({
url: localizedUrl(locale, `/blog/${post.slug}`),
lastModified: post.updatedAt,
alternates: {
languages: Object.fromEntries(
post.locales.map((l: Locale) => [l, localizedUrl(l, `/blog/${post.slug}`)])
),
},
}))
);
}एक विधि चुनें - <head> में या साइटमैप में। दोनों एक ही समय में मान्य हैं, लेकिन यदि वे भिन्न हैं, तो आपको परस्पर विरोधी संकेत मिलेंगे। 20 भाषाओं और हजारों पृष्ठों के साथ, प्रति फ़ाइल 50,000 यूआरएल की सीमा पर विचार करें और साइटमैप को generateSitemaps के माध्यम से विभाजित करें।
निदान
- सर्च कंसोल → पेज इंडेक्सिंग → "डुप्लिकेट, Google ने एक अलग कैनोनिकल पेज चुना है" अनुवाद पर: कैनोनिकल जांचें और यह कि पाठ वास्तव में अनुवादित है और मूल के समान नहीं है।
- स्रोत HTML देखें, DevTools में DOM नहीं:
curl -s https://example.com/kk/blog/post | grep -E 'hreflang|canonical'। टैग सर्वर प्रतिक्रिया में होने चाहिए. - एक स्क्रिप्ट के साथ पारस्परिकता की जांच करें: प्रत्येक पृष्ठ के लिए, उसके hreflang से सभी यूआरएल लोड करें और सुनिश्चित करें कि उनमें से प्रत्येक वापस लिंक हो।
- ब्राउज़र भाषा द्वारा रीडायरेक्ट। यदि
/स्वचालित रूप सेAccept-Languageपर रीडायरेक्ट करता है, तो रोबोट (जो आमतौर पर इस हेडर को नहीं भेजता है) कुछ संस्करणों को कभी नहीं देख सकता है। भाषा चयन की पेशकश करें, लेकिन भाषा यूआरएल से रीडायरेक्ट को बाध्य न करें।
सीमाएँ
hreflang एक संकेत है, निर्देश नहीं: यदि Google इसे अधिक प्रासंगिक समझता है तो एक अलग संस्करण दिखा सकता है। यांडेक्स hreflang का समर्थन करता है, लेकिन रूसी भाषी दर्शकों के लिए, वेबमास्टर में क्षेत्रीय बंधन का अर्थ अधिक हो सकता है। और यदि अनुवाद मशीन से बने हैं और खराब गुणवत्ता के हैं, तो उचित मार्कअप उन्हें कम गुणवत्ता वाली रेटिंग से नहीं बचाएगा।
Нужна реализация под ваш проект или аудит архитектуры?
Разрабатываем сайты на Next.js, Telegram-ботов, интеграции с CRM и ИИ-агентов под ключ.