@intlayer/docs 7.5.10 → 7.5.12

package/docs/ru/plugins/sync-json.md

@@ -108,18 +108,22 @@ syncJSON({
   source: ({ key, locale }) => string, // обязательно
   location?: string, // необязательная метка, по умолчанию: "plugin"
   priority?: number, // необязательный приоритет для разрешения конфликтов, по умолчанию: 0
-  format?: 'intlayer' | 'icu' | 'i18next', // необязательный форматтер, по умолчанию: 'intlayer'
+  format?: 'intlayer' | 'icu' | 'i18next', // необязательный форматтер, используется для совместимости с runtime Intlayer
 });
 ```
 
 #### `format` ('intlayer' | 'icu' | 'i18next')
 
-Указывает форматтер, который будет использоваться для содержимого словаря при синхронизации JSON-файлов. Это позволяет использовать различные синтаксисы форматирования сообщений, совместимые с различными библиотеками i18n.
+Указывает форматтер, который будет использоваться для содержимого словаря при синхронизации JSON-файлов. Это позволяет использовать различные синтаксисы форматирования сообщений, совместимые с runtime Intlayer.
 
+- `undefined`: Форматтер не будет использоваться, содержимое JSON будет использоваться как есть.
 - `'intlayer'`: Форматтер Intlayer по умолчанию (по умолчанию).
 - `'icu'`: Использует форматирование сообщений ICU (совместимо с библиотеками, такими как react-intl, vue-i18n).
 - `'i18next'`: Использует форматирование сообщений i18next (совместимо с i18next, next-i18next, Solid-i18next).
 
+> Обратите внимание, что использование форматтера преобразует ваше содержимое JSON на входе и выходе. Для сложных правил JSON, таких как множественные числа ICU, парсинг может не гарантировать соответствие 1 к 1 между входом и выходом.
+> Если вы не используете runtime Intlayer, возможно, лучше не устанавливать форматтер.
+
 **Пример:**
 
 ```ts

package/docs/tr/cli/ci.md

