@intlayer/docs 8.12.5-canary.0 → 9.0.0-canary.10

package/docs/tr/cli/doc-review.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-11
-updatedAt: 2025-11-22
+updatedAt: 2026-06-17
 title: Doküman İncelemesi
 description: Farklı yerellerdeki dokümantasyon dosyalarını kalite, tutarlılık ve tamlık açısından nasıl inceleyeceğinizi öğrenin.
 keywords:
@@ -15,6 +15,10 @@ slugs:
   - concept
   - cli
   - doc-review
+history:
+  - version: 9.0.0
+    date: 2026-06-17
+    changes: "--log seçeneği eklendi"
 author: aymericzip
 ---
 
@@ -55,8 +59,110 @@ Zaten çevrilmiş dosyaları incelemek ve çevirinin doğru olup olmadığını
 
 ## Argümanlar:
 
-`doc review` komutu, belirli dokümantasyon dosyalarını incelemenize ve kalite kontrolleri uygulamanıza olanak tanıyan `doc translate` ile aynı argümanları kabul eder.
+**Dosya listesi seçenekleri:**
 
-Eğer git seçeneklerinden birini etkinleştirdiyseniz, komut yalnızca değişen dosya kısımlarını inceleyecektir. Betik, dosyayı parçalara ayırarak işleyecek ve her parçayı inceleyecektir. Parçada değişiklik yoksa, betik inceleme sürecini hızlandırmak ve AI Sağlayıcı API maliyetini sınırlamak için o kısmı atlayacaktır.
+- **`--doc-pattern [docPattern...]`**: İncelemek için dokümantasyon dosyalarını eşleştirmek üzere glob desenleri.
 
