@intlayer/docs 9.0.0-canary.15 → 9.0.0-canary.17

package/docs/ru/live-sync.md

@@ -0,0 +1,185 @@
+---
+createdAt: 2026-07-08
+updatedAt: 2026-07-08
+title: Live Sync | Отражение изменений контента CMS в реальном времени
+description: Позвольте вашему приложению отражать изменения контента Intlayer CMS в реальном времени — без пересборки и повторного развёртывания.
+keywords:
+  - Live Sync
+  - Живая синхронизация
+  - CMS
+  - Визуальный редактор
+  - Интернационализация
+  - Документация
+  - Intlayer
+  - Next.js
+  - Vite
+history:
+  - version: 9.0.0
+    date: 2026-07-08
+    changes: "Перенесено из документации Intlayer CMS в отдельную страницу"
+  - version: 6.0.1
+    date: 2025-09-22
+    changes: "Добавлена документация по live sync"
+  - version: 6.0.0
+    date: 2025-09-04
+    changes: "Заменено поле `hotReload` на `liveSync`"
+author: aymericzip
+---
+
+# Живая синхронизация
+
+Живая синхронизация позволяет вашему приложению отражать изменения контента CMS в режиме реального времени. Пересборка или повторный деплой не требуются. Когда функция включена, обновления передаются на сервер живой синхронизации, который обновляет словари, используемые вашим приложением.
+
+## Содержание
+
+<TOC/>
+
+---
+
+## Включение Live Sync
+
+Включите живую синхронизацию, обновив конфигурацию Intlayer:
+
+```typescript fileName="intlayer.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
+import type { IntlayerConfig } from "intlayer";
+
+const config: IntlayerConfig = {
+  // ... другие настройки конфигурации
+  editor: {
+    /**
+     * Включает горячую перезагрузку конфигураций локалей при обнаружении изменений.
+     * Например, когда словарь добавляется или обновляется, приложение обновляет
+     * отображаемый на странице контент.
+     *
+     * Поскольку горячая перезагрузка требует постоянного подключения к серверу,
+     * она доступна только для клиентов с тарифным планом `enterprise`.
+     *
+     * По умолчанию: false
+     */
+    liveSync: true,
+  },
+  dictionary: {
+    /**
+     * Управляет способом импорта словарей:
+     *
+     * - "fetch": словари загружаются динамически с использованием Live Sync API.
+     *   Заменяет useIntlayer на useDictionaryDynamic.
+     *
+     * Примечание: Режим "fetch" использует Live Sync API для загрузки словарей. Если вызов API
+     * не удаётся, словари импортируются динамически.
+     * Примечание: Только словари с удалённым содержимым и флагом "live" используют режим "fetch".
+     * Остальные используют динамический режим для повышения производительности.
+     */
+    importMode: "fetch",
+  },
+};
+
+export default config;
+```
+
+Запустите сервер Live Sync, чтобы обернуть ваше приложение:
+
+Пример использования автономного сервера:
+
+```json5 fileName="package.json"
+{
+  "scripts": {
+    // ... other scripts
+    "live:start": "npx intlayer live",
+  },
+}
+```
+
+Вы также можете использовать сервер вашего приложения параллельно, используя аргумент `--process`.
+
+Пример с использованием Next.js:
+
+```json5 fileName="package.json"
+{
+  "scripts": {
+    // ... другие скрипты
+    "build": "next build",
+    "dev": "next dev",
+    "start": "npx intlayer live --with 'next start'",
+  },
+}
+```
+
+Пример с использованием Vite:
+
+```json5 fileName="package.json"
+{
+  "scripts": {
+    // ... другие скрипты
+    "build": "vite build",
+    "dev": "vite dev",
+    "start": "npx intlayer live --with 'vite start'",
+  },
+}
+```
+
+Сервер Live Sync оборачивает ваше приложение и автоматически применяет обновлённый контент по мере его поступления.
+
+Чтобы получать уведомления об изменениях из CMS, сервер Live Sync поддерживает SSE-соединение с бэкендом. Когда контент в CMS изменяется, бэкенд пересылает обновление серверу Live Sync, который записывает новые словари. Ваше приложение отобразит обновление при следующей навигации или перезагрузке браузера, пересборка не требуется.
+
+Блок-схема (CMS/Backend -> Live Sync Server -> Application Server -> Frontend):
+
+![Схема потока Live Sync CMS/Backend/Live Sync Server/Application Server/Frontend](https://github.com/aymericzip/intlayer/blob/main/docs/assets/live_sync_flow_scema.svg)
+
+Как это работает:
+
+![Схема логики Live Sync](https://github.com/aymericzip/intlayer/blob/main/docs/assets/live_sync_logic_schema.svg)
+
+## Рабочий процесс разработки (локально)
+
+- В процессе разработки все удалённые словари загружаются при запуске приложения, чтобы вы могли быстро тестировать обновления.
+- Чтобы протестировать Live Sync локально с Next.js, оберните ваш dev-сервер:
+
+```json5 fileName="package.json"
+{
+  "scripts": {
+    // ... другие скрипты
+    "dev": "npx intlayer live --with 'next dev'",
+    // "dev": "npx intlayer live --with 'vite dev'", // Для Vite
+  },
+}
+```
+
+Включите оптимизацию, чтобы Intlayer применял трансформации Live импорта во время разработки:
+
+```typescript fileName="intlayer.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
+import type { IntlayerConfig } from "intlayer";
+
+const config: IntlayerConfig = {
+  editor: {
+    applicationURL: "http://localhost:5173",
+    liveSyncURL: "http://localhost:4000",
+    liveSync: true,
+  },
+  dictionary: {
+    importMode: "fetch",
+  },
+  build: {
+    optimize: true, // default: process.env.NODE_ENV === 'production'
+  },
+};
+
+export default config;
+```
+
+Эта настройка оборачивает ваш dev-сервер сервером Live Sync, загружает удалённые словари при запуске и транслирует обновления из CMS через SSE. Обновите страницу, чтобы увидеть изменения.
+
+## Примечания и ограничения
+
+- Добавьте источник live sync в политику безопасности вашего сайта (CSP). Убедитесь, что URL live sync разрешён в `connect-src` (и в `frame-ancestors`, если это актуально).
+- Live Sync не работает со статическим выводом. Для Next.js страница должна быть динамической, чтобы получать обновления во время выполнения (например, используйте `generateStaticParams`, `generateMetadata`, `getServerSideProps` или `getStaticProps` соответствующим образом, чтобы избежать ограничений полностью статического вывода).
+- В CMS у каждого словаря есть флаг `live`. Только словари с `live=true` загружаются через API live sync; остальные импортируются динамически и остаются неизменными во время выполнения.
+- Флаг `live` оценивается для каждого словаря во время сборки. Если удалённый контент не был помечен как `live=true` во время сборки, необходимо выполнить повторную сборку, чтобы включить Live Sync для этого словаря.
+- Сервер live sync должен иметь возможность записывать в `.intlayer`. В контейнерах убедитесь, что есть права на запись в `/.intlayer`.
+
+## Полезные ссылки
+
+- [Intlayer CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_CMS.md)
+- [Визуальный редактор Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_visual_editor.md)
+- [Справочник по конфигурации](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/configuration.md)
+- [Руководство по самостоятельному размещению](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/self_hosting.md)

package/docs/ru/releases/v9.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2026-06-14
-updatedAt: 2026-06-30
+updatedAt: 2026-07-08
 title: Новый Intlayer v9 — Что нового?
 description: Узнайте, что нового в Intlayer v9. Представляем пакеты совместимости drop-in для популярных библиотек i18n, а также поддержку Collections и Variants.
 keywords:
@@ -205,6 +205,49 @@ const product = useIntlayer("product-copy", {
 
 ---
 
+## `@intlayer/analytics`: отслеживание показов контента и A/B-тестирование
+
+Новый необязательный пакет [`@intlayer/analytics`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/analytics.md) показывает, какой контент реально видят ваши посетители — и замыкает цикл с **Collections и Variants**, позволяя проводить A/B-тесты контента и измерять конверсии по каждому варианту.
+
+- **Отслеживание на уровне провайдера**: `IntlayerProvider` (React / Next.js / React Native) автоматически регистрирует события `page_view` при загрузке, смене маршрута и смене локали.
+- **Отслеживание на уровне узла**: каждое разрешение `useIntlayer` отправляет событие `content_exposure` — какой ключ словаря, путь ключа, локаль и (если применимо) A/B-**вариант** были показаны. Повторные показы одного и того же узла в пределах окна отправки объединяются в одно событие.
+- **Детерминированное назначение A/B-варианта**: `getVariant(experimentKey, variants)` назначает сессии вариант **без обращения к серверу**, поэтому перед первым рендером не возникает мерцания.
+- **`useConversion()`**: привязывает цель (регистрация, клик, покупка…) к варианту, который видела сессия.
+- **Нулевая стоимость, если не установлен**: тот же tree-shakeable паттерн, что и у `@intlayer/editor` — динамический `import()`, обёрнутый в `try/catch`, плюс переменная окружения времени сборки (`INTLAYER_ANALYTICS_ENABLED`), которая полностью удаляет интеграцию из бандла для приложений, которые её не подключили.
+- **Без новой схемы конфигурации**: переиспользует `editor.backendURL` (эндпоинт для отправки событий / самостоятельный хостинг) и `editor.clientId` (ключ проекта, он же переключатель включения).
+- **Уважение к приватности**: анонимное хеширование сессии (SHA-256, без хранения исходных id), без хранения IP, только приблизительная геолокация по стране, пакетная отправка запросов примерно раз в 20 секунд.
+- **Дашборд**: новая страница **Analytics** (отображается в боковой панели после выбора проекта) показывает активных пользователей, пользователей за сегодня, за последние 7/30/90 дней, график динамики посетителей и разбивку по локалям и странам.
+
+```tsx fileName="CTAButton.tsx" codeFormat="tsx"
+import { useConversion } from "react-intlayer";
+
+const CTAButton = () => {
+  const trackConversion = useConversion();
+
+  return (
+    <button
+      onClick={() =>
+        trackConversion({
+          experimentKey: "homepage-hero",
+          variant: "black_friday",
+          goal: "cta_click",
+        })
+      }
+    >
+      Get started
+    </button>
+  );
+};
+```
+
+```bash packageManager="npm"
+npm install @intlayer/analytics
+```
+
+Уже доступно для React, Next.js и React Native (через `react-intlayer`); привязки для других фреймворков (Vue, Svelte, Angular, …) планируются по той же схеме внедрения, что и `@intlayer/editor`. Полное руководство см. в [документации Analytics](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/analytics.md).
+
+---
+
 ## Vite Plugin: Bundled Compiler & Proxy
 
 Plugin Vite `intlayer()` теперь объединяет **компилятор** и **proxy маршрутизации локалей** напрямую, поэтому большинству проектов нужен только один plugin в `vite.config.ts`:
@@ -351,6 +394,7 @@ Chromium (используемый для генерации скриншото
 
 - [Руководство по пакетам адаптеров совместимости](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/compat/index.md)
 - [Динамические словари — Collections и Variants](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/dynamic_dictionaries/index.md)
+- [Аналитика - отслеживание показов контента и A/B-тестирование](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/analytics.md)
 - [Справочник по конфигурации](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/configuration.md)
 - [CMS SDK — программный доступ через @intlayer/api](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_CMS.md)
 - [Руководство по самостоятельному размещению](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/self_hosting.md)

package/docs/tr/cli/index.md

@@ -125,7 +125,7 @@ Mevcut dillerin veya diğer parametrelerin nasıl yapılandırılacağını öğ
 
 ### Kimlik Doğrulama
 
-- **[Login](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/login.md)** - Intlayer CMS ile kimlik doğrulaması yapın ve erişim kimlik bilgilerini alın
+- **[Login](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/cli/login.md)** - Intlayer CMS ile kimlik doğrulaması yapın ve erişim kimlik bilgilerini alın
 
 ### Temel Komutlar
 

package/docs/tr/configuration.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-13
-updatedAt: 2026-06-23
+updatedAt: 2026-07-11
 title: Yapılandırma (Configuration)
 description: Uygulamanız için Intlayer'ı nasıl yapılandıracağınızı öğrenin. Intlayer'ı ihtiyaçlarınıza göre özelleştirmek için çeşitli ayarları ve seçenekleri anlayın.
 keywords:
@@ -14,6 +14,9 @@ slugs:
   - concept
   - configuration
 history:
+  - version: 9.0.0
+    date: 2026-07-11
+    changes: "`analytics` yapılandırması eklendi"
   - version: 9.0.0
     date: 2026-06-24
     changes: "Add `enableProxy` option to the routing configuration"
@@ -355,6 +358,30 @@ const config: IntlayerConfig = {
     liveSync: true,
   },
 
+  /**
+   * Analitik (analytics) yapılandırması.
+   */
+  analytics: {
+    /**
+     * Analitik toplamanın etkin olup olmadığı (sayfa görüntülemeleri, içerik gösterimleri, A/B olayları).
+     * Atıflandırma (attribution) için `editor.clientId` ayarlanmış olmalıdır.
+     * Varsayılan: false
+     */
+    enabled: true,
+
+    /**
+     * Backend'e otomatik toplu gönderimler arasındaki milisaniye.
+     * Varsayılan: 20000
+     */
+    flushInterval: 20000,
+
+    /**
+     * Kaydedilecek oturumların oranı, 0 (hiçbiri) ile 1 (tümü) arasında.
+     * Varsayılan: 1
+     */
+    sampleRate: 1,
+  },
+
   /**
    * Yapay zeka destekli çeviri ve oluşturma ayarları.
    */
@@ -668,6 +695,20 @@ Sunucu portu ve etkinleştirme durumu dahil olmak üzere yerleşik görsel edit
 
 ---
 
+### Analitik Yapılandırması (Analytics)
+
+Intlayer analitiğiyle ilgili ayarları tanımlar: kullanıcılara gerçekten gösterilen içeriğin (sayfa görüntülemeleri, içerik gösterimleri) toplanması ve içerik üzerinde A/B testinin desteklenmesi.
+
+Analitik kesinlikle opt-in'dir: `analytics.enabled` açıkça `true` olarak ayarlanmadıkça **ve** atıflandırma için bir proje anahtarı (`editor.clientId`) yapılandırılmadıkça hiçbir şey toplanmaz. Devre dışı bırakıldığında (varsayılan), analitik entegrasyonunun tamamı uygulama paketinizden kaldırılır (dead-code elimination).
+
+| Alan            | Açıklama                                                                                     | Tür       | Varsayılan | Örnek   | Not                                                                                                                           |
+| --------------- | -------------------------------------------------------------------------------------------- | --------- | ---------- | ------- | ----------------------------------------------------------------------------------------------------------------------------- |
+| `enabled`       | Analitik toplamayı etkinleştirir (sayfa görüntülemeleri, içerik gösterimleri, A/B olayları). | `boolean` | `false`    | `true`  | Atıflandırma için `editor.clientId` ayarlanmış olmalıdır; aksi takdirde `enabled` `true` olsa bile analitik devre dışı kalır. |
+| `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.

package/docs/tr/intlayer_CMS.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-08-23
-updatedAt: 2026-06-30
+updatedAt: 2026-07-08
 title: Intlayer CMS | İçeriğinizi Intlayer CMS'ye Dışa Aktarın
 description: İçeriğinizin yönetimini ekibinize devretmek için içeriğinizi Intlayer CMS'ye dışa aktarın.
 keywords:
@@ -18,6 +18,9 @@ slugs:
   - cms
 youtubeVideo: https://www.youtube.com/watch?v=UDDTnirwi_4
 history:
+  - version: 9.0.0
+    date: 2026-07-08
+    changes: "'Canlı senkronizasyon' bölümü kendi sayfasına (live-sync.md) taşındı, burada yalnızca kısa bir giriş ve bağlantı bırakıldı"
   - version: 9.0.0
     date: 2026-06-30
     changes: "Kendi Sunucuda Barındırma bölümü eklendi"
@@ -248,132 +251,7 @@ Daha sonra sözlüğünüzü [Intlayer CMS](https://app.intlayer.org/content) ü
 
 Canlı Senkronizasyon, uygulamanızın CMS içerik değişikliklerini çalışma zamanında yansıtmasını sağlar. Yeniden derleme veya yeniden dağıtım gerekmez. Etkinleştirildiğinde, güncellemeler uygulamanızın okuduğu sözlükleri yenileyen bir Canlı Senkronizasyon sunucusuna aktarılır.
 
-> Canlı Senkronizasyon sürekli bir sunucu bağlantısı gerektirir ve yalnızca enterprise planında kullanılabilir.
-
-Intlayer yapılandırmanızı güncelleyerek Canlı Senkronizasyonu etkinleştirin:
-
-```typescript fileName="intlayer.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
-import type { IntlayerConfig } from "intlayer";
-
-const config: IntlayerConfig = {
-  // ... diğer yapılandırma ayarları
-  editor: {
-    /**
-     * Değişiklik algılandığında yerel ayar yapılandırmalarının sıcak yeniden yüklemesini etkinleştirir.
-     * Örneğin, bir sözlük eklendiğinde veya güncellendiğinde, uygulama sayfada görüntülenen içeriği günceller.
-     *
-     * Sıcak yeniden yükleme sürekli bir sunucu bağlantısı gerektirdiği için,
-     * yalnızca `enterprise` planı müşterileri için kullanılabilir.
-     *
-     * Varsayılan: false
-     */
-    liveSync: true,
-  },
-  dictionary: {
-    /**
-     * Sözlüklerin nasıl içe aktarılacağını kontrol eder:
-     *
-     * - "live": Sözlükler, Live Sync API kullanılarak dinamik olarak getirilir.
-     *   useIntlayer yerine useDictionaryDynamic kullanılır.
-     *
-     * Not: Canlı mod, sözlükleri getirmek için Live Sync API'sini kullanır. API çağrısı
-     * başarısız olursa, sözlükler dinamik olarak içe aktarılır.
-     * Not: Yalnızca uzak içeriğe ve "live" bayraklarına sahip sözlükler canlı modu kullanır.
-     * Diğerleri performans için dinamik modu kullanır.
-     */
-    importMode: "fetch",
-  },
-};
-
-export default config;
-```
-
-Uygulamanızı sarmak için Live Sync sunucusunu başlatın:
-
-Next.js kullanarak örnek:
-
-```json5 fileName="package.json"
-{
-  "scripts": {
-    // ... diğer komutlar
-    "build": "next build",
-    "dev": "next dev",
-    "start": "npx intlayer live --with 'next start'",
-  },
-}
-```
-
-Vite kullanarak örnek:
-
-```json5 fileName="package.json"
-{
-  "scripts": {
-    // ... diğer komutlar
-    "build": "vite build",
-    "dev": "vite dev",
-    "start": "npx intlayer live --with 'vite start'",
-  },
-}
-```
-
-Live Sync sunucusu uygulamanızı sarar ve güncellenen içeriği geldiği anda otomatik olarak uygular.
-
-CMS'den değişiklik bildirimleri almak için, Live Sync sunucusu backend ile bir SSE bağlantısı sürdürür. CMS'de içerik değiştiğinde, backend güncellemeyi Live Sync sunucusuna iletir ve bu sunucu yeni sözlükleri yazar. Uygulamanız, sonraki gezinme veya tarayıcı yenilemesinde güncellemeyi yansıtacaktır, yeniden derleme gerekmez.
-
-Akış şeması (CMS/Backend -> Live Sync Sunucusu -> Uygulama Sunucusu -> Ön Yüz):
-
-![Live Sync Mantık Şeması](https://github.com/aymericzip/intlayer/blob/main/docs/assets/live_sync_logic_schema.svg)
-
-Nasıl çalışır:
-
-![Live Sync Akış CMS/Backend/Live Sync Sunucusu/Uygulama Sunucusu/Ön Yüz Şeması](https://github.com/aymericzip/intlayer/blob/main/docs/assets/live_sync_flow_scema.svg)
-
-### Geliştirme iş akışı (yerel)
-
-- Geliştirme aşamasında, uygulama başladığında tüm uzak sözlükler alınır, böylece güncellemeleri hızlıca test edebilirsiniz.
-- Next.js ile Live Sync'i yerel olarak test etmek için geliştirme sunucunuzu şu şekilde sarmalayın:
-
-```json5 fileName="package.json"
-{
-  "scripts": {
-    // ... diğer scriptler
-    "dev": "npx intlayer live --with 'next dev'",
-    // "dev": "npx intlayer live --with 'vite dev'", // Vite için
-  },
-}
-```
-
-Optimizasyonu etkinleştirin, böylece Intlayer geliştirme sırasında Live import dönüşümlerini uygular:
-
-```typescript fileName="intlayer.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
-import type { IntlayerConfig } from "intlayer";
-
-const config: IntlayerConfig = {
-  editor: {
-    applicationURL: "http://localhost:5173",
-    liveSyncURL: "http://localhost:4000",
-    liveSync: true,
-  },
-  dictionary: {
-    importMode: "fetch",
-  },
-  build: {
-    optimize: true,
-  },
-};
-
-export default config;
-```
-
-Bu yapılandırma, geliştirme sunucunuzu Live Sync sunucusuyla sarar, başlangıçta uzak sözlükleri getirir ve CMS'den SSE aracılığıyla güncellemeleri aktarır. Değişiklikleri görmek için sayfayı yenileyin.
-
-Notlar ve kısıtlamalar:
-
-- Live sync kaynağını site güvenlik politikanıza (CSP) ekleyin. Live sync URL'sinin `connect-src` içinde (ve ilgili ise `frame-ancestors` içinde) izinli olduğundan emin olun.
-- Live Sync statik çıktı ile çalışmaz. Next.js için, sayfa çalışma zamanında güncellemeleri alabilmek için dinamik olmalıdır (örneğin, tam statik kısıtlamalardan kaçınmak için `generateStaticParams`, `generateMetadata`, `getServerSideProps` veya `getStaticProps` uygun şekilde kullanılmalıdır).
-- CMS'de, her sözlüğün bir `live` bayrağı vardır. Yalnızca `live=true` olan sözlükler live sync API'si aracılığıyla alınır; diğerleri dinamik olarak içe aktarılır ve çalışma zamanında değişmeden kalır.
-- `live` bayrağı her sözlük için build zamanında değerlendirilir. Uzaktaki içerik derleme sırasında `live=true` olarak işaretlenmemişse, o sözlük için Live Sync'i etkinleştirmek üzere yeniden derleme yapmanız gerekir.
-- Live sync sunucusunun `.intlayer` dosyasına yazabilmesi gerekir. Konteynerlerde, `/.intlayer` dosyasına yazma erişiminin olduğundan emin olun.
+Tam kurulum kılavuzu (etkinleştirme, Live Sync sunucusunu başlatma, yerel geliştirme iş akışı ve kısıtlamalar) için [Live Sync belgelerine](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/live-sync.md) bakın.
 
 ## Kendi Sunucunuzda Barındırma
 

package/docs/tr/live-sync.md

@@ -0,0 +1,173 @@
+---
+createdAt: 2026-07-08
+updatedAt: 2026-07-08
+title: Canlı senkronizasyon | CMS içerik değişikliklerini çalışma zamanında yansıtın
+description: Uygulamanızın, yeniden derleme veya yeniden dağıtım gerektirmeden Intlayer CMS içerik değişikliklerini çalışma zamanında yansıtmasını sağlayın.
+keywords:
+  - Canlı senkronizasyon
+  - Live Sync
+  - CMS
+  - Görsel Düzenleyici
+  - Uluslararasılaştırma
+  - Dokümantasyon
+  - Intlayer
+  - Next.js
+  - Vite
+history:
+  - version: 9.0.0
+    date: 2026-07-08
+    changes: "Intlayer CMS belgelerinden ayrılarak kendi sayfasına taşındı"
+  - version: 6.0.1
+    date: 2025-09-22
+    changes: "Canlı senkronizasyon dokümantasyonu eklendi"
+  - version: 6.0.0
+    date: 2025-09-04
+    changes: "`hotReload` alanı `liveSync` ile değiştirildi"
+author: aymericzip
+---
+
+# Canlı senkronizasyon
+
+Canlı Senkronizasyon, uygulamanızın CMS içerik değişikliklerini çalışma zamanında yansıtmasını sağlar. Yeniden derleme veya yeniden dağıtım gerekmez. Etkinleştirildiğinde, güncellemeler uygulamanızın okuduğu sözlükleri yenileyen bir Canlı Senkronizasyon sunucusuna aktarılır.
+
+## İçindekiler
+
+<TOC/>
+
+---
+
+## Canlı senkronizasyonu etkinleştirme
+
+> Canlı Senkronizasyon sürekli bir sunucu bağlantısı gerektirir ve yalnızca enterprise planında kullanılabilir.
+
+Intlayer yapılandırmanızı güncelleyerek Canlı Senkronizasyonu etkinleştirin:
+
+```typescript fileName="intlayer.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
+import type { IntlayerConfig } from "intlayer";
+
+const config: IntlayerConfig = {
+  // ... diğer yapılandırma ayarları
+  editor: {
+    /**
+     * Değişiklik algılandığında yerel ayar yapılandırmalarının sıcak yeniden yüklemesini etkinleştirir.
+     * Örneğin, bir sözlük eklendiğinde veya güncellendiğinde, uygulama sayfada görüntülenen içeriği günceller.
+     *
+     * Sıcak yeniden yükleme sürekli bir sunucu bağlantısı gerektirdiği için,
+     * yalnızca `enterprise` planı müşterileri için kullanılabilir.
+     *
+     * Varsayılan: false
+     */
+    liveSync: true,
+  },
+  dictionary: {
+    /**
+     * Sözlüklerin nasıl içe aktarılacağını kontrol eder:
+     *
+     * - "live": Sözlükler, Live Sync API kullanılarak dinamik olarak getirilir.
+     *   useIntlayer yerine useDictionaryDynamic kullanılır.
+     *
+     * Not: Canlı mod, sözlükleri getirmek için Live Sync API'sini kullanır. API çağrısı
+     * başarısız olursa, sözlükler dinamik olarak içe aktarılır.
+     * Not: Yalnızca uzak içeriğe ve "live" bayraklarına sahip sözlükler canlı modu kullanır.
+     * Diğerleri performans için dinamik modu kullanır.
+     */
+    importMode: "fetch",
+  },
+};
+
+export default config;
+```
+
+Uygulamanızı sarmak için Live Sync sunucusunu başlatın:
+
+Next.js kullanarak örnek:
+
+```json5 fileName="package.json"
+{
+  "scripts": {
+    // ... diğer komutlar
+    "build": "next build",
+    "dev": "next dev",
+    "start": "npx intlayer live --with 'next start'",
+  },
+}
+```
+
+Vite kullanarak örnek:
+
+```json5 fileName="package.json"
+{
+  "scripts": {
+    // ... diğer komutlar
+    "build": "vite build",
+    "dev": "vite dev",
+    "start": "npx intlayer live --with 'vite start'",
+  },
+}
+```
+
+Live Sync sunucusu uygulamanızı sarar ve güncellenen içeriği geldiği anda otomatik olarak uygular.
+
+CMS'den değişiklik bildirimleri almak için, Live Sync sunucusu backend ile bir SSE bağlantısı sürdürür. CMS'de içerik değiştiğinde, backend güncellemeyi Live Sync sunucusuna iletir ve bu sunucu yeni sözlükleri yazar. Uygulamanız, sonraki gezinme veya tarayıcı yenilemesinde güncellemeyi yansıtacaktır, yeniden derleme gerekmez.
+
+Akış şeması (CMS/Backend -> Live Sync Sunucusu -> Uygulama Sunucusu -> Ön Yüz):
+
+![Live Sync Mantık Şeması](https://github.com/aymericzip/intlayer/blob/main/docs/assets/live_sync_logic_schema.svg)
+
+Nasıl çalışır:
+
+![Live Sync Akış CMS/Backend/Live Sync Sunucusu/Uygulama Sunucusu/Ön Yüz Şeması](https://github.com/aymericzip/intlayer/blob/main/docs/assets/live_sync_flow_scema.svg)
+
+## Geliştirme iş akışı (yerel)
+
+- Geliştirme aşamasında, uygulama başladığında tüm uzak sözlükler alınır, böylece güncellemeleri hızlıca test edebilirsiniz.
+- Next.js ile Live Sync'i yerel olarak test etmek için geliştirme sunucunuzu şu şekilde sarmalayın:
+
+```json5 fileName="package.json"
+{
+  "scripts": {
+    // ... diğer scriptler
+    "dev": "npx intlayer live --with 'next dev'",
+    // "dev": "npx intlayer live --with 'vite dev'", // Vite için
+  },
+}
+```
+
+Optimizasyonu etkinleştirin, böylece Intlayer geliştirme sırasında Live import dönüşümlerini uygular:
+
+```typescript fileName="intlayer.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
+import type { IntlayerConfig } from "intlayer";
+
+const config: IntlayerConfig = {
+  editor: {
+    applicationURL: "http://localhost:5173",
+    liveSyncURL: "http://localhost:4000",
+    liveSync: true,
+  },
+  dictionary: {
+    importMode: "fetch",
+  },
+  build: {
+    optimize: true,
+  },
+};
+
+export default config;
+```
+
+Bu yapılandırma, geliştirme sunucunuzu Live Sync sunucusuyla sarar, başlangıçta uzak sözlükleri getirir ve CMS'den SSE aracılığıyla güncellemeleri aktarır. Değişiklikleri görmek için sayfayı yenileyin.
+
+## Notlar ve kısıtlamalar
+
+- Live sync kaynağını site güvenlik politikanıza (CSP) ekleyin. Live sync URL'sinin `connect-src` içinde (ve ilgili ise `frame-ancestors` içinde) izinli olduğundan emin olun.
+- Live Sync statik çıktı ile çalışmaz. Next.js için, sayfa çalışma zamanında güncellemeleri alabilmek için dinamik olmalıdır (örneğin, tam statik kısıtlamalardan kaçınmak için `generateStaticParams`, `generateMetadata`, `getServerSideProps` veya `getStaticProps` uygun şekilde kullanılmalıdır).
+- CMS'de, her sözlüğün bir `live` bayrağı vardır. Yalnızca `live=true` olan sözlükler live sync API'si aracılığıyla alınır; diğerleri dinamik olarak içe aktarılır ve çalışma zamanında değişmeden kalır.
+- `live` bayrağı her sözlük için build zamanında değerlendirilir. Uzaktaki içerik derleme sırasında `live=true` olarak işaretlenmemişse, o sözlük için Live Sync'i etkinleştirmek üzere yeniden derleme yapmanız gerekir.
+- Live sync sunucusunun `.intlayer` dosyasına yazabilmesi gerekir. Konteynerlerde, `/.intlayer` dosyasına yazma erişiminin olduğundan emin olun.
+
+## Faydalı bağlantılar
+
+- [Intlayer CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/intlayer_CMS.md)
+- [Intlayer Görsel Düzenleyici](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/intlayer_visual_editor.md)
+- [Yapılandırma Referansı](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/configuration.md)
+- [Kendi Sunucuda Barındırma Kılavuzu](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/self_hosting.md)