@intlayer/docs 9.5.4 → 9.5.6

package/docs/tr/packages/astro-intlayer/exports.md

@@ -1,12 +1,12 @@
 ---
 createdAt: 2026-01-21
-updatedAt: 2026-01-21
-title: astro-intlayer Paket Dokümantasyonu
-description: Intlayer için Astro entegrasyonu; locale tabanlı yönlendirme ve sözlük yönetimi için kurulum sağlar.
+updatedAt: 2026-09-19
+title: astro-intlayer Paketi Dokümantasyonu
+description: Yerel ayar tabanlı yönlendirme, ara yazılım, hook'lar, istemci deposu ve sözlük yönetimi kurulumunu sağlayan Intlayer Astro entegrasyonu.
 keywords:
   - astro-intlayer
   - astro
-  - internationalization
+  - uluslararasılaştırma
   - i18n
 slugs:
   - doc
@@ -14,15 +14,18 @@ slugs:
   - astro-intlayer
   - exports
 history:
+  - version: 9.5.5
+    date: 2026-09-19
+    changes: "useIntlayer, useDictionary, useLocale hook'ları, ara yazılım ve formatlayıcılar dokümantasyonu eklendi"
   - version: 8.0.0
     date: 2026-01-21
-    changes: "Tüm dışa aktarımlar için birleştirilmiş dokümantasyon"
+    changes: "Tüm dışa aktarımlar için birleşik dokümantasyon"
 author: aymericzip
 ---
 
 # astro-intlayer Paketi
 
-`astro-intlayer` paketi, Intlayer'ı Astro uygulamalarına entegre etmek için gerekli araçları sağlar. Locale tabanlı yönlendirme ve sözlük yönetimini yapılandırır.
+`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
 
@@ -30,26 +33,175 @@ author: aymericzip
 npm install astro-intlayer
 ```
 
-## Dışa Aktarımlar
+## Dışa Aktarılanlar
 
 ### Entegrasyon
 
-`astro-intlayer` paketi, projenizde Intlayer'ı yapılandırmak için bir Astro entegrasyonu sağlar.
+`astro-intlayer` paketi, projenizde Intlayer'ı kuran bir Astro entegrasyonu sağlar.
 
 İçe aktarma:
 
 ```tsx
-import "astro-intlayer";
+import { intlayer } from "astro-intlayer";
 ```
 