@@ -0,0 +1,137 @@
+---
+createdAt: 2026-01-06
+updatedAt: 2026-01-06
+title: CI Komutu
+description: CI/CD pipeline'ları ve monorepo'larda otomatik olarak enjekte edilen kimlik bilgileriyle Intlayer komutlarını çalıştırmak için Intlayer CI komutunu nasıl kullanacağınızı öğrenin.
+keywords:
+  - CI
+  - CI/CD
+  - Otomasyon
+  - Monorepo
+  - Kimlik Bilgileri
+  - CLI
+  - Intlayer
+slugs:
+  - doc
+  - concept
+  - cli
+  - ci
+history:
+  - version: 7.5.11
+    date: 2026-01-06
+    changes: CI komutu ekle
+---
+
+# CI Komutu
+
+```bash
+npx intlayer ci <command...>
+```
+
+CI komutu otomasyon ve CI/CD pipeline'ları için tasarlanmıştır. `INTLAYER_PROJECT_CREDENTIALS` ortam değişkeninden kimlik bilgilerini otomatik olarak enjekte eder ve bir monorepo'daki birden fazla projede Intlayer komutlarını çalıştırabilir.
+
+## Nasıl çalışır
+
+CI komutu iki modda çalışır:
+
+1. **Tek Proje Modu**: Mevcut çalışma dizini `INTLAYER_PROJECT_CREDENTIALS` içindeki proje yollarından biriyle eşleşiyorsa, komutu yalnızca o belirli proje için çalıştırır.
+
+2. **Yineleme Modu**: Belirli bir proje bağlamı algılanmazsa, yapılandırılmış tüm projeler üzerinde yineler ve her biri için komutu çalıştırır.
+
+## Ortam Değişkeni
+
+Komut, `INTLAYER_PROJECT_CREDENTIALS` ortam değişkeninin ayarlanmış olmasını gerektirir. Bu değişken, proje yollarını kimlik bilgilerine eşleyen bir JSON nesnesi içermelidir:
+
+```json
+{
+  "packages/app": {
+    "clientId": "your-client-id-1",
+    "clientSecret": "your-client-secret-1"
+  },
+  "packages/admin": {
+    "clientId": "your-client-id-2",
+    "clientSecret": "your-client-secret-2"
+  }
+}
+```
+
+## Paket Yöneticisi Algılama
+
+CI komutu, `npm_config_user_agent` ortam değişkenine dayalı olarak hangi paket yöneticisinin kullanıldığını (npm, yarn, pnpm veya bun) otomatik olarak algılar ve Intlayer'ı çalıştırmak için uygun komutu kullanır.
+
+## Argümanlar
+
+- **`<command...>`**: Çalıştırılacak Intlayer komutu (örneğin, `fill`, `push`, `build`). Herhangi bir Intlayer komutunu ve argümanlarını iletebilirsiniz.
+
+  > Örnek: `npx intlayer ci fill --verbose`
+  >
+  > Örnek: `npx intlayer ci push`
+  >
+  > Örnek: `npx intlayer ci build`
+
+## Örnekler
+
+### Tek proje modunda komut çalıştırma
+
+`INTLAYER_PROJECT_CREDENTIALS` içindeki yollardan biriyle eşleşen bir proje dizinindeyken:
+
+```bash
+cd packages/app
+npx intlayer ci fill
+```
+
+Bu, `packages/app` projesi için kimlik bilgileri otomatik olarak enjekte edilerek `fill` komutunu çalıştıracaktır.
+
+### Tüm projelerde komut çalıştırma
+
+Herhangi bir proje yoluyla eşleşmeyen bir dizindeyken, komut yapılandırılmış tüm projeler üzerinde yineleyecektir:
+
+```bash
+cd /path/to/monorepo
+npx intlayer ci push
+```
+
+Bu, `INTLAYER_PROJECT_CREDENTIALS` içinde yapılandırılmış her proje için `push` komutunu çalıştıracaktır.
+
+### Ek bayraklar iletme
+
+Temel Intlayer komutuna herhangi bir bayrak iletebilirsiniz:
+
+```bash
+npx intlayer ci fill --verbose --mode complete
+```
+
+### CI/CD pipeline'larında kullanma
+
+CI/CD yapılandırmanızda (örneğin, GitHub Actions, GitLab CI), `INTLAYER_PROJECT_CREDENTIALS`'i bir sır olarak ayarlayın:
+
+```yaml
+# GitHub Actions örneği
+env:
+  INTLAYER_PROJECT_CREDENTIALS: ${{ secrets.INTLAYER_PROJECT_CREDENTIALS }}
+
+steps:
+  - name: Sözlükleri doldur
+    run: npx intlayer ci fill
+```
+
+## Hata İşleme
+
+- `INTLAYER_PROJECT_CREDENTIALS` ayarlanmamışsa, komut bir hata ile çıkacaktır.
+- `INTLAYER_PROJECT_CREDENTIALS` geçerli bir JSON değilse, komut bir hata ile çıkacaktır.
+- Bir proje yolu mevcut değilse, bir uyarı ile atlanacaktır.
+- Herhangi bir proje başarısız olursa, komut sıfır olmayan bir durum kodu ile çıkacaktır.
+
+## Kullanım Durumları
+
+- **Monorepo otomasyonu**: Bir monorepo'daki birden fazla projede Intlayer komutlarını çalıştırma
+- **CI/CD pipeline'ları**: Sürekli entegrasyon iş akışlarında sözlük yönetimini otomatikleştirme
+- **Toplu işlemler**: Birden fazla Intlayer projesinde aynı işlemi aynı anda gerçekleştirme
+- **Gizli yönetimi**: Ortam değişkenlerini kullanarak birden fazla proje için kimlik bilgilerini güvenli bir şekilde yönetme
+
+## Güvenlik En İyi Uygulamaları
+
+- `INTLAYER_PROJECT_CREDENTIALS`'i CI/CD platformunuzda şifrelenmiş sırlar olarak saklayın
+- Kimlik bilgilerini asla sürüm kontrolüne commit etmeyin
+- Farklı dağıtım ortamları için ortama özel kimlik bilgileri kullanın
+- Kimlik bilgilerini düzenli olarak döndürün

