@intlayer/docs 8.9.4-canary.0 → 8.9.5

package/docs/tr/dictionary/content_file.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-02-07
-updatedAt: 2026-01-28
+updatedAt: 2026-05-12
 title: İçerik Dosyası
 description: İçerik bildirim dosyalarınız için uzantıları nasıl özelleştireceğinizi öğrenin. Projenizde koşulları verimli bir şekilde uygulamak için bu dokümantasyonu takip edin.
 keywords:
@@ -12,6 +12,9 @@ slugs:
   - concept
   - content
 history:
+  - version: 8.9.0
+    date: 2026-05-12
+    changes: "Add `plural` content node type"
   - version: 8.0.0
     date: 2026-01-28
     changes: "`html` içerik düğümü tipi eklendi"
@@ -63,6 +66,7 @@ import { type ReactNode } from "react";
 import {
   t,
   enu,
+  plural,
   cond,
   nest,
   md,
@@ -82,6 +86,7 @@ interface Content {
   };
   multilingualContent: string;
   quantityContent: string;
+  pluralContent: string;
   conditionalContent: string;
   markdownContent: never;
   htmlContent: never;
@@ -117,6 +122,10 @@ export default {
       ">5": "Birkaç araba",
       ">19": "Birçok araba",
     }),
+    pluralContent: plural({
+      one: "One car",
+      other: "{{count}} cars",
+    }),
     conditionalContent: cond({
       true: "Doğrulama etkin",
       false: "Doğrulama devre dışı",
@@ -171,6 +180,13 @@ export default {
         ">5": "Birkaç araba",
         ">19": "Birçok araba",
       },
+      "pluralContent": {
+        "nodeType": "plural",
+        "plural": {
+          "one": "One car",
+          "other": "{{count}} cars",
+        },
+      },
     },
     "conditionalContent": {
       "nodeType": "condition",
@@ -218,6 +234,7 @@ export default {
 - **İlkel değerler**: stringler, sayılar, booleanlar, null, undefined
 - **Tiplenmiş düğümler**: Çeviriler, koşullar, markdown gibi özel içerik türleri
 - **Fonksiyonlar**: Çalışma zamanında değerlendirilebilen dinamik içerik [bkz. Fonksiyon Getirme](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/dictionary/function_fetching.md)
+- **Plural Content**: See Plural Content [See Plural Content](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/dictionary/plural.md)
 - **İç içe içerik**: Diğer sözlüklere referanslar
 
 #### İçerik Türleri
@@ -563,6 +580,8 @@ multilingualContent: t({
 });
 ```
 
+> See [Çeviri İçeriği (`t`) Doc](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/dictionary/translation.md) for more information.
+
 ### Koşul İçeriği (`cond`)
 
 Boolean koşullara göre değişen içerik:
@@ -576,6 +595,8 @@ conditionalContent: cond({
 });
 ```
 
+> See [Koşul İçeriği (`cond`) Doc](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/dictionary/condition.md) for more information.
+
 ### Numaralandırma İçeriği (`enu`)
 
 Numaralandırılmış değerlere göre değişen içerik:
@@ -590,6 +611,23 @@ statusContent: enu({
 });
 ```
 
+> See [Numaralandırma İçeriği (`enu`) Doc](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/dictionary/enumeration.md) for more information.
+
+### Plural Content (`plural`)
+
+Content that varies based on plural rules:
+
+```typescript
+import { plural } from "intlayer";
+
+pluralContent: plural({
+  one: "One car",
+  other: "{{count}} cars",
+});
+```
+
+> See [Plural Content Doc](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/dictionary/plural.md) for more information.
+
 ### Ekleme İçeriği (`insert`)
 
 Başka içeriklere eklenebilen içerik:
@@ -600,6 +638,8 @@ import { insert } from "intlayer";
 insertionContent: insert("Bu metin herhangi bir yere eklenebilir");
 ```
 
+> See [Ekleme İçeriği (`insert`) Doc](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/dictionary/insertion.md) for more information.
+
 ### İç İçe İçerik (`nest`)
 
 Diğer sözlüklere referanslar:
@@ -610,6 +650,8 @@ import { nest } from "intlayer";
 nestedContent: nest("about-page");
 ```
 
+> See [İç İçe İçerik (`nest`) Doc](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/dictionary/nesting.md) for more information.
+
 ### Markdown İçeriği (`md`)
 
 Markdown formatında zengin metin içeriği:
@@ -622,6 +664,8 @@ markdownContent: md(
 );
 ```
 
+> See [Markdown İçeriği (`md`) Doc](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/dictionary/markdown.md) for more information.
+
 ### HTML İçeriği (`html`)
 
 Standart etiketler veya özel bileşenler kullanabilen zengin HTML içeriği:
@@ -639,6 +683,8 @@ localizedHtmlContent: t({
 });
 ```
 
+> See [HTML İçeriği (`html`) Doc](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/dictionary/html.md) for more information.
+
 ### Cinsiyete Göre İçerik (`gender`)
 
 Cinsiyete göre değişen içerik:
@@ -653,6 +699,8 @@ genderContent: gender({
 });
 ```
 
+> See [Cinsiyete Göre İçerik (`gender`) Doc](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/dictionary/gender.md) for more information.
+
 ### Dosya İçeriği (`file`)
 
 Harici dosyalara referanslar:
@@ -663,6 +711,8 @@ import { file } from "intlayer";
 fileContent: file("./path/to/content.txt");
 ```
 
+> See [Dosya İçeriği (`file`) Doc](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/dictionary/file.md) for more information.
+
 ## İçerik Dosyaları Oluşturma
 
 ### Temel İçerik Dosyası Yapısı

package/docs/tr/mcp_server.md

@@ -23,7 +23,7 @@ history:
     changes: "Claude Desktop kurulumu eklendi"
   - version: 5.5.12
     date: 2025-07-10
-    changes: "SSE aktarımı ve uzak sunucu eklendi"
+    changes: "Streamable HTTP aktarımı ve uzak sunucu eklendi"
   - version: 5.5.10
     date: 2025-06-29
     changes: "Geçmiş başlatıldı"
@@ -51,12 +51,12 @@ IDE'nizde Intlayer MCP Sunucusunu etkinleştirerek şunları açığa çıkarır
 
   > Komutların ve seçeneklerin tam listesini [Intlayer CLI dokümantasyonunda](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/cli/index.md) görüntüleyin.
 
-## Yerel sunucu (stdio) vs Uzak sunucu (SSE)
+## Yerel sunucu (stdio) vs Uzak sunucu (Streamable HTTP)
 
 MCP sunucusu iki şekilde kullanılabilir:
 
 - Yerel sunucu (stdio)
-- Uzak sunucu (SSE)
+- Uzak sunucu (Streamable HTTP)
 
 ### Yerel sunucu (stdio) (önerilen)
 
@@ -64,9 +64,9 @@ Intlayer, makinenizde yerel olarak yüklenebilen bir NPM paketi sağlar. VS Code
 
 Bu sunucu, MCP sunucusunun tüm özelliklerini entegre ettiği için önerilen yol, CLI araçları dahil.
 
-### Uzak sunucu (SSE)
+### Uzak sunucu (Streamable HTTP)
 
-MCP sunucusu ayrıca uzak olarak, SSE aktarım yöntemini kullanarak kullanılabilir. Bu sunucu Intlayer tarafından barındırılır ve https://mcp.intlayer.org adresinde kullanılabilir. Bu sunucuya herkese açık olarak, herhangi bir kimlik doğrulaması olmadan erişilebilir ve kullanımı ücretsizdir.
+MCP sunucusu ayrıca uzak olarak, Streamable HTTP aktarım yöntemini kullanarak kullanılabilir. Bu sunucu Intlayer tarafından barındırılır ve https://mcp.intlayer.org adresinde kullanılabilir. Bu sunucuya herkese açık olarak, herhangi bir kimlik doğrulaması olmadan erişilebilir ve kullanımı ücretsizdir.
 
 Uzak sunucunun CLI araçlarını, AI otomatik tamamlama vb. entegre etmediğini unutmayın. Uzak sunucu sadece AI asistanınızın Intlayer ekosistemiyle etkileşim kurması için dokümantasyon içindir.
 
@@ -97,7 +97,7 @@ bun x intlayer init mcp
 Bu komut şunları yapacaktır:
 
 1. Hangi platformu kullandığınızı soracaktır (Cursor, VS Code, Claude Desktop vb.).
-2. Hangi taşıma yöntemini kullanmak istediğinizi soracaktır (Yerel sunucu (stdio) veya Uzak sunucu (SSE)).
+2. Hangi taşıma yöntemini kullanmak istediğinizi soracaktır (Yerel sunucu (stdio) veya Uzak sunucu (Streamable HTTP)).
 3. Yapılandırma dosyanızı otomatik olarak güncelleyecektir (örneğin, `.cursor/mcp.json`, `.vscode/mcp.json` veya genel Claude Desktop yapılandırması).
 
 ---
@@ -107,7 +107,7 @@ Bu komut şunları yapacaktır:
 1. Komut Paletini açın (Ctrl+Shift+P veya Cmd+Shift+P).
 2. `Intlayer: Setup AI Agent Skills` yazın
 3. Kullandığınız platformu seçin (örn. `VS Code`, `Cursor`, `Windsurf`, `OpenCode`, `Claude Code`, `GitHub Copilot Workspace` vb.).
-4. Kurulacak MCP'yi seçin (stdio, SSE)
+4. Kurulacak MCP'yi seçin (stdio, Streamable HTTP)
 5. Enter'a basın.
 
 ---
@@ -131,16 +131,16 @@ Proje kökünüzde aşağıdaki `.cursor/mcp.json` yapılandırma dosyasını ek
 }
 ```
 
-### Uzak sunucu (SSE)
+### Uzak sunucu (Streamable HTTP)
 
-Server-Sent Events (SSE) kullanarak uzak bir Intlayer MCP sunucusuna bağlanmak için, MCP istemcinizi barındırılan servise bağlanacak şekilde yapılandırabilirsiniz.
+Server-Sent Events (Streamable HTTP) kullanarak uzak bir Intlayer MCP sunucusuna bağlanmak için, MCP istemcinizi barındırılan servise bağlanacak şekilde yapılandırabilirsiniz.
 
 ```json fileName=".cursor/mcp.json"
 {
   "mcpServers": {
-    "intlayer": {
-      "url": "https://mcp.intlayer.org",
-      "transport": "sse"
+    "intlayer-sse": {
+      "command": "npx",
+      "args": ["-y", "mcp-remote@latest", "https://mcp.intlayer.org"]
     }
   }
 }
@@ -172,16 +172,16 @@ Proje kökünüzde bir `.vscode/mcp.json` dosyası oluşturun:
 }
 ```
 
-### Uzak sunucu (SSE)
+### Uzak sunucu (Streamable HTTP)
 
-Server-Sent Events (SSE) kullanarak uzak bir Intlayer MCP sunucusuna bağlanmak için, MCP istemcinizi barındırılan servise bağlanacak şekilde yapılandırabilirsiniz.
+Server-Sent Events (Streamable HTTP) kullanarak uzak bir Intlayer MCP sunucusuna bağlanmak için, MCP istemcinizi barındırılan servise bağlanacak şekilde yapılandırabilirsiniz.
 
 ```json fileName=".vscode/mcp.json"
 {
   "servers": {
-    "intlayer": {
-      "url": "https://mcp.intlayer.org",
-      "type": "sse"
+    "intlayer-sse": {
+      "command": "npx",
+      "args": ["-y", "mcp-remote@latest", "https://mcp.intlayer.org"]
     }
   }
 }
@@ -191,7 +191,7 @@ Server-Sent Events (SSE) kullanarak uzak bir Intlayer MCP sunucusuna bağlanmak
 
 ## ChatGPT'de Kurulum
 
-### Uzak sunucu (SSE)
+### Uzak sunucu (Streamable HTTP)
 
 ChatGPT'de MCP sunucusunu yapılandırmak için [resmi dokümantasyonu](https://platform.openai.com/docs/mcp#test-and-connect-your-mcp-server) takip edin.
 
@@ -232,6 +232,19 @@ Yapılandırma dosyasının yolu:
 }
 ```
 
+### Uzak sunucu (Streamable HTTP)
+
+```json fileName="claude_desktop_config.json"
+{
+  "mcpServers": {
+    "intlayer-sse": {
+      "command": "npx",
+      "args": ["-y", "mcp-remote@latest", "https://mcp.intlayer.org"]
+    }
+  }
+}
+```
+
 ---
 
 ## CLI aracılığıyla MCP Sunucusunu Kullanma

package/docs/tr/plugins/sync-po.md

@@ -0,0 +1,333 @@
+---
+createdAt: 2026-05-10
+updatedAt: 2026-05-10
+title: Sync PO eklentisi
+description: Intlayer sözlüklerini Gettext PO dosyalarıyla senkronize edin. Mesajlarınızı yönetmek, çevirmek ve test etmek için Intlayer'ı kullanırken mevcut i18n yapınızı koruyun.
+keywords:
+  - Intlayer
+  - Sync PO
+  - Gettext
+  - i18n
+  - çeviriler
+slugs:
+  - doc
+  - plugin
+  - sync-po
+youtubeVideo: https://www.youtube.com/watch?v=MpGMxniDHNg
+history:
+  - version: 8.9.4
+    date: 2026-05-10
+    changes: "Sync PO eklentisi ilk dokümantasyonu"
+---
+
+# Sync PO (i18n köprüleri) - ICU / i18next desteğiyle Sync PO
+
+Intlayer'ı mevcut i18n yığınınız için bir eklenti olarak kullanın. Bu eklenti, Gettext PO mesajlarınızı Intlayer sözlükleriyle senkronize tutar, böylece şunları yapabilirsiniz:
+
+- Mevcut PO tabanlı çeviri iş akışınızı koruyun.
+- Uygulamanızı yeniden yapılandırmadan mesajlarınızı Intlayer (CLI, CI, sağlayıcılar, CMS) ile yönetin ve çevirin.
+- PO yönetim katmanı olarak Intlayer'ı önerirken, her ekosistemi hedefleyen öğreticiler ve SEO içerikleri sunun.
+
+Notlar ve mevcut kapsam:
+
+- CMS'ye dışsallaştırma, çeviriler ve klasik metinler için çalışır.
+- PO girişlerinin kendisinde eklemeler, çoğullar/ICU veya diğer kütüphanelerin gelişmiş çalışma zamanı özellikleri için henüz destek yoktur.
+- Görsel düzenleyici henüz üçüncü taraf i18n çıktıları için desteklenmemektedir.
+
+### Bu eklenti ne zaman kullanılmalı?
+
+- Çevirileriniz için zaten Gettext PO dosyalarını kullanıyorsanız.
+- İşleme çalışma zamanınızı değiştirmeden yapay zeka destekli doldurma, CI'da test ve içerik operasyonları istiyorsanız.
+
+## Kurulum
+
+```bash
+pnpm add -D @intlayer/sync-po-plugin
+# veya
+npm i -D @intlayer/sync-po-plugin
+```
+
+## Eklentiler
+
+Bu paket iki eklenti sunar:
+
+- `loadPO`: PO dosyalarını Intlayer sözlüklerine yükler.
+  - Bu eklenti, bir kaynaktan PO dosyalarını yüklemek için kullanılır ve Intlayer sözlüklerine yüklenecektir. Tüm kod tabanını tarayabilir ve belirli PO dosyalarını arayabilir.
+    Bu eklenti şu durumlarda kullanılabilir:
+    - PO dosyalarınızın yükleneceği belirli bir konumu zorunlu kılan bir i18n kütüphanesi kullanıyorsanız ancak içerik bildiriminizi kod tabanınızda istediğiniz yere yerleştirmek istiyorsanız.
+    - Mesajlarınızı uzak bir kaynaktan (örneğin: bir CMS, bir API vb.) getirmek ve mesajlarınızı PO dosyalarında saklamak istiyorsanız.
+
+  > Arka planda, bu eklenti tüm kod tabanını tarayacak ve belirli PO dosyalarını arayacak ve bunları Intlayer sözlüklerine yükleyecektir.
+  > Bu eklentinin çıktıyı ve çevirileri PO dosyalarına geri yazmayacağını unutmayın.
+
+- `syncPO`: PO dosyalarını Intlayer sözlükleriyle senkronize eder.
+  - Bu eklenti, PO dosyalarını Intlayer sözlükleriyle senkronize etmek için kullanılır. Verilen konumu tarayabilir ve belirli PO dosyaları için kalıpla eşleşen PO'ları yükleyebilir. Bu eklenti, başka bir i18n kütüphanesi kullanırken Intlayer'ın avantajlarından yararlanmak istiyorsanız yararlıdır.
+
+## Her iki eklentinin kullanımı
+
+```ts fileName="intlayer.config.ts"
+import { Locales, type IntlayerConfig } from "intlayer";
+import { loadPO, syncPO } from "@intlayer/sync-po-plugin";
+
+const config: IntlayerConfig = {
+  internationalization: {
+    locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],
+    defaultLocale: Locales.ENGLISH,
+  },
+
+  // Mevcut PO dosyalarınızı Intlayer sözlükleriyle senkronize tutun
+  plugins: [
+    /**
+     * src içindeki {key}.i18n.po kalıbıyla eşleşen tüm PO dosyalarını yükleyecektir
+     */
+    loadPO({
+      source: ({ key }) => `./src/**/${key}.i18n.po`,
+      locale: Locales.ENGLISH,
+      priority: 1, // Bu PO dosyalarının `./locales/en/${key}.po` adresindeki dosyalara göre öncelikli olmasını sağlar
+    }),
+    /**
+     * Çıktıyı ve çevirileri yükleyecek ve locales dizinindeki PO dosyalarına geri yazacaktır
+     */
+    syncPO({
+      source: ({ key, locale }) => `./locales/${locale}/${key}.po`,
+      priority: 0,
+    }),
+  ],
+};
+
+export default config;
+```
+
+## `syncPO` eklentisi
+
+### Hızlı başlangıç
+
+Eklentiyi `intlayer.config.ts` dosyanıza ekleyin ve mevcut PO yapınızı işaret edin.
+
+```ts fileName="intlayer.config.ts"
+import { Locales, type IntlayerConfig } from "intlayer";
+import { syncPO } from "@intlayer/sync-po-plugin";
+
+const config: IntlayerConfig = {
+  internationalization: {
+    locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],
+    defaultLocale: Locales.ENGLISH,
+  },
+
+  // Mevcut PO dosyalarınızı Intlayer sözlükleriyle senkronize tutun
+  plugins: [
+    syncPO({
+      // Dil başına, ad alanı başına düzen
+      source: ({ key, locale }) => `./locales/${locale}/${key}.po`,
+    }),
+  ],
+};
+
+export default config;
+```
+
+Alternatif: dil başına tek dosya:
+
+```ts fileName="intlayer.config.ts"
+import { Locales, type IntlayerConfig } from "intlayer";
+import { syncPO } from "@intlayer/sync-po-plugin";
+
+const config: IntlayerConfig = {
+  internationalization: {
+    locales: [Locales.ENGLISH, Locales.FRENCH],
+    defaultLocale: Locales.ENGLISH,
+  },
+  plugins: [
+    syncPO({
+      source: ({ locale }) => `./locales/${locale}.po`,
+    }),
+  ],
+};
+
+export default config;
+```
+
+#### Nasıl çalışır?
+
+- Okuma: Eklenti, `source` oluşturucunuzdan PO dosyalarını bulur ve bunları Intlayer sözlükleri olarak yükler.
+- Yazma: Derlemelerden ve doldurmalardan sonra, yerelleştirilmiş PO'ları aynı yollara geri yazar (uygun Gettext başlıklarıyla).
+- Otomatik Doldurma: Eklenti, her sözlük için bir `autoFill` yolu bildirir. `intlayer fill` komutunu çalıştırmak varsayılan olarak yalnızca PO dosyalarınızdaki eksik çevirileri günceller.
+
+API:
+
+```ts
+syncPO({
+  source: ({ key, locale }) => string, // gerekli
+  location?: string, // isteğe bağlı etiket, varsayılan: "sync-po::path/to/source"
+  priority?: number, // çakışma çözümü için isteğe bağlı öncelik, varsayılan: 0
+});
+```
+
+### Birden fazla PO kaynağı ve öncelik
+
+Farklı PO kaynaklarını senkronize etmek için birden fazla `syncPO` eklentisi ekleyebilirsiniz. Bu, projenizde birden fazla çeviri kaynağınız veya farklı PO yapılarınız olduğunda kullanışlıdır.
+
+#### Öncelik sistemi
+
+Birden fazla eklenti aynı sözlük anahtarını hedeflediğinde, `priority` parametresi hangi eklentinin öncelikli olduğunu belirler:
+
+- Yüksek öncelik sayıları düşük olanlara göre önceliklidir
+- `.content` dosyalarının varsayılan önceliği `0`'dır
+- Eklentilerin varsayılan önceliği `0`'dır
+- Aynı önceliğe sahip eklentiler yapılandırmada göründükleri sıraya göre işlenir
+
+```ts fileName="intlayer.config.ts"
+import { Locales, type IntlayerConfig } from "intlayer";
+import { syncPO } from "@intlayer/sync-po-plugin";
+
+const config: IntlayerConfig = {
+  internationalization: {
+    locales: [Locales.ENGLISH, Locales.FRENCH],
+    defaultLocale: Locales.ENGLISH,
+  },
+
+  plugins: [
+    // Birincil PO kaynağı (en yüksek öncelik)
+    syncPO({
+      source: ({ key, locale }) => `./locales/${locale}/${key}.po`,
+      location: "main-translations",
+      priority: 10,
+    }),
+
+    // Yedek PO kaynağı (düşük öncelik)
+    syncPO({
+      source: ({ locale }) => `./fallback-locales/${locale}.po`,
+      location: "fallback-translations",
+      priority: 5,
+    }),
+
+    // Eski PO kaynağı (en düşük öncelik)
+    syncPO({
+      source: ({ locale }) => `/my/other/app/legacy/${locale}/messages.po`,
+      location: "legacy-translations",
+      priority: 1,
+    }),
+  ],
+};
+
+export default config;
+```
+
+## Load PO eklentisi
+
+### Hızlı başlangıç
+
+Mevcut PO dosyalarını Intlayer sözlükleri olarak almak için eklentiyi `intlayer.config.ts` dosyanıza ekleyin. Bu eklenti salt okunurdur (diske yazma yapılmaz):
+
+```ts fileName="intlayer.config.ts"
+import { Locales, type IntlayerConfig } from "intlayer";
+import { loadPO } from "@intlayer/sync-po-plugin";
+
+const config: IntlayerConfig = {
+  internationalization: {
+    locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],
+    defaultLocale: Locales.ENGLISH,
+  },
+
+  plugins: [
+    // Kaynak ağacınızın herhangi bir yerinde bulunan PO mesajlarını alın
+    loadPO({
+      source: ({ key }) => `./src/**/${key}.i18n.po`,
+      // Eklenti örneği başına tek bir dil yükle (yapılandırma defaultLocale değerine varsayılan olarak ayarlanır)
+      locale: Locales.ENGLISH,
+      priority: 0,
+    }),
+  ],
+};
+
+export default config;
+```
+
+Alternatif: dil başına düzen, hala salt okunur (yalnızca seçilen dil yüklenir):
+
+```ts fileName="intlayer.config.ts"
+import { Locales, type IntlayerConfig } from "intlayer";
+import { loadPO } from "@intlayer/sync-po-plugin";
+
+const config: IntlayerConfig = {
+  internationalization: {
+    locales: [Locales.ENGLISH, Locales.FRENCH],
+    defaultLocale: Locales.ENGLISH,
+  },
+  plugins: [
+    loadPO({
+      // Bu kalıptan yalnızca Locales.FRENCH dosyaları yüklenecektir
+      source: ({ key, locale }) => `./locales/${locale}/${key}.po`,
+      locale: Locales.FRENCH,
+    }),
+  ],
+};
+
+export default config;
+```
+
+### Nasıl çalışır?
+
+- Keşfetme: `source` oluşturucunuzdan bir glob oluşturur ve eşleşen PO dosyalarını toplar.
+- Alım: Her PO dosyasını sağlanan `locale` ile bir Intlayer sözlüğü olarak yükler.
+- Salt Okunur: Çıktı dosyalarını yazmaz veya biçimlendirmez; gidiş-dönüş senkronizasyonuna ihtiyacınız varsa `syncPO` kullanın.
+- Otomatik Doldurmaya Hazır: Eksik anahtarları doldurmak için `intlayer content fill` komutunun kullanabileceği bir `fill` yolu tanımlar.
+
+### API
+
+```ts
+loadPO({
+  // PO dosyalarınıza giden yolları oluşturun. Yapınızda dil segmenti yoksa `locale` isteğe bağlıdır
+  source: ({ key, locale }) => string,
+
+  // Bu eklenti örneği tarafından yüklenen sözlükler için hedef dil
+  // configuration.internationalization.defaultLocale değerine varsayılan olarak ayarlanır
+  locale?: Locale,
+
+  // Kaynağı tanımlamak için isteğe bağlı etiket
+  location?: string, // varsayılan: "plugin"
+
+  // Diğer kaynaklara karşı çakışma çözümü için kullanılan öncelik
+  priority?: number, // varsayılan: 0
+});
+```
+
+### Davranış ve kurallar
+
+- `source` maskeniz bir dil yer tutucusu içeriyorsa, yalnızca seçilen `locale` için dosyalar alınır.
+- Maskenizde `{key}` segmenti yoksa sözlük anahtarı "index" olur.
+- Anahtarlar, `source` oluşturucunuzdaki `{key}` yer tutucusunun değiştirilmesiyle dosya yollarından türetilir.
+- Eklenti yalnızca bulunan dosyaları kullanır ve eksik dilleri veya anahtarları uydurmaz.
+- `fill` yolu `source` değerinizden çıkarılır ve katılım sağladığınızda CLI aracılığıyla eksik değerleri güncellemek için kullanılır.
+
+## Çakışma çözümü
+
+Aynı çeviri anahtarı birden fazla PO kaynağında mevcut olduğunda:
+
+1. En yüksek önceliğe sahip eklenti nihai değeri belirler
+2. Düşük öncelikli kaynaklar eksik anahtarlar için geri dönüş olarak kullanılır
+3. Bu, yeni yapılara kademeli olarak geçerken eski çevirileri korumanıza olanak tanır
+
+## CLI
+
+Senkronize edilmiş PO dosyaları diğer `.content` dosyaları gibi değerlendirilecektir. Bu, senkronize edilmiş PO dosyaları için tüm intlayer komutlarının kullanılabilir olacağı anlamına gelir. Şunlar dahildir:
+
+- Eksik çeviri olup olmadığını test etmek için `intlayer content test`
+- Senkronize edilmiş PO dosyalarını listelemek için `intlayer content list`
+- Eksik çevirileri doldurmak için `intlayer content fill`
+- Senkronize edilmiş PO dosyalarını göndermek (push) için `intlayer content push`
+- Senkronize edilmiş PO dosyalarını çekmek (pull) için `intlayer content pull`
+
+Daha fazla ayrıntı için [Intlayer CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/cli/index.md) sayfasına bakın.
+
+## Sınırlamalar (güncel)
+
+- Üçüncü taraf kütüphaneleri hedeflerken ekleme veya çoğul/ICU desteği yoktur.
+- Görsel düzenleyici henüz Intlayer dışı çalışma zamanları için mevcut değildir.
+- Yalnızca PO senkronizasyonu; PO dışı katalog biçimleri desteklenmez.
+
+## Bu neden önemli?
+
+- Yerleşik i18n çözümlerini önerebilir ve Intlayer'ı bir eklenti olarak konumlandırabiliriz.
+- PO'ları yönetmek için Intlayer'ı önererek sona eren öğreticilerle onların SEO/anahtar kelimelerinden yararlanırız.
+- Adreslenebilir kitleyi "yeni projelerden", "zaten i18n kullanan herhangi bir ekibe" genişletir.

package/docs/uk/benchmark/nextjs.md

@@ -61,6 +61,13 @@ history:
 
 Intlayer намагається оптимізувати всі ці параметри одночасно.
 
+## TL;DR
+
+- **Intlayer** та **next-translate**: Найкращі варіанти для продуктивності Next.js, що забезпечують мінімальний розмір та найкращу підтримку статичного рендерингу.
+- **next-intl**: Найбільш трендовий варіант на сьогодні, проте він важкий і складний в оптимізації для великих додатків.
+- **next-i18next**: Популярний та багатий на плагіни, але має значну вагу бандла (~3× Intlayer).
+- **Уникайте**: **gt-next** та **lingo.dev** через серйозні проблеми з продуктивністю, прив'язку до вендора (vendor lock-in) та критичні помилки при збірці.
+
 ## Протестуйте свій додаток
 
 Щоб виявити ці проблеми, я створив безкоштовний сканер, який ви можете спробувати [тут](https://intlayer.org/i18n-seo-scanner).
@@ -99,14 +106,14 @@ Intlayer намагається оптимізувати всі ці парам
 Для цього бенчмарку ми порівняли наступні бібліотеки:
 
 - `Base App` (Без бібліотеки i18n)
-- `next-intlayer` (v8.7.5)
+- `next-intlayer` (v8.7.12)
 - `next-i18next` (v16.0.5)
 - `next-intl` (v4.9.1)
 - `@lingui/core` (v5.3.0)
 - `next-translate` (v3.1.2)
 - `next-international` (v1.3.1)
 - `@inlang/paraglide-js` (v2.15.1)
-- `tolgee` (v7.0.0)
+- `@tolgee/react` (v7.0.0)
 - `@lingo.dev/compiler` (v0.4.0)
 - `wuchale` (v0.22.11)
 - `gt-next` (v6.16.5)
@@ -161,10 +168,10 @@ Intlayer намагається оптимізувати всі ці парам
 
 **(General Translation)** (`gt-next@6.16.5`):
 
-- Для додатку розміром 110 КБ `gt-react` додає понад 440 КБ зайвих даних.
+- Для додатку розміром 110 КБ `gt-next` додає понад 440 КБ зайвих даних.
 - `Quota Exceeded, please upgrade your plan` вже під час першої збірки.
 - Переклади не рендериться; отримую помилку `Error: <T> used on the client-side outside of <GTProvider>`, що схоже на баг бібліотеки.
-- При впровадженні **gt-tanstack-start-react** я також стикнувся з [проблемою](https://github.com/generaltranslation/gt/issues/1210#event-24510646961) бібліотеки: помилка `does not provide an export named 'printAST' - @formatjs/icu-messageformat-parser`, через яку додаток падав. Після звіту про помилку розробник виправив її протягом 24 годин.
+- При впровадженні **gt-next** я також стикнувся з [проблемою](https://github.com/generaltranslation/gt/issues/1210#event-24510646961) бібліотеки: помилка `does not provide an export named 'printAST' - @formatjs/icu-messageformat-parser`, через яку додаток падав. Після звіту про помилку розробник виправив її протягом 24 годин.
 - Бібліотека блокує статичний рендеринг сторінок Next.js.
 
 **(Lingo.dev)** (`@lingo.dev/compiler@0.4.0`):
@@ -186,9 +193,11 @@ Intlayer намагається оптимізувати всі ці парам
 Особисто мені не подобається необхідність регенерувати JS-файли перед кожним пушем, що створює постійний ризик конфліктів під час злиття через PR. Інструмент також здається більш орієнтованим на Vite, ніж на Next.js.
 Нарешті, порівняно з іншими рішеннями, Paraglide не використовує стор (наприклад, React context) для отримання поточної локалі для рендерингу. Для кожного обробленого вузла він запитує локаль з localStorage / cookie тощо. Це призводить до виконання непотрібної логіки, що впливає на реактивність компонентів.
 
+> Примітка щодо paraglide: це рішення впроваджує код у вашу кодову базу для імпорту, в результаті чого показник 'розмір бібліотеки' у звіті бенчмарку становить майже 0. Генерація коду — це добре, оскільки функція, що використовується, міститиме лише необхідну логіку (повний префікс проти відсутності префікса, кукі проти сховища тощо). Для порівняння, Intlayer виконує цю фільтрацію через впровадження змінних середовища під час збірки, щоб змусити бандлер видалити невикористаний контент (tree-shaking) залежно від логіки. Завдяки цьому paraglide та intlayer виявляються в 6-10 разів легшими рішеннями, ніж i18next або next-intl.
+
 ### 3 — Прийнятні рішення
 
-**(Tolgee)** (`tolgee@7.0.0`):
+**(Tolgee)** (`@tolgee/react@7.0.0`):
 
 `Tolgee` вирішує багато зі згаданих проблем. Проте його впровадження здалося мені складнішим, ніж у подібних інструментів. Він не забезпечує типізацію (type safety), що ускладнює виявлення відсутніх ключів під час компіляції. Мені довелося обертати функції Tolgee своїми, щоб додати перевірку відсутніх ключів.
 
@@ -216,7 +225,7 @@ Intlayer намагається оптимізувати всі ці парам
 
 `next-translate` — моя основна рекомендація, якщо вам подобається API у стилі `t()`. Він елегантно працює через `next-translate-plugin`, завантажуючи простори імен через `getStaticProps` за допомогою завантажувача Webpack / Turbopack. Це також найлегший варіант у цьому списку (~2.5 КБ). Визначення просторів імен для сторінок або маршрутів у конфігу добре продумане і простіше в підтримці, ніж у **next-intl** чи **next-i18next**. У версії `3.1.2` я помітив, що статичний рендеринг не працював; Next.js переходив до динамічного рендерингу.
 
-**(Intlayer)** (`next-intlayer@8.7.5`):
+**(Intlayer)** (`next-intlayer@8.7.12`):
 
 Я не буду особисто оцінювати `next-intlayer` заради об’єктивності, оскільки це моє власне рішення.