-veya `astro.config.mjs` dosyasına ekleyerek:
+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()],
 });
 ```
 
-| Fonksiyon  | Açıklama                                        |
-| ---------- | ----------------------------------------------- |
-| `intlayer` | Projenizde Intlayer'ı kuran Astro entegrasyonu. |
+| Fonksiyon  | Açıklama                                                                                                                                                                                                                        | İlgili Doküman                                                                                                |
+| ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------- |
+| `intlayer` | Sö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](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/packages/astro-intlayer/intlayer.md) |
+
+### Hook'lar (Sunucu ve İstemci)
+
+İçe aktarma:
+
+```tsx
+import { useIntlayer, useDictionary, useLocale } from "astro-intlayer";
+```
+
+| Hook            | Açıklama                                                                                                                                                                                    | İlgili Doküman                                                                                                          |
+| --------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------- |
+| `useIntlayer`   | Bir 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](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/packages/astro-intlayer/useIntlayer.md)     |
+| `useDictionary` | Bir 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](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/packages/astro-intlayer/useDictionary.md) |
+| `useLocale`     | Geç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](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/packages/astro-intlayer/useLocale.md)         |
+
+### Ara Yazılım (astro-intlayer/middleware)
+
+İçe aktarma:
+
+```tsx
+import { onRequest } from "astro-intlayer/middleware";
+```
+
+| Dışa Aktarım | Tür                 | Açıklama                                                                                                                                                                | İlgili Doküman                                                                                                  |
+| ------------ | ------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------- |
+| `onRequest`  | `MiddlewareHandler` | İ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](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/packages/astro-intlayer/onRequest.md) |
+
+### Yardımcı Programlar
+
+İçe aktarma:
+
+```tsx
+import { getIntlayerLocals } from "astro-intlayer";
+```
+
+| Fonksiyon           | Açıklama                                                                                                              | İlgili Doküman |
+| ------------------- | --------------------------------------------------------------------------------------------------------------------- | -------------- |
+| `getIntlayerLocals` | `Astro.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";
+```
+
+| Hook              | Açıklama                                                                                                          |
+| ----------------- | ----------------------------------------------------------------------------------------------------------------- |
+| `useIntl`         | Önbelleğe alma ve abonelik özellikleriyle istek veya istemci yerel ayarına bağlı bir Intl örneği döndürür.        |
+| `useDate`         | Geçerli yerel ayara önceden bağlanmış bir tarih biçimlendirme işlevi döndürür (`Intl.DateTimeFormat`).            |
+| `useNumber`       | Geçerli yerel ayara önceden bağlanmış bir sayı biçimlendirme işlevi döndürür (`Intl.NumberFormat`).               |
+| `useCurrency`     | Geçerli yerel ayara önceden bağlanmış bir para birimi biçimlendirme işlevi döndürür.                              |
+| `usePercentage`   | Geçerli yerel ayara önceden bağlanmış bir yüzde biçimlendirme işlevi döndürür.                                    |
+| `useRelativeTime` | Geçerli yerel ayara önceden bağlanmış bir göreli zaman biçimlendirme işlevi döndürür (`Intl.RelativeTimeFormat`). |
+| `useList`         | Geçerli yerel ayara önceden bağlanmış bir liste biçimlendirme işlevi döndürür (`Intl.ListFormat`).                |
+| `useUnit`         | Geçerli yerel ayara önceden bağlanmış bir birim biçimlendirme işlevi döndürür.                                    |
+| `useCompact`      | Geç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ım      | Tür        | Açıklama                                                        |
+| ----------------- | ---------- | --------------------------------------------------------------- |
+| `renderHTML`      | `Function` | HTML düğümlerini oluşturmak için bağımsız yardımcı işlev.       |
+| `useHTML`         | `Hook`     | HTML sağlayıcı bağlamını ve yapılandırmasını alma hook'u.       |
+| `useHTMLRenderer` | `Hook`     | Ö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ım          | Tür        | Açıklama                                                            |
+| --------------------- | ---------- | ------------------------------------------------------------------- |
+| `compileMarkdown`     | `Function` | Markdown dizelerini yapılandırılmış bir temsile derler.             |
+| `renderMarkdown`      | `Function` | Markdown içeriğini çıktı düğümlerine dönüştürür.                    |
+| `parseMarkdown`       | `Function` | Ham Markdown içeriğini bir AST'ye ayrıştırır.                       |
+| `useMarkdown`         | `Hook`     | Markdown sağlayıcı bağlamını alma hook'u.                           |
+| `useMarkdownRenderer` | `Hook`     | Ö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";
+```
+
+| Tip               | Açıklama                                                                                        |
+| ----------------- | ----------------------------------------------------------------------------------------------- |
+| `IntlayerLocals`  | `locale`, `defaultLocale` ve `availableLocales` içeren `Astro.locals.intlayer`'a eklenen nesne. |
+| `UseLocaleProps`  | `useLocale()` tarafından kabul edilen isteğe bağlı yapılandırma özellikleri.                    |
+| `UseLocaleResult` | Yerel ayar özelliklerini ve güncelleme yöntemlerini sağlayan `useLocale()` dönüş türü.          |

package/docs/tr/packages/astro-intlayer/intlayer.md

