@intlayer/docs 9.3.3 → 9.4.0

package/docs/tr/packages/intlayer/getEnumeration.md

@@ -31,6 +31,8 @@ author: aymericzip
 
 `getEnumeration` fonksiyonu, bir numaralandırma nesnesindeki önceden tanımlanmış koşullara göre belirli bir miktara karşılık gelen içeriği alır. Koşullar anahtarlar olarak tanımlanır ve öncelik, nesnedeki sıralarına göre belirlenir.
 
+Enumerations bildirimi hakkında daha fazla bilgi için [Enumeration documentation](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/dictionary/enumeration.md) bölümüne bakınız.
+
 ## Parametreler
 
 - `enumerationContent: QuantityContent<Content>`

package/docs/tr/packages/intlayer/getIntlayer.md

@@ -0,0 +1,197 @@
+---
+createdAt: 2026-08-23
+updatedAt: 2026-08-23
+title: getIntlayer Fonksiyonu Dokümantasyonu | intlayer
+description: intlayer paketi için getIntlayer fonksiyonunun nasıl kullanılacağını öğrenin
+keywords:
+  - getIntlayer
+  - dictionary
+  - content
+  - selector
+  - Intlayer
+  - intlayer
+  - Internationalization
+  - Documentation
+  - JavaScript
+  - TypeScript
+slugs:
+  - doc
+  - packages
+  - intlayer
+  - getIntlayer
+history:
+  - version: 9.4.0
+    date: 2026-08-23
+    changes: "Initial documentation"
+author: aymericzip
+---
+
+# Belgelendirme: `intlayer`'de `getIntlayer` Fonksiyonu
+
+## Açıklama
+
+`getIntlayer` işlevi bir anahtar (key) ile bir sözlüğü seçer ve içeriğini belirli bir yerel ayar için yorumlanmış şekilde döndürür. `useIntlayer` hook'unun framework-agnostik karşılığıdır: aynı içerik, aynı seçiciler, ancak React context'in kullanılamadığı her yerde kullanılabilir — Node scriptleri, server işlevleri, route loaders, metadata builders, Express/Fastify handlers, testler.
+
+Intlayer tarafından `.intlayer/` içinde oluşturulan sözlükleri okur, bu nedenle `key` argümanı sizin kendi içerik bildirimlerinizden türü belirlenmiş ve otomatik tamamlanmıştır, ve döndürülen nesne her yaprakta tam olarak türü belirlenmiştir.
+
+**Ana Özellikler:**
+
+- Türü belirlenmiş sözlük anahtarları ve türü belirlenmiş döndürülen içerik
+- Her içerik düğümünü yorumlar (`t()`, `enu()`, `cond()`, `insert()`, `nest()`, `md()`, `html()`, `file()`, `gender()`)
+- Yerel ayarı veya seçici nesnesini kabul eder (koleksiyonlar, varyantlar)
+- Sonuçlar `key + locale + selector` başına bellekte tutulur
+- Geliştirme sırasında sözlük eksik olduğunda, kilitlenmek yerine güvenli bir proxy'ye geri döner
+
+---
+
+## Fonksiyon İmzası
+
+```typescript
+getIntlayer(
+  key: DictionaryKeys,                        // Gerekli
+  localeOrSelector?: LocalesValues | DictionarySelector, // İsteğe bağlı
+  plugins?: Plugins[]                         // İsteğe bağlı
+): DeepTransformContent<...>
+```
+
+---
+
+## Parametreler
+
+- `key: DictionaryKeys`
+  - **Açıklama**: İçerik dosyalarınızda bildirilen sözlüğün anahtarı.
+  - **Tür**: `DictionaryKeys` — bildirilen her sözlük anahtarının birleşimi.
+  - **Gerekli**: Evet
+
+- `localeOrSelector: LocalesValues | DictionarySelector`
+  - **Açıklama**: İçeriği yorumlamak için kullanılacak yerel ayar veya [dinamik sözlükler](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/dynamic_dictionaries/index.md) için bir seçici nesnesi.
+    - `'fr'` — bir yerel ayar
+    - `{ item: 2 }` — bir [koleksiyon](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/dynamic_dictionaries/collections.md) öğesi (`item` öğesini atlayarak tüm öğeleri dizi olarak alabilirsiniz)
+    - `{ variant: 'black-friday' }` — adlandırılmış bir [varyant](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/dynamic_dictionaries/variants.md) (varsayılan olanı almak için atlayın)
+    - `{ variant: { id: 'prod_abc', userId: '123' } }` — yapılandırılmış bir varyant
+    - Herhangi bir seçici yerel ayar taşıyabilir: `{ item: 2, locale: 'fr' }`
+  - **Tür**: `LocalesValues | DictionarySelector`
+  - **Gerekli**: Hayır (İsteğe bağlı) — yapılandırılan `defaultLocale` değerini kullanır.
+
+- `plugins: Plugins[]`
+  - **Açıklama**: Temel yorumlayıcı eklentilerinin yerini alan özel düğüm dönüştürücüleri. Yalnızca ileri kullanım için; varsayılan davranışı korumak için atlayın.
+  - **Tür**: `Plugins[]`
+  - **Gerekli**: Hayır (İsteğe bağlı)
+
+### Döndürülen Değerler
+
+- **Type**: Sözlüğünüzün deklarasyonundan yazılan, yorumlanan içerik.
+- **Description**: Sözlüğünüzün `content` alanını yansıtan düz bir nesne; burada her Intlayer düğümü, istenen locale için nihai değerine çözülmüştür.
+
+---
+
+## Örnek Kullanım
+
+### Temel Kullanım
+
+```typescript fileName="src/app.content.ts" codeFormat="typescript"
+import { t, type Dictionary } from "intlayer";
+
+const appContent = {
+  key: "app",
+  content: {
+    title: t({
+      tr: "Merhaba",
+      en: "Hello",
+      fr: "Bonjour",
+    }),
+  },
+} satisfies Dictionary;
+
+export default appContent;
+```
+
+```typescript codeFormat={["typescript", "esm", "commonjs"]}
+import { getIntlayer } from "intlayer";
+
+const { title } = getIntlayer("app", "fr"); // "Bonjour"
+```
+
+### Locale olmadan
+
+Locale'i atlarsanız, içerik [yapılandırmanızda](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/configuration.md) belirtilen `defaultLocale` ile yorumlanır.
+
+```typescript
+import { getIntlayer } from "intlayer";
+
+const { title } = getIntlayer("app"); // Varsayılan locale ile yorumlanır
+```
+
+### Bir sunucu işleyicisinin içinde
+
+```typescript fileName="src/routes/greeting.ts" codeFormat="typescript"
+import { getIntlayer, getLocale } from "intlayer";
+
+export const greetingHandler = async (request: Request) => {
+  const locale = await getLocale({
+    getHeader: (name) => request.headers.get(name) ?? undefined,
+  });
+
+  const { title } = getIntlayer("app", locale);
+
+  return Response.json({ title });
+};
+```
+
+### Seçici ile (collections ve variants)
+
+```typescript
+import { getIntlayer } from "intlayer";
+
+// Bir collection öğesi
+const secondPost = getIntlayer("blog-post", { item: 2, locale: "fr" });
+
+// Collection'ın tüm öğeleri, sıralı bir dizi olarak
+const allPosts = getIntlayer("blog-post", { locale: "fr" });
+
+// Adlandırılmış bir variant
+const banner = getIntlayer("banner", { variant: "black-friday", locale: "fr" });
+```
+
+---
+
+## Davranış Notları
+
+### Önbellekleme
+
+Sonuçlar, `key + locale + selector` ile anahtarlanan bir modül seviyesi önbelleğinde memoize edilir. `getIntlayer("app", "fr")` işlemini tekrar tekrar çağırmak sözlüğü bir kez yorumlar ve daha sonra aynı nesneyi döndürür.
+
+### Eksik sözlükler
+
+Geliştirme sırasında, oluşturulmuş bir sözlüğü olmayan bir anahtarı istediğinizde, bir uyarı bir kez kaydedilir ve güvenli bir fallback proxy döndürülür: `content.title` öğesini okuduğunuzda hata atmak yerine `"app.title"` dizesini verir. Bu, eksik bildirim düzeltilirken bir sayfanın kullanılabilir kalmasını sağlar. Sözlüğün oluşturulması için Intlayer build'ini (veya geliştirme sunucusunu) çalıştırın.
+
+### Bundle boyutu
+
+`getIntlayer` birleştirilmiş sözlüğü okur; bu sözlük **her** locale'i içerir. İstemci bundle'larında, [build eklentileri](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/bundle_optimization.md) çağrıyı yeniden yazarak yalnızca gerekli içeriğin gönderilmesini sağlar. Rendering dışında içerik okuyorsanız (metadata, loaders, server functions) ve talep üzerine tek bir locale yüklenmesini istiyorsanız, bunun yerine [`getIntlayerAsync`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/packages/intlayer/getIntlayerAsync.md) kullanın.
+
+---
+
+## İlgili Fonksiyonlar
+
+- [`getIntlayerAsync`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/packages/intlayer/getIntlayerAsync.md): Tek bir locale chunk yükleyen async eşdeğeri.
+- [`getDictionary`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/packages/intlayer/getDictionary.md): Anahtarla arama yapılan bir sözlük yerine, kendiniz geçtiğiniz bir sözlük nesnesini yorumlar.
+- [`useIntlayer`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/packages/react-intlayer/useIntlayer.md): React hook eşdeğeri, provider'dan locale'i okur.
+
+---
+
+## TypeScript
+
+```typescript
+function getIntlayer<
+  const T extends DictionaryKeys,
+  const A extends LocalesValues | DictionarySelector = DeclaredLocales,
+>(
+  key: T,
+  localeOrSelector?: A,
+  plugins?: Plugins[]
+): DeepTransformContent<
+  DictionaryRegistryResult<T, A>,
+  IInterpreterPluginState,
+  ExtractSelectorLocale<A>
+>;
+```

