@intlayer/docs 9.4.4 → 9.5.0

package/docs/ru/self_hosting.md

@@ -35,8 +35,6 @@ curl -fsSL https://intlayer.org/install.sh | sh
 
 <TOC/>
 
----
-
 ## Архитектура
 
 ```
@@ -56,8 +54,6 @@ curl -fsSL https://intlayer.org/install.sh | sh
 
 Chromium (используемый для генерации скриншотов Puppeteer) включен в образ бэкенда — отдельный контейнер не требуется.
 
----
-
 ## Предварительные требования
 
 - **Docker** ≥ 24 и **Docker Compose** ≥ v2. Если что-либо из этого отсутствует, установщик выведет ссылку для установки и завершит работу.
@@ -66,8 +62,6 @@ Chromium (используемый для генерации скриншото
 
 Всё остальное — Bun, Redis, MinIO, Chromium — поставляется внутри образа.
 
----
-
 ## Быстрый старт
 
 ### 1. Запустите установщик
@@ -136,8 +130,6 @@ curl -fsSL https://intlayer.org/install.sh | INTLAYER_ENV_FILE=./config/intlayer
 
 > Четыре переменные портов изменяют только **хост** часть маппинга, выведённую в команде `docker run`. Опубликованный образ имеет `http://localhost:3000`, `http://localhost:3100` и `http://localhost:9000`, встроенные в bundle панели управления во время сборки, поэтому переназначение их оставляет браузер указывающим на старые порты. Сохраняйте значения по умолчанию, если вы не создаёте свой собственный образ — см. [Ограничения](#limitations).
 
----
-
 ## Быстрый старт
 
 Что делает установщик:
@@ -150,8 +142,6 @@ curl -fsSL https://intlayer.org/install.sh | INTLAYER_ENV_FILE=./config/intlayer
 
 После запуска стека откройте **http://localhost:3000** и создайте свою первую учетную запись.
 
----
-
 ## Сервисы
 
 | Сервис      | Образ                                 | Порт(ы) хоста                         | Назначение                                                        |
@@ -165,8 +155,6 @@ curl -fsSL https://intlayer.org/install.sh | INTLAYER_ENV_FILE=./config/intlayer
 
 > Порт MinIO `9000` должен быть доступен из браузера, поскольку загруженные активы (аватары, скриншоты) загружаются непосредственно из `S3_PUBLIC_URL=http://localhost:9000/intlayer`.
 
----
-
 ## Переменные окружения
 
 ### Обязательно
@@ -236,8 +224,6 @@ curl -fsSL https://intlayer.org/install.sh | INTLAYER_ENV_FILE=./config/intlayer
 
 > Приоритет: собственная почтовая система организации (настроенная из панели управления **Organization**) имеет приоритет над глобальной почтовой системой, которая, в свою очередь, имеет приоритет над стандартным ключом Resend.
 
----
-
 ## Подключение вашего проекта Intlayer
 
 После запуска стека направьте свой проект на самохостинговый бэкенд и панель управления вместо `intlayer.org`.