@@ -0,0 +1,76 @@
+---
+createdAt: 2026-01-21
+updatedAt: 2026-09-19
+title: intlayer Entegrasyon Dokümantasyonu | astro-intlayer
+description: astro.config.mjs dosyasında intlayer Astro entegrasyonunu nasıl yapılandıracağınızı ve kullanacağınızı öğrenin.
+keywords:
+  - intlayer
+  - astro
+  - astro-intlayer
+  - entegrasyon
+  - i18n
+  - uluslararasılaştırma
+  - dokümantasyon
+slugs:
+  - doc
+  - packages
+  - astro-intlayer
+  - intlayer
+history:
+  - version: 9.5.5
+    date: 2026-09-19
+    changes: "Entegrasyon dokümantasyonu ara yazılım ve hook ayrıntılarıyla güncellendi"
+  - version: 8.0.0
+    date: 2026-01-21
+    changes: "Başlangıç dokümantasyonu"
+author: aymericzip
+---
+
+# intlayer Astro Entegrasyon Dokümantasyonu
+
+Astro için `intlayer` entegrasyonu, projenizi çok dilli uluslararasılaştırma (i18n) için yapılandırır. Derleme zamanı sözlük hazırlığı, Vite eklenti enjeksiyonu, otomatik istek ara yazılımı kaydı ve yerelleştirilmiş önceden oluşturulmuş sayfaların çıktısını yönetir.
+
+## Kullanım
+
+`astro.config.mjs` dosyanıza `intlayer()` ekleyin:
+
+```ts fileName="astro.config.mjs"
+import { defineConfig } from "astro/config";
+import { intlayer } from "astro-intlayer";
+
+export default defineConfig({
+  integrations: [intlayer()],
+});
+```
+
+Astro CLI'nin codemod'u (`astro add astro-intlayer`) da desteklenen varsayılan bir içe aktarma oluşturur:
+
+```ts
+import intlayer from "astro-intlayer";
+```
+
+## Açıklama
+
+Entegrasyon, Astro'nun derleme ve çalışma zamanı yaşam döngüsüne kancalanır:
+
+1. **Yapılandırma Kurulumu (`astro:config:setup`)**:
+   - **Sözlük Hazırlığı**: Derleme çalışmadan önce Intlayer sözlüklerini ve oluşturulan tipleri hazırlar.
+   - **Vite Eklentileri**: Vite takma adları (sorunsuz sözlük içe aktarımlarını etkinleştiren), yerel ayar yönlendirme proxy'leri ve derleme budaması için eklentiler enjekte eder.
+   - **Ara Yazılım Kaydı**: Projenizin ara yazılım zincirine `astro-intlayer/middleware`'i otomatik olarak enjekte eder ve gelen her istekte `Astro.locals.intlayer`'ı doldurur.
+2. **Derleme Tamamlandı (`astro:build:done`)**:
+   - **Sayfa Yeniden Yazımları**: Yerelleştirilmiş URL yeniden yazım kurallarını inceler ve önceden oluşturulmuş HTML sayfalarını bunlara karşılık gelen yerelleştirilmiş yollarda yayınlar.
+
+## Kutudan Çıktığı Gibi Sağlananlar
+
+Yapılandırıldıktan sonra, Astro uygulamanız hemen şunları kullanabilir:
+
+- `.astro` bileşen frontmatter'ı içinde `useIntlayer`, `useDictionary` ve `useLocale` hook'ları.
+- Astro uç noktalarında ve sayfalarında `Astro.locals.intlayer` nesnesi.
+- Reaktif güncellemelerle aynı API'yi yansıtan `<script>` bloklarındaki istemci tarafı içe aktarımları.
+- `astro-intlayer/format` altındaki yerleşik biçimlendiriciler (`useDate`, `useNumber`, `useCurrency`, vb.).
+
+## İlgili Dokümantasyon
+
+- [Hook `useIntlayer`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/packages/astro-intlayer/useIntlayer.md)
+- [Hook `useLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/packages/astro-intlayer/useLocale.md)
+- [Ara Yazılım `onRequest`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/packages/astro-intlayer/onRequest.md)

package/docs/tr/packages/astro-intlayer/onRequest.md

@@ -0,0 +1,76 @@
+---
+createdAt: 2026-09-19
+updatedAt: 2026-09-19
+title: onRequest Ara Yazılım Dokümantasyonu | astro-intlayer
+description: İstek yerel ayarını çözümlemek ve Astro.locals.intlayer'ı doldurmak için Astro uygulamalarında onRequest ara yazılımının nasıl kullanılacağını görün.
+keywords:
+  - onRequest
+  - middleware
+  - astro
+  - astro-intlayer
+  - Astro.locals
+  - uluslararasılaştırma
+  - dokümantasyon
+slugs:
+  - doc
+  - packages
+  - astro-intlayer
+  - onRequest
+history:
+  - version: 9.5.5
+    date: 2026-09-19
+    changes: "Başlangıç dokümantasyonu"
+author: aymericzip
+---
+
+# onRequest Astro Ara Yazılım Dokümantasyonu
+
+`astro-intlayer/middleware` paketindeki `onRequest` ara yazılımı, gelen her HTTP isteğinin yerel ayarını çözer ve `Astro.locals.intlayer` nesnesini doldurur.
+
+`astro.config.mjs` içinde `intlayer()` entegrasyonunu kaydettiğinizde bu ara yazılım otomatik olarak eklenir. Yalnızca `sequence(...)` kullanarak Astro ara yazılımını manuel olarak oluşturuyorsanız doğrudan içe aktarmanız gerekir.
+
+## Kullanım
+
+```ts fileName="src/middleware.ts"
+import { onRequest as intlayer } from "astro-intlayer/middleware";
+import { sequence } from "astro:middleware";
+
+export const onRequest = sequence(intlayer, async (context, next) => {
+  // Özel ara yazılımınızda çözümlenen yerel ayara erişin
+  const { locale } = context.locals.intlayer;
+  console.log(`Yerel ayar için istek işleniyor: ${locale}`);
+
+  return next();
+});
+```
+
+## Açıklama
+
+Ara yazılım aşağıdaki işlemleri gerçekleştirir:
+
+1. **Yerel Ayar Algılama**:
+   - **URL**: URL yolu önekini veya `?locale=` arama parametresini analiz eder (`routing.mode` `no-prefix` olarak ayarlanmadığı sürece).
+   - **Çerezler / Başlıklar**: Kalıcı yerel ayar çerezlerini veya özel başlık değerlerini kontrol eder.
+   - **Accept-Language**: Tarayıcının tercih edilen dil anlaşmasına geri döner.
+   - Önceden oluşturulmuş sayfalar (`context.isPrerendered`) için, Astro derleme uyarılarını önlemek amacıyla yerel ayar kesinlikle URL'den ayıklanır.
+2. **Bağlam Doldurma**: `Astro.locals.intlayer`'ı şunlarla doldurur:
+   - `locale`: Çözümlenen yerel ayar.
+   - `defaultLocale`: Varsayılan geri dönüş yerel ayarı.
+   - `availableLocales`: Yapılandırılmış yerel ayarlar dizisi.
+3. **AsyncLocalStorage Kapsamı**: Sonraki istek işlemeyi bir `AsyncLocalStorage` kapsamı içinde sararak `useIntlayer()`, `useDictionary()` ve `useLocale()`'ün argüman iletmeden istek durumuna erişmesine olanak tanır.
+
+## `IntlayerLocals` Tipi
+
+```ts
+export type IntlayerLocals = {
+  locale: DeclaredLocales;
+  defaultLocale: DeclaredLocales;
+  availableLocales: DeclaredLocales[];
+};
+```
+
+## İlgili Dokümantasyon
+
+- [`intlayer` Entegrasyonu](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/packages/astro-intlayer/intlayer.md)
+- [Hook `useIntlayer`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/packages/astro-intlayer/useIntlayer.md)
+- [Hook `useLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/packages/astro-intlayer/useLocale.md)