package/docs/tr/packages/intlayer/getIntlayerAsync.md

@@ -0,0 +1,141 @@
+---
+createdAt: 2026-08-23
+updatedAt: 2026-08-23
+title: getIntlayerAsync Function Documentation | intlayer
+description: getIntlayerAsync fonksiyonunun intlayer paketi ile nasıl kullanılacağını öğrenin
+keywords:
+  - getIntlayerAsync
+  - dictionary
+  - dynamic import
+  - metadata
+  - bundle optimization
+  - Intlayer
+  - intlayer
+  - Internationalization
+  - Documentation
+  - JavaScript
+  - TypeScript
+slugs:
+  - doc
+  - packages
+  - intlayer
+  - getIntlayerAsync
+history:
+  - version: 9.4.0
+    date: 2026-08-23
+    changes: "Initial documentation"
+author: aymericzip
+---
+
+# Dokumentasyon: `intlayer` içindeki `getIntlayerAsync` Fonksiyonu
+
+## Açıklama
+
+`getIntlayerAsync` fonksiyonu bir sözlüğü anahtarına göre seçer ve içeriğini belirli bir locale için çözer, **yalnızca o locale'i yükler**.
+
+[`getIntlayer`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/packages/intlayer/getIntlayer.md) fonksiyonunun asenkron karşılığıdır ve sözlüğün render işlemi dışında okunduğu yerlerde kullanılır — route `head` / metadata builders, loaders, server functions.
+
+`getIntlayer` tüm locale'leri içeren birleştirilmiş sözlüğü çekerken, [build plugins](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/bundle_optimization.md) (`@intlayer/babel`, `@intlayer/swc`) bu çağrıyı `getDictionaryAsync(loaderMap, key, locale)` olarak yeniden yazar ve `.intlayer/dynamic_dictionaries/` içindeki locale başına chunks'lara işaret eder. Bundle bu nedenle yalnızca istenen locale'i taşır.
+
+Bu plugins olmadan — optimize edilmemiş bir build — çağrı bunun yerine senkron sözlük registry'si üzerinden çözülür: aynı içerik, locale başına bölünme olmadan.
+
+**Temel Özellikler:**
+
+- `getIntlayer` ile aynı typed keys, selectors ve döndürülen içerik
+- Optimize edilmiş builds'de yalnızca istenen locale chunk'ını yükler
+- Aynı chunk için eş zamanlı çağrılar tek bir yüklemişi paylaşır
+- `async` metadata builders, loaders ve server functions'larda kullanmak için güvenlidir
+
+---
+
+## Fonksiyon İmzası
+
+```typescript
+getIntlayerAsync(
+  key: DictionaryKeys,                        // Gerekli
+  localeOrSelector?: LocalesValues | DictionarySelector, // İsteğe Bağlı
+  plugins?: Plugins[]                         // İsteğe Bağlı
+): Promise<DeepTransformContent<...>>
+```
+
+---
+
+## Parametreler
+
+- `key: DictionaryKeys`
+  - **Description**: İçerik dosyalarınızda bildirildiği şekilde okunacak sözlüğün anahtarı.
+  - **Type**: `DictionaryKeys` — bildirilen her sözlük anahtarının birleşimi.
+  - **Required**: Evet
+
+- `localeOrSelector: LocalesValues | DictionarySelector`
+  - **Description**: İçeriği yorumlamak için kullanılacak yerel ayar veya [dinamik sözlükler](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/dynamic_dictionaries/index.md) için seçici nesnesi.
+    - `'fr'` — bir yerel ayar
+    - `{ item: 2 }` — bir [koleksiyon](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/dynamic_dictionaries/collections.md) öğesi (tüm öğeleri dizi olarak almak için `item` atlanmalıdır)
+    - `{ variant: 'black-friday' }` — adlandırılmış bir [varyant](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/dynamic_dictionaries/variants.md) (varsayılan olan için atlanmalıdır)
+    - `{ variant: { id: 'prod_abc', userId: '123' } }` — yapılandırılmış varyant
+    - Herhangi bir seçici yerel ayar taşıyabilir: `{ item: 2, locale: 'fr' }`
+  - **Type**: `LocalesValues | DictionarySelector`
+  - **Required**: Hayır (İsteğe bağlı) — yapılandırılan `defaultLocale` değerini kullanır.
+
+- `plugins: Plugins[]`
+  - **Description**: Temel yorumlayıcı eklentilerini değiştiren özel düğüm dönüştürücüleri. Yalnızca ileri kullanım için.
+  - **Type**: `Plugins[]`
+  - **Required**: Hayır (İsteğe bağlı)
+
+### Döndürülen Değer
+
+- **Type**: `Promise<Content>` — sözlüğün yorumlanan içeriğine çözümlenen bir promise, deklarasyonunuzdan yazılmıştır.
+
+---
+
+## Örnek Kullanım
+
+### Temel Kullanım
+
+```typescript codeFormat={["typescript", "esm", "commonjs"]}
+import { getIntlayerAsync } from "intlayer";
+
+const { title } = await getIntlayerAsync("app", "fr"); // "Bonjour"
+```
+
+---
+
+## `getIntlayer` vs `getIntlayerAsync`
+
+|                    | [`getIntlayer`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/packages/intlayer/getIntlayer.md) | `getIntlayerAsync`                                       |
+| ------------------ | --------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------- |
+| Döndürülen değer   | İçerik                                                                                                          | İçeriğin bir promise'i                                   |
+| Yüklenen sözlük    | Birleştirilmiş sözlük (tüm diller)                                                                              | Yalnızca istenen dilin parçası                           |
+| En uygun kullanım  | Rendering, senkron kod yolları                                                                                  | Metadata, loaders, server fonksiyonları                  |
+| Plugin gerekli mi? | Hayır                                                                                                           | Hayır — dil başına bölme, build eklentilerini gerektirir |
+
+Her ikisi de aynı argümanları kabul eder ve aynı içeriği döndürür: birinden diğerine geçiş yalnızca **ne zaman** ve **ne kadar** yüklendiğini değiştirir.
+
+---
+
+## İlgili Fonksiyonlar
+
+- [`getIntlayer`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/packages/intlayer/getIntlayer.md): Birleştirilmiş sözlüğü okuyan senkron eşdeğer.
+- [`getDictionaryAsync`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/packages/intlayer/getDictionaryAsync.md): Build eklentilerinin bu çağrıyı yeniden yazdığı alt seviye fonksiyon.
+- [`getLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/packages/intlayer/getLocale.md): Gelen bir isteğin yerel ayarını algılar.
+
+---
+
+## TypeScript
+
+```typescript
+function getIntlayerAsync<
+  const T extends DictionaryKeys,
+  const A extends LocalesValues | DictionarySelector = DeclaredLocales,
+>(
+  key: T,
+  localeOrSelector?: A,
+  plugins?: Plugins[]
+): Promise<
+  DeepTransformContent<
+    DictionaryRegistryResult<T, A>,
+    IInterpreterPluginState,
+    ExtractSelectorLocale<A>
+  >
+>;
+```

package/docs/tr/packages/intlayer/getLocalizedPath.md

@@ -31,6 +31,8 @@ author: aymericzip
 
 getLocalizedPath fonksiyonu, verilen locale ve yeniden yazma (rewrite) kurallarına göre bir canonical path'i (uygulama içi yol) hedef dildeki karşılığına çözer. Dil bazlı olarak değişen, SEO dostu URL'ler üretmek için özellikle faydalıdır.
 
+[`getLocalizedUrl`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/packages/intlayer/getLocalizedUrl.md) işlevinin göreceli karşılığıdır — göreceli bir giriş için her ikisi de aynı değeri döndürür. `getLocalizedUrl`'den farklı olarak, asla mutlak bir URL döndürmez: `domains` yapılandırması yok sayılır, bu nedenle kendi alanından sunulan bir locale yine de bir yol döndürür. Mutlak bir giriş kabul edilir, ancak kaynağı atılır — yalnızca yol, sorgu dizesi ve hash korunur.
+
 **Temel Özellikler:**
 
 - `[param]` sözdizimini kullanarak dinamik rota parametrelerini destekler.
@@ -60,18 +62,23 @@ getLocalizedPath(
   - **Tür**: `string`
   - **Gerekli**: Evet
 
-- `locale: Locales`
-  - **Açıklama**: Yolun yerelleştirileceği hedef yerel.
-  - **Tür**: `Locales`
-  - **Gerekli**: Evet
-
 ### İsteğe Bağlı Parametreler
 
+- `locale?: Locales`
+  - **Description**: Yolun yerelleştirilmesi gereken hedef locale.
+  - **Type**: `Locales`
+  - **Default**: Projenizin yapılandırmasının varsayılan locale'i.
+
 - `rewriteRules?: RoutingConfig['rewrite']`
   - **Açıklama**: Özel yeniden yazma kurallarını tanımlayan bir nesne. Sağlanmazsa, proje yapılandırmanızdaki `routing.rewrite` özelliği varsayılan olarak kullanılır.
   - **Tür**: `RoutingConfig['rewrite']`
   - **Varsayılan**: `configuration.routing.rewrite`
 
+  - `options.locales?: Locales[]` — desteklenen locale'ler. **Varsayılan**: `configuration.internationalization.locales`
+  - `options.defaultLocale?: Locales` — varsayılan locale. **Varsayılan**: `configuration.internationalization.defaultLocale`
+  - `options.mode?: 'prefix-no-default' | 'prefix-all' | 'no-prefix' | 'search-params'` — locale'nin yolda nasıl göründüğü. **Varsayılan**: `configuration.routing.mode`
+  - `options.rewrite?: RoutingConfig['rewrite']` — özel rewrite kuralları. **Varsayılan**: `configuration.routing.rewrite`
+
 ---
 
 ## Dönüş Değeri
@@ -79,6 +86,28 @@ getLocalizedPath(
 - **Tür**: `string`
 - **Açıklama**: Belirtilen yerel için yerelleştirilmiş yol.
 
+Tür, yapılandırmanızda bildirilen yeniden yazma kurallarından daraltılır, bu nedenle düzenleyici çıplak `string` yerine çözülmüş yolu gösterir:
+
+```typescript codeFormat="typescript"
+// Yapılandırma: mod 'prefix-no-default', defaultLocale 'en',
+//                { '/about': { fr: '/a-propos' }, '/product/[id]': { fr: '/produit/[id]' } }
+const about = getLocalizedPath("/about", Locales.FRENCH);
+//    ^? '/fr/a-propos'
+const product = getLocalizedPath("/product/123", Locales.FRENCH);
+//    ^? '/fr/produit/123'
+const contact = getLocalizedPath("/contact", Locales.FRENCH);
+//    ^? '/fr/contact'  (eşleşen yeniden yazma kuralı yok, sadece önek uygulanır)
+const home = getLocalizedPath("/", Locales.FRENCH);
+//    ^? '/fr'
+```
+
+Aynı daraltma [`getLocalizedUrl`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/packages/intlayer/getLocalizedUrl.md) içine akar, bu da locale'i ön ekleme yapmadan önce yeniden yazma kurallarını uygular.
+
+İki durumun `string`'e genişletilmesi gerekir, çünkü bunlar derleme zamanında çözümlenemez:
+
+- string literal olmayan bir yol (örneğin bir değişkenden oluşturulan);
+- çok segmentli veya isteğe bağlı bir parametre kullanan bir kuralla eşleşen bir yol (`[...slug]`, `[[...slug]]`, `:param?`).
+
 ---
 
 ## Örnek Kullanım
@@ -126,6 +155,18 @@ getLocalizedPath("/contact", Locales.FRENCH, manualRules);
 // Output: "/contactez-nous"
 ```
 
+### Yerel Ayarı Atlamak
+
+Yerel ayar verilmediğinde, yol yapılandırılan varsayılan yerel ayar için yerelleştirilir:
+
+```typescript codeFormat="typescript"
+import { getLocalizedPath } from "intlayer";
+
+// Yapılandırma: defaultLocale = Locales.ENGLISH, { '/about': { en: '/about', fr: '/a-propos' } }
+getLocalizedPath("/about");
+// Çıktı: "/about"
+```
+
 ---
 
 ## İlgili Fonksiyonlar

package/docs/tr/packages/intlayer/getLocalizedUrl.md

@@ -70,6 +70,11 @@ getLocalizedUrl(
 
 ### İsteğe Bağlı Parametreler
 
+- `options?: object`
+  - **Description**: URL yerelleştirme davranışı için yapılandırma nesnesi.
+  - **Type**: `object`
+  - **Required**: Hayır (İsteğe bağlı)
+
 - `locales?: Locales[]`
   - **Açıklama**: Desteklenen yerel ayarlar dizisi. Sağlanmazsa, proje yapılandırmanızdan yapılandırılan yerel ayarları kullanır.
   - **Tür**: `Locales[]`
@@ -210,6 +215,12 @@ getLocalizedUrl(
 - **Desteklenmeyen Yerel Ayarlar:**
   - `locales`'te listelenmeyen yerel ayarlar için fonksiyon herhangi bir önek uygulamaz.
 
+- **Yönlendirme Modları:**
+  - `'prefix-no-default'`: Varsayılan yerel ayarın öneki yoktur, diğerlerinin var (ör: `/about`, `/fr/about`)
+  - `'prefix-all'`: Tüm yerel ayarların önekleri var (ör: `/en/about`, `/fr/about`)
+  - `'no-prefix'`: URL'lerde yerel ayar öneki yoktur (yerel ayar başka yerde işlenir)
+  - `'search-params'`: Sorgu parametresi aracılığıyla belirtilen yerel ayar (ör: `/about?locale=fr`)
+
 ---
 
 ## Uygulamalarda Kullanım

package/docs/tr/packages/intlayer/getMultilingualUrls.md

@@ -138,8 +138,6 @@ getMultilingualUrls(
 // }
 ```
 
----
-
 ### Farklı Yönlendirme Modları
 
 ```typescript
@@ -205,6 +203,12 @@ getMultilingualUrls("/dashboard", {
 - **Desteklenmeyen Yerel Ayarlar:**
   - Sadece `locales` dizisinde sağlanan yerel ayarlar URL'leri oluşturmak için dikkate alınır.
 
+- **Yönlendirme Modları:**
+  - `'prefix-no-default'`: Varsayılan yerel ayarın öneki yok, diğerlerinin vardır (örn. `/dashboard`, `/fr/dashboard`)
+  - `'prefix-all'`: Tüm yerel ayarların önekleri vardır (örn. `/en/dashboard`, `/fr/dashboard`)
+  - `'no-prefix'`: URL'lerde yerel ayar öneki yoktur (tüm yerel ayarlar aynı URL'yi döndürür)
+  - `'search-params'`: Yerel ayar sorgu parametresi aracılığıyla belirtilir (örn. `/dashboard?locale=fr`)
+
 ---
 
 ## Uygulamalarda Kullanım

package/docs/tr/packages/intlayer/getTranslation.md

@@ -31,6 +31,8 @@ author: aymericzip
 
 `getTranslationContent` fonksiyonu, özelleştirilebilir dil içeriğinin bir kümesinden belirli bir yerel ayara karşılık gelen içeriği alır. Belirtilen yerel ayar bulunamazsa, projede yapılandırılan varsayılan yerel ayar için içeriği döndürür.
 
+Çevirileri nasıl bildireceğiniz hakkında daha fazla ayrıntı için bkz. [Çeviri belgeleri](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/dictionary/translation.md).
+
 ## Parametreler
 
 - `languageContent: CustomizableLanguageContent<Content>`

package/docs/tr/packages/next-intlayer/t.md

@@ -158,6 +158,23 @@ const greeting = t(translations);
 
 #### Örnek:
 
+<Tabs>
+ <Tab label='Intlayer >=9.4' value='>=9.4'>
+
+```tsx codeFormat={["typescript", "esm", "commonjs"]}
+import type { FC, ReactNode } from "react";
+import type { Locales } from "intlayer";
+import { IntlayerProvider } from "next-intlayer/server";
+
+const Page: FC<{ locale: Locales; children: ReactNode }> = ({
+  locale,
+  children,
+}) => <IntlayerProvider locale={locale}>{children}</IntlayerProvider>;
+```
+
+ </Tab>
+ <Tab label='Intlayer <9.4' value='<9.4'>
+
 ```tsx codeFormat={["typescript", "esm", "commonjs"]}
 import type { FC } from "react";
 import type { Locales } from "intlayer";
@@ -173,6 +190,9 @@ const Page: FC<{ locale: Locales }> = ({ locale }) => (
 );
 ```
 
+</Tab>
+</Tabs>
+
 ---
 
 ## Yaygın Hatalar ve Sorun Giderme

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

@@ -79,6 +79,34 @@ Next.js uygulamanızda istemci tarafı veya sunucu tarafı bileşenlerde çalı
 
 İşte uygulamanın mevcut yerel ayarına göre yerelleştirilmiş içeriği dinamik olarak yüklemek için `useIntlayer` hook'unu bir Next.js sayfasında nasıl uygulayabileceğiniz:
 
+<Tabs>
+ <Tab label='Intlayer >=9.4' value='>=9.4'>
+
+```tsx fileName="src/pages/[locale]/index.tsx" codeFormat={["typescript", "esm"]}
+import { ClientComponentExample } from "@components/ClientComponentExample";
+import { ServerComponentExample } from "@components/ServerComponentExample";
+import { type NextPageIntlayer } from "next-intlayer";
+import { useIntlayer } from "next-intlayer";
+import { IntlayerProvider } from "next-intlayer/server";
+
+const HomePage: NextPageIntlayer = async ({ params }) => {
+  const { locale } = await params;
+
+  const content = useIntlayer("homepage", locale);
+
+  return (
+    <IntlayerProvider locale={locale}>
+      <p>{content.introduction}</p>
+      <ClientComponentExample />
+      <ServerComponentExample />
+    </IntlayerProvider>
+  );
+};
+```
+
+ </Tab>
+ <Tab label='Intlayer <9.4' value='<9.4'>
+
 ```tsx fileName="src/pages/[locale]/index.tsx" codeFormat={["typescript", "esm"]}
 import { ClientComponentExample } from "@components/ClientComponentExample";
 import { ServerComponentExample } from "@components/ServerComponentExample";
@@ -104,6 +132,9 @@ const HomePage: NextPageIntlayer = async ({ params }) => {
 };
 ```
 
+</Tab>
+</Tabs>
+
 ```tsx fileName="src/components/ClientComponentExample.tsx" codeFormat={["typescript", "esm"]}
 "use-client";
 

package/docs/tr/packages/next-intlayer/useLocale.md

@@ -104,6 +104,8 @@ const LocaleSwitcher: FC = () => {
 
 ## Dönüş Değerleri
 
+`useLocale` hook'unu çağırdığınızda, aşağıdaki özellikleri içeren bir nesne döndürür:
+
 - **`locale`**: React bağlamında ayarlanan mevcut yerel ayar.
 - **`defaultLocale`**: Yapılandırmada tanımlanan birincil yerel ayar.
 - **`availableLocales`**: Yapılandırmada tanımlanan tüm kullanılabilir yerel ayarların listesi.

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

@@ -36,8 +36,6 @@ Bu bölüm, React uygulamalarında görsel düzenleyici olmadan yerelleştirilmi
 
 ## Sunucu Entegrasyonu
 
-`useDictionary` hook'unu `IntlayerProvider` dışında kullanıyorsanız, bileşeni işlerken yerel ayar açıkça parametre olarak sağlanmalıdır:
-
 ```tsx fileName="./ServerComponentExample.tsx" codeFormat={["typescript", "esm"]}
 import type { FC } from "react";
 import { useDictionary } from "react-intlayer/server";

package/docs/tr/packages/react-intlayer/useI18n.md

@@ -77,6 +77,34 @@ All dictionary keys must be declared within content declaration files to enhance
 
 Examples of using the `useI18n` hook within React components:
 
+<Tabs>
+ <Tab label='Intlayer >=9.4' value='>=9.4'>
+
+```tsx fileName="src/App.tsx" codeFormat={["typescript", "esm"]}
+import type { FC } from "react";
+import { ClientComponentExample, ServerComponentExample } from "@components";
+import { IntlayerProvider } from "react-intlayer";
+import { useI18n } from "react-intlayer/server";
+import { Locales } from "intlayer";
+
+const App: FC<{ locale: Locales }> = ({ locale }) => {
+  const t = useI18n("home-page", locale);
+
+  return (
+    <>
+      <p>{t("introduction")}</p>
+      <IntlayerProvider locale={locale}>
+        <ClientComponentExample />
+      </IntlayerProvider>
+      <ServerComponentExample />
+    </>
+  );
+};
+```
+
+ </Tab>
+ <Tab label='Intlayer <9.4' value='<9.4'>
+
 ```tsx fileName="src/App.tsx" codeFormat={["typescript", "esm"]}
 import type { FC } from "react";
 import { ClientComponentExample, ServerComponentExample } from "@components";
@@ -101,6 +129,9 @@ const App: FC<{ locale: Locales }> = ({ locale }) => {
 };
 ```
 
+</Tab>
+</Tabs>
+
 ```tsx fileName="src/components/ComponentExample.tsx" codeFormat={["typescript", "esm"]}
 import type { FC } from "react";
 import { useI18n } from "react-intlayer";