v(i)b(e)c(o)d(e)4u.com
Назад на форум vbcd4u.com
🔥 Нейросети2026-11-17T09:12:00.000Z▲ 0 upvotes

hreflang dan kanonik untuk 20 bahasa di Next.js 15: API metadata, peta situs, dan kesalahan ketik

@murdasoftРедакция vbcd4u · MurdaSoft
Открыть все обсуждения →

Dua tugas berbeda

canonical dan hreflang sering membingungkan, dan karenanya, pengindeksan terjemahan rusak.

  • canonical mengatakan: “dari grup halaman yang identik, ini adalah halaman utama.” Terjemahan bukanlah halaman yang identik.
  • hreflang mengatakan: “halaman ini memiliki versi dalam bahasa lain, berikut alamatnya.”

Oleh karena itu aturan utamanya: setiap versi bahasa menunjukkan kanoniknya sendiri. Jika /kk/blog/post menyetel kanonis ke /en/blog/post, Google menganggap versi Kazakh merupakan duplikat dari versi bahasa Inggris dan tidak menampilkannya di hasil.

Persyaratan markup

  • hreflang timbal balik: jika halaman A tertaut ke B, maka B harus tertaut ke A. Google mengabaikan tautan non-timbal balik.
  • Setiap halaman menyertakan dirinya sendiri dalam set.
  • Kode - ISO 639-1 untuk bahasa dan, jika perlu, ISO 3166-1 alpha-2 untuk wilayah yang dipisahkan dengan tanda hubung: ru, kk, en, pt-BR. Garis bawah (pt_BR) tidak cocok.
  • x-default - halaman untuk pengguna yang bahasanya tidak ditemukan dalam daftar: biasanya pilihan bahasa atau versi utama.
  • Hanya URL absolut, dan URL yang menghasilkan 200 dan menganggap dirinya kanonik. Tautan hreflang ke alamat dengan pengalihan adalah kesalahan.

Satu-satunya sumber kebenaran

Daftar lokal dan ketersediaan terjemahan untuk halaman tertentu harus diambil dari satu tempat:

// 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}`;
}

menghasilkan Metadata

// 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,
    },
  };
}

Di Next.js 15, params adalah Janji, jadi await. Setel metadataBase di tata letak root jika Anda menggunakan jalur relatif; di sini alamatnya mutlak, dan lebih dapat diandalkan.

Halaman yang belum diterjemahkan

Masalah paling umum dengan situs multibahasa: 5 diterjemahkan ke dalam 20 bahasa, dan 15 alamat sisanya menyediakan teks bahasa Inggris di bawah /de/, /ja/ dan seterusnya. Ini adalah 15 pengambilan untuk setiap artikel. Pilihan:

  1. 1.Jangan buat rute seperti itu: generateStaticParams hanya mengembalikan pasangan yang ada, dan di page.tsx untuk yang hilang - notFound().
  2. 2.Jika rute harus ada (misalnya, antarmuka umum diterjemahkan, tetapi artikelnya tidak), sajikan halaman dengan robots: { index: false } dan jangan sertakan dalam hreflang dan peta situs.

Kode di atas sudah mempertimbangkan hal ini: hanya lokal dari translations yang disertakan dalam languages.

Peta Situs dengan alternatif

hreflang juga dapat ditentukan di peta situs - ini berguna bila ada banyak halaman:

// 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}`)])
        ),
      },
    }))
  );
}

Pilih satu metode - di <head> atau di peta situs. Keduanya valid pada saat yang sama, namun jika berbeda, Anda akan mendapatkan sinyal yang bertentangan. Dengan 20 bahasa dan ribuan halaman, pertimbangkan batas 50.000 URL per file dan bagi peta situs melalui generateSitemaps.

Diagnostik

  • Search Console → Pengindeksan Halaman → “Duplikat, Google telah memilih halaman kanonik yang berbeda” pada terjemahan: periksa kanonikal dan apakah teks tersebut benar-benar diterjemahkan dan tidak sama dengan aslinya.
  • Lihat HTML sumber, bukan DOM di DevTools: curl -s https://example.com/kk/blog/post | grep -E 'hreflang|canonical'. Tag harus ada dalam respons server.
  • Periksa timbal balik dengan skrip: untuk setiap halaman, muat semua URL dari hreflangnya dan pastikan masing-masing URL tertaut kembali.
  • Pengalihan berdasarkan bahasa browser. Jika / otomatis dialihkan ke Accept-Language, robot (yang biasanya tidak mengirimkan header ini) mungkin tidak akan pernah melihat beberapa versi. Tawarkan pilihan bahasa, namun jangan memaksakan pengalihan dari URL bahasa.

Keterbatasan

hreflang adalah sebuah petunjuk, bukan arahan: Google mungkin menampilkan versi yang berbeda jika dianggap lebih relevan. Yandex mendukung hreflang, tetapi bagi audiens berbahasa Rusia, pengikatan regional di Webmaster mungkin lebih berarti. Dan jika terjemahannya adalah buatan mesin dan kualitasnya buruk, markup yang tepat tidak akan menyelamatkannya dari peringkat kualitas rendah.

Нужна реализация под ваш проект или аудит архитектуры?

Разрабатываем сайты на Next.js, Telegram-ботов, интеграции с CRM и ИИ-агентов под ключ.

Обсуждение (0)

Ещё на vbcd4u.com