hreflang وcanonical لـ 20 لغة في Next.js 15: واجهة برمجة تطبيقات البيانات الوصفية وخريطة الموقع وأخطاء الكتابة
مهمتان مختلفتان
غالبًا ما يتم الخلط بين canonical وhreflang، ولهذا السبب، يتم كسر فهرسة الترجمة.
- canonical يقول: "من بين مجموعة الصفحات المتماثلة، هذه الصفحة هي الصفحة الرئيسية." الترجمات ليست صفحات متطابقة.
- يقول hreflang: "تحتوي هذه الصفحة على إصدارات بلغات أخرى، وهذه عناوينها."
ومن هنا القاعدة الأساسية: تشير كل نسخة لغة إلى نفسها. إذا تم تعيين /kk/blog/post على /en/blog/post، فإن Google يعتبر النسخة الكازاخستانية نسخة مكررة من النسخة الإنجليزية ولا يظهرها في النتائج.
متطلبات الترميز
- hreflang reciprocal: إذا كانت الصفحة A ترتبط بالصفحة B، فيجب أن ترتبط الصفحة B بالصفحة A. ويتجاهل Google الروابط غير المتبادلة.
- كل صفحة تتضمن نفسها في المجموعة.
- الرموز - ISO 639-1 للغة، وإذا لزم الأمر، ISO 3166-1 alpha-2 للمنطقة المفصولة بواصلة:
ru،kk،en،pt-BR. الشرطة السفلية (pt_BR) غير مناسبة. x-default- صفحة للمستخدمين الذين لم يتم العثور على لغتهم في القائمة: عادةً اختيار اللغة أو الإصدار الرئيسي.- عناوين URL المطلقة فقط، وتحديدًا تلك التي تعرض 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 لغة وآلاف الصفحات، ضع في اعتبارك حد 50000 عنوان URL لكل ملف وقم بتقسيم خريطة الموقع عبر generateSitemaps.
التشخيص
- وحدة التحكم في البحث ← فهرسة الصفحة ← "نسخة مكررة، اختار Google صفحة أساسية مختلفة" في الترجمات: تحقق من الصفحة الأساسية وأن النص مترجم فعليًا وليس هو نفسه النص الأصلي.
- عرض مصدر HTML، وليس DOM في DevTools:
curl -s https://example.com/kk/blog/post | grep -E 'hreflang|canonical'. يجب أن تكون العلامات في استجابة الخادم. - تحقق من المعاملة بالمثل باستخدام برنامج نصي: لكل صفحة، قم بتحميل جميع عناوين URL من hreflang الخاص بها وتأكد من أن كل منها يرتبط مرة أخرى.
- عمليات إعادة التوجيه حسب لغة المتصفح. إذا قام
/بإعادة التوجيه تلقائيًا إلىAccept-Language، فقد لا يرى الروبوت (الذي عادةً لا يرسل هذا الرأس) بعض الإصدارات أبدًا. اعرض اختيار اللغة، ولكن لا تفرض عمليات إعادة التوجيه من عناوين URL للغة.
القيود
يعد hreflang تلميحًا وليس توجيهًا: قد تعرض Google إصدارًا مختلفًا إذا رأت أنه أكثر صلة. يدعم Yandex hreflang، ولكن بالنسبة للجمهور الناطق باللغة الروسية، قد يعني الارتباط الإقليمي في Webmaster أكثر من ذلك. وإذا كانت الترجمات مصنوعة آليًا وذات جودة رديئة، فلن ينقذها الترميز المناسب من تصنيف الجودة المنخفضة.
Нужна реализация под ваш проект или аудит архитектуры?
Разрабатываем сайты на Next.js, Telegram-ботов, интеграции с CRM и ИИ-агентов под ключ.