package/docs/tr/cli/index.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-11
-updatedAt: 2025-12-30
+updatedAt: 2026-01-06
 title: CLI
 description: Çok dilli web sitenizi yönetmek için Intlayer CLI'nın nasıl kullanılacağını keşfedin. Projenizi birkaç dakika içinde kurmak için bu çevrimiçi dokümantördeki adımları izleyin.
 keywords:
@@ -17,6 +17,9 @@ slugs:
   - concept
   - cli
 history:
+  - version: 7.5.11
+    date: 2026-01-06
+    changes: projects list komutu eklendi
   - version: 7.5.9
     date: 2025-12-30
     changes: init komutu eklendi
@@ -119,6 +122,7 @@ Mevcut yerellerin veya diğer parametrelerin nasıl yapılandırılacağını g
 - **[Sözlükleri Derle](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/cli/build.md)** - İçerik beyan dosyalarından sözlüklerinizi derleyin
 - **[Sözlükleri İzle](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/cli/watch.md)** - Değişiklikleri izleyin ve sözlükleri otomatik olarak derleyin
 - **[CLI Sürümünü Kontrol Et](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/cli/version.md)** - Yüklü Intlayer CLI sürümünü kontrol edin
+- **[Projeleri Listele](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/cli/list_projects.md)** - Bir dizindeki veya git deposundaki tüm Intlayer projelerini listeleyin
 
 ### Sözlük Yönetimi
 
@@ -166,6 +170,7 @@ Mevcut yerellerin veya diğer parametrelerin nasıl yapılandırılacağını g
   "intlayer:list": "npx intlayer content list",
   "intlayer:test": "npx intlayer content test",
   "intlayer:transform": "npx intlayer transform",
+  "intlayer:projects": "npx intlayer projects list",
   "intlayer:doc:translate": "npx intlayer doc translate",
   "intlayer:doc:review": "npx intlayer doc review"
 }
@@ -175,3 +180,4 @@ Mevcut yerellerin veya diğer parametrelerin nasıl yapılandırılacağını g
 >
 > - `npx intlayer list` yerine `npx intlayer content list`
 > - `npx intlayer test` yerine `npx intlayer content test`
+> - `npx intlayer projects-list` veya `npx intlayer pl` yerine `npx intlayer projects list`

package/docs/tr/cli/list.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-11
-updatedAt: 2025-11-22
+updatedAt: 2026-01-06
 title: İçerik Beyan Dosyalarını Listele
 description: Projenizdeki tüm içerik beyan dosyalarını nasıl listeleyeceğinizi öğrenin.
 keywords:
@@ -13,6 +13,13 @@ slugs:
   - concept
   - cli
   - list
+history:
+  - version: 7.5.12
+    date: 2026-01-06
+    changes: list komutuna mutlak çıktı seçeneği eklendi
+  - version: 7.5.11
+    date: 2026-01-06
+    changes: list komutuna JSON çıktı seçeneği eklendi
 ---
 
 # İçerik beyan dosyalarını listele
@@ -27,14 +34,36 @@ npx intlayer content list
 
 Bu komut, projenizdeki tüm içerik beyan dosyalarını, sözlük anahtarları ve dosya yolları ile birlikte gösterir. Tüm içerik dosyalarınızın genel bir görünümünü elde etmek ve Intlayer tarafından doğru şekilde keşfedildiklerini doğrulamak için faydalıdır.
 
-## Örnek:
+## Argümanlar:
+
+- **`--json`**: Sonuçları biçimlendirilmiş metin yerine JSON olarak çıktılar. Betik oluşturma ve programatik erişim için yararlıdır.
+
+  > Örnek: `npx intlayer content list --json`
+
+## Örnekler:
+
+### İçerik beyan dosyalarını listele:
 
 ```bash
 npx intlayer content list
 ```
 