-Tam argüman listesi için, bkz. [Translate Document](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/cli/doc-translate.md) komut dokümantasyonu.
+  > Örnek: `npx intlayer doc review --doc-pattern "docs/**/*.md" "src/**/*.mdx"`
+
+- **`--excluded-glob-pattern [excludedGlobPattern...]`**: İncelemeden hariç tutulacak dosyaları eşleştirmek için glob desenleri.
+
+  > Örnek: `npx intlayer doc review --excluded-glob-pattern "docs/internal/**"`
+
+- **`--skip-if-modified-before [skipIfModifiedBefore]`**: Dosya belirtilen zamandan önce değiştirilmişse atla.
+  - Mutlak bir zaman olabilir, örneğin "2025-12-05" (string veya Date)
+  - Göreceli bir zaman olabilir, ms cinsinden `1 * 60 * 60 * 1000` (1 saat)
+  - Bu seçenek, dosyanın güncelleme zamanını `fs.stat` yöntemi ile kontrol eder. Bu nedenle, dosyayı değiştiren Git veya diğer araçlardan etkilenebilir.
+
+  > Örnek: `npx intlayer doc review --skip-if-modified-before "2025-12-05"`
+
+- **`--skip-if-modified-after [skipIfModifiedAfter]`**: Dosya belirtilen zaman içinde değiştirilmişse atla.
+  - Mutlak bir zaman olabilir, örneğin "2025-12-05" (string veya Date)
+  - Göreceli bir zaman olabilir, ms cinsinden `1 * 60 * 60 * 1000` (1 saat)
+  - Bu seçenek, dosyanın güncelleme zamanını `fs.stat` yöntemi ile kontrol eder. Bu nedenle, dosyayı değiştiren Git veya diğer araçlardan etkilenebilir.
+
+  > Örnek: `npx intlayer doc review --skip-if-modified-after "2025-12-05"`
+
+- **`--skip-if-exists`**: Dosya zaten varsa atla.
+
+  > Örnek: `npx intlayer doc review --skip-if-exists`
+
+**İnceleme modu seçenekleri:**
+
+- **`--log`**: Yalnızca günlükleme modu. AI ile çeviri yapmaz; bunun yerine başka bir temsilcinin çevirileri oluşturmasına yardımcı olmak için temel ve hedef yerel ayarlar için dikkat gerektiren blokları (satır numaraları ve içerikleriyle birlikte) günlüğe kaydeder.
+
+  > Örnek: `npx intlayer doc review --log`
+
+**Girdi çıktı seçenekleri:**
+
+- **`--locales [locales...]`**: Dokümantasyonun inceleneceği hedef diller.
+
+  > Örnek: `npx intlayer doc review --locales fr es de`
+
+- **`--base-locale [baseLocale]`**: Karşılaştırılacak kaynak dil (temel belge).
+
+  > Örnek: `npx intlayer doc review --base-locale en`
+
+**Dosya işleme seçenekleri:**
+
+- **`--nb-simultaneous-file-processed [nbSimultaneousFileProcessed]`**: İnceleme için eşzamanlı işlenecek dosya sayısı.
+
+  > Örnek: `npx intlayer doc review --nb-simultaneous-file-processed 5`
+
+**Yapay Zeka seçenekleri:**
+
+- **`--model [model]`**: İnceleme için kullanılacak yapay zeka modeli (örneğin, `gpt-3.5-turbo`).
+- **`--provider [provider]`**: İnceleme için kullanılacak yapay zeka sağlayıcısı.
+- **`--temperature [temperature]`**: Yapay zeka modeli için sıcaklık ayarı.
+- **`--api-key [apiKey]`**: Yapay zeka servisi için kendi API anahtarınızı sağlayın.
+- **`--application-context [applicationContext]`**: Yapay zeka incelemesi için ek bağlam sağlayın.
+- **`--data-serialization [dataSerialization]`**: Intlayer'ın AI özellikleri için kullanılacak veri serileştirme formatı. Seçenekler: `json` (standart, güvenilir), `toon` (daha az jeton, daha az tutarlı).
+- **`--custom-prompt [prompt]`**: İnceleme için kullanılan temel promptu özelleştirin. (Not: Çoğu durum için, davranış üzerinde daha iyi kontrol sağladığı için `--custom-instructions` seçeneği önerilir.)
+
+  > Örnek: `npx intlayer doc review --model deepseek-chat --provider deepseek --temperature 0.5 --api-key sk-1234567890 --application-context "My application is a cat store"`
+
+**Ortam değişkenleri seçenekleri:**
+
+- **`--env`**: Ortamı belirtin (örneğin, `development`, `production`).
+- **`--env-file [envFile]`**: Değişkenleri yüklemek için özel bir ortam dosyası sağlayın.
+- **`--base-dir`**: Proje için temel dizini belirtin.
+- **`--no-cache`**: Önbelleği devre dışı bırakın.
+
+  > Örnek: `npx intlayer doc review --base-dir ./docs --env-file .env.production.local`
+
+**Günlük seçenekleri:**
+
+- **`--verbose`**: Hata ayıklama için ayrıntılı günlüklemeyi etkinleştirir. (CLI kullanıldığında varsayılan olarak true)
+
+  > Örnek: `npx intlayer doc review --verbose`
+
+**Özel talimatlar seçenekleri:**
+
+- **`--custom-instructions [customInstructions]`**: Prompt'a eklenen özel talimatlar. Biçimlendirme, URL çevirisi vb. konularda belirli kurallar uygulamak için kullanışlıdır.
+
+  > Örnek: `npx intlayer doc review --custom-instructions "URL çevirilerini yapmaktan kaçının ve markdown formatını koruyun"`
+
+  > Örnek: `npx intlayer doc review --custom-instructions "$(cat ./instructions.md)"`
+
+**Git seçenekleri:**
+
+- **`--git-diff`**: Sadece temel (varsayılan `origin/main`) ile mevcut dal (varsayılan: `HEAD`) arasındaki değişiklikleri içeren dosyalarda çalıştırır.
+- **`--git-diff-base`**: git diff için temel referansı belirtir (varsayılan `origin/main`).
+- **`--git-diff-current`**: git diff için mevcut referansı belirtir (varsayılan `HEAD`).
+- **`--uncommitted`**: İşlenmemiş değişiklikleri dahil eder.
+- **`--unpushed`**: Gönderilmemiş değişiklikleri dahil eder.
+- **`--untracked`**: İzlenmeyen dosyaları dahil eder.
+
+  > Örnek: `npx intlayer doc review --git-diff --git-diff-base origin/main --git-diff-current HEAD`
+
+  > Örnek: `npx intlayer doc review --uncommitted --unpushed --untracked`
+
+> Çıktı dosya yolunun aşağıdaki kalıplar değiştirilerek belirleneceğini unutmayın:
+>
+> - `/{{baseLocale}}/` yerine `/{{locale}}/` (Unix)
+> - `\{{baseLocale}}\` yerine `\{{locale}}\` (Windows)
+> - `_{{baseLocale}}.` yerine `_{{locale}}.`
+> - `{{baseLocale}}_` yerine `{{locale}}_`
+> - `.{{baseLocaleName}}.` yerine `.{{localeName}}.`
+>
+> Eğer kalıp bulunamazsa, çıktı dosyasının uzantısına `.{{locale}}` eklenecektir. Örneğin `./my/file.md` dosyası incelenecek ve Fransızca için `./my/file.fr.md` olarak güncellenecektir.

package/docs/tr/cli/fill.md

@@ -47,6 +47,14 @@ Bu komut, içerik bildirim dosyalarınızı eksik çeviriler, yapısal tutarsız
 - Mevcut çevirileri üzerine yazmayarak korur.
 - Hızı artırmak için bir kuyruk sistemi kullanarak dosyaları, parçaları ve yerel ayarları paralel olarak işler.
 
+## Ana Noktalar:
+
+- Büyük JSON dosyalarını AI modelinin context window limitine uymak için parçalara böler.
+- Çıktı formatı yanlışsa çeviriye yeniden dener.
+- Çeviri doğruluğunu artırmak için uygulamaya ve dosyaya özgü context'i içerir.
+- Mevcut çevirileri korur ve bunların üzerine yazılmasını engeller.
+- Dosyaları, parçaları ve locale'leri bir kuyruk sistemi kullanarak paralel olarak işler hız artışı için.
+
 ## Takma İsimler:
 
 - `npx intlayer dictionaries fill`

package/docs/tr/cli/index.md

@@ -17,7 +17,7 @@ slugs:
   - concept
   - cli
 history:
-  - version: 8.13.0
+  - version: 9.0.0
     date: 2026-06-11
     changes: "Scan komutu eklendi"
   - version: 8.6.4

package/docs/tr/cli/login.md

@@ -200,16 +200,6 @@ Bağlantı sorunlarıyla karşılaşırsanız, şunları doğrulayın:
 
 Kimlik bilgileri alınmadıysa:
 
-1. Tarayıcıda kimlik doğrulama işlemini tamamladığınızdan emin olun
-2. Yerel portun engellenmediğini doğrulayın
-3. Komutu tekrar deneyin
-4. İnternet bağlantınızın düzgün çalıştığından emin olun
-5. Bağlantıyı engelleyen herhangi bir güvenlik duvarı olmadığından emin olun
-
-### Kimlik Bilgileri Alınmadı
-
-Kimlik bilgileri alınmadıysa:
-
 1. Tarayıcıda kimlik doğrulama sürecini tamamladığınızdan emin olun
 2. Yerel portun engellenmediğini doğrulayın
 3. Komutu tekrar deneyin

package/docs/tr/cli/scan.md

@@ -18,7 +18,7 @@ slugs:
   - cli
   - scan
 history:
-  - version: 8.13.0
+  - version: 9.0.0
     date: 2026-06-11
     changes: "Scan komutu eklendi"
 author: aymericzip

package/docs/tr/compat/i18n-js.md

@@ -0,0 +1,44 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: "i18n-js'den Intlayer'a Geçiş Yapın"
+description: "Uyumluluk adaptörünü kullanarak uygulamanızı i18n-js'den Intlayer'a nasıl geçireceğinizi öğrenin."
+keywords:
+  - i18n-js
+  - intlayer
+  - göç
+  - uyumluluk
+slugs:
+  - doc
+  - compatibility
+  - i18n-js
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "Init history"
+author: aymericzip
+---
+
+# i18n-js'den Intlayer'a Geçiş Yapın
+
+`i18n-js` kütüphanesinden Intlayer'a geçiş, büyük çeviri konfigürasyonlarını Intlayer'ın yapılandırılmış dosya çözümleme sistemine aktarmak için tasarlanmış, yüksek derecede optimize edilmiş bir göçtür.
+
+## Ne yapmalı
+
+Deponuzda aşağıdaki kurulum komutunu yürütün:
+
+```bash
+npx intlayer init
+```
+
+`intlayer.config.ts` hazırlandığında, bundler konfigürasyonunuza Intlayer'ın takma adını ekleyebilirsiniz, böylece `i18n-js` importlarının herhangi biri uyumluluk paketi `@intlayer/i18n-js`'yi hedefleyebilir.
+
+## Arka Planda Neler Olur
+
+`i18n-js`, `i18n.t('scope.key', {name})` gibi ifadelerle ad alanlarına erişir ve yerel geri dönüş mekanizmaları ile belirli çoğul eşlemelerine sahiptir.
+
+Arka Planda:
+
+- **Interpolasyon:** Uyumluluk adaptörü, `%{name}` eşlemelerini hedeflenen runtime sözlük değerine kolayca ayrıştırır.
+- **Çoğullaştırma:** `one/other` alt anahtarlarının yerini alır ve Intlayer'ın güçlü alttaki çoğul mekanizmalarına karşı (`Intl.PluralRules`) eşler, manuel eşlemeleri ortadan kaldırır.
+- **Yerel Ayarlar:** Monolitik dil yüklerini önyüklemede yüklemek yerine, sözlükler mevcut bağlam kurulumuna dayalı olarak optimize bir şekilde sunulur, yerel Intlayer yapılandırmasıyla birlikte çalışır.

package/docs/tr/compat/i18next.md

@@ -0,0 +1,59 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: "i18next'ten Intlayer'a Geçiş Yapın"
+description: "Uyumluluk adaptörünü kullanarak Vanilla JS/TS uygulamanızı i18next'ten Intlayer'a nasıl geçireceğinizi öğrenin."
+keywords:
+  - i18next
+  - vanilla
+  - javascript
+  - typescript
+  - intlayer
+  - göç
+  - uyumluluk
+slugs:
+  - doc
+  - compatibility
+  - i18next
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "Init history"
+author: aymericzip
+---
+
+# i18next'ten Intlayer'a Geçiş Yapın
+
+Ayrıntılı adım adım eğitim için lütfen tam [i18next Göç Kılavuzuna](../migration_from_i18next_to_intlayer.md) bakın.
+
+Intlayer mükemmel şekilde `i18next`'in core runtime özelliklerini çoğaltır. Uyumluluk paketini kullanarak, Vanilla uygulamalarınız veya iç modülleriniz tanıdık sözdizimini kullanmaya devam edebilir.
+
+## Ne yapmalı
+
+Başlamak için projede Intlayer'ı başlatın:
+
+```bash
+npx intlayer init
+```
+
+Vite kullanıyorsanız, `@intlayer/i18next` importlarını yönlendirmek için Intlayer plugin'ini ekleyin:
+
+```typescript fileName="vite.config.ts"
+import { defineConfig } from "vite";
+import { i18nextVitePlugin } from "@intlayer/i18next/plugin";
+
+export default defineConfig({
+  plugins: [i18nextVitePlugin()],
+});
+```
+
+## Arka Planda Neler Olur
+
+`i18nextVitePlugin`, `i18next` importlarını `@intlayer/i18next`'e takma ad olarak atamakta, JSON dosya içeriklerinden bundle şişmesini ortadan kaldırmaktadır.
+
+Arka Planda:
+
+- **Instance konfigürasyonu:** `createInstance` ad alanı fallback'lerini doğru ayrıştırmakta ve uygularken Intlayer'ın compilation pipeline'ını sözlük alınması için kullanmaktadır.
+- **Interpolasyon:** `{{name}}` değişim ve `$t(key)` nesting'i özyinelemeli olarak destekler.
+- **Bağlam & Çoğullar:** `key_male` ve `key_one`/`key_other` gibi sonek biçimlerini tanımlar ve standart `Intl.PluralRules` aracılığıyla değerlendirir.
+- **Return Nesneleri:** `returnObjects: true` modu güvenli şekilde Intlayer sözlüklerinden ağaçları ayıklar.

package/docs/tr/compat/index.md

@@ -0,0 +1,51 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: "Intlayer Uyumluluk Adaptörleri"
+description: "Mevcut i18n çözümünüzü sıfır zorlukla Intlayer'a geçirin uyumluluk adaptörleri kullanarak."
+keywords:
+  - uyumluluk
+  - göç
+  - uluslararasılaştırma
+  - i18n
+  - Intlayer
+slugs:
+  - doc
+  - compatibility
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "Init history"
+author: aymericzip
+---
+
+# Intlayer Uyumluluk Adaptörleri
+
+Büyük bir uygulamayı yeni bir uluslararasılaştırma kütüphanesine geçirmek sinir bozucu olabilir. Bu geçişi kolaylaştırmak için Intlayer, ekosistemde en popüler i18n kütüphaneleri için **uyumluluk adaptörleri** sağlar.
+
+Bu adapter paketleri, mevcut i18n kütüphanelerinizle **tamamen aynı genel API'yi** ortaya koymakla birlikte, çalışma zamanında tüm çeviri işini Intlayer'a devredederler.
+
+## Nasıl çalışır
+
+Bir uyumluluk adaptörü kullandığınızda, uygulamanızın importlarını yeniden yazmanız veya çeviri hook'larınızı ve bileşenlerinizi nasıl kullandığınızı değiştirmenize gerek yoktur. Bunun yerine, Intlayer'ın bundler plugin'leri mevcut importlarınızı otomatik olarak Intlayer uyumluluk paketlerine takma ad olarak atarlar.
+
+Örneğin, bir geliştirici `import { useTranslation } from 'react-i18next'` yerine `import { useTranslation } from '@intlayer/react-i18next'` kullanır (bundler plugin'i tarafından otomatik olarak yapılır) ve uygulama Intlayer sözlüklerinden sunulan çevirilerle çalışmaya devam eder. Anahtarlar ayrıca Intlayer sözlüklerinizle yazılı kontrol edilir\!
+
+## Kullanılabilir Uyumluluk Adaptörleri
+
+Mevcut kütüphanenizi seçin ve sorunsuzca nasıl geçiş yapacağınızı öğrenin:
+
+- [Vue I18n](./vue-i18n.md)
+- [Transloco](./transloco.md)
+- [React Intl](./react-intl.md)
+- [Svelte I18n](./svelte-i18n.md)
+- [React i18next](./react-i18next.md)
+- [Polyglot.js](./polyglot.md)
+- [NuxtJS I18n](./nuxtjs-i18n.md)
+- [NGX Translate](./ngx-translate.md)
+- [Next Translate](./next-translate.md)
+- [Next Intl](./next-intl.md)
+- [Next i18next](./next-i18next.md)
+- [i18next](./i18next.md)
+- [Lingui](./lingui.md)
+- [I18n-js](./i18n-js.md)

package/docs/tr/compat/lingui.md

@@ -0,0 +1,44 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: "Lingui'den Intlayer'a Geçiş Yapın"
+description: "Uyumluluk adaptörünü kullanarak uygulamanızı Lingui'den Intlayer'a nasıl geçireceğinizi öğrenin."
+keywords:
+  - lingui
+  - intlayer
+  - göç
+  - uyumluluk
+slugs:
+  - doc
+  - compatibility
+  - lingui
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "Init history"
+author: aymericzip
+---
+
+# Lingui'den Intlayer'a Geçiş Yapın
+
+Projeniz şu anda Lingui'nin macro tabanlı derlemesine dayanıyorsa, Intlayer'a geçiş güçlü macro workflow'larınızı korurken onları doğal olarak Intlayer'ın JSON compilation stratejisiyle desteklemenize izin verir.
+
+## Ne yapmalı
+
+Başlamak için projede Intlayer'ı başlatın:
+
+```bash
+npx intlayer init
+```
+
+Bu `intlayer.config.ts` oluşturur. `@lingui/babel-plugin-lingui-macro` / `@lingui/swc-plugin`'yi build adımınızda Intlayer compiler'ından _önce_ çalıştırmak için tutun. Ardından bundler plugin takma adını `@lingui/core` ve `@lingui/react`'i `@intlayer/lingui`'ye yönlendirmek için kullanın.
+
+## Arka Planda Neler Olur
+
+Lingui macro'ları kullanır (`` t`Hello ${name}` `` ve `<Trans>` gibi) `i18n._(id, values)` gibi runtime çağrılarına derlenir.
+
+Arka Planda:
+
+- **Macro'lar:** Kaynak sözdiziminde hiçbir kesinti olmadan tamamen daha önce yaptığı gibi derlenir.
+- **Runtime Çeviri:** Takma ad atanan `i18n._()` Intlayer sözlüklerini kullanır. Hem açıkça adlandırılan ID'ler hem de karma hash ID'ler Intlayer'ın `.po` sync plugin'lerini kullanarak anahtarları güvenli şekilde toplamak ve budamak için tamamen eşlenir.
+- **ICU Yetenekleri:** Çoğullaştırma, seçim ve ICU varyantları desteği, Intlayer'ın birleştirilmiş ICU ayrıştırıcısı sayesinde güçlü kalır, aynı render çıktılarını sağlar.

package/docs/tr/compat/next-i18next.md

@@ -0,0 +1,57 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: "next-i18next'ten Intlayer'a Geçiş Yapın"
+description: "Uyumluluk adaptörünü kullanarak Next.js uygulamanızı next-i18next'ten Intlayer'a nasıl geçireceğinizi öğrenin."
+keywords:
+  - next-i18next
+  - nextjs
+  - intlayer
+  - göç
+  - uyumluluk
+slugs:
+  - doc
+  - compatibility
+  - next-i18next
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "Init history"
+author: aymericzip
+---
+
+# next-i18next'ten Intlayer'a Geçiş Yapın
+
+Kapsamlı ve ayrıntılı adım adım eğitim için lütfen tam [next-i18next Göç Kılavuzuna](../migration_from_next-i18next_to_intlayer.md) bakın.
+
+Intlayer, Next.js Pages Router ve App Router uygulamalarını saydam şekilde işler. Adaptörü kullanmak, `next-i18next` uygulamanızı sıfır kod yeniden yazımı olmadan göç etmenize izin verir.
+
+## Ne yapmalı
+
+Başlamak için şunu çalıştırın:
+
+```bash
+npx intlayer init
+```
+
+Bu, gerekli Intlayer setup dosyasını oluşturur. Arka Planda Intlayer'a geçmek için `next.config.ts` dosyasını güncelleyin:
+
+```typescript fileName="next.config.ts"
+import type { NextConfig } from "next";
+import { createNextI18nPlugin } from "@intlayer/next-i18next/plugin";
+
+const withIntlayer = createNextI18nPlugin();
+
+const nextConfig: NextConfig = {};
+
+export default withIntlayer(nextConfig);
+```
+
+## Arka Planda Neler Olur
+
+`createNextI18nPlugin`, Next.js'nin yerel davranışını core `next-intlayer` plugin'iyle birlikte oluşturmakta, `next-i18next`, `react-i18next` ve `i18next` için tüm gerekli Webpack/Turbopack takma adlarını enjekte etmektedir.
+
+Arka Planda:
+
+- **`serverSideTranslations` & `appWithTranslation`:** Artık Intlayer'ın iç yükleyicileri için wrapper'lar olarak işlev gördüğünden, büyük statik JSON enjeksiyonunu ortadan kaldırır.
+- **Client Hook'ları:** Tüm biçimlendirme, çoğullaştırma ve iç içe ad alanı özelliklerini koruyarak `@intlayer/react-i18next`'e hemen delege eder.

package/docs/tr/compat/next-intl.md

@@ -0,0 +1,59 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: "next-intl'den Intlayer'a Geçiş Yapın"
+description: "Uyumluluk adaptörünü kullanarak Next.js uygulamanızı next-intl'den Intlayer'a nasıl geçireceğinizi öğrenin."
+keywords:
+  - next-intl
+  - nextjs
+  - intlayer
+  - göç
+  - uyumluluk
+slugs:
+  - doc
+  - compatibility
+  - next-intl
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "Init history"
+author: aymericzip
+---
+
+# next-intl'den Intlayer'a Geçiş Yapın
+
+Kapsamlı ve ayrıntılı adım adım eğitim için lütfen tam [next-intl Göç Kılavuzuna](../migration_from_next-intl_to_intlayer.md) bakın.
+
+`next-intl`'den Intlayer'a geçiş, uygulama routing'inizi ve sözdizimini tamamen etkilemeden tutmanıza izin verir.
+
+## Ne yapmalı
+
+Deponuzda aşağıdaki komutu yürütün:
+
+```bash
+npx intlayer init
+```
+
+Bu, bir `intlayer.config.ts` oluşturacaktır. `next.config.ts` dosyasında, plugin wrapper'ını kullanarak `next-intl` takma adlarını `@intlayer/next-intl`'ye sorunsuzca enjekte edin.
+
+```typescript fileName="next.config.ts"
+import type { NextConfig } from "next";
+import { createNextIntlPlugin } from "@intlayer/next-intl/plugin";
+
+const withIntlayer = createNextIntlPlugin();
+
+const nextConfig: NextConfig = {};
+
+export default withIntlayer(nextConfig);
+```
+
+## Arka Planda Neler Olur
+
+Bundler wrapper çevirileri değiştirir, ancak **`next-intl/navigation` özelliklerini olduğu gibi bırakır** (örneğin `Link`, `redirect`, `usePathname`).
+
+Arka Planda:
+
+- **ICU runtime:** Çoğullar (`=0`, `one`, `other`), select/selectordinal, `#` argümanları ve biçimlendirilmiş argümanlar (`{ts, date, long}`) paylaşılan `resolveMessage(..., 'icu')` çözümleyicisini kullanarak doğru şekilde çalışır.
+- **`useTranslations()` & `getTranslations()`:** Bare scope çağrıları ilk anahtar segmentini doğru sözlük tanımlayıcısı olarak ayıklar. İç içe ad alanları zarif bir şekilde sözlük yolları ve ön eklerine bölünür.
+- **Zengin Biçimlendirme:** Hem `t.rich()` hem de `t.markup()` tamamen doğal olarak uygulanmakta, HTML benzeri düğümleri render edilen React chunks'lerine dönüştürmektedir.
+- **`useFormatter`:** `relativeTime`, `list`, `dateTimeRange` ve yapılandırmadan adlı biçimler, core yerel `Intl` formatter'larına köprü atılmaktadır.

