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

hreflang i kanoniczny dla 20 języków w Next.js 15: API metadanych, mapa witryny i błędy typów

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

Dwa różne zadania

canonical i hreflang są często mylone i z tego powodu indeksowanie tłumaczeń jest zepsute.

  • kanoniczny mówi: „z grupy identycznych stron ta jest główna”. Tłumaczenia nie są identycznymi stronami.
  • hreflang mówi: „ta strona ma wersje w innych językach, oto ich adresy.”

Stąd główna zasada: każda wersja językowa wskazuje na siebie kanoniczną. Jeśli /kk/blog/post ustawi kanoniczny na /en/blog/post, Google uzna wersję kazachską za duplikat wersji angielskiej i nie wyświetli jej w wynikach.

Wymagania dotyczące znaczników

  • hreflang wzajemny: jeśli strona A prowadzi do B, to B musi zawierać link do A. Google ignoruje linki niewzajemne.
  • Każda strona zawiera się w zestawie.
  • Kody - ISO 639-1 dla języka i, jeśli to konieczne, ISO 3166-1 alfa-2 dla regionu oddzielonego łącznikiem: ru, kk, en, pt-BR. Podkreślenie (pt_BR) nie jest odpowiednie.
  • x-default - strona dla użytkowników, których języka nie ma na liście: zazwyczaj wybór języka lub wersja główna.
  • Tylko bezwzględne adresy URL i dokładnie te, które zwracają 200 i uważają się za kanoniczne. Link hreflang do adresu z przekierowaniem jest błędem.

Pojedyncze źródło prawdy

Listę lokalizacji i dostępność tłumaczenia dla konkretnej strony należy pobrać z jednego miejsca:

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

wygenerujMetadane

[[VB_1_KOD]]

W Next.js 15 params jest obietnicą, więc await. Ustaw metadataBase w układzie głównym, jeśli używasz ścieżek względnych; tutaj adresy są bezwzględne i są bardziej niezawodne.

Nieprzetłumaczone strony

Najczęstszy problem ze stronami wielojęzycznymi: 5 jest przetłumaczonych na 20 języków, a pozostałe 15 adresów podaje tekst w języku angielskim w ramach /de/, /ja/ i tak dalej. To jest 15 ujęć dla każdego artykułu. Opcje:

  1. 1.Nie generuj takich tras: generateStaticParams zwraca tylko istniejące pary, a w page.tsx dla brakujących - notFound().
  2. 2.Jeśli trasa musi istnieć (np. ogólny interfejs jest przetłumaczony, ale artykuł nie), podaj stronie robots: { index: false } i nie umieszczaj go w hreflangu i mapie witryny.

Powyższy kod już to uwzględnia: tylko ustawienia regionalne z translations są uwzględnione w languages.

Mapa witryny z alternatywami

hreflang można również określić w mapie witryny - jest to wygodne, gdy stron jest dużo:

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

Wybierz jedną metodę - w <head> lub w mapie witryny. Oba są ważne w tym samym czasie, ale jeśli się różnią, otrzymasz sprzeczne sygnały. Przy 20 językach i tysiącach stron weź pod uwagę limit 50 000 adresów URL na plik i podziel mapę witryny przez generateSitemaps.

Diagnostyka

  • Search Console → Indeksowanie stron → „Duplikuj, Google wybrał inną stronę kanoniczną” w przypadku tłumaczeń: sprawdź kanoniczny i czy tekst jest rzeczywiście przetłumaczony i nie jest taki sam jak oryginał.
  • Wyświetl źródłowy kod HTML, a nie DOM w DevTools: curl -s https://example.com/kk/blog/post | grep -E 'hreflang|canonical'. Tagi muszą znajdować się w odpowiedzi serwera.
  • Sprawdź wzajemność za pomocą skryptu: dla każdej strony załaduj wszystkie adresy URL z jej hreflangu i upewnij się, że każdy z nich zawiera linki zwrotne.
  • Przekierowania według języka przeglądarki. Jeśli / automatycznie przekierowuje do Accept-Language, robot (który zwykle nie wysyła tego nagłówka) może nigdy nie zobaczyć niektórych wersji. Oferuj wybór języka, ale nie wymuszaj przekierowań z adresów URL języków.

Ograniczenia

hreflang to wskazówka, a nie dyrektywa: Google może wyświetlić inną wersję, jeśli uzna ją za bardziej odpowiednią. Yandex obsługuje hreflang, ale dla rosyjskojęzycznych odbiorców powiązanie regionalne w Webmasterze może oznaczać więcej. A jeśli tłumaczenia są wykonane maszynowo i są kiepskiej jakości, odpowiednie znaczniki nie uchronią ich przed niską oceną jakości.

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

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

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

Ещё на vbcd4u.com