+### JSON olarak çıktı:
+
+```bash
+npx intlayer content list --json
+```
+
+### Mutlak yollar olarak çıktı:
+
+```bash
+npx intlayer content list --absolute
+```
+
 ## Örnek çıktı:
 
+### Biçimlendirilmiş çıktı:
+
 ```bash
 npx intlayer content list
 İçerik beyan dosyaları:
@@ -45,6 +74,14 @@ npx intlayer content list
 Toplam içerik beyan dosyası: 3
 ```
 
+### JSON çıktı:
+
+```bash
+$ npx intlayer content list --json
+
+[{"key":"home-page","path":"src/components/HomePage/homePage.content.ts"},{"key":"server-component","path":"src/components/ServerComponent/serverComponent.content.ts"},{"key":"client-component","path":"src/components/ClientComponent/clientComponent.content.ts"}]
+```
+
 Bu komut aşağıdakileri çıktı olarak verir:
 
 - Anahtarları ve göreli dosya yolları ile birlikte tüm içerik beyan dosyalarının biçimlendirilmiş listesi

package/docs/tr/cli/list_projects.md

@@ -0,0 +1,134 @@
+---
+createdAt: 2025-12-30
+updatedAt: 2026-01-06
+title: Intlayer Projelerini Listele
+description: Bir dizinde veya git deposunda bulunan tüm Intlayer projelerinin nasıl listeleneceğini öğrenin.
+keywords:
+  - Liste
+  - Projeler
+  - CLI
+  - Intlayer
+  - Git
+slugs:
+  - doc
+  - concept
+  - cli
+  - list-projects
+history:
+  - version: 7.5.12
+    date: 2026-01-06
+    changes: list projects komutuna mutlak çıktı seçeneği ekle
+---
+
+# Intlayer Projelerini Listele
+
+```bash
+npx intlayer projects list
+```
+
+Bu komut, Intlayer yapılandırma dosyalarını içeren dizinleri bularak tüm Intlayer projelerini arar ve listeler. Monorepo, workspace veya git deposundaki tüm Intlayer projelerini keşfetmek için faydalıdır.
+
+## Kısaltmalar:
+
+- `npx intlayer projects-list`
+- `npx intlayer pl`
+
+## Argümanlar:
+
+- **`--base-dir [path]`**: Aramaya başlanacak temel dizini belirtin. Varsayılan olarak geçerli çalışma dizinidir.
+
+  > Örnek: `npx intlayer projects list --base-dir /path/to/workspace`
+
+  > Örnek: `npx intlayer projects list --base-dir /path/to/workspace`
+
+- **`--git-root`**: Temel dizin yerine git kök dizininden arama yapar. Bu, monorepo veya git deposundaki tüm Intlayer projelerini bulmak için faydalıdır.
+
+  > Örnek: `npx intlayer projects list --git-root`
+
+- **`--json`**: Sonuçları biçimlendirilmiş metin yerine JSON olarak çıktılar. Betik oluşturma ve programatik erişim için yararlıdır.
+
+  > Örnek: `npx intlayer projects list --json`
+
+- **`--absolute`**: Sonuçları göreli yollar yerine mutlak yollar olarak çıktılar.
+
+  > Örnek: `npx intlayer projects list --absolute`
+
+## Nasıl çalışır:
+
+Komut, belirtilen dizinde (veya `--git-root` kullanıldıysa git kökünde) Intlayer yapılandırma dosyalarını arar. Aşağıdaki yapılandırma dosyası desenlerini kontrol eder:
+
+- `intlayer.config.ts`
+- `intlayer.config.js`
+- `intlayer.config.json`
+- `intlayer.config.cjs`
+- `intlayer.config.mjs`
+- `.intlayerrc`
+
+Bu dosyalardan birini içeren her dizin bir Intlayer projesi olarak kabul edilir ve çıktıda listelenecektir.
+
+## Örnekler:
+
+### Geçerli dizindeki projeleri listele:
+
+```bash
+npx intlayer projects list
+```
+
+### Belirli bir dizindeki projeleri listele:
+
+```bash
+npx intlayer projects list --base-dir ./packages
+```
+
+### Git deposundaki tüm projeleri listele:
+
+```bash
+npx intlayer projects list --git-root
+```
+
+### Kısayol alias'ı kullanma:
+
+```bash
+npx intlayer pl --git-root
+```
+
+### JSON olarak çıktı:
+
+```bash
+npx intlayer projects list --json
+```
+
+## Örnek çıktı:
+
+### Biçimlendirilmiş çıktı:
+
+```bash
+$ npx intlayer projects list --git-root
+
+3 Intlayer projesi bulundu:
+
+  - /Users/user/workspace/packages/app
+  - /Users/user/workspace/packages/admin
+  - /Users/user/workspace/packages/shared
+```
+
+### JSON çıktı:
+
+```bash
+$ npx intlayer projects list --json
+
+["/Users/user/workspace/packages/app","/Users/user/workspace/packages/admin","/Users/user/workspace/packages/shared"]
+```
+
+## Kullanım durumları:
+
+- **Monorepo yönetimi**: Monorepo yapısındaki tüm Intlayer projelerini keşfetme
+- **Proje keşfi**: Bir workspace içindeki Intlayer etkin projeleri bulma
+- **CI/CD**: Otomatik iş akışlarında Intlayer projelerini doğrulama
+- **Dokümantasyon**: Intlayer kullanan tüm projeleri listeleyen dokümantasyon oluşturma
+
+Çıktı, her proje dizinine mutlak yollar sağlar; bu da bu dizinlere gitmeyi veya birden çok Intlayer projesi üzerinde betik tabanlı işlemler yapmayı kolaylaştırır.
+
+- **Dokümantasyon**: Intlayer kullanan tüm projelerin listesini içeren dokümantasyon oluşturma
+
+Çıktı, her proje dizinine mutlak yollar sağlar; bu da birden fazla Intlayer projesine kolayca erişmeyi veya bu projeler üzerinde betiklerle işlem yapmayı kolaylaştırır.