package/docs/tr/compat/next-translate.md

@@ -0,0 +1,45 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: "Next Translate'den Intlayer'a Geçiş Yapın"
+description: "Uyumluluk adaptörünü kullanarak Next.js uygulamanızı next-translate'den Intlayer'a nasıl geçireceğinizi öğrenin."
+keywords:
+  - next-translate
+  - nextjs
+  - intlayer
+  - göç
+  - uyumluluk
+slugs:
+  - doc
+  - compatibility
+  - next-translate
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "Init history"
+author: aymericzip
+---
+
+# Next Translate'den Intlayer'a Geçiş Yapın
+
+`next-translate`'den Intlayer'a geçiş, mevcut sözdizimini ve etiketleri koruyan neredeyse drop-in bir değişikliktir.
+
+## Ne yapmalı
+
+Intlayer'ı projede başlatın:
+
+```bash
+npx intlayer init
+```
+
+CLI konfigürasyonunuzu oluşturacaktır. Daha sonra Intlayer plugin'ini `next.config.ts` dosyasına uygulayabilirsiniz, bu da `next-translate/useTranslation`'ı `@intlayer/next-translate`'ye eşleyen build zamanı alt yolu takma adlarını enjekte eder.
+
+## Arka Planda Neler Olur
+
+`next-translate`, `useTranslation('ns')`, `t('ns:key.path')` ve `<Trans>` bileşeni gibi hook'lar sağlar.
+
+Arka Planda:
+
+- **Interpolasyon & Çoğullar:** `react-i18next` adaptör davranışına yakından bağlıdır. Dinamik olarak işlenen `{{var}}` yer tutuşları ve `key_0`, `key_one` ve `key_other` gibi sonekleri eşlenen çoğullaştırma.
+- **`<Trans>` Bileşeni:** HTML benzeri tag ayrıştırması ve dizi tabanlı `components` prop'u için doğrudan desteklenir.
+- **Ad Alanları:** Alt yol takma adlandırması, `useTranslation` referanslarınızın manuel değişiklik olmadan doğru iç sözlük ad alanlarına başvurmasını sağlar.