package/docs/tr/packages/astro-intlayer/useDictionary.md

@@ -0,0 +1,95 @@
+---
+createdAt: 2026-09-19
+updatedAt: 2026-09-19
+title: useDictionary Hook Dokümantasyonu | astro-intlayer
+description: Sözlük nesnelerini çözümlemek için Astro bileşenlerinde ve komut dosyalarında useDictionary hook'unun nasıl kullanılacağını görün.
+keywords:
+  - useDictionary
+  - dictionary
+  - astro
+  - astro-intlayer
+  - Intlayer
+  - intlayer
+  - uluslararasılaştırma
+  - dokümantasyon
+slugs:
+  - doc
+  - packages
+  - astro-intlayer
+  - useDictionary
+history:
+  - version: 9.5.5
+    date: 2026-09-19
+    changes: "Başlangıç dokümantasyonu"
+author: aymericzip
+---
+
+# useDictionary Hook Dokümantasyonu
+
+`useDictionary` hook'u, içe aktarılmış veya satır içi bir sözlük nesnesini çözer ve Astro uygulamalarında geçerli yerel ayar için içeriğini döndürür.
+
+Genel sözlük kaydından anahtarla sözlükleri alan `useIntlayer`'ın aksine, `useDictionary` doğrudan bir sözlük nesnesiyle çalışır.
+
+## Kullanım
+
+```astro fileName="src/pages/index.astro"
+---
+import { useDictionary } from "astro-intlayer";
+import homeContent from "../content/home.content";
+
+const content = useDictionary(homeContent);
+---
+
+<main>
+  <h1>{content.title}</h1>
+  <p>{content.description}</p>
+</main>
+```
+
+`t()` ile tanımlanan satır içi sözlükleri de geçirebilirsiniz:
+
+```astro fileName="src/components/Footer.astro"
+---
+import { useDictionary } from "astro-intlayer";
+import { t } from "intlayer";
+
+const footer = useDictionary({
+  key: "footer",
+  content: {
+    copyright: t({
+      tr: "Tüm hakları saklıdır.",
+      en: "All rights reserved.",
+      fr: "Tous droits réservés.",
+      es: "Todos los derechos reservados.",
+    }),
+  },
+});
+---
+
+<footer>
+  <p>{footer.copyright}</p>
+</footer>
+```
+
+## Parametreler
+
+```ts
+useDictionary(dictionary, localeOrSelector?)
+```
+
+1. **`dictionary`**: Bir sözlük nesnesi veya nitelikli sözlük grubu.
+2. **`localeOrSelector`** (isteğe bağlı): Belirli bir yerel ayar veya seçici nesnesi (`{ item }`, `{ variant }`, isteğe bağlı olarak `locale`).
+
+## Açıklama
+
+Hook aşağıdaki görevleri yerine getirir:
+
+1. **Yerel Ayar Algılama**: Sunucuda, yerel ayarı `Astro.locals.intlayer`'dan alır. Tarayıcıda, istemci tarafı depo yerel ayarını kullanır.
+2. **İçerik İşleme**: Çözümlenen yerel ayara göre çevirileri (`t()`), numaralandırmaları, koşulları ve iç içe geçmiş yapıları çözümler.
+3. **Seçiciler**: Bağımsız değişkenlerde sağlanan tüm öğe veya varyant seçicilerini uygular.
+
+## İlgili Dokümantasyon
+
+- [`intlayer` Entegrasyonu](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/packages/astro-intlayer/intlayer.md)
+- [Hook `useIntlayer`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/packages/astro-intlayer/useIntlayer.md)
+- [Hook `useLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/packages/astro-intlayer/useLocale.md)

package/docs/tr/packages/astro-intlayer/useIntlayer.md

@@ -0,0 +1,98 @@
+---
+createdAt: 2026-09-19
+updatedAt: 2026-09-19
+title: useIntlayer Hook Dokümantasyonu | astro-intlayer
+description: Yerelleştirilmiş içeriğe erişmek için Astro bileşenlerinde ve istemci komut dosyalarında useIntlayer hook'unun nasıl kullanılacağını görün.
+keywords:
+  - useIntlayer
+  - dictionary
+  - astro
+  - astro-intlayer
+  - Intlayer
+  - intlayer
+  - uluslararasılaştırma
+  - dokümantasyon
+slugs:
+  - doc
+  - packages
+  - astro-intlayer
+  - useIntlayer
+history:
+  - version: 9.5.5
+    date: 2026-09-19
+    changes: "Başlangıç dokümantasyonu"
+author: aymericzip
+---
+
+# useIntlayer Hook Dokümantasyonu
+
+`useIntlayer` hook'u, Astro uygulamalarında anahtara göre yerelleştirilmiş sözlük içeriğini almanızı sağlar.
+
+Aynı içe aktarma yolu kullanılarak iki farklı bağlamda çağrılabilir:
+
+1. **Sunucu / Frontmatter**: `.astro` dosyaları içinde, `Astro.locals.intlayer`'da depolanan istek yerel ayarını kullanarak içeriği otomatik olarak çözer.
+2. **Tarayıcı / İstemci `<script>`**: İstemci komut dosyaları veya UI çerçeve bileşenleri içinde, istemci tarafı depo uygulamasına (`vanilla-intlayer`) çözümlenir.
+
+## Kullanım
+
+### Astro Bileşen Frontmatter'ında
+
+```astro fileName="src/pages/index.astro"
+---
+import { useIntlayer } from "astro-intlayer";
+
+const content = useIntlayer("home");
+---
+
+<main>
+  <h1>{content.title}</h1>
+  <p>{content.description}</p>
+</main>
+```
+
+### İstemci `<script>` Bloklarında
+
+```astro fileName="src/components/InteractiveWidget.astro"
+---
+import { useIntlayer } from "astro-intlayer";
+
+const content = useIntlayer("home");
+---
+
+<button id="alert-btn">{content.buttonText}</button>
+
+<script>
+  import { useIntlayer } from "astro-intlayer";
+
+  const content = useIntlayer("home");
+
+  document.getElementById("alert-btn")?.addEventListener("click", () => {
+    alert(content.buttonText);
+  });
+</script>
+```
+
+## Parametreler
+
+```ts
+useIntlayer(key, localeOrSelector?)
+```
+
+1. **`key`**: Sözlüğün benzersiz anahtarı (`.content.ts` bildirim dosyalarınızda tanımlandığı gibi).
+2. **`localeOrSelector`** (isteğe bağlı): Belirli bir yerel ayar veya seçici nesnesi (`{ item }`, `{ variant }`, isteğe bağlı olarak `locale`). Sağlandığında, istek bağlamından veya istemci deposundan algılanan yerel ayarı geçersiz kılar.
+
+## Açıklama
+
+Hook aşağıdaki görevleri yerine getirir:
+
+1. **Yerel Ayar Çözümleme**:
+   - Sunucuda, `astro-intlayer/middleware` tarafından başlatılan bir `AsyncLocalStorage` kapsamı aracılığıyla `Astro.locals.intlayer`'dan etkin yerel ayarı okur.
+   - Tarayıcıda, etkin yerel ayarı istemci deposundan okur.
+2. **Sözlük Alma**: Belirtilen anahtarla eşleşen sözlük içeriğini enjekte eder.
+3. **Çeviri İşleme**: Çevirileri (`t()`), numaralandırmaları, koşulları ve markdown'ı oluşturulmaya hazır içeriğe dönüştürür.
+
+## İlgili Dokümantasyon
+
+- [`intlayer` Entegrasyonu](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/packages/astro-intlayer/intlayer.md)
+- [Hook `useDictionary`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/packages/astro-intlayer/useDictionary.md)
+- [Hook `useLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/packages/astro-intlayer/useLocale.md)