Yazar:
    Oluşturma:2026-01-21Son güncelleme:2026-09-19

    astro-intlayer Paketi

    astro-intlayer paketi, Intlayer'ı Astro uygulamalarına entegre etmek için gerekli araçları sağlar. Yerel ayar tabanlı yönlendirmeyi, sözlük yönetimini, derleme zamanı sayfa yeniden yazımını, istek ara yazılımını ve hem sunucu tarafından oluşturulan .astro bileşenlerinde hem de istemci tarafı komut dosyalarında çok dilli içeriğe erişmek için hook'ları yapılandırır.

    Kurulum

    bash
    npm install astro-intlayer
    

    Dışa Aktarılanlar

    Entegrasyon

    astro-intlayer paketi, projenizde Intlayer'ı kuran bir Astro entegrasyonu sağlar.

    İçe aktarma:

    tsx
    import { intlayer } from "astro-intlayer";
    

    veya astro.config.mjs içinde varsayılan içe aktarma:

    ts
    import { defineConfig } from "astro/config";
    import intlayer from "astro-intlayer";
    
    export default defineConfig({
      integrations: [intlayer()],
    });
    
    FonksiyonAçıklamaİlgili Doküman
    intlayerSözlükleri hazırlayan, Vite eklentilerini (takma adlar, yönlendirme proxy'si, budama) yapılandıran, istek ara yazılımını otomatik kaydeden ve yeniden yazılan URL'lerde önceden oluşturulmuş sayfalar yayan Astro entegrasyonu.intlayer

    Hook'lar (Sunucu ve İstemci)

    İçe aktarma:

    tsx
    import { useIntlayer, useDictionary, useLocale } from "astro-intlayer";
    
    HookAçıklamaİlgili Doküman
    useIntlayerBir sözlüğü anahtarına göre seçer ve yerelleştirilmiş içeriğini döndürür. .astro frontmatter'ında istek yerel ayarını Astro.locals'tan okur. <script> içinde istemci deposundan okur.useIntlayer
    useDictionaryBir sözlük nesnesini dönüştürür ve çözümlenen yerel ayar için içerik döndürür. Frontmatter ve istemci komut dosyalarında çalışır.useDictionary
    useLocaleGeçerli yerel ayarı, varsayılan yerel ayarı, kullanılabilir yerel ayarları ve yerel ayarı güncellemek için bir işlevi döndürür.useLocale

    Ara Yazılım (astro-intlayer/middleware)

    İçe aktarma:

    tsx
    import { onRequest } from "astro-intlayer/middleware";
    
    Dışa AktarımTürAçıklamaİlgili Doküman
    onRequestMiddlewareHandlerİstek yerel ayarını algılayan ve Astro.locals.intlayer bağlayan Astro ara yazılımı. intlayer() tarafından otomatik kaydedilir veya birleştirmek için içe aktarılır.onRequest

    Yardımcı Programlar

    İçe aktarma:

    tsx
    import { getIntlayerLocals } from "astro-intlayer";
    
    FonksiyonAçıklamaİlgili Doküman
    getIntlayerLocalsAstro.locals dışındaki istek depolama kapsamından geçerli IntlayerLocals nesnesini almak için yardımcı fonksiyon.-

    İstemci Yardımcı Programları (astro-intlayer/client)

    İçe aktarma:

    tsx
    import {
      useIntlayer,
      useDictionary,
      useDictionaryDynamic,
      useLocale,
      useLocaleStorage,
      useLocaleCookie,
      getIntlayer,
      getDictionary,
      installIntlayer,
      setLocaleInStorage,
      setLocaleCookie,
      localeInStorage,
      localeCookie,
    } from "astro-intlayer/client";
    

    Tarayıcıda veya istemci <script> etiketleri içinde içe aktarıldığında, astro-intlayer otomatik olarak astro-intlayer/client'a eşlenir (vanilla-intlayer tarafından desteklenir), istemci tarafı sözlük alıcıları, depo aboneleri ve yerel ayar kalıcılık araçları sağlar.

    Formatlayıcılar (astro-intlayer/format)

    İçe aktarma:

    tsx
    import {
      useIntl,
      useDate,
      useNumber,
      useCurrency,
      usePercentage,
      useRelativeTime,
      useList,
      useUnit,
      useCompact,
    } from "astro-intlayer/format";
    
    HookAçıklama
    useIntlÖnbelleğe alma ve abonelik özellikleriyle istek veya istemci yerel ayarına bağlı bir Intl örneği döndürür.
    useDateGeçerli yerel ayara önceden bağlanmış bir tarih biçimlendirme işlevi döndürür (Intl.DateTimeFormat).
    useNumberGeçerli yerel ayara önceden bağlanmış bir sayı biçimlendirme işlevi döndürür (Intl.NumberFormat).
    useCurrencyGeçerli yerel ayara önceden bağlanmış bir para birimi biçimlendirme işlevi döndürür.
    usePercentageGeçerli yerel ayara önceden bağlanmış bir yüzde biçimlendirme işlevi döndürür.
    useRelativeTimeGeçerli yerel ayara önceden bağlanmış bir göreli zaman biçimlendirme işlevi döndürür (Intl.RelativeTimeFormat).
    useListGeçerli yerel ayara önceden bağlanmış bir liste biçimlendirme işlevi döndürür (Intl.ListFormat).
    useUnitGeçerli yerel ayara önceden bağlanmış bir birim biçimlendirme işlevi döndürür.
    useCompactGeçerli yerel ayara önceden bağlanmış bir kompakt sayı biçimlendirme işlevi döndürür (ör. 1.5K).

    HTML Yardımcı Programları (astro-intlayer/html)

    İçe aktarma:

    tsx
    import { renderHTML, useHTML, useHTMLRenderer } from "astro-intlayer/html";
    
    Dışa AktarımTürAçıklama
    renderHTMLFunctionHTML düğümlerini oluşturmak için bağımsız yardımcı işlev.
    useHTMLHookHTML sağlayıcı bağlamını ve yapılandırmasını alma hook'u.
    useHTMLRendererHookÖnceden yapılandırılmış bir HTML oluşturucu işlevi alma hook'u.

    Markdown Yardımcı Programları (astro-intlayer/markdown)

    İçe aktarma:

    tsx
    import {
      compileMarkdown,
      renderMarkdown,
      parseMarkdown,
      useMarkdown,
      useMarkdownRenderer,
    } from "astro-intlayer/markdown";
    
    Dışa AktarımTürAçıklama
    compileMarkdownFunctionMarkdown dizelerini yapılandırılmış bir temsile derler.
    renderMarkdownFunctionMarkdown içeriğini çıktı düğümlerine dönüştürür.
    parseMarkdownFunctionHam Markdown içeriğini bir AST'ye ayrıştırır.
    useMarkdownHookMarkdown sağlayıcı bağlamını alma hook'u.
    useMarkdownRendererHookÖnceden yapılandırılmış bir Markdown oluşturucu işlevi alma hook'u.

    Tipler

    İçe aktarma:

    tsx
    import type {
      IntlayerLocals,
      UseLocaleProps,
      UseLocaleResult,
    } from "astro-intlayer";
    
    TipAçıklama
    IntlayerLocalslocale, defaultLocale ve availableLocales içeren Astro.locals.intlayer'a eklenen nesne.
    UseLocalePropsuseLocale() tarafından kabul edilen isteğe bağlı yapılandırma özellikleri.
    UseLocaleResultYerel ayar özelliklerini ve güncelleme yöntemlerini sağlayan useLocale() dönüş türü.