@@ -299,8 +285,6 @@ const cms = createIntlayerCMS({
 const { data: dictionaries } = await dictionaryEndpoint(cms).getDictionaries();
 ```
 
----
-
 ## Обновление
 
 Это загружает последние образы и перезапускает контейнеры с помощью `docker compose pull && docker compose up -d`. Существующие тома (`mongo-data`, `redis-data`, `minio-data`) сохраняются — потери данных нет.
@@ -310,8 +294,6 @@ docker compose pull
 docker compose up -d
 ```
 
----
-
 ## Резервное копирование и восстановление
 
 Все постоянные данные хранятся в трех именованных томах Docker.
@@ -346,16 +328,12 @@ docker run --rm \
 # Повторите для redis-data и minio-data
 ```
 
----
-
 ## Ограничения
 
 - **MongoDB должна быть внешней (Atlas).** Backend подключается только через `mongodb+srv://` (собирается из `DB_ID` / `DB_MDP` / `DB_CLUSTER`), поэтому обычный `mongodb://host:27017` — включая встроенный `mongod` контейнера — не может быть использован. Предоставьте кластер MongoDB Atlas.
 - **Нет пользовательского домена.** Все URL-адреса `VITE_*`, обращенные к браузеру, встраиваются в приложение во время сборки, и опубликованный образ поставляется со значениями `localhost`. Доступ к панели управления должен осуществляться через `http://localhost:3000`; подача его на общедоступный домен потребует перестройки образа с встроенными целевыми URL-адресами и не поддерживается из коробки.
 - **Email требует работающего mailer.** Начальная настройка требует проверки электронной почты, поэтому должны быть настроены либо `RESEND_API_KEY`, либо [глобальный SMTP mailer](#global-mailer) (`MAIL_PROVIDER=smtp` + `MAIL_SMTP_*`). После входа первого администратора каждая организация также может настроить свой собственный SMTP или Resend mailer из панели управления.
 
----
-
 ## Устранение неполадок
 
 ### Бэкенд циклически перезапускается при первом запуске
@@ -382,8 +360,6 @@ docker compose logs redis
 docker compose run --rm minio-init
 ```
 
----
-
 ## Полезные ссылки
 
 - [Документация Intlayer CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_CMS.md)

package/docs/ru/testing.md

@@ -24,16 +24,12 @@ author: aymericzip
 
 Это руководство показывает, как автоматически проверять полноту ваших словарей, выявлять отсутствующие переводы до выпуска и тестировать локализованный пользовательский интерфейс в вашем приложении.
 
----
-
 ## Что вы можете тестировать
 
 - **Отсутствующие переводы**: провалить CI, если для любого словаря отсутствуют обязательные локали.
 - **Отрисовка локализованного UI**: рендерить компоненты с провайдером конкретной локали и проверять видимый текст/атрибуты.
 - **Аудиты во время сборки (build time)**: запускать быстрый аудит локально через CLI.
 
----
-
 ## Быстрый старт: аудит через CLI
 
 Запустите аудит из корня вашего проекта:
@@ -64,8 +60,6 @@ bun x intlayer content test
 
 Примечание: CLI выводит подробный отчет, но не завершает работу с ошибкой при обнаружении проблем. Для контроля в CI добавьте юнит-тест (ниже), который проверяет отсутствие отсутствующих обязательных локалей.
 
----
-
 ## Программное тестирование (Vitest/Jest)
 
 Используйте API Intlayer CLI, чтобы проверить, что отсутствующих переводов для обязательных локалей нет.
@@ -112,8 +106,6 @@ test("отсутствуют обязательные локали", () => {
   - `missingLocales`: объединение всех отсутствующих локалей.
   - `missingRequiredLocales`: подмножество, ограниченное `requiredLocales` (или все локали, если `requiredLocales` не установлены).
 
----
-
 ## Тестирование локализованного UI (React / Next.js)
 
 Рендерьте компоненты под провайдером Intlayer и проверяйте видимый контент.
@@ -162,8 +154,6 @@ test("отображает локализованный заголовок на
 - Когда вам нужны необработанные строковые значения для атрибутов (например, `aria-label`), обращайтесь к полю `.value`, возвращаемому `useIntlayer` в React.
 - Храните словари рядом с компонентами для упрощения модульного тестирования и очистки.
 
----
-
 ## Непрерывная интеграция
 
 Добавьте тест, который будет прерывать сборку, если отсутствуют необходимые переводы.
@@ -213,8 +203,6 @@ pnpm intlayer content test --verbose
 bun x intlayer content test --verbose
 ```
 
----
-
 ## Устранение неполадок
 
 - Убедитесь, что ваша конфигурация Intlayer определяет `locales` и (опционально) `requiredLocales`.

package/docs/tr/analytics.md

@@ -35,8 +35,6 @@ author: aymericzip
 
 <TOC/>
 
----
-
 ## Neleri İzler
 
 `@intlayer/analytics` üç tür anonim olayı toplu olarak işler (batch):

package/docs/tr/bundle_optimization.md

@@ -133,8 +133,6 @@ export default config;
 
 > Purge ve minify yalnızca `next build` sırasında çalışır — optimize pipeline'ı `next dev` sırasında kapalıdır.
 
-> Uyumluluk adaptörü çağıranları yapılandırıldığında da devre dışı kalırlar (`swcExtraCallers`; `@intlayer/next-intl` veya `@intlayer/react-i18next` gibi uyumluluk paketleri tarafından ayarlanır): bu çağrı noktaları kullanım analizörüne görünmez, dolayısıyla purge kodun hâlâ okuduğu alanları kaldırırdı. Import yeniden yazımı etkin kalır.
-
 **Daha eski sürümler (9.2.1 öncesi)** `@intlayer/babel` paketini ve `intlayerPurgeBabelPlugin` ile `intlayerMinifyBabelPlugin` tanımlayan bir `babel.config.js` dosyasını gerektiriyordu. Bu dosya artık gerekli değildir ve silinebilir.
 
  </Tab>

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

@@ -89,11 +89,15 @@ Zaten çevrilmiş dosyaları incelemek ve çevirinin doğru olup olmadığını
 
 **İ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.
+- **`--mode [mode]`**: İncelemenin nasıl çalışacağı. Varsayılan olarak `apply`.
 
-> Örnek: `npx intlayer doc review --mode report`
+  - `apply`: farklılaşan blokları yapay zeka ile çevirin ve dosyaları yazın.
+  - `report`: herhangi bir yapay zeka çağırmayın; 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 kaydedin.
+  - `synthesis`: herhangi bir yapay zeka çağırmayın ve blok başına çıktıyı atlayın; yalnızca güncel olan belgelerin ve düzenlenecek blokları olan belgelerin son özetini günlüğe kaydedin.
 
-> Örnek: `npx intlayer doc review --log`
+  > Örnek: `npx intlayer doc review --mode report`
+
+  > Örnek: `npx intlayer doc review --mode synthesis`
 
 Hangi mod olursa olsun, çalıştırma, temel belgesiyle hizalı olan belgeleri ve düzenlenmesi gereken blokların hala var olan belgelerini listeleyen bir sentez ile sona erer.
 

package/docs/tr/cli/index.md

@@ -70,14 +70,10 @@ author: aymericzip
 
 # Intlayer CLI - Çok dilli web siteniz için tüm Intlayer CLI komutları
 
----
-
 ## İçindekiler
 
 <TOC/>
 
----
-
 ## Paketi Yükle
 
 Gerekli paketleri npm kullanarak yükleyin:

package/docs/tr/cli/login.md

@@ -20,8 +20,6 @@ author: aymericzip
 
 # Intlayer CLI Login Komutu
 
----
-
 ## Açıklama
 
 Intlayer CLI'nin `login` komutu, Intlayer CMS ile kimlik doğrulaması yapmanıza olanak tanır. Bu komut, kimlik doğrulama işlemini tamamlamak ve Intlayer hizmetlerini kullanmak için gerekli kimlik bilgilerini (Client ID ve Client Secret) almak üzere varsayılan tarayıcınızı otomatik olarak açar.

package/docs/tr/compiler.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-09-09
-updatedAt: 2026-06-23
+updatedAt: 2026-09-08
 title: Intlayer Compiler | i18n için Otomatik İçerik Çıkarımı
 description: Uluslararasılaştırma sürecinizi Intlayer Compiler ile otomatikleştirin. İçeriği bileşenlerinizden doğrudan çıkararak Vite, Next.js ve daha fazlasında daha hızlı ve verimli i18n sağlayın.
 keywords:
@@ -68,7 +68,7 @@ Alternatif olarak, içeriğiniz üzerinde tam kontrolü korurken i18n süreciniz
 
 ## Kullanım
 
-> The quickest way to wire the compiler in is the interactive setup: run `npx intlayer init --interactive` and select **Compiler**. On Vite there is nothing to configure — the compiler is plugged in directly through the `intlayerCompiler()` plugin. On Next.js the command scaffolds the `babel.config.js` shown below. The non-interactive `intlayer init` leaves the compiler setup untouched.
+> Derleyiciyi bağlamanın en hızlı yolu etkileşimli kurulumdur: `npx intlayer init --interactive` komutunu çalıştırın ve **Compiler** seçeneğini seçin. Next.js ve Vite üzerinde, `compiler.enabled` ayarlandığında ve bir `compiler.output` yolu yapılandırıldığında otomatik olarak etkinleşir.
 
 <Tabs>
  <Tab value='vite'>
@@ -92,19 +92,13 @@ import { defineConfig } from "vite";
 import { intlayer } from "vite-intlayer";
 
 export default defineConfig({
-  plugins: [
-    intlayer({
-      proxy: {
-        ignore: (req) => req.url?.startsWith("/api"),
-      },
-    }),
-  ],
+  plugins: [intlayer()],
 });
 ```
 
 > Bağımsız `intlayerCompiler()` eklentisi, gelişmiş kurulumlar için hala dışa aktarılmaktadır. `intlayer()` ile birlikte kaydetmek güvenlidir — derleyici kendisini çoğaltmaz ve yalnızca bir kez çalışır.
 
-See complete tutorial: [Intlayer Compiler with Vite+React](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_with_vite+react_compiler.md)
+See complete tutorial: [Translate Vite and React with Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_with_vite+react.md)
 
 #### Framework Desteği
 
@@ -131,7 +125,33 @@ npm install @intlayer/svelte-compiler
  </Tab>
  <Tab value='nextjs'>
 
-### Next.js (Babel)
+### Next.js
+
+Next.js'te derleyici bir paketleyici yükleyici (bundler loader) olan `next-intlayer/extractor-loader` olarak çalışır. `withIntlayer` bunu hem Turbopack hem de webpack üzerinde sizin için kaydeder, yazılacak bir `babel.config.js` yoktur.
+
+#### Kurulum
+
+```bash
+npm install @intlayer/babel
+```
+
+#### Konfigürasyon
+
+Yapılandırılacak bir şey yok. `next.config.ts` dosyanız `withIntlayer` kullandığı sürece, `@intlayer/babel` yüklemek loader'ın kaydedilmesi için yeterlidir:
+
+```ts fileName="next.config.ts"
+import { withIntlayer } from "next-intlayer/server";
+
+export default withIntlayer({});
+```
+
+Loader, `next-swc-loader` öncesinde `.tsx` ve `.jsx` dosyalarında çalışır, bu nedenle orijinal JSX'inizi okur. Bileşenlerinizde bildirilen içerik `.content` dosyalarına çıkarılır ve dosya derlenirken `.intlayer` içine dahil edilir.
+
+</Tab>
+
+ <Tab value="Babel">
+
+### Babel
 
 Next.js veya Babel kullanan diğer Webpack tabanlı uygulamalar için, derleyiciyi `@intlayer/babel` eklentisi ile yapılandırabilirsiniz.
 
@@ -166,8 +186,6 @@ module.exports = {
 
 Bu yapılandırma, bileşenlerinizde beyan edilen içeriğin otomatik olarak çıkarılmasını ve derleme süreciniz sırasında sözlüklerin oluşturulmasında kullanılmasını sağlar.
 
-See complete tutorial: [Intlayer Compiler with Next.js](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_with_nextjs_compiler.md)
-
  </Tab>
 </Tabs>
 

package/docs/tr/configuration.md

@@ -122,14 +122,10 @@ author: aymericzip
 
 Intlayer yapılandırma dosyaları, uluslararasılaştırma, ara yazılım (middleware) ve içerik yönetimi gibi eklentinin çeşitli yönlerini özelleştirmenize olanak tanır. Bu belge, yapılandırmadaki her özelliğin ayrıntılı bir açıklamasını sunar.
 
----
-
 ## İçindekiler
 
 <TOC/>
 
----
-
 ## Yapılandırma Dosyası Desteği
 
 Intlayer, JSON, JS, MJS ve TS yapılandırma dosyası formatlarını kabul eder:
@@ -143,8 +139,6 @@ Intlayer, JSON, JS, MJS ve TS yapılandırma dosyası formatlarını kabul eder:
 - `intlayer.config.mjs`
 - `.intlayerrc`
 
----
-
 ## Örnek Yapılandırma Dosyası
 
 ````typescript fileName="intlayer.config.ts" codeFormat="typescript"
@@ -694,14 +688,10 @@ const config: IntlayerConfig = {
 export default config;
 ````
 
----
-
 ## Yapılandırma Referansı
 
 Aşağıdaki bölümler Intlayer için mevcut olan çeşitli yapılandırma ayarlarını açıklamaktadır.
 
----
-
 ### Uluslararasılaştırma Yapılandırması
 
 Mevcut diller ve uygulama için varsayılan dil de dahil olmak üzere uluslararasılaştırma ile ilgili ayarları tanımlar.
@@ -713,8 +703,6 @@ Mevcut diller ve uygulama için varsayılan dil de dahil olmak üzere uluslarara
 | `strictMode`      | TypeScript kullanarak uluslararasılaştırılmış içeriğin sağlam uygulamalarını sağlar. | `string`   | `'inclusive'`       |                      | • `"strict"` ise: `t` fonksiyonu bildirilen her dilin tanımlanmış olmasını gerektirir - eksikse veya bildirilmemişse hata verir.<br/>• `"inclusive"` ise: Eksik diller için uyarı verir ancak bildirilmeyenlerin kullanımına izin verir.<br/>• `"loose"` ise: Mevcut herhangi bir dili kabul eder. |
 | `defaultLocale`   | İstenen dil bulunamadığında geri dönüş olarak kullanılan varsayılan dil.             | `string`   | `Locales.ENGLISH`   | `'en'`               | URL'de, tanımlama bilgisinde (cookie) veya üstbilgide (header) belirtilmediğinde dili belirlemek için kullanılır.                                                                                                                                                                                  |
 
----
-
 ### Editör Yapılandırması
 
 Sunucu portu ve etkinleştirme durumu dahil olmak üzere yerleşik görsel editör ayarlarını tanımlar.
@@ -746,8 +734,6 @@ Analitik opt-out'tur: varsayılan olarak etkindir ve `@intlayer/analytics` paket
 | `flushInterval` | Backend'e otomatik toplu gönderimler arasındaki milisaniye.                                  | `number`  | `20000`    | `10000` |                                                                                                                                                                                     |
 | `sampleRate`    | Kaydedilecek oturumların oranı, `0` (hiçbiri) ile `1` (tümü) arasında.                       | `number`  | `1`        | `0.5`   | Örnekleme oturum başına belirlenimlidir, bu nedenle kaydedilen bir oturum tüm olaylarını raporlar (kısmi huniler olmaz).                                                            |
 
----
-
 ### Yönlendirme Yapılandırması
 
 URL yapısı, dil saklama ve ara yazılım yönetimi dahil olmak üzere yönlendirme davranışını kontrol eden ayarlar.
@@ -949,8 +935,6 @@ const config: IntlayerConfig = {
 export default config;
 ```
 
----
-
 ### İçerik Yapılandırması
 
 Dizin adları, dosya uzantıları ve türetilmiş yapılandırmalar dahil olmak üzere uygulama içindeki içeriğin nasıl yönetileceği ile ilgili ayarlar.
@@ -964,8 +948,6 @@ Dizin adları, dosya uzantıları ve türetilmiş yapılandırmalar dahil olmak
 | `excludedPath`   | İçerik taramasından hariç tutulan dizinler.                                                                        | `string[]` | `['**/node_modules/**', '**/dist/**', '**/build/**', '**/.intlayer/**', '**/.next/**', '**/.nuxt/**', '**/.expo/**', '**/.vercel/**', '**/.turbo/**', '**/.tanstack/**']` |                                                                                                                                                                                       | Henüz kullanılmıyor; gelecekteki uygulama için planlandı.                                                                                        |
 | `formatCommand`  | Intlayer onları yerel olarak yazarken içerik dosyalarını biçimlendirme komutu.                                     | `string`   | `undefined`                                                                                                                                                               | `'npx prettier --write "{{file}}" --log-level silent'` (Prettier), `'npx biome format "{{file}}" --write --log-level none'` (Biome), `'npx eslint --fix "{{file}}" --quiet'` (ESLint) | • `{{file}}` dosya yolu ile değiştirilecektir.<br/>• Tanımlanmazsa, Intlayer bunu otomatik olarak algılar (prettier, biome, eslint'i test eder). |
 
----
-
 ### Sistem Yapılandırması
 
 Intlayer'ın iç yolları ve çıktı sonuçlarıyla ilgili ayarlar. Bu ayarlar tipik olarak dahili olup kullanıcı tarafından değiştirilmesi gerekmez.
@@ -1020,8 +1002,6 @@ dictionary: {
 };
 ```
 
----
-
 ### Logger Yapılandırması
 
 Intlayer'dan gelen günlük çıkışını özelleştirmek için parametreler.
@@ -1092,8 +1072,6 @@ Derleme seçenekleri `@intlayer/babel` ve `@intlayer/swc` eklentileri için geç
 | `outputFormat`        | Sözlüklerin çıktı formatını kontrol eder.                                                                                          | `('esm' &#124; 'cjs')[]`         | `['esm', 'cjs']`                                                                                                                                                                  | `['cjs']`                                                                     |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
 | `traversePattern`     | Optimizasyon sırasında hangi dosyaların taranacağını tanımlayan kalıplar.                                                          | `string[]`                       | `['**/*.{tsx,ts,js,mjs,cjs,jsx,vue,svelte,svte}', '!**/node_modules/**', '!**/dist/**', '!**/.intlayer/**', '!**/*.config.*', '!**/*.test.*', '!**/*.spec.*', '!**/*.stories.*']` | `['src/**/*.{ts,tsx}', '../ui-library/**/*.{ts,tsx}', '!**/node_modules/**']` | • Derleme performansını artırmak için optimizasyonu ilgili dosyalarla sınırlayın.<br/>• `optimize` kapalıysa yok sayılır.<br/>• Glob kalıplarını kullanır.                                                                                                                                                                                                                                                                                                                                                                                                      |
 
----
-
 ### Derleyici Yapılandırması
 
 Sözlükleri doğrudan bileşenlerinizden çıkaran Intlayer derleyicisini kontrol eden ayarlar.
@@ -1113,8 +1091,6 @@ Sözlükleri doğrudan bileşenlerinizden çıkaran Intlayer derleyicisini kontr
 | --------- | --------------------------------------------------------------------------------- | --------------------------- |
 | `schemas` | Sözlüklerinizin yapısını doğrulamak için Zod şemaları tanımlamanıza olanak tanır. | `Record<string, ZodSchema>` |
 
----
-
 ### Eklentiler (Plugins)
 
 | Alan      | Açıklama                                           | Tür                |
@@ -1130,25 +1106,21 @@ Sözlükleri doğrudan bileşenlerinizden çıkaran Intlayer derleyicisini kontr
 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).
@@ -1156,7 +1128,6 @@ Hayır. `npx intlayer extract` komutunu çalıştırın; Intlayer kaynak dosyala
 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ı:
@@ -1168,49 +1139,41 @@ Beş araç, hepsi isteğe bağlı:
 - **[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.

package/docs/tr/dictionary/html.md

@@ -122,8 +122,6 @@ const myContent = html(
 
 Bir HTML düğümü üzerinde `.use()` yöntemini kullanırken, sağladığınız bileşenler `html()` fonksiyonunda sağlanan tanıma (varsa) göre kontrol edilecektir.
 
----
-
 ## HTML'i Render Etme
 
 Render işlemi Intlayer'ın içerik sistemi tarafından otomatik olarak veya özel araçlar kullanılarak manuel olarak yapılabilir.
@@ -477,8 +475,6 @@ HTML render'lamasını tüm uygulamanız için global olarak yapılandırabilirs
   </Tab>
 </Tabs>
 
----
-
 ### Manuel Renderlama ve Gelişmiş Araçlar
 
 Ham HTML string'lerini render etmeniz gerekiyorsa veya bileşen eşlemesinde daha fazla kontrole ihtiyacınız varsa, aşağıdaki araçları kullanın.
@@ -651,8 +647,6 @@ Belirli bileşenlerle bir HTML dizesi oluşturun.
   </Tab>
 </Tabs>
 
----
-
 ## Seçenekler Referansı
 
 Bu seçenekler `HTMLProvider`, `HTMLRenderer`, `useHTMLRenderer` ve `renderHTML`'e iletilebilir.

package/docs/tr/dictionary/markdown.md

@@ -1171,8 +1171,6 @@ export class MyComponent {
   </Tab>
 </Tabs>
 
----
-
 ## Sunucu Tarafı İşleme (SSR) ve Hidrasyon
 
 Remark / rehype gibi diğer Markdown ayrıştırıcılarıyla karşılaştırıldığında, Intlayer Markdown bağımlılık içermez ve hem istemci hem de sunucu tarafında çalışır.

package/docs/tr/how_works_intlayer.md

@@ -265,25 +265,21 @@ Sunucu, Express tabanlıdır ve görsel düzenleyici isteklerini almak ve içeri
 Derleme zamanında. Intlayer eklentisi `.content.ts` dosyalarını tarar, bunları optimize edilmiş sözlüklere derler ve `.intlayer` klasörüne yazar. Geliştirme ortamında bu süreç her dosya kaydında anında tekrarlanır.
 
 </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).
@@ -291,7 +287,6 @@ Hayır. `npx intlayer extract` komutunu çalıştırın; Intlayer kaynak dosyala
 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ı:
@@ -303,43 +298,36 @@ Beş araç, hepsi isteğe bağlı:
 - **[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=".intlayer klasörü nedir ve onu git'e eklemeli miyim?">
 
 Oluşturulan çıktıdır: derlenmiş sözlükler ve üretilen TypeScript tipleri. İçerik dosyalarınızdan türetildiği için `.gitignore` dosyasına eklenmeli ve CI/CD süreçlerinde `intlayer build` ile üretilmelidir.
 
 </Question>
-
 <Question title="Aktif yerel nasıl belirlenir?">
 
 `routing.storage` içinde listelenen kaynaklardan sırasıyla: URL ön eki, çerez, `Accept-Language` başlığı ve son olarak varsayılan dil.
 
 </Question>
-
 <Question title="Yerel ve uzak sözlükler arasındaki fark nedir?">
 
 Yerel bir sözlük kod tabanınızda bildirilir ve uygulamanızla birlikte derlenir. Uzak bir sözlük ise CMS içinde yönetilir ve API üzerinden çekilir, böylece kod dağıtımı olmadan metin değişiklikleri yayınlanabilir.
 
 </Question>
-
 <Question title="Intlayer TypeScript olmadan çalışır mı?">
 
 Evet. İçerik dosyaları TypeScript, JavaScript, ESM, CommonJS veya JSON formatlarında yazılabilir. TypeScript, otomatik tip denetimi ve otomatik tamamlama avantajlarını açığa çıkarır.
 
 </Question>
-
 <Question title="Sunucu renderi ve istemci renderi aynı içeriği nasıl paylaşır?">
 
 Sunucu, sunucu bileşenlerinin içeriğini doğrudan çözer, bu nedenle bu bileşenler için istemciye hiçbir sözlük gönderilmez. İstemci bileşenleri ise yalnızca tarayıcıda etkileşim için gereken sözlükleri alır.
 
 </Question>
-
 <Question title="Intlayer yerel ile ilgili hidrasyon uyumsuzluğunu (hydration mismatch) nasıl önler?">
 
 Yerel dil sunucuda bir kez çözümlenir ve istemci sağlayıcısına iletilir, tarayıcıda yeniden algılanmaya çalışılmaz; bu sayede sunucu ve istemci HTML çıktıları birebir eşleşir.
 
 </Question>
-
 <Question title="Bir çeviri eklediğimde uygulamayı yeniden derlemem gerekir mi?">
 
 Geliştirme ortamında hayır: eklenti içerik dosyalarını izler ve sözlükleri anında günceller. Üretim ortamında evet: yerel sözlükler derleme adımında optimize edilir.