package/docs/tr/intlayer_CMS.md

@@ -71,6 +71,26 @@ Vite + React ile entegrasyon için, [kurulum kılavuzuna](https://github.com/aym
 
 ## Konfigürasyon
 
+Intlayer CMS'ye giriş yapmak için aşağıdaki komutu çalıştırın:
+
+```bash packageManager="npm"
+npx intlayer login
+```
+
+```bash packageManager="yarn"
+yarn intlayer login
+```
+
+```bash packageManager="pnpm"
+pnpm intlayer login
+```
+
+```bash packageManager="bun"
+bunx intlayer login
+```
+
+Bu, kimlik doğrulama işlemini tamamlamak ve Intlayer hizmetlerini kullanmak için gerekli kimlik bilgilerini (Client ID ve Client Secret) almak için varsayılan tarayıcınızı açacaktır.
+
 Intlayer konfigürasyon dosyanızda, CMS ayarlarını özelleştirebilirsiniz:
 
 ```typescript fileName="intlayer.config.ts" codeFormat="typescript"

package/docs/tr/intlayer_with_next-i18next.md

@@ -592,7 +592,6 @@ const config: IntlayerConfig = {
   },
   plugins: [
     syncJSON({
-      format: "i18next",
       source: ({ locale }) => `./locales/${locale}.json`,
     }),
   ],

package/docs/tr/intlayer_with_nextjs_14.md

@@ -66,6 +66,34 @@ bunx intlayer init
 
 ## Adım 2: Intlayer Yapılandırma Dosyası Oluşturma
 
+Here is the final structure that we will make:
+
+```bash
+.
+├── src
+│   ├── app
+│   │   ├── [locale]
+│   │   │   ├── layout.tsx            # Locale layout for the Intlayer provider
+│   │   │   ├── page.content.ts
+│   │   │   └── page.tsx
+│   │   └── layout.tsx                # Root layout for style and global providers
+│   ├── components
+│   │   ├── client-component-example.content.ts
+│   │   ├── ClientComponentExample.tsx
+│   │   ├── LocaleSwitcher
+│   │   │   ├── localeSwitcher.content.ts
+│   │   │   └── LocaleSwitcher.tsx
+│   │   ├── server-component-example.content.ts
+│   │   └── ServerComponentExample.tsx
+│   └── middleware.ts
+├── intlayer.config.ts
+├── next.config.ts
+├── package.json
+└── tsconfig.json
+```
+
+> If you don't want locale routing, intlayer can be used as a simple provider / hook. See [this guide](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_with_nextjs_no_locale_path.md) for more details.
+
 Proje kök dizininizde `intlayer.config.ts` dosyasını oluşturun:
 
 ```typescript fileName="intlayer.config.ts" codeFormat="typescript"

package/docs/tr/intlayer_with_nextjs_15.md

@@ -87,6 +87,34 @@ bunx intlayer init
 
 ### Adım 2: Projenizi Yapılandırma
 
+Here is the final structure that we will make:
+
+```bash
+.
+├── src
+│   ├── app
+│   │   ├── [locale]
+│   │   │   ├── layout.tsx            # Locale layout for the Intlayer provider
+│   │   │   ├── page.content.ts
+│   │   │   └── page.tsx
+│   │   └── layout.tsx                # Root layout for style and global providers
+│   ├── components
+│   │   ├── client-component-example.content.ts
+│   │   ├── ClientComponentExample.tsx
+│   │   ├── LocaleSwitcher
+│   │   │   ├── localeSwitcher.content.ts
+│   │   │   └── LocaleSwitcher.tsx
+│   │   ├── server-component-example.content.ts
+│   │   └── ServerComponentExample.tsx
+│   └── middleware.ts
+├── intlayer.config.ts
+├── next.config.ts
+├── package.json
+└── tsconfig.json
+```
+
+> If you don't want locale routing, intlayer can be used as a simple provider / hook. See [this guide](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_with_nextjs_no_locale_path.md) for more details.
+
 Uygulamanızın dillerini yapılandırmak için bir yapılandırma dosyası oluşturun:
 
 ```typescript fileName="intlayer.config.ts" codeFormat="typescript"

package/docs/tr/intlayer_with_nextjs_16.md

@@ -104,6 +104,34 @@ Intlayer'ı Next.js ile entegre eden paket. Next.js uluslararasılaştırması i
 
 ### Adım 2: Projenizi Yapılandırın
 
+Here is the final structure that we will make:
+
+```bash
+.
+├── src
+│   ├── app
+│   │   ├── [locale]
+│   │   │   ├── layout.tsx            # Locale layout for the Intlayer provider
+│   │   │   ├── page.content.ts
+│   │   │   └── page.tsx
+│   │   └── layout.tsx                # Root layout for style and global providers
+│   ├── components
+│   │   ├── client-component-example.content.ts
+│   │   ├── ClientComponentExample.tsx
+│   │   ├── LocaleSwitcher
+│   │   │   ├── localeSwitcher.content.ts
+│   │   │   └── LocaleSwitcher.tsx
+│   │   ├── server-component-example.content.ts
+│   │   └── ServerComponentExample.tsx
+│   └── proxy.ts
+├── intlayer.config.ts
+├── next.config.ts
+├── package.json
+└── tsconfig.json
+```
+
+> If you don't want locale routing, intlayer can be used as a simple provider / hook. See [this guide](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_with_nextjs_no_locale_path.md) for more details.
+
 Uygulamanızın dillerini yapılandırmak için bir yapılandırma dosyası oluşturun:
 
 ```typescript fileName="intlayer.config.ts" codeFormat="typescript"