package/docs/tr/compat/ngx-translate.md

@@ -0,0 +1,45 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: "NGX-Translate'den Intlayer'a Geçiş Yapın"
+description: "Uyumluluk adaptörünü kullanarak Angular uygulamanızı ngx-translate'den Intlayer'a nasıl geçireceğinizi öğrenin."
+keywords:
+  - ngx-translate
+  - angular
+  - intlayer
+  - göç
+  - uyumluluk
+slugs:
+  - doc
+  - compatibility
+  - ngx-translate
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "Init history"
+author: aymericzip
+---
+
+# NGX-Translate'den Intlayer'a Geçiş Yapın
+
+Angular uygulamanızı `ngx-translate`'den Intlayer'a geçirmek uyumluluk adaptörü sayesinde kolaydır, tüm template'lerinizi yeniden yazma ihtiyacını ortadan kaldırır.
+
+## Ne yapmalı
+
+Aşağıdaki komutu çalıştırarak başlayın:
+
+```bash
+npx intlayer init
+```
+
+Bu, `intlayer.config.ts` ayarını yapılandırır. `TranslateModule.forRoot()` kurulumlarını ve import takma adlarını `@intlayer/ngx-translate` işaret etmek için uygun şekilde değiştirin.
+
+## Arka Planda Neler Olur
+
+`ngx-translate`, `TranslateService` (`instant`, `get`, `stream`), `{{ 'KEY' | translate:params }}` pipe'ı ve `[translate]` direktifini kullanır.
+
+Arka Planda:
+
+- **Hizmetler:** `TranslateService`, `getIntlayer` ve locale observable'ı sarmalamakta, tamamen aynı yöntemleri sağlamaktadır.
+- **Pipe'lar & Direktifler:** Intlayer sözlüklerine karşı doğrudan çözüm için yeniden uygulanmıştır.
+- **Yükleyiciler:** `TranslateHttpLoader` kurulumları uyarı saplamalarına dönüştürülür, çünkü Intlayer doğası gereği çevirilerinizi build zamanında (veya standart dinamik importlar aracılığıyla) çözer ve bundle'lar, HTTP yükleyicilerine olan ihtiyacı tamamen ortadan kaldırır.

