Creation:2024-08-13Last update:2026-01-26

    Özel URL Yeniden Yazımları Uygulaması

    Intlayer, standart /locale/path yapısından farklı olan yerel-dil özgü yollar tanımlamanıza olanak tanıyan özel URL yeniden yazımlarını destekler. Bu, dahili uygulama mantığını kanonik tutarken İngilizce için /about ve Fransızca için /a-propos gibi URL'lere izin verir.

    Yapılandırma

    Özel yeniden yazımlar, framework'e özgü formatters kullanılarak intlayer.config.ts dosyanızın routing bölümünde yapılandırılır. Bu formatters, tercih ettiğiniz router için doğru sözdizimini sağlar.

    intlayer.config.ts
    import { Locales, type IntlayerConfig } from "intlayer";import { nextjsRewrite } from "intlayer/routing";const config: IntlayerConfig = {  // ...  routing: {    mode: "prefix-no-default",    rewrite: nextjsRewrite({      "/[locale]/about": {        fr: "/[locale]/a-propos",        es: "/[locale]/acerca-de",      },      "/[locale]/products/[id]": {        fr: "/[locale]/produits/[id]",        es: "/[locale]/productos/[id]",      },    }),  },};export default config;

    Kullanılabilir Formatlayıcılar

    Intlayer tüm popüler framework'ler için formatlayıcılar sağlar:

    • nextjsRewrite: Next.js App Router için. [slug], [...slug] (1+), ve [[...slug]] (0+) destekler.
    • svelteKitRewrite: SvelteKit için. [slug], [...path] (0+), ve [[optional]] (0-1) destekler.
    • reactRouterRewrite: React Router için. :slug ve * (0+) destekler.
    • vueRouterRewrite: Vue Router 4 için. :slug, :slug? (0-1), :slug* (0+), ve :slug+ (1+) destekler.
    • solidRouterRewrite: Solid Router için. :slug ve *slug (0+) destekler.
    • tanstackRouterRewrite: TanStack Router için. $slug ve * (0+) destekler.
    • nuxtRewrite: Nuxt 3 için. [slug] ve [...slug] (0+) destekler.
    • viteRewrite: Herhangi bir Vite tabanlı proje için genel bir formatter. Vite proxy'su için sözdizimini normalleştirir.

    Gelişmiş Desenler

    Intlayer bu desenleri dahili olarak birleşik bir sözdizimine normalleştirir; bu, gelişmiş yol eşleştirme ve oluşturma olanağı sağlar:

    • İsteğe Bağlı Segmentler: [[optional]] (SvelteKit) veya :slug? (Vue/React) desteklenir.
    • Catch-all (Sıfır veya daha fazla): [[...slug]] (Next.js), [...path] (SvelteKit/Nuxt) veya * (React/TanStack) birden fazla segmentle eşleşmeye izin verir.
    • Zorunlu Catch-all (Bir veya daha fazla): [...slug] (Next.js) veya :slug+ (Vue) en az bir segmentin varlığını garanti eder.

    İstemci Taraflı URL Düzeltmesi: useRewriteURL

    Tarayıcı adres çubuğunun her zaman "pretty" (gösterişli) yerelleştirilmiş URL'yi yansıtmasını sağlamak için Intlayer useRewriteURL hook'unu sağlar. Bu hook, kullanıcı kanonik bir yola geldiğinde URL'yi window.history.replaceState kullanarak sessizce günceller.

    Çerçevelerde Kullanım

    tsx
    'use client';import { useRewriteURL } from "next-intlayer";const MyLayout = ({ children }) => {  useRewriteURL(); // /fr/about adresini otomatik olarak /fr/a-propos olarak düzeltir  return <>{children}</>;};

    Router Entegrasyonu ve Proxy'ler

    Intlayer'in sunucu tarafı proxy'leri (Vite ve Next.js), SEO tutarlılığını sağlamak için özel yeniden yazmaları otomatik olarak yönetir.

    1. Dahili Yeniden Yazmalar: Bir kullanıcı /fr/a-propos adresini ziyaret ettiğinde, proxy bunu dahili olarak /fr/about adresine eşler, böylece framework doğru rotayla eşleşir.
    2. Yetkili Yönlendirmeler: Bir kullanıcı elle /fr/about yazarsa, proxy /fr/a-propos'a 301/302 yönlendirmesi yapar; böylece arama motorları sayfanın yalnızca tek bir sürümünü dizine ekler.

    Next.js Entegrasyonu

    Next.js entegrasyonu intlayerProxy middleware'i aracılığıyla tamamen yönetilir.

    middleware.ts
    import { intlayerProxy } from "next-intlayer/middleware";import { NextRequest } from "next/server";export function middleware(request: NextRequest) {  return intlayerProxy(request);}

    Vite Entegrasyonu

    SolidJS, Vue ve Svelte için intlayerProxy Vite eklentisi geliştirme sırasında yeniden yazmaları (rewrites) yönetir.

    vite.config.ts
    import { defineConfig } from "vite";import { intlayerProxy } from "vite-intlayer";export default defineConfig({  plugins: [intlayerProxy()],});

    Temel Özellikler

    1. Çoklu Bağlam Yeniden Yazmaları

    Her formatter, farklı tüketiciler için uzmanlaşmış kuralları içeren bir RewriteObject oluşturur:

    • url: İstemci tarafı URL oluşturma için optimize edilmiştir (locale segmentlerini kaldırır).
    • nextjs: Next.js middleware için [locale] korur.
    • vite: Vite proxy'leri için :locale korur.

    2. Otomatik Pattern Normalizasyonu

    Intlayer, tüm kaynak framework'lerinden bağımsız olarak eşlemenin tutarlı kalmasını sağlamak için tüm desen sözdizimlerini dahili olarak normalleştirir (ör. [param]'ı :param'a dönüştürmek).

    3. SEO için Yetkili URL'ler

    Kanonik yollardan daha okunaklı takma adlara yapılan yönlendirmeleri zorunlu kılarak, Intlayer çoğaltılmış içerik sorunlarını önler ve sitenin bulunabilirliğini artırır.

    Temel Yardımcı Fonksiyonlar

    • getLocalizedUrl(url, locale): Yeniden yazma kurallarına uyan yerelleştirilmiş bir URL üretir.
    • getCanonicalPath(path, locale): Yerelleştirilmiş bir URL'yi dahili kanonik yoluna çözer.
    • getRewritePath(pathname, locale): Bir yol adının daha okunaklı yerelleştirilmiş takma adına düzeltilmesi gerekip gerekmediğini tespit eder.
    Neden Intlayer?