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

package/docs/ru/self_hosting.md

@@ -0,0 +1,349 @@
+---
+createdAt: 2026-06-30
+updatedAt: 2026-06-30
+title: Самостоятельный хостинг Intlayer
+description: Запустите полноценный экземпляр Intlayer на собственной инфраструктуре с помощью одной команды. Аккаунт Intlayer Cloud не требуется.
+keywords:
+  - Самостоятельный хостинг
+  - Docker
+  - Docker Compose
+  - Intlayer
+  - CMS
+  - Установка
+  - Инфраструктура
+slugs:
+  - doc
+  - self-hosting
+author: aymericzip
+---
+
+# Самостоятельный хостинг Intlayer
+
+Intlayer может полностью работать на вашей собственной инфраструктуре — аккаунт Intlayer Cloud не требуется. Одна команда запускает готовый к production стек:
+
+```sh
+curl -fsSL https://intlayer.org/install.sh | sh
+```
+
+Установщик загружает `docker-compose.yml` и `.env`, автоматически генерирует необходимые секреты и запускает все контейнеры с помощью `docker compose up -d`.
+
+## Оглавление
+
+<TOC/>
+
+---
+
+## Архитектура
+
+```
+                ┌─────────────────────────────┐
+ браузер ──────▶ │ приложение  (TanStack Start)  :3000│ ──┐
+                └─────────────────────────────┘   │ VITE_BACKEND_URL
+                ┌─────────────────────────────┐   │
+                │  бэкенд (Fastify/Bun)  :3100│ ◀─┘
+                └──────────────┬──────────────┘
+          ┌──────────┬─────────┼──────────┬───────────┐
+          ▼          ▼         ▼          ▼           ▼
+     mongo:27017  redis:6379  minio:9000  mailpit:1025  Chromium
+     (RS из 1 узла)          (API S3)     (SMTP)        (в образе)
+                             minio:9001   mailpit:8025
+                             (консоль)    (веб-интерфейс)
+```
+
+Chromium (используемый для генерации скриншотов Puppeteer) включен в образ бэкенда — отдельный контейнер не требуется.
+
+---
+
+## Предварительные требования
+
+- **Docker** ≥ 24 и **Docker Compose** ≥ v2. Если что-либо из этого отсутствует, установщик выведет ссылку для установки и завершит работу.
+- Порты `3000`, `3100`, `8025`, `9000` и `9001` должны быть доступны на хосте.
+- Хост на Linux или macOS (или WSL2 на Windows).
+
+---
+
+## Быстрый старт
+
+```sh
+curl -fsSL https://intlayer.org/install.sh | sh
+```
+
+Что делает установщик:
+
+1.  Проверяет наличие `docker` и `docker compose`.
+2.  Загружает `docker-compose.yml` и `.env.example` в `./intlayer/`.
+3.  Если файл `.env` отсутствует, копирует пример и генерирует случайные секреты для `BETTER_AUTH_SECRET`, `S3_ACCESS_KEY_ID` и `S3_SECRET_ACCESS_KEY` с помощью `openssl rand`.
+4.  Запускает `docker compose pull` + `docker compose up -d`.
+5.  Выводит URL: панель управления `:3000`, API `:3100`, интерфейс электронной почты `:8025`, консоль MinIO `:9001`.
+
+После запуска стека откройте **http://localhost:3000** и создайте свою первую учетную запись.
+
+---
+
+## Сервисы
+
+| Сервис      | Образ                                 | Порт(ы) хоста                         | Назначение                                                        |
+| ----------- | ------------------------------------- | ------------------------------------- | ----------------------------------------------------------------- |
+| **app**     | построен из `apps/app/Dockerfile`     | `3000`                                | Панель управления TanStack Start (пользовательский интерфейс CMS) |
+| **backend** | построен из `apps/backend/Dockerfile` | `3100`                                | REST API Fastify (эндпоинт `/health`)                             |
+| **mongo**   | `mongo:7`                             | внутренний                            | Репликационный набор из одного узла (`rs0`)                       |
+| **redis**   | `redis:7-alpine`                      | внутренний                            | Очереди заданий (BullMQ) и кеширование (ioredis)                  |
+| **minio**   | `minio/minio`                         | `9000` (S3), `9001` (консоль)         | S3-совместимое объектное хранилище для аватаров и скриншотов      |
+| **mailpit** | `axllent/mailpit`                     | `1025` (SMTP), `8025` (веб-интерфейс) | Локальный приемник транзакционных электронных писем               |
+
+Внутренние порты (mongo, redis) по умолчанию не открыты на хосте.
+
+> Порт MinIO `9000` должен быть доступен из браузера, поскольку загруженные активы (аватары, скриншоты) загружаются непосредственно из `S3_PUBLIC_URL=http://localhost:9000/intlayer`.
+
+---
+
+## Переменные окружения
+
+Установщик генерирует готовый к использованию файл `.env`. В таблице ниже описана каждая переменная.
+
+### Обязательные (автоматически генерируемые или запрашиваемые)
+
+| Переменная             | Пример                                          | Описание                                                    |
+| ---------------------- | ----------------------------------------------- | ----------------------------------------------------------- |
+| `NODE_ENV`             | `production`                                    | Среда выполнения                                            |
+| `PORT`                 | `3100`                                          | Порт прослушивания бэкенда                                  |
+| `BACKEND_URL`          | `http://localhost:3100`                         | Публичный URL API бэкенда                                   |
+| `APP_URL`              | `http://localhost:3000`                         | Публичный URL панели управления                             |
+| `DOMAIN`               | `localhost`                                     | Домен для файлов cookie                                     |
+| `MONGODB_URI`          | `mongodb://mongo:27017/intlayer?replicaSet=rs0` | Полный URI для подключения к MongoDB                        |
+| `REDIS_URL`            | `redis://redis:6379`                            | URL для подключения к Redis                                 |
+| `BETTER_AUTH_SECRET`   | _(сгенерирован)_                                | 32-байтный секрет для подписи сессий                        |
+| `MAIL_PROVIDER`        | `smtp`                                          | Транспорт для почты: `smtp` или `resend`                    |
+| `MAIL_SMTP_HOST`       | `mailpit`                                       | Имя хоста SMTP (имя контейнера Mailpit)                     |
+| `MAIL_SMTP_PORT`       | `1025`                                          | Порт SMTP                                                   |
+| `MAIL_FROM`            | `Intlayer <no-reply@localhost>`                 | Адрес отправителя                                           |
+| `S3_ENDPOINT`          | `http://minio:9000`                             | S3-совместимый эндпоинт                                     |
+| `S3_PUBLIC_URL`        | `http://localhost:9000/intlayer`                | Публичный URL для загрузки активов браузером                |
+| `S3_BUCKET_NAME`       | `intlayer`                                      | Имя корзины                                                 |
+| `S3_ACCESS_KEY_ID`     | _(сгенерирован)_                                | Ключ доступа MinIO                                          |
+| `S3_SECRET_ACCESS_KEY` | _(сгенерирован)_                                | Секретный ключ MinIO                                        |
+| `VITE_BACKEND_URL`     | `http://localhost:3100`                         | URL бэкенда, встроенный в панель управления во время сборки |
+| `VITE_DOMAIN`          | `localhost`                                     | Домен, встроенный в панель управления во время сборки       |
+
+### Необязательные (функции работают с ограничениями, если отсутствуют)
+
+| Переменная                                               | Функция                                                                                   |
+| -------------------------------------------------------- | ----------------------------------------------------------------------------------------- |
+| `OPENAI_API_KEY`                                         | Перевод и аудит контента с помощью ИИ                                                     |
+| `STRIPE_SECRET_KEY`, `STRIPE_WEBHOOK_SECRET`, `STRIPE_*` | Управление счетами и подписками                                                           |
+| `RESEND_API_KEY`                                         | Транзакционные электронные письма через Resend (переопределяет Mailpit, если установлено) |
+| `GITHUB_CLIENT_ID`, `GITHUB_CLIENT_SECRET`               | Вход через GitHub OAuth                                                                   |
+| `GOOGLE_CLIENT_ID`, `GOOGLE_CLIENT_SECRET`               | Вход через Google OAuth                                                                   |
+| `GITLAB_CLIENT_ID`, `GITLAB_CLIENT_SECRET`               | Вход через GitLab OAuth                                                                   |
+| `MICROSOFT_CLIENT_ID`, `MICROSOFT_CLIENT_SECRET`         | Вход через Microsoft OAuth                                                                |
+| `LINKEDIN_CLIENT_ID`, `LINKEDIN_CLIENT_SECRET`           | Вход через LinkedIn OAuth                                                                 |
+| `ATLASSIAN_CLIENT_ID`, `ATLASSIAN_CLIENT_SECRET`         | Вход через Atlassian OAuth                                                                |
+
+---
+
+## Подключение вашего проекта Intlayer
+
+После запуска стека направьте свой проект на самохостинговый бэкенд и панель управления вместо `intlayer.org`.
+
+### Конфигурация проекта
+
+```typescript fileName="intlayer.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
+import type { IntlayerConfig } from "intlayer";
+
+const config: IntlayerConfig = {
+  editor: {
+    clientId: process.env.INTLAYER_CLIENT_ID,
+    clientSecret: process.env.INTLAYER_CLIENT_SECRET,
+
+    /**
+     * URL самохостинговой панели управления CMS.
+     * По умолчанию: https://app.intlayer.org
+     */
+    cmsURL: process.env.INTLAYER_CMS_URL, // e.g. http://localhost:3000
+
+    /**
+     * URL самохостингового API бэкенда.
+     * По умолчанию: https://back.intlayer.org
+     */
+    backendURL: process.env.INTLAYER_BACKEND_URL, // e.g. http://localhost:3100
+  },
+};
+
+export default config;
+```
+
+Установите переменные окружения в файле `.env` вашего проекта:
+
+```sh
+INTLAYER_CMS_URL=http://localhost:3000
+INTLAYER_BACKEND_URL=http://localhost:3100
+INTLAYER_CLIENT_ID=<your-client-id>
+INTLAYER_CLIENT_SECRET=<your-client-secret>
+```
+
+Создайте учетные данные доступа на вашей самохостинговой панели управления в разделе **Проекты → Ключи доступа** по адресу `http://localhost:3000/projects`.
+
+### SDK `@intlayer/api`
+
+При программном использовании SDK `@intlayer/api` явно передайте `backendURL`:
+
+```typescript fileName="cms.ts" codeFormat="typescript"
+import { createIntlayerCMS } from "@intlayer/api";
+import { dictionaryEndpoint } from "@intlayer/api/dictionary";
+
+const cms = createIntlayerCMS({
+  editor: {
+    clientId: process.env.INTLAYER_CLIENT_ID,
+    clientSecret: process.env.INTLAYER_CLIENT_SECRET,
+    backendURL: process.env.INTLAYER_BACKEND_URL, // http://localhost:3100
+  },
+});
+
+const { data: dictionaries } = await dictionaryEndpoint(cms).getDictionaries();
+```
+
+---
+
+## Обновление
+
+Повторный запуск установщика на существующем развертывании выполняет скользящее обновление:
+
+```sh
+curl -fsSL https://intlayer.org/install.sh | sh
+```
+
+Это загружает последние образы и перезапускает контейнеры с помощью `docker compose pull && docker compose up -d`. Существующие тома (`mongo-data`, `redis-data`, `minio-data`) сохраняются — потери данных нет.
+
+Для обновления вручную из директории `./intlayer/`:
+
+```sh
+docker compose pull
+docker compose up -d
+```
+
+---
+
+## Резервное копирование и восстановление
+
+Все постоянные данные хранятся в трех именованных томах Docker.
+
+### Резервное копирование
+
+```sh
+docker run --rm \
+  -v intlayer_mongo-data:/data \
+  -v "$(pwd)":/backup \
+  busybox tar czf /backup/mongo-data.tar.gz /data
+
+docker run --rm \
+  -v intlayer_redis-data:/data \
+  -v "$(pwd)":/backup \
+  busybox tar czf /backup/redis-data.tar.gz /data
+
+docker run --rm \
+  -v intlayer_minio-data:/data \
+  -v "$(pwd)":/backup \
+  busybox tar czf /backup/minio-data.tar.gz /data
+```
+
+### Восстановление
+
+```sh
+docker run --rm \
+  -v intlayer_mongo-data:/data \
+  -v "$(pwd)":/backup \
+  busybox tar xzf /backup/mongo-data.tar.gz -C /
+
+# Повторите для redis-data и minio-data
+```
+
+---
+
+## Использование обратного прокси (Nginx / Caddy)
+
+Для production развертываний разместите обратный прокси перед контейнерами приложения и бэкенда вместо того, чтобы открывать их напрямую.
+
+### Пример Nginx
+
+```nginx
+server {
+    listen 80;
+    server_name cms.example.com;
+
+    location / {
+        proxy_pass http://localhost:3000;
+        proxy_set_header Host $host;
+        proxy_set_header X-Real-IP $remote_addr;
+    }
+}
+
+server {
+    listen 80;
+    server_name api.example.com;
+
+    location / {
+        proxy_pass http://localhost:3100;
+        proxy_set_header Host $host;
+        proxy_set_header X-Real-IP $remote_addr;
+    }
+}
+```
+
+Обновите следующие переменные `.env`, чтобы они соответствовали вашим публичным доменам:
+
+```sh
+BACKEND_URL=https://api.example.com
+APP_URL=https://cms.example.com
+DOMAIN=example.com
+VITE_BACKEND_URL=https://api.example.com
+VITE_DOMAIN=example.com
+```
+
+> Переменные `VITE_*` встраиваются в образ панели управления во время сборки. Если вы измените их после сборки образа, вам потребуется пересобрать образ `app` (`docker compose build app`) или использовать инъекцию runtime-конфигурации.
+
+---
+
+## Устранение неполадок
+
+### Бэкенд циклически перезапускается при первом запуске
+
+MongoDB и Redis должны быть работоспособны до запуска бэкенда. Файл compose использует `depends_on` с `condition: service_healthy`. Если вы видите повторяющиеся перезапуски бэкенда, убедитесь, что проверки работоспособности `mongo` и `redis` проходят:
+
+```sh
+docker compose ps
+docker compose logs mongo
+docker compose logs redis
+```
+
+### Панель управления не может связаться с API
+
+Убедитесь, что `VITE_BACKEND_URL` соответствует URL, по которому бэкенд доступен из **браузера** (а не из сети Docker). Если вы изменили порт бэкенда или добавили обратный прокси, пересоберите образ панели управления:
+
+```sh
+docker compose build app
+docker compose up -d app
+```
+
+### Электронные письма не отправляются
+
+По умолчанию вся исходящая почта перехватывается Mailpit. Откройте `http://localhost:8025`, чтобы увидеть отправленные сообщения. Для отправки реальных писем установите `MAIL_PROVIDER=resend` и `RESEND_API_KEY=<your-key>` в `.env`, затем перезапустите бэкенд:
+
+```sh
+docker compose restart backend
+```
+
+### Отсутствует корзина MinIO
+
+Если одноразовый сервис `minio-init` не запустился (или запустился до того, как MinIO был готов), создайте корзину вручную:
+
+```sh
+docker compose run --rm minio-init
+```
+
+---
+
+## Полезные ссылки
+
+- [Документация Intlayer CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_CMS.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#programmatic-access-with-the-intlayerapi-sdk)

package/docs/tr/CI_CD.md

@@ -26,6 +26,10 @@ author: aymericzip
 
 Intlayer, içerik bildirim dosyalarınız için çevirilerin otomatik olarak oluşturulmasına izin verir. İş akışınıza bağlı olarak bunu başarmanın birden fazla yolu vardır.
 
+## İçindekiler
+
+<TOC/>
+
 ## CMS Kullanarak
 
 Intlayer ile, sadece tek bir yerel ayar yerel olarak bildirilirken, tüm çevirilerin CMS aracılığıyla uzaktan yönetildiği bir iş akışı benimseyebilirsiniz. Bu, içerik ve çevirileri kod tabanından tamamen ayırmaya izin verir, içerik editörleri için daha fazla esneklik sunar ve sıcak içerik yeniden yüklemesini etkinleştirir (değişiklikleri uygulamak için uygulamayı yeniden oluşturmaya gerek yoktur).

package/docs/tr/autoFill.md

@@ -28,6 +28,53 @@ history:
 author: aymericzip
 ---
 
+# İçerik Bildirim Dosyası Çevirilerini Doldur
+
+**İçerik bildirim dosyalarını otomatik doldur**, CI'nizde geliştirme iş akışınızı hızlandırmanın bir yoludur.
+
+## Davranışı Anlamak
+
+`fill` komutu iki moda sahiptir:
+
+- **Complete**: Her yerel ayar için tüm eksik içeriği otomatik olarak doldurur ve geçerli dosyayı veya belirtilmişse başka bir dosyayı düzenler. Yani, complete modu, zaten çevrilen varsa mevcut içeriğin çevirisini atlar.
+- **Review**: Her yerel ayar için **tüm** içeriği otomatik olarak doldurur ve belirli bir dosya için veya belirtilmişse başka bir dosya için oluşturur.
+
+`fill` komutu tüm yerel ayar içeriği bildirimi dosyalarınızı işleyecektir. Yani, CMS'den uzak içeriğinizi işlemeyecektir. CMS'nin kendi çevirileri yönetimi vardır.
+`@intlayer/sync-json-plugin` gibi eklentileri kullanıyorsanız, Intlayer JSON dosyalarını yerel ayar içeriği bildirimi dosyalarına dönüştürecektir. Yani, `fill` komutu tarafından işleneceklerdir.
+
+Yeni oluşturulan dosyalar, sözlük metaverisi olarak `filled` talimatını içerir. Bu talimat, Intlayer tarafından dosyanın otomatik olarak doldurulup doldurulmadığını bilmek için kullanılır ve varsa bu dosyayı tekrar çevirilmekten atlar.
+
+Intlayer ayrıca otomatik doldurma için aşağıdaki talimatı dikkate alacaktır:
+
+- `.content.{ts|js|json}` dosyanızdan → `fill` talimatı
+- `.intlayer.config.ts` yapılandırma dosyanızdan → `dictionary.fill` talimatı
+- Aksi takdirde varsayılan olarak `true` olarak ayarlanır
+
+Yerel ayara özgü içerik bildirimi dosyaları için, `true` talimatı `./{{fileName}}.fill.content.json` ile değiştirilecektir. Bunun nedeni, yerel ayara özgü bir içerik bildirimi dosyasının ek yerelleştirilmiş içerik alamamasıdır. Yani, mevcut dosyayı üzerine yazmamak için yeni bir dosya oluşturacaktır.
+
+## Varsayılan Davranış
+
+Varsayılan olarak, `fill` global olarak `true` olarak ayarlanır, bu da Intlayer'ın tüm içerik dosyalarını otomatik olarak dolduracağı ve dosyanın kendisini düzenleyeceği anlamına gelir. Bu davranış çeşitli şekillerde özelleştirilebilir:
+
+### Genel Yapılandırma Seçenekleri
+
+1. **`fill: true` (default)** - Tüm locales'i otomatik olarak doldur ve mevcut dosyayı düzenle
+2. **`fill: false`** - Bu content dosyası için auto-fill'i devre dışı bırak
+3. **`fill: "./relative/path/to/file"`** - Mevcut dosyayı düzenlemeden belirtilen dosyayı oluştur/güncelle ve mevcut dosyanın konumuna göre çözümlenen göreli yola işaret et
+4. **`fill: "/absolute/path/to/file"`** - Mevcut dosyayı düzenlemeden belirtilen dosyayı oluştur/güncelle ve `.intlayer.config.ts` yapılandırma dosyasındaki base directory konumuna (`baseDir` alanı) göre çözümlenen yola işaret et
+5. **`fill: "C:\\absolute\path\to\file"`** - Mevcut dosyayı düzenlemeden belirtilen dosyayı oluştur/güncelle ve işletim sisteminize göre çözümlenen mutlak yola işaret et
+6. **`fill: { [key in Locales]?: string }`** - Her locale için belirtilen dosyayı oluştur/güncelle
+
+### v7 Davranış Değişiklikleri
+
+v7'de, `fill` komutunun davranışı güncellenmiştir:
+
+- **`fill: true`** - Geçerli dosyayı tüm diller için doldurulmuş içerikle yeniden yazar
+- **`fill: "path/to/file"`** - Belirtilen dosyayı geçerli dosyayı değiştirmeden doldurur
+- **`fill: false`** - Otomatik doldurmayı tamamen devre dışı bırakır
+
+Başka bir dosyaya yazmak için bir yol seçeneği kullanırken, doldurma mekanizması içerik deklarasyon dosyaları arasında _ana-köle_ ilişkisi aracılığıyla çalışır. Ana (master) dosya gerçeğin kaynağı olarak hizmet eder ve güncellendiğinde, Intlayer bu değişiklikleri otomatik olarak yol tarafından belirtilen türetilmiş (doldurulmuş) deklarasyon dosyalarına uygular.
+
 # Otomatik Doldurma İçerik Beyan Dosyası Çevirileri
 
 **Otomatik doldurma içerik beyan dosyaları**, geliştirme iş akışınızı hızlandırmanın bir yoludur.
@@ -88,6 +135,40 @@ Intlayer, ana dosyada henüz beyan edilmemiş tüm yerelleri doldurarak, türeti
 
 Daha sonra, her iki beyan dosyası tek bir sözlükte birleştirilecek ve standart `useIntlayer("example")` hook'u (react) / composable'ı (vue) kullanılarak erişilebilir olacaktır.
 
+## Genel Konfigürasyon
+
+`intlayer.config.ts` dosyasında genel otomatik doldurma konfigürasyonunu yapılandırabilirsiniz.
+
+```ts fileName="intlayer.config.ts"
+import { type IntlayerConfig, Locales } from "intlayer";
+
+const config: IntlayerConfig = {
+  internationalization: {
+    locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],
+    defaultLocale: Locales.ENGLISH,
+    requiredLocales: [Locales.ENGLISH, Locales.FRENCH],
+  },
+  dictionary: {
+    // Tüm sözlükler için eksik çevirileri otomatik oluştur
+    fill: "./{{fileName}}Filled.content.ts",
+    //
+    // fill: "/messages/{{locale}}/{{key}}/{{fileName}}.content.json",
+    //
+    // fill: true, // "./{{fileName}}.content.json" kullanarak tüm sözlükler için eksik çevirileri otomatik oluştur
+    //
+    // fill: {
+    //   en: "./{{fileName}}.en.content.json",
+    //   fr: "./{{fileName}}.fr.content.json",
+    //   es: "./{{fileName}}.es.content.json",
+    // },
+  },
+};
+
+export default config;
+```
+
+İçerik dosyalarında `fill` alanını kullanarak her sözlük için ince ayar yapabilirsiniz. Intlayer önce sözlük başına konfigürasyonu dikkate alır, ardından genel konfigürasyona geri döner.
+
 ## Otomatik Doldurulmuş Dosya Formatı
 
 Önerilen otomatik doldurulmuş beyan dosyalarının formatı, biçimlendirme kısıtlamalarından kaçınmaya yardımcı olan **JSON** formatıdır. Ancak, Intlayer `.ts`, `.js`, `.mjs`, `.cjs` ve diğer formatları da destekler.

package/docs/tr/benchmark/solid.md

@@ -118,6 +118,28 @@ Framework, **10 sayfa** ve **10 dilden** oluşan çok dilli bir uygulamaya sahip
 - **Scoped static**: Karmaşık ek ağ istekleri olmadan kodu düzenli tutar (mantıksal ayrım).
 - **Scoped dynamic**: _Kod bölme_ ve performans için en iyi yaklaşım. Yalnızca geçerli görünüm ve aktif dil için gerekenleri yükleyerek belleği minimize eder.
 
+### Ölçtüklerim:
+
+Aynı çok dilli uygulamayı her stack için gerçek bir tarayıcıda çalıştırdım, ardından tel üzerinde tam olarak ne göründüğünü ve işlerin ne kadar sürdüğünü not ettim. Boyutlar **normal web sıkıştırmasından sonra** rapor edilir, çünkü bu ham kaynak sayılarından daha çok insanların indirdiklerine yakındır.
+
+- **Internationalization kütüphanesi boyutu**: Bundling, tree-shaking ve minification işleminden sonra, i18n kütüphanesinin boyutu, boş bir bileşendeki sağlayıcılar + hooks/primitives kodunun boyutudur. Çeviri dosyalarının yüklenmesini içermez. Kütüphanenin içeriğiniz devreye girmeden önceki maliyetinin ne olduğunu yanıtlar.
+
+- **Sayfa başına JavaScript**: Her benchmark rotası için, tarayıcının bu ziyaret için çektiği betik miktarı, paketteki sayfalar (ve rapor onları topladığında yerel ayarlar) arasında ortalanmıştır. Ağır sayfalar yavaş sayfalardır.
+
+- **Diğer yerel ayarlardan sızıntı**: Denetlenen sayfada yanlışlıkla yüklenebilecek başka bir dilde aynı sayfanın içeriğidir. Bu içerik gereksizdir ve kaçınılmalıdır. (ör. `/fr/about` sayfa içeriği `/en/about` sayfa paketinde)
+
+- **Diğer rotalardan sızıntı**: Aynı fikir **uygulamadaki diğer ekranlar** için: sadece bir sayfayı açarken kopyalarının birlikte gidip gitmediği. (ör. `/en/about` sayfa içeriği `/en/contact` sayfa paketinde). Yüksek bir skor zayıf bölme veya çok geniş paketler hinting.
+
+- **Ortalama bileşen paketi boyutu**: Ortak UI parçaları **birer birer** ölçülür, bir dev app numarasının içinde gizlenmek yerine. Internationalization'ın sessizce günlük bileşenleri şişirip şişirmediğini gösterir. Örneğin, bileşeniniz yeniden render edilirse, bellekten tüm bu verileri yükleyecektir. Herhangi bir bileşene bir dev JSON bağlamak, bileşenlerinizin performansını yavaşlatacak kullanılmayan verilerin büyük bir deposunu bağlamak gibidir.
+
+- **Dil değiştirme duyarlılığı**: Uygulamanın kendi kontrolünü kullanarak dili çeviririm ve sayfanın açıkça değiştiği, bir ziyaretçinin fark edeceği, laboratuvar mikro adımı değil ne kadar sürdüğünü ölçerim.
+
+- **Dil değişikliğinden sonraki işleme çalışması**: Dar bir takip: arayüzün geçiş uçuşta iken yeni dil için yeniden boyamak için ne kadar çaba gerektiği. "Hissedilen" zaman ve çerçeve maliyeti farklılık gösterdiğinde yararlı.
+
+- **İlk sayfa yükleme zamanı**: Tarayıcının test ettiğim senaryolar için sayfayı tamamen yüklenmiş olarak görene kadar navigasyon. Soğuk başlangıçları karşılaştırmak için iyi.
+
+- **Rehidrasyon zamanı**: Uygulama bunu gösterdiğinde, istemcinin sunucu HTML'sini gerçekten tıklayabileceğiniz bir şeye dönüştürmek için harcadığı zaman. Tablolardaki bir çizgi, bu uygulamanın bu benchmark'ta güvenilir bir rehidrasyon şekli sağlamadığı anlamına gelir.
+
 ## GitHub Yıldızları
 
 GitHub yıldızları, bir projenin popülerliğinin, topluluk güveninin ve uzun vadeli alakasının güçlü bir göstergesidir. Teknik kalitenin doğrudan bir ölçüsü olmasa da, kaç geliştiricinin projeyi yararlı bulduğunu, ilerlemesini takip ettiğini ve benimseme olasılığını yansıtır. Bir projenin değerini tahmin etmek için yıldızlar, alternatifler arasındaki çekişi karşılaştırmaya yardımcı olur ve ekosistem büyümesi hakkında içgörüler sağlar.

package/docs/tr/benchmark/svelte.md

@@ -116,6 +116,28 @@ Framework, **10 sayfa** ve **10 dilden** oluşan çok dilli bir uygulamaya sahip
 - **Scoped static**: Karmaşık ek ağ istekleri olmadan kodu düzenli tutar (mantıksal ayrım).
 - **Scoped dynamic**: _Kod bölme_ ve performans için en iyi yaklaşım. Yalnızca geçerli görünüm ve aktif dil için gerekenleri yükleyerek belleği minimize eder.
 
+### Ölçtüğüm şeyler:
+
+Aynı çok dilli uygulamayı her stack için gerçek bir tarayıcıda çalıştırdım, ardından tel üzerinde gerçekten ne göründüğünü ve ne kadar sürdüğünü not ettim. Boyutlar **normal web sıkıştırmasından sonra** raporlanır, çünkü bu ham kaynak sayılarından daha yakın olduğu insanları indir.
+
+- **Uluslararasılaştırma kitaplığı boyutu**: Bundling, tree-shaking ve minification sonrasında, i18n kitaplığının boyutu, sağlayıcılar + boş bir bileşendeki kod depolama boyutudur. Çeviri dosyalarının yüklenmesini içermez. Bu, içeriğiniz resme girmeden önce kitaplığın ne kadar pahalı olduğunu yanıtlar.
+
+- **Sayfa başına JavaScript**: Her benchmark rotası için, tarayıcının bu ziyaret için ne kadar script çektiği, paketteki sayfalar arasında ortalaması alınmıştır (ve rapor onları topladığında yerel ayarlar arasında). Ağır sayfalar yavaş sayfalar.
+
+- **Diğer yerel ayarlardan sızıntı**: Denetlenen sayfaya yanlışlıkla yüklenecek aynı sayfanın başka bir dildeki içeriğidir. Bu içerik gereksizdir ve kaçınılmalıdır. (örn. `/fr/about` sayfa içeriği `/en/about` sayfa paketinde)
+
+- **Diğer rotalardan sızıntı**: Aynı fikir **uygulamadaki diğer ekranlar** için: yalnızca bir sayfa açtığınızda kopyalarının eşlik edip etmediği. (örn. `/en/about` sayfa içeriği `/en/contact` sayfa paketinde). Yüksek bir puan, zayıf bölme veya çok geniş paketleri işaret eder.
+
+- **Ortalama bileşen paket boyutu**: Ortak kullanıcı arayüzü parçaları, bir dev uygulama numarası içinde gizlenmek yerine **tek tek** ölçülür. Uluslararasılaştırmanın günlük bileşenleri sessizce şişirip şişirmediğini gösterir. Örneğin, bileşeniniz yeniden işlenirse, bellek içinden tüm bu verileri yükleyecektir. Herhangi bir bileşene devasa bir JSON eklemek, bileşenlerinizin performansını yavaşlatacak kullanılmayan büyük bir veri deposunu bağlamak gibidir.
+
+- **Dil değiştirme yanıt hızı**: Uygulamanın kendi denetimini kullanarak dili değiştiririm ve sayfa açıkça değişinceye kadar ne kadar sürdüğünü ölçerim, ziyaretçinin fark edeceği şey, laboratuvar mikro adımı değil.
+
+- **Dil değişikliğinden sonra işleme çalışması**: Daha dar bir takip: dil değişimi uçuş halinde olduktan sonra arayüzün yeni dili yeniden boyamak için ne kadar çaba harcadığı. "Hissedilen" süre ve çerçeve maliyeti farklılaştığında kullanışlıdır.
+
+- **İlk sayfa yükleme süresi**: Gezintiden tarayıcıya test ettiğim senaryolar için sayfanın tamamen yüklenmiş olarak kabul etmesine kadar. Soğuk başlangıçları karşılaştırmak için iyi.
+
+- **Hidrasyon süresi**: Uygulama bunu ortaya çıkardığında, istemcinin sunucu HTML'sini gerçekten tıklayabileceğiniz bir şeye dönüştürmede harcadığı süre. Tablolardaki bir tire, bu uygulamanın bu kıyaslama da güvenilir bir hidrasyon rakamı sağlamadığı anlamına gelir.
+
 ## GitHub Yıldızları
 
 GitHub yıldızları, bir projenin popülerliğinin, topluluk güveninin ve uzun vadeli alakasının güçlü bir göstergesidir. Teknik kalitenin doğrudan bir ölçüsü olmasa da, kaç geliştiricinin projeyi yararlı bulduğunu, ilerlemesini takip ettiğini ve benimseme olasılığını yansıtır. Bir projenin değerini tahmin etmek için yıldızlar, alternatifler arasındaki çekişi karşılaştırmaya yardımcı olur ve ekosistem büyümesi hakkında içgörüler sağlar.

package/docs/tr/benchmark/tanstack.md

@@ -124,6 +124,28 @@ Framework, **10 sayfa** ve **10 dilden** oluşan çok dilli bir uygulamaya sahip
 - **Scoped static**: Karmaşık ek ağ istekleri olmadan kodu düzenli tutar (mantıksal ayrım).
 - **Scoped dynamic**: Kod bölme (code-splitting) ve performans için en iyi yaklaşım. Yalnızca geçerli görünümün ve aktif dilin ihtiyaç duyduğu şeyi yükleyerek bellek kullanımını en aza indirir.
 
+### Ne Ölçtüm:
+
+Aynı çok dilli uygulamayı her stack için gerçek bir tarayıcıda çalıştırdım ve ardından kabloda tam olarak ne göründüğünü ve işlerin ne kadar sürdüğünü yazdım. Boyutlar **normal web sıkıştırmasından sonra** raporlanmıştır, çünkü bu ham kaynak sayılarından daha insanların indirdiklerine yakındır.
+
+- **Uluslararasılaştırma kütüphanesi boyutu**: Paketleme, tree-shaking ve minifikasyondan sonra, i18n kütüphanesinin boyutu sağlayıcıların (örn. `NextIntlClientProvider`) + hook'ların (örn. `useTranslations`) boş bir bileşende yazılan kodunun boyutudur. Çeviri dosyalarının yüklenmesini içermez. Kütüphansenin içeriğiniz resme girmeden önce ne kadar pahalı olduğunu cevaplar.
+
+- **Sayfa başına JavaScript**: Her benchmark rotası için, tarayıcının bu ziyaret için çektiği betik miktarı, paketteki sayfaların genelinde (ve rapor bunları birleştirdiği localer arasında) ortalaması. Ağır sayfalar yavaş sayfalarıdır.
+
+- **Diğer localer'den sızıntı**: Denetlenen sayfada yanlışlıkla yüklenecek başka bir dilde aynı sayfanın içeriğidir. Bu içerik gereksizdir ve kaçınılmalıdır. (örn. `/en/about` sayfasında `/fr/about` sayfa içeriği paketi)
+
+- **Diğer rotalardan sızıntı**: Aynı fikir **uygulamadaki diğer ekranlar** için: yalnızca bir sayfa açtığınızda bunların kopyasının birlikte olup olmadığı. (örn. `/en/contact` sayfası paketinde `/en/about` sayfa içeriği). Yüksek bir puan zayıf bölme veya çok geniş paketleri gösterir.
+
+- **Ortalama bileşen paketi boyutu**: Ortak UI parçaları **birer birer** ölçülür, bir dev uygulama numarasının içinde gizlenmek yerine. Uluslararasılaştırmanın gündelik bileşenleri sessizce şişirip şişirmediğini gösterir. Örneğin, bileşeniniz yeniden oluşturursa, tüm bu verileri bellekten yükler. Herhangi bir bileşene dev bir JSON eklemek, bileşenlerinizin performansını yavaşlatacak kullanılmayan verilerin büyük bir deposuna bağlanmak gibidir.
+
+- **Dil değiştirme duyarlılığı**: Uygulamanın kendi kontrolünü kullanarak dili değiştirir ve sayfanın ne kadar sürede açıkça değiştiği, bir ziyaretçinin fark edeceği, bir laboratuvar mikro-adımı değil, zamanı kaydederim.
+
+- **Dil değişikliğinden sonra işleme çalışması**: Dar bir takip: yeni dil için değiştirme uçuştayken arabirim ne kadar yeniden boyamak için çaba harcadı. "Hissedilen" zaman ve çerçeve maliyeti farklı olduğunda yararlıdır.
+
+- **İlk sayfa yükleme süresi**: Gezintiden tarayıcıya test ettiğim senaryolar için sayfanın tamamen yüklenmiş olduğunu düşünüyor. Soğuk başlangıçları karşılaştırmak için iyidir.
+
+- **Hidrasyon süresi**: Uygulama bunu ortaya çıkardığında, istemcinin sunucu HTML'sini aslında tıklayabileceğiniz bir şeye dönüştürmek için harcadığı zaman. Tablolardaki bir tire, o uygulamanın bu kıyaslamada güvenilir bir hidrasyon rakamı sağlamadığı anlamına gelir.
+
 ## GitHub Yıldızları
 
 GitHub yıldızları, bir projenin popülerliğinin, topluluk güveninin ve uzun vadeli alakasının güçlü bir göstergesidir. Teknik kalitenin doğrudan bir ölçüsü olmasa da, kaç geliştiricinin projeyi yararlı bulduğunu, ilerlemesini takip ettiğini ve benimseme olasılığını yansıtır. Bir projenin değerini tahmin etmek için yıldızlar, alternatifler arasındaki çekişi karşılaştırmaya yardımcı olur ve ekosistem büyümesi hakkında içgörüler sağlar.

package/docs/tr/cli/ci.md

@@ -140,6 +140,28 @@ steps:
     run: npx intlayer ci fill
 ```
 
+## İskele Kurulu GitHub Actions
+
+`intlayer init` komutunu çalıştırdığınızda, Intlayer paket yöneticinizi (npm, yarn, pnpm veya bun) algılar ve `.github/workflows/` klasörü altında iki GitHub Actions iş akışı oluşturur; komutlar paket yöneticinizle eşleşir:
+
+- **`intlayer-fill.yml`** — Her pull request'te sözlükleri derler ve değiştirilen sözlükler için eksik çevirileri oluşturmak üzere `intlayer fill --git-diff --mode complete` komutunu çalıştırır, ardından sonucu PR dalına geri kaydeder.
+- **`intlayer-test.yml`** — Her pull request'te sözlükleri derler ve `intlayer test` komutunu çalıştırır; gerekli localelar çevirilerden yoksun olduğunda kontrolü başarısız kılar.
+
+Mevcut iş akışı dosyaları asla üzerine yazılmaz. İskele kurmayı tamamen atlamak için şu komutu çalıştırın:
+
+```bash
+npx intlayer init --no-github-actions
+```
+
+### Fill workflow'una AI erişimi sağlama
+
+Scaffold edilen `intlayer-fill.yml` AI erişimi gerektirir. İki seçenek mevcuttur (workflow'un `env` bloğunda yapılandırılır):
+
+1. **Kendi AI sağlayıcı anahtarınız** — Repository ayarlarınıza bir `AI_API_KEY` secret'i ekleyin (Settings → Secrets and variables → Actions). Workflow bunu `--provider`, `--model` ve `--api-key` aracılığıyla iletir.
+2. **Intlayer CMS erişim anahtarları** — `INTLAYER_CLIENT_ID` ve `INTLAYER_CLIENT_SECRET` secret'lerini ekleyin ve bunları `intlayer.config` dosyanızdaki `editor` bölümüne bağlayın. CMS erişim anahtarları Intlayer backend'i aracılığıyla AI erişimi sağlar.
+
+`intlayer-test.yml` workflow'u herhangi bir AI erişimi gerektirmez.
+
 ## Hata İşleme
 
 - `INTLAYER_PROJECT_CREDENTIALS` ayarlanmamışsa, komut bir hata ile çıkacaktır.