package/docs/tr/compat/nuxtjs-i18n.md

@@ -0,0 +1,46 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: "NuxtJS I18n'den Intlayer'a Geçiş Yapın"
+description: "Uyumluluk adaptörünü kullanarak Nuxt.js uygulamanızı @nuxtjs/i18n'den Intlayer'a nasıl geçireceğinizi öğrenin."
+keywords:
+  - nuxtjs-i18n
+  - nuxt
+  - vue
+  - intlayer
+  - göç
+  - uyumluluk
+slugs:
+  - doc
+  - compatibility
+  - nuxtjs-i18n
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "Init history"
+author: aymericzip
+---
+
+# NuxtJS I18n'den Intlayer'a Geçiş Yapın
+
+Nuxt uygulamanızı `@nuxtjs/i18n`'den Intlayer'a geçirmek Nuxt adapter modülü kullanılarak sorunsuz bir işlemdir.
+
+## Ne yapmalı
+
+Projeyi başlatmak için şunu çalıştırın:
+
+```bash
+npx intlayer init
+```
+
+Bu `intlayer.config.ts` ayarını yapılandıracaktır. Ardından Intlayer Nuxt modülünü (örneğin `@intlayer/nuxt-i18n`) `nuxt.config.ts` modules dizisine ekleyin. Bu uygulamanız için uyumluluk konfigürasyonunu otomatik olarak uygular.
+
+## Arka Planda Neler Olur
+
+`@nuxtjs/i18n`, `vue-i18n`'i sarmalamakta, Nuxt'a özgü routing composable'ları (`useLocalePath`, `useSwitchLocalePath`, `<NuxtLinkLocale>`) sağlamaktadır.
+
+Arka Planda:
+
+- **Çeviriler:** Tüm string çeviri görevleri için doğal olarak `@intlayer/vue-i18n` uyumluluk katmanına bağlıdır (`vue-i18n` biçimlerini, pipe çoğullarını ve reaktiviteyi tam olarak desteklemektedir).
+- **Routing:** Intlayer'ın yerelleştirilmiş URL yardımcılarını kullanarak routing composable'larını yansıtır.
+- **Konfigürasyon:** `availableLocales` ve varsayılan ayarları doğrudan `intlayer.config.ts` dosyasından okuyarak Nuxt sayfalarını otomatik olarak koordine eder.