@intlayer/docs 9.4.1 → 9.4.3

package/docs/tr/bundle_optimization.md

@@ -43,139 +43,6 @@ JSON dosyalarına dayanan geleneksel i18n çözümlerinde en yaygın zorluklarda
 
 <TOC />
 
-## Paketinizi analiz edin
-
-Paketinizi analiz etmek, "ağır" JSON dosyalarını ve kod bölme (code-splitting) fırsatlarını belirlemede atılacak ilk adımdır. Bu araçlar, uygulamanızın derlenmiş (compiled) kodunun görsel bir treemap'ini oluşturarak tam olarak hangi kütüphanelerin en çok yer kapladığını görmenize olanak tanır.
-
-<Tabs>
- <Tab value="vite">
-
-### Vite / Rollup
-
-Vite, arka planda Rollup kullanır. `rollup-plugin-visualizer` eklentisi, grafiğinizdeki her modülün boyutunu gösteren etkileşimli bir HTML dosyası üretir.
-
-```bash
-npm install -D rollup-plugin-visualizer
-```
-
-```typescript fileName="vite.config.ts"
-import { defineConfig } from "vite";
-import { visualizer } from "rollup-plugin-visualizer";
-
-export default defineConfig({
-  plugins: [
-    visualizer({
-      open: true, // Raporu otomatik olarak tarayıcınızda açar
-      filename: "stats.html",
-      gzipSize: true,
-      brotliSize: true,
-    }),
-  ],
-});
-```
-
- </Tab>
- <Tab value="nextjs (turbopack)">
-
-### Next.js (Turbopack)
-
-App Router ve Turbopack kullanan projelerde, Next.js ekstra bir bağımlılığa ihtiyaç duymayan yerleşik, deneysel bir analizör sağlar.
-
-```bash packageManager='npm'
-npx next experimental-analyze
-```
-
-```bash packageManager='yarn'
-yarn next experimental-analyze
-```
-
-```bash packageManager='pnpm'
-pnpm next experimental-analyze
-```
-
-```bash packageManager='bun'
-bun next experimental-analyze
-```
-
- </Tab>
- <Tab value="nextjs (Webpack)">
-
-### Next.js (Webpack)
-
-Next.js'de varsayılan Webpack paketleyiciyi kullanıyorsanız, resmi bundle analyzer'ı kullanın. Bunu derleme (build) sırasında bir ortam değişkeni ayarlayarak tetikleyebilirsiniz.
-
-```bash packageManager='npm'
-npm install -D @next/bundle-analyzer
-```
-
-```bash packageManager='yarn'
-yarn add -D @next/bundle-analyzer
-```
-
-```bash packageManager='pnpm'
-pnpm add -D @next/bundle-analyzer
-```
-
-```bash packageManager='bun'
-bun add -d @next/bundle-analyzer
-```
-
-```javascript fileName="next.config.js"
-const withBundleAnalyzer = require("@next/bundle-analyzer")({
-  enabled: process.env.ANALYZE === "true",
-});
-
-module.exports = withBundleAnalyzer({
-  // Next.js yapılandırmanız
-});
-```
-
-**Kullanımı:**
-
-```bash
-ANALYZE=true npm run build
-```
-
- </Tab>
- <Tab value="Webpack (CRA / Angular / etc)">
-
-### Standart Webpack
-
-Create React App (ejected), Angular veya özel Webpack yapılandırmaları için endüstri standardı olan `webpack-bundle-analyzer`ı kullanın.
-
-```bash packageManager='npm'
-npm install -D webpack-bundle-analyzer
-```
-
-```bash packageManager='yarn'
-yarn add -D webpack-bundle-analyzer
-```
-
-```bash packageManager='pnpm'
-pnpm add -D webpack-bundle-analyzer
-```
-
-```bash packageManager='bun'
-bun add -d webpack-bundle-analyzer
-```
-
-```typescript fileName="webpack.config.ts"
-import { BundleAnalyzerPlugin } from "webpack-bundle-analyzer";
-
-export default {
-  plugins: [
-    new BundleAnalyzerPlugin({
-      analyzerMode: "static",
-      reportFilename: "bundle-analyzer.html",
-      openAnalyzer: false,
-    }),
-  ],
-};
-```
-
- </Tab>
-</Tabs>
-
 ## Nasıl Çalışır
 
 Intlayer, **bileşen başına bir yaklaşım** kullanır. Global JSON dosyalarının aksine, içeriğiniz bileşenlerinizin yanında veya içinde tanımlanır. Derleme işlemi sırasında Intlayer şunları gerçekleştirir:
