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

Next.js 15'te 20 dil için hreflang ve canonical: meta veri API'si, site haritası ve tür hataları

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

İki farklı görev

canonical ve hreflang sıklıkla karıştırılır ve bu nedenle çeviri indekslemesi bozulur.

  • canonical şunu söylüyor: "aynı sayfalardan oluşan grupta bu, ana sayfadır." Çeviriler aynı sayfalar değildir.
  • hreflang şunu söylüyor: “bu sayfanın başka dillerde versiyonları var, işte adresleri.”

Dolayısıyla ana kural: her dil sürümü kanonik olarak kendisini işaret eder. Eğer /kk/blog/post kanonik değerini /en/blog/post olarak ayarlarsa, Google Kazakça sürümünü İngilizce sürümün kopyası olarak kabul eder ve bunu sonuçlarda göstermez.

İşaretleme gereksinimleri

  • hreflang karşılıklı: A sayfası B'ye bağlanırsa, B'nin de A'ya bağlanması gerekir. Google, karşılıklı olmayan bağlantıları dikkate almaz.
  • Her sayfa setin içerisinde kendisini içerir.
  • Kodlar - Dil için ISO 639-1 ve gerekirse kısa çizgiyle ayrılmış bölge için ISO 3166-1 alpha-2: ru, kk, en, pt-BR. Alt çizgi (pt_BR) uygun değildir.
  • x-default - dili listede bulunmayan kullanıcılar için sayfa: genellikle dil seçimi veya ana sürüm.
  • Yalnızca mutlak URL'ler ve tam olarak 200 değerini döndüren ve kendilerini standart kabul eden URL'ler. Yönlendirmeli bir adrese verilen hreflang bağlantısı bir hatadır.

Gerçeğin tek kaynağı

Belirli bir sayfa için yerel ayarların listesi ve çevirinin kullanılabilirliği tek bir yerden alınmalıdır:

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

meta veri oluşturmak

// 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'te, params bir Sözdür, dolayısıyla await. Göreli yollar kullanıyorsanız kök düzende metadataBase değerini ayarlayın; burada adresler mutlaktır ve daha güvenilirdir.

Çevrilmemiş sayfalar

Çok dilli sitelerde en yaygın sorun: 5 adres 20 dile çevriliyor ve geri kalan 15 adres /de/, /ja/ vb. altında İngilizce metin sağlıyor. Bu, her makale için 15 çekimdir. Seçenekler:

  1. 1.Bu tür rotalar oluşturmayın: generateStaticParams yalnızca mevcut çiftleri döndürür ve eksik olanlar için page.tsx içinde - notFound().
  2. 2.Rotanın mevcut olması gerekiyorsa (örneğin, genel arayüz çevrilmiş ancak makale çevrilmemiştir), sayfayı robots: { index: false } ile sunun ve bunu hreflang ve site haritasına dahil etmeyin.

Yukarıdaki kod bunu zaten hesaba katıyor: yalnızca translations yerel ayarları languages'a dahil edilmiştir.

Alternatifli site haritası

hreflang site haritasında da belirtilebilir; bu, çok sayıda sayfa olduğunda kullanışlıdır:

// 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> veya site haritasından bir yöntem seçin. Her ikisi de aynı anda geçerlidir, ancak birbirlerinden ayrılırlarsa çelişkili sinyaller alırsınız. 20 dil ve binlerce sayfa ile dosya başına 50.000 URL sınırını göz önünde bulundurun ve site haritasını generateSitemaps aracılığıyla bölün.

Teşhis

  • Arama Konsolu → Sayfa Dizine Ekleme → "Kopyala, Google farklı bir standart sayfa seçti" çevirilerde: standartı ve metnin gerçekten çevrildiğini ve orijinaliyle aynı olmadığını kontrol edin.
  • DevTools'taki DOM'yi değil, kaynak HTML'yi görüntüleyin: curl -s https://example.com/kk/blog/post | grep -E 'hreflang|canonical'. Etiketler sunucu yanıtında olmalıdır.
  • Karşılıklılığı bir komut dosyasıyla kontrol edin: her sayfa için, tüm URL'leri kendi hreflang'ından yükleyin ve her birinin geri bağlantı verdiğinden emin olun.
  • Tarayıcı diline göre yönlendirmeler. Eğer / otomatik olarak Accept-Language'a yönlendirme yaparsa, robot (genellikle bu başlığı göndermez) bazı sürümleri asla göremeyebilir. Dil seçimi sunun, ancak dil URL'lerinden yönlendirmeleri zorlamayın.

Sınırlamalar

hreflang bir yönerge değil, bir ipucudur: Google, daha alakalı olduğunu düşünürse farklı bir sürüm gösterebilir. Yandex hreflang'ı desteklemektedir, ancak Rusça konuşan kitle için Web Yöneticisi'ndeki bölgesel bağlama daha anlamlı olabilir. Ve eğer çeviriler makine yapımıysa ve kalitesizse, doğru işaretleme onları düşük kalite derecelendirmesinden kurtarmayacaktır.

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

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

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

Ещё на vbcd4u.com