@@ -189,59 +56,6 @@ Bu şu anlamlara gelir:
 - Bir bileşen (component) import edilmezse, içeriği de pakete (bundle) dahil edilmez (Dead Code Elimination).
 - Bir bileşen lazy-loaded (tembel yükleme) ile çağrılırsa, içeriği de lazy-loaded olur.
 
-## Eklenti (Plugin) Referansı
-
-Intlayer'ın derleme optimizasyonu, her birinin tek bir sorumluluğu olduğu birkaç ayrı eklentiye bölünmüştür. Her birinin ne işe yaradığını anlamak yapılandırma sırasında karışıklığı önler.
-
-### Babel eklentileri (`@intlayer/babel`)
-
-Bunlar doğrudan Webpack tabanlı yapılandırmalarda (Babel ile kullanılan Next.js, CRA, özel Webpack vb.) `babel.config.js` içinde kullanılır.
-
-Aşağıdaki tablo bunları gerekli pipeline sırasına göre listeler (`babel.config.js` içinde görünmeleri gereken sırayla aynı):
-
-| Eklenti                       | Ne yapar                                                                                                                                  |
-| :---------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------- |
-| `intlayerExtractBabelPlugin`  | `.content.ts` dosyalarını tarayarak derlenmiş sözlükleri `.intlayer/` altına yazar                                                        |
-| `intlayerPurgeBabelPlugin`    | Tüm kaynak dosyaları tarar, derlenmiş `.intlayer/**/*.json` sözlük dosyalarından **kullanılmayan içerik alanlarını** temizler             |
-| `intlayerMinifyBabelPlugin`   | JSON dosyalarındaki ve kaynak koddaki **içerik alanı anahtarlarını kısa alfabetik isimlere (alias)** (`title` → `a`) dönüştürür           |
-| `intlayerOptimizeBabelPlugin` | `useIntlayer('key')` çağrısını `useDictionary(hash)` olarak yeniden yazar ve ilgili sözlük için eşleşen bir `import` ifadesi enjekte eder |
-
-> **Eklenti sırası önemlidir.** `babel.config.js` dosyanızda purge ve minify eklentileri optimize eklentisinden **önce** gelmelidir. Optimize aşaması `useIntlayer('key')` öğesini belirsiz bir `useDictionary(hash)` çağrısı ile değiştirdiğinden, purge ve minify işlemlerinin hangi alanların kullanıldığını tespit edebilmesi için gerekli olan sözlük anahtar bilgisi kaybolur.
-
-Her Babel eklentisi, yapılandırma yüklenme zamanında `intlayer.config.ts`'yi bir kez okuyan ve önceden çözümlenmiş değerler döndüren, kendisine eşlik eden bir opsiyon yardımcısı (options helper) içerir:
-
-| Opsiyon yardımcısı           | Birlikte kullanıldığı eklenti |
-| :--------------------------- | :---------------------------- |
-| `getExtractPluginOptions()`  | `intlayerExtractBabelPlugin`  |
-| `getPurgePluginOptions()`    | `intlayerPurgeBabelPlugin`    |
-| `getMinifyPluginOptions()`   | `intlayerMinifyBabelPlugin`   |
-| `getOptimizePluginOptions()` | `intlayerOptimizeBabelPlugin` |
-
-### Vite eklentileri (`vite-intlayer`)
-
-Vite kullanıcıları **bunları asla doğrudan yapılandırmaz**. Bunlar `vite.config.ts` içinde `withIntlayer()` fonksiyonu çağrıldığında otomatik olarak bağlanır. `intlayer.config.ts` içindeki `build.purge` ve `build.minify` bayrakları, ek bir eklenti kaydına (registration) gerek kalmadan karşılık gelen davranışı etkinleştirip kapatır.
-
-| Dahili Vite eklentisi | Eşdeğer davranışı                                                                                |
-| :-------------------- | :----------------------------------------------------------------------------------------------- |
-| Usage analyzer        | `intlayerPurgeBabelPlugin` analizi ile aynı                                                      |
-| Dictionary prune      | `intlayerPurgeBabelPlugin` JSON yazma adımı ile aynı                                             |
-| Dictionary minify     | `intlayerMinifyBabelPlugin` JSON yazma adımı ile aynı                                            |
-| Babel transform       | `intlayerMinifyBabelPlugin` kaynak kod yeniden adlandırması + `intlayerOptimizeBabelPlugin` aynı |
-
-### SWC eklentisi (`@intlayer/swc`)
-
-Next.js kullanıcıları da **bunları asla doğrudan yapılandırmaz**. **v9.2.1**'den itibaren `next.config.ts` içindeki `withIntlayer()`, yalnızca `build.purge` ve `build.minify` bayraklarına dayanarak tüm pipeline'ı — purge, minify ve import yeniden yazımını — çalıştırır.
-
-İş ikiye bölünmüştür, çünkü bir SWC Wasm eklentisi her seferinde tek bir dosyayı dönüştürür ve dosya sistemine erişimi yoktur:
-
-| Geçiş                                               | Nerede çalışır                | Ne yapar                                                                                                                  |
-| :-------------------------------------------------- | :---------------------------- | :------------------------------------------------------------------------------------------------------------------------ |
-| Kullanım analizi + JSON purge/minify                | Node, `withIntlayer()` içinde | Her bileşen kaynak dosyasını okur, `.intlayer/**/*.json` dosyalarını yeniden yazar, yeniden adlandırma tablolarını üretir |
-| Kaynak kodu yeniden yazımı (`content.title` → `.a`) | `@intlayer/swc` (Wasm)        | Yeniden adlandırma tablolarını kodunuzdaki eşleşen özellik erişimlerine uygular                                           |
-| Import yeniden yazımı (`useIntlayer` → dict)        | `@intlayer/swc` (Wasm)        | `intlayerOptimizeBabelPlugin` ile aynı                                                                                    |
-
-_Hangi_ alanların kullanılmadığına ve her birinin _hangi_ takma adı alacağına karar vermek dosyalar arası durum ve dosya G/Ç gerektirir; bu nedenle bu yarısı Node'da çalışır ve SWC eklentisi yalnızca ortaya çıkan tabloları alır.
-
 ## Platforma Göre Kurulum
 
 <Tabs>
@@ -405,6 +219,59 @@ module.exports = {
  </Tab>
 </Tabs>
 
+## Eklenti (Plugin) Referansı
+
+Intlayer'ın derleme optimizasyonu, her birinin tek bir sorumluluğu olduğu birkaç ayrı eklentiye bölünmüştür. Her birinin ne işe yaradığını anlamak yapılandırma sırasında karışıklığı önler.
+
+### Babel eklentileri (`@intlayer/babel`)
+
+Bunlar doğrudan Webpack tabanlı yapılandırmalarda (Babel ile kullanılan Next.js, CRA, özel Webpack vb.) `babel.config.js` içinde kullanılır.
+
+Aşağıdaki tablo bunları gerekli pipeline sırasına göre listeler (`babel.config.js` içinde görünmeleri gereken sırayla aynı):
+
+| Eklenti                       | Ne yapar                                                                                                                                  |
+| :---------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------- |
+| `intlayerExtractBabelPlugin`  | `.content.ts` dosyalarını tarayarak derlenmiş sözlükleri `.intlayer/` altına yazar                                                        |
+| `intlayerPurgeBabelPlugin`    | Tüm kaynak dosyaları tarar, derlenmiş `.intlayer/**/*.json` sözlük dosyalarından **kullanılmayan içerik alanlarını** temizler             |
+| `intlayerMinifyBabelPlugin`   | JSON dosyalarındaki ve kaynak koddaki **içerik alanı anahtarlarını kısa alfabetik isimlere (alias)** (`title` → `a`) dönüştürür           |
+| `intlayerOptimizeBabelPlugin` | `useIntlayer('key')` çağrısını `useDictionary(hash)` olarak yeniden yazar ve ilgili sözlük için eşleşen bir `import` ifadesi enjekte eder |
+
+> **Eklenti sırası önemlidir.** `babel.config.js` dosyanızda purge ve minify eklentileri optimize eklentisinden **önce** gelmelidir. Optimize aşaması `useIntlayer('key')` öğesini belirsiz bir `useDictionary(hash)` çağrısı ile değiştirdiğinden, purge ve minify işlemlerinin hangi alanların kullanıldığını tespit edebilmesi için gerekli olan sözlük anahtar bilgisi kaybolur.
+
+Her Babel eklentisi, yapılandırma yüklenme zamanında `intlayer.config.ts`'yi bir kez okuyan ve önceden çözümlenmiş değerler döndüren, kendisine eşlik eden bir opsiyon yardımcısı (options helper) içerir:
+
+| Opsiyon yardımcısı           | Birlikte kullanıldığı eklenti |
+| :--------------------------- | :---------------------------- |
+| `getExtractPluginOptions()`  | `intlayerExtractBabelPlugin`  |
+| `getPurgePluginOptions()`    | `intlayerPurgeBabelPlugin`    |
+| `getMinifyPluginOptions()`   | `intlayerMinifyBabelPlugin`   |
+| `getOptimizePluginOptions()` | `intlayerOptimizeBabelPlugin` |
+
+### Vite eklentileri (`vite-intlayer`)
+
+Vite kullanıcıları **bunları asla doğrudan yapılandırmaz**. Bunlar `vite.config.ts` içinde `withIntlayer()` fonksiyonu çağrıldığında otomatik olarak bağlanır. `intlayer.config.ts` içindeki `build.purge` ve `build.minify` bayrakları, ek bir eklenti kaydına (registration) gerek kalmadan karşılık gelen davranışı etkinleştirip kapatır.
+
+| Dahili Vite eklentisi | Eşdeğer davranışı                                                                                |
+| :-------------------- | :----------------------------------------------------------------------------------------------- |
+| Usage analyzer        | `intlayerPurgeBabelPlugin` analizi ile aynı                                                      |
+| Dictionary prune      | `intlayerPurgeBabelPlugin` JSON yazma adımı ile aynı                                             |
+| Dictionary minify     | `intlayerMinifyBabelPlugin` JSON yazma adımı ile aynı                                            |
+| Babel transform       | `intlayerMinifyBabelPlugin` kaynak kod yeniden adlandırması + `intlayerOptimizeBabelPlugin` aynı |
+
+### SWC eklentisi (`@intlayer/swc`)
+
+Next.js kullanıcıları da **bunları asla doğrudan yapılandırmaz**. **v9.2.1**'den itibaren `next.config.ts` içindeki `withIntlayer()`, yalnızca `build.purge` ve `build.minify` bayraklarına dayanarak tüm pipeline'ı — purge, minify ve import yeniden yazımını — çalıştırır.
+
+İş ikiye bölünmüştür, çünkü bir SWC Wasm eklentisi her seferinde tek bir dosyayı dönüştürür ve dosya sistemine erişimi yoktur:
+
+| Geçiş                                               | Nerede çalışır                | Ne yapar                                                                                                                  |
+| :-------------------------------------------------- | :---------------------------- | :------------------------------------------------------------------------------------------------------------------------ |
+| Kullanım analizi + JSON purge/minify                | Node, `withIntlayer()` içinde | Her bileşen kaynak dosyasını okur, `.intlayer/**/*.json` dosyalarını yeniden yazar, yeniden adlandırma tablolarını üretir |
+| Kaynak kodu yeniden yazımı (`content.title` → `.a`) | `@intlayer/swc` (Wasm)        | Yeniden adlandırma tablolarını kodunuzdaki eşleşen özellik erişimlerine uygular                                           |
+| Import yeniden yazımı (`useIntlayer` → dict)        | `@intlayer/swc` (Wasm)        | `intlayerOptimizeBabelPlugin` ile aynı                                                                                    |
+
+_Hangi_ alanların kullanılmadığına ve her birinin _hangi_ takma adı alacağına karar vermek dosyalar arası durum ve dosya G/Ç gerektirir; bu nedenle bu yarısı Node'da çalışır ve SWC eklentisi yalnızca ortaya çıkan tabloları alır.
+
 ## Yapılandırma
 
 Intlayer'ın paketinizi (bundle) nasıl optimize edeceğini `intlayer.config.ts` dosyanızdaki `build` özelliği aracılığıyla kontrol edebilirsiniz.
@@ -650,3 +517,136 @@ const content = useDictionaryAsync({
 | **Ağ İstekleri**     | 0 Eksta İstek Gerektirmez                                      | 1 Sözlük için anahtar isteği alır            |
 | **Tree Shaking**     | Bileşen Seviyesinde                                            | Bileşen ve Dil Seviyesinde                   |
 | **En İyi Senaryo**   | UI ve Arayüz Bileşenleri, Küçük Uygulamalar                    | Büyük Yazılar içeren Siteler, Çok Sayıda Dil |
+
+## Paketinizi analiz edin
+
+Paketinizi analiz etmek, "ağır" JSON dosyalarını ve kod bölme (code-splitting) fırsatlarını belirlemenin en doğrudan yoludur. Bu araçlar, uygulamanızın derlenmiş (compiled) kodunun görsel bir treemap'ini oluşturarak tam olarak hangi kütüphanelerin en çok yer kapladığını görmenize olanak tanır.
+
+<Tabs>
+ <Tab value="vite">
+
+### Vite / Rollup
+
+Vite, arka planda Rollup kullanır. `rollup-plugin-visualizer` eklentisi, grafiğinizdeki her modülün boyutunu gösteren etkileşimli bir HTML dosyası üretir.
+
+```bash
+npm install -D rollup-plugin-visualizer
+```
+
+```typescript fileName="vite.config.ts"
+import { defineConfig } from "vite";
+import { visualizer } from "rollup-plugin-visualizer";
+
+export default defineConfig({
+  plugins: [
+    visualizer({
+      open: true, // Raporu otomatik olarak tarayıcınızda açar
+      filename: "stats.html",
+      gzipSize: true,
+      brotliSize: true,
+    }),
+  ],
+});
+```
+
+ </Tab>
+ <Tab value="nextjs (turbopack)">
+
+### Next.js (Turbopack)
+
+App Router ve Turbopack kullanan projelerde, Next.js ekstra bir bağımlılığa ihtiyaç duymayan yerleşik, deneysel bir analizör sağlar.
+
+```bash packageManager='npm'
+npx next experimental-analyze
+```
+
+```bash packageManager='yarn'
+yarn next experimental-analyze
+```
+
+```bash packageManager='pnpm'
+pnpm next experimental-analyze
+```
+
+```bash packageManager='bun'
+bun next experimental-analyze
+```
+
+ </Tab>
+ <Tab value="nextjs (Webpack)">
+
+### Next.js (Webpack)
+
+Next.js'de varsayılan Webpack paketleyiciyi kullanıyorsanız, resmi bundle analyzer'ı kullanın. Bunu derleme (build) sırasında bir ortam değişkeni ayarlayarak tetikleyebilirsiniz.
+
+```bash packageManager='npm'
+npm install -D @next/bundle-analyzer
+```
+
+```bash packageManager='yarn'
+yarn add -D @next/bundle-analyzer
+```
+
+```bash packageManager='pnpm'
+pnpm add -D @next/bundle-analyzer
+```
+
+```bash packageManager='bun'
+bun add -d @next/bundle-analyzer
+```
+
+```javascript fileName="next.config.js"
+const withBundleAnalyzer = require("@next/bundle-analyzer")({
+  enabled: process.env.ANALYZE === "true",
+});
+
+module.exports = withBundleAnalyzer({
+  // Next.js yapılandırmanız
+});
+```
+
+**Kullanımı:**
+
+```bash
+ANALYZE=true npm run build
+```
+
+ </Tab>
+ <Tab value="Webpack (CRA / Angular / etc)">
+
+### Standart Webpack
+
+Create React App (ejected), Angular veya özel Webpack yapılandırmaları için endüstri standardı olan `webpack-bundle-analyzer`ı kullanın.
+
+```bash packageManager='npm'
+npm install -D webpack-bundle-analyzer
+```
+
+```bash packageManager='yarn'
+yarn add -D webpack-bundle-analyzer
+```
+
+```bash packageManager='pnpm'
+pnpm add -D webpack-bundle-analyzer
+```
+
+```bash packageManager='bun'
+bun add -d webpack-bundle-analyzer
+```
+
+```typescript fileName="webpack.config.ts"
+import { BundleAnalyzerPlugin } from "webpack-bundle-analyzer";
+
+export default {
+  plugins: [
+    new BundleAnalyzerPlugin({
+      analyzerMode: "static",
+      reportFilename: "bundle-analyzer.html",
+      openAnalyzer: false,
+    }),
+  ],
+};
+```
+
+ </Tab>
+</Tabs>

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

@@ -91,8 +91,6 @@ Zaten çevrilmiş dosyaları incelemek ve çevirinin doğru olup olmadığını
 
 - **`--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.
 
-I'm ready to audit the Turkish translation. However, I need you to provide:
-
 > Örnek: `npx intlayer doc review --mode report`
 
 > Örnek: `npx intlayer doc review --log`

package/docs/tr/configuration.md

@@ -1120,3 +1120,101 @@ Sözlükleri doğrudan bileşenlerinizden çıkaran Intlayer derleyicisini kontr
 | Alan      | Açıklama                                           | Tür                |
 | --------- | -------------------------------------------------- | ------------------ |
 | `plugins` | Etkinleştirilecek Intlayer eklentilerinin listesi. | `IntlayerPlugin[]` |
+
+## Sıkça Sorulan Sorular
+
+<FAQ>
+
+<Question title="intlayer.config.ts dosyası nerede bulunmalıdır?">
+
+Projenizin kök dizininde, `package.json` dosyasının yanında. Intlayer çalışma dizinini ve üst dizinleri `intlayer.config.ts`, `intlayer.config.js`, `intlayer.config.mjs` veya `intlayer.config.cjs` için tarar. CLI komutlarında `--config` bayrağı ile özel bir yol da belirtebilirsiniz.
+
+</Question>
+
+<Question title="i18n paket boyutuma ne kadar ekler?">
+
+Ad alanı (namespace) tabanlı bir kuruluma kıyasla çok daha az, çünkü bir sayfa render etmediği bir sözlüğü asla indirmez. Sunucu tarafında render edilen markup içeriği sunucuda çözer ve derleme zamanı derleyicisi `useIntlayer` çağrılarını bileşenin kullandığı kesin sözlük kayıtlarıyla değiştirir, böylece kullanılmayan anahtarlar ve diller elenir. [Dinamik sözlükler](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/dynamic_dictionaries/index.md) geri kalanını yerel başına böler. Yaygın alternatiflerle karşılaştırıldığında Intlayer paket ve sayfa boyutunu %50'ye kadar azaltır. Bkz. [paket optimizasyonu](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/bundle_optimization.md) ve [kıyaslama](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/benchmark/index.md).
+
+</Question>
+
+<Question title="i18next, next-intl veya react-i18next'ten bileşenlerimi yeniden yazmadan geçiş yapabilir miyim?">
+
+Evet, iki yol mevcuttur. [i18next geçiş kılavuzu](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/migration_from_i18next_to_intlayer.md) veya [next-intl geçiş kılavuzu](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/migration_from_next-intl_to_intlayer.md) ile içeriği aşamalı olarak taşıyabilirsiniz. Ya da mevcut API'nizi tamamen koruyabilirsiniz: [uyumluluk adaptörleri](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/compat/index.md), `i18next`, `react-i18next`, `next-intl`, `next-i18next`, `react-intl`, `use-intl`, `vue-i18n` ve `Lingui` ile tamamen aynı API'yi sunar, ancak Intlayer sözlükleri tarafından desteklenir; böylece yalnızca import satırları değişir, bileşen kodu aynı kalır.
+
+</Question>
+
+<Question title="Mevcut JSON çeviri dosyalarımı koruyabilir miyim?">
+
+Evet. [sync JSON eklentisi](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/plugins/sync-json.md), `/messages/{locale}/{namespace}.json` dosyalarınızı doğruluk kaynağı olarak tutar ve her iki yönde Intlayer sözlükleri üretir. [sync PO eklentisi](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/plugins/sync-po.md) gettext katalogları için aynısını yapar ve [yerel başına dosyalar](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/per_locale_file.md), yerelleri tek bir dosyada gruplamak yerine içeriği dile göre ayırmanıza olanak tanır.
+
+</Question>
+
+<Question title="İçeriğimi anahtar anahtar taşımak zorunda mıyım?">
+
+Hayır. `npx intlayer extract` komutunu çalıştırın; Intlayer kaynak dosyalarınızı okur, kullanıcıya dönük dizeleri çıkarır ve her birinin yanına bir `.content` dosyası yazar, böylece dizeleri tek tek kopyalamak yerine bir diff incelersiniz. Bkz. [extract komutu](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/cli/extract.md).
+
+Tam otomatik bir akış için [Intlayer Compiler](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/compiler.md) derleme sırasında JSX, TSX, Vue ve Svelte kodunda aynı işlemi yapar ve sözlükleri her değişiklikte otomatik üretir, böylece elle anahtar yönetimi gerekmez. Statik analizle çalıştığından, yalnızca çalışma zamanında var olan dizeler kapsam dışı kalır.
+
+</Question>
+
+<Question title="Hangi editör ve AI aracı araçları mevcuttur?">
+
+Beş araç, hepsi isteğe bağlı:
+
+- **[VS Code eklentisi](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/vs_code_extension.md)**: bir `useIntlayer` anahtarından onu tanımlayan içerik dosyasına atlayın, bileşenden içerik çıkarın ve komut paletinden build, fill, test, push ve pull komutlarını çalıştırın.
+- **[LSP sunucusu](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/lsp.md)**: LSP destekleyen tüm editörlerde tanıma gitme, tüm referansları bulma, çevrilmiş değerlerin fareyle üzerine gelindiğinde önizlemesi ve otomatik tamamlama. `i18next`, `react-i18next`, `next-intl` ve `use-intl` çağrılarını da çözer.
+- **[MCP sunucusu](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/mcp_server.md)**: Intlayer dokümantasyonunu ve CLI'sini Cursor, VS Code, Claude Desktop, Claude Code ve ChatGPT'ye sunar.
+- **[Ajan becerileri (Agent skills)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/agent_skills.md)**: `intlayer-config`, `intlayer-cli` ve `intlayer-content` gibi odaklanmış beceriler.
+- **[ESLint eklentisi](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/eslint.md)**: `no-raw-text` kuralı doğrudan kodlanmış metinleri işaretler.
+
+</Question>
+
+<Question title="Uygulamama yeni bir dili nasıl eklerim?">
+
+Dili `internationalization.locales` dizisine ekleyin, ardından mevcut içeriği bu dile çevirmek için `npx intlayer fill` komutunu çalıştırın. Derleyici bir sonraki çalıştırmada yeni dili otomatik olarak dahil eder.
+
+</Question>
+
+<Question title="URL'lerimden yerel ön ekini nasıl kaldırırım?">
+
+`routing.mode` ayarını yapın. `"no-prefix"` modu tüm diller için ön eki kaldırır ve yereli çerezden veya başlıktan çözer. `"prefix-no-default"` (varsayılan) ise ön eki yalnızca varsayılan dil için kaldırır.
+
+</Question>
+
+<Question title="Her dili kendi alan adından sunabilir miyim?">
+
+Evet. `routing.domains` ayarı her yereli bir alan adına eşler, örneğin `{ tr: 'example.com.tr', en: 'example.com' }`. Alan adı tespiti yol ön eklerinden önce gelir ve `getMultilingualUrls` tam URL'leri üretir.
+
+</Question>
+
+<Question title="Kullanıcının dili nasıl algılanır?">
+
+`routing.storage` üzerinden, öncelik sırasına göre: genellikle önce URL, ardından çerez, daha sonra `Accept-Language` başlığı ve son olarak varsayılan dil.
+
+</Question>
+
+<Question title="routing.enableProxy ne işe yarar?">
+
+Ön ekleri ve yönlendirmeleri çözen yerel yönlendirme ara katman yazılımını (proxy) kontrol eder. Tanımlanmadığında geliştirme ve üretim ortamlarında otomatik çalışır. `false` olarak ayarlanırsa tamamen devre dışı bırakılır.
+
+</Question>
+
+<Question title="importMode static, dynamic ve fetch arasındaki fark nedir?">
+
+`"static"` (varsayılan), sözlükleri statik olarak içe aktarır, böylece pakete dahil edilir ve senkronize okunur. `"dynamic"`, sözlükleri dil başına asenkron yükler. `"fetch"`, sözlükleri çalışma zamanında bir sunucudan veya CMS'den çeker.
+
+</Question>
+
+<Question title="Otomatik çeviri için AI sağlayıcısını ve API anahtarını nereye ayarlamalıyım?">
+
+Yapılandırma dosyasındaki `ai` bölümünde veya komut satırında `--provider`, `--model` ve `--api-key` bayrakları ile. Anahtarınız yerel kalır ve ortamınızdan asla dışarı çıkmaz. Bkz. [AI yapılandırma referansı](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/configuration.md).
+
+</Question>
+
+<Question title="Yapılandırmayı değiştirdikten sonra geliştirme sunucusunu yeniden başlatmam gerekir mi?">
+
+Genellikle hayır. Intlayer watcher `intlayer.config.ts` dosyasını izler: kaydettiğinizde yapılandırmayı yeniden yükler ve sözlükleri arka planda günceller.
+
+</Question>
+
+</FAQ>

package/docs/tr/dictionary/content_file.md

@@ -363,15 +363,15 @@ Sözlüğü, içerikte bildirilen her alanın otomatik olarak bir çeviri düğ
 
 **Örnek:**
 
-```json
+```jsonc
 // Yerel dil bazlı sözlük
 {
   "key": "about-page",
   "locale": "en",
   "content": {
     "title": "About Us", // Bu 'en' için bir çeviri düğümü olur
-    "description": "Learn more about our company"
-  }
+    "description": "Learn more about our company",
+  },
 }
 ```
 
@@ -440,7 +440,7 @@ Sözlük içeriğini harici kaynaklardan otomatik olarak doldurma talimatları.
 
 **Örnekler:**
 
-```json
+```jsonc
 // Tüm yerel diller için etkinleştir
 {
   "autoFill": true

package/docs/tr/dictionary/markdown.md

@@ -51,6 +51,7 @@ Markdown içeriğini `md` işlevini kullanarak veya basitçe bir dize olarak (Ma
 
 <Tabs>
   <Tab label=".content.md" value=".content.md">
+
     Sürüm `8.10.0`'dan itibaren Markdown içeriğini doğrudan `.content.md` dosyalarında bildirebilirsiniz. Intlayer, Markdown içeriğini otomatik olarak algılar ve ayrıştırır.
 
     ```md fileName="markdown-file.en.content.md"
@@ -96,6 +97,7 @@ Markdown içeriğini `md` işlevini kullanarak veya basitçe bir dize olarak (Ma
     ```
 
   </Tab>
+
   <Tab label="Harici Dosyalar" value="external-files">
     `.md` dosyalarını doğrudan `file` işlevini kullanarak içe aktarın.
 
@@ -129,6 +131,7 @@ Markdown içeriğini `md` işlevini kullanarak veya basitçe bir dize olarak (Ma
     ```
 
   </Tab>
+
 </Tabs>
 
 ## Markdown'u İşleme (Rendering)

package/docs/tr/dictionary/plurial.md

@@ -33,11 +33,14 @@ Intlayer'da çoğul içerik, CLDR çoğul kategorilerini (`zero`, `one`, `two`,
 
 Kendi tanımladığınız sayısal aralıklara göre içerik seçen [`enu`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/dictionary/enumeration.md) işlevinden farklı olarak, `plural` seçimi CLDR kurallarına devreder. Rusça, Lehçe, Arapça veya Galce gibi karmaşık çoğullaştırma kurallarına sahip diller için, elle modülo mantığı yazmak zorunda kalmadan ölçeklenebilir olmasını sağlayan şey budur.
 
-## Ne Zaman `plural` vs `enu` Kullanılmalı?
+## `plural` ve `enu` Ne Zaman Kullanılır
 
-To use plural content inside a React component, retrieve it via the `useIntlayer` hook and call it with a count. The active locale and the count are combined to pick the matching CLDR category.
+| Kullanım senaryosu                                               | Yardımcı |
+| ---------------------------------------------------------------- | -------- |
+| Dile duyarlı dilbilgisel çoğul formları (bir elma / iki elma)    | `plural` |
+| Özel sayısal aralıklar (`<5`, `>=10`) veya CLDR dışı kategoriler | `enu`    |
 
-To use plural content in Next.js Client Components, retrieve it via the `useIntlayer` hook and call it with a count. Here's an example:
+Yalnızca İngilizceyi hedefliyorsanız (yalnızca `one` / `other` bulunur), her ikisi de çalışır. `few` / `many` / `two` ayrımlarına sahip diller için `plural` tercih edin.
 
 ## Çoğul İçeriği Ayarlama