@intlayer/docs 5.8.1 → 6.0.0-canary.1

package/frequent_questions/tr/intlayer_command_undefined.md

@@ -0,0 +1,156 @@
+---
+createdAt: 2025-09-07
+updatedAt: 2025-09-07
+title: Intlayer komutu tanımsız
+description: Intlayer komutu tanımsız hatasını nasıl düzelteceğinizi öğrenin.
+keywords:
+  - intlayer
+  - komut
+  - tanımsız
+  - hata
+  - vscode
+  - eklenti
+  - plugin
+  - framework
+  - next.js
+  - vite
+slugs:
+  - doc
+  - faq
+  - intlayer-command-undefined
+---
+
+# Intlayer komutu tanımsız
+
+## Genel Bakış
+
+Intlayer CLI, intlayer içeriğinizi yönetmek için (sözlük oluşturma, çeviri gönderme vb.) kolay bir yol sunar. Ancak, projenizin çalışması için zorunlu değildir. Paketleyici eklentisini (ör. Next.js için `withIntlayer()`, Vite için `intlayerPlugin()`) kullanıyorsanız, Intlayer uygulamanızın derlemesi veya geliştirme sunucusu başlatılırken sözlükleri otomatik olarak oluşturur. Geliştirme modunda, içerik bildirim dosyalarındaki değişiklikleri izler ve otomatik olarak yeniden oluşturur.
+
+Intlayer komutlarına şu şekillerde erişebilirsiniz:
+
+- `intlayer` cli komutunu doğrudan kullanarak
+- [VSCode eklentisi](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/vs_code_extension.md) ile
+- `@intlayer/cli` SDK ile
+
+## Sorun
+
+`intlayer` komutunu kullanmaya çalışırken şu hatayla karşılaşabilirsiniz:
+
+```bash
+'intlayer' is not recognized as an internal or external command,
+operable program or batch file.
+```
+
+## Çözümler
+
+Şu adımları sırayla deneyin:
+
+1. **Komutun kurulu olduğundan emin olun**
+
+```bash
+npx intlayer -h
+```
+
+Beklenen çıktı:
+
+```bash
+Usage: intlayer [options] [command]
+
+Intlayer CLI
+
+Options:
+    -V, --version            output the version number
+    -h, --help               display help for command
+
+Commands:
+    dictionary|dictionaries  Dictionaries operations
+    configuration|config     Configuration operations
+    help [command]           display help for command
+```
+
+2. **intlayer-cli paketini global kurun**
+
+```bash
+npm install intlayer-cli -g
+```
+
+> Zaten `intlayer` paketini kurduysanız gerekli olmayabilir
+
+3. **Paketi global kurun**
+
+```bash
+npm install intlayer -g
+```
+
+4. **Terminali yeniden başlatın**
+   Bazen yeni komutların tanınması için terminali yeniden başlatmak gerekir.
+
+5. **Temizleyip tekrar kurun**
+   Yukarıdakiler işe yaramazsa:
+
+```bash
+rm -rf node_modules package-lock.json
+npm install
+```
+
+6. **Kurulum dosyalarını kontrol edin**
+   Sorun devam ederse şu dosyaların varlığını kontrol edin:
+   - `node_modules/intlayer/dist/cjs/cli.cjs`
+   - `node_modules/intlayer/package.json` (içinde `bin` alanı `./dist/cjs/cli.cjs`'i göstermeli)
+
+7. **PATH ortam değişkenini kontrol edin**
+   npm global bin dizininizin PATH'te olduğundan emin olun:
+
+```bash
+# macOS/Linux için
+echo $PATH
+# /usr/local/bin veya ~/.npm-global/bin gibi bir yol olmalı
+
+# Windows için
+echo %PATH%
+# npm global bin dizini olmalı
+```
+
+8. **npx ile tam yolu kullanın**
+   Komut hala bulunamıyorsa, npx ile tam yolu deneyin:
+
+```bash
+npx ./node_modules/intlayer/ dictionaries build
+```
+
+9. **Çakışan kurulumları kontrol edin**
+
+```bash
+# Tüm global kurulu paketleri listele
+npm list -g --depth=0
+
+# Çakışan global kurulumları kaldır
+npm uninstall -g intlayer
+npm uninstall -g intlayer-cli
+# Sonra tekrar kur
+npm install -g intlayer
+```
+
+10. **Node.js ve npm sürümlerini kontrol edin**
+    Uyumlu sürümler kullandığınızdan emin olun:
+
+```bash
+node --version
+npm --version
+```
+
+    Eski sürüm kullanıyorsanız Node.js ve npm'i güncelleyin.
+
+11. **İzin sorunlarını kontrol edin**
+    İzin hatası alıyorsanız:
+
+    ```bash
+    # macOS/Linux için
+    sudo npm install -g intlayer
+
+    # Veya npm'in varsayılan dizinini değiştirin
+    mkdir ~/.npm-global
+    npm config set prefix '~/.npm-global'
+    # ~/.profile veya ~/.bashrc'ye ekleyin:
+    export PATH=~/.npm-global/bin:$PATH
+    ```

package/frequent_questions/tr/locale_incorect_in_url.md

@@ -0,0 +1,74 @@
+---
+createdAt: 2025-09-07
+updatedAt: 2025-09-07
+title: URL'den yanlış locale alınması
+description: URL'den yanlış locale alınması sorununu nasıl düzelteceğinizi öğrenin.
+keywords:
+  - locale
+  - url
+  - intlayer
+  - next.js
+  - vite
+  - framework
+  - middleware
+  - yapılandırma
+  - prefixDefault
+  - noPrefix
+slugs:
+  - doc
+  - faq
+  - locale-incorect-in-url
+---
+
+# URL'den Yanlış Locale Alınması
+
+## Sorun Açıklaması
+
+URL'den locale parametresini almaya çalışırken, locale değeri yanlış dönebilir:
+
+```js
+const { locale } = await params;
+console.log(locale); // Beklenen locale yerine "about" döner
+```
+
+## Çözüm
+
+### 1. Dosya Yapısını Kontrol Edin
+
+Next.js uygulama router yolunuzun şu yapıda olduğundan emin olun:
+
+```bash
+src/app/[locale]/about/page.tsx
+```
+
+### 2. Middleware Yapılandırmasını Kontrol Edin
+
+Sorun genellikle middleware'in olmamasından veya tetiklenmemesinden kaynaklanır. Middleware dosyanız şurada olmalı:
+
+```bash
+src/middleware.ts
+```
+
+Bu middleware, `prefixDefault` false olduğunda `/en/about`'u `/about`'a yönlendirmekten sorumludur.
+
+### 3. Yapılandırmaya Göre URL Şablonları
+
+#### Varsayılan Yapılandırma (`prefixDefault: false`, `noPrefix: false`)
+
+- İngilizce: `/about`
+- Fransızca: `/fr/about`
+- İspanyolca: `/es/about`
+
+#### `prefixDefault: true` ile
+
+- İngilizce: `/en/about`
+- Fransızca: `/fr/about`
+- İspanyolca: `/es/about`
+
+#### `noPrefix: true` ile
+
+- İngilizce: `/about`
+- Fransızca: `/about`
+- İspanyolca: `/about`
+
+Bu yapılandırma seçenekleri hakkında daha fazla bilgi için [Yapılandırma Dokümantasyonu](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/configuration.md) sayfasına bakın.

package/frequent_questions/tr/static_rendering.md

@@ -0,0 +1,45 @@
+---
+createdAt: 2025-09-07
+updatedAt: 2025-09-07
+title: Next.js'de i18n ile Statik ve Dinamik Render
+ description: Next.js'de i18n ile statik ve dinamik render nasıl kullanılır, öğrenin.
+keywords:
+  - statik
+  - dinamik
+  - render
+  - i18n
+  - next.js
+  - next-intl
+  - intlayer
+  - framework
+  - middleware
+  - yapılandırma
+slugs:
+  - doc
+  - faq
+  - static-rendering
+---
+
+# Next.js'de i18n ile Statik ve Dinamik Render
+
+## **next-intl** ile yaşanan sorun
+
+- **Ne olur?**
+  `useTranslations`, `getTranslations` veya herhangi bir next-intl yardımcı fonksiyonunu _Server Component_ içinde kullandığınızda, Next.js tüm rotayı **dinamik** olarak işaretler. ([Next Intl][1])
+
+- **Neden?**
+  next-intl, mevcut locale'i yalnızca istek başlığı (`x-next-intl-locale`) üzerinden `headers()` ile okur. `headers()` **dinamik bir API** olduğu için, ona dokunan her bileşen statik optimizasyonunu kaybeder. ([Next Intl][1], [Next.js][2])
+
+- **Resmi çözüm (boilerplate)**
+  1. Desteklenen her locale için `generateStaticParams` export edin.
+  2. Her layout/page'de `useTranslations`'dan önce `setRequestLocale(locale)` çağırın. ([Next Intl][1])
+     Böylece header bağımlılığı kalkar, ancak fazladan kod ve kararsız bir API ile uğraşırsınız.
+
+## **intlayer** ile bu sorun nasıl aşılır?
+
+**Tasarım tercihleri**
+
+1. **Sadece route-param** – Locale, Next.js'in her sayfaya zaten ilettiği `[locale]` URL segmentinden gelir.
+2. **Derleme zamanı paketleri** – Çeviriler normal ES modülleri olarak import edilir, tree-shake edilir ve derleme zamanında gömülür.
+3. **Dinamik API yok** – `useT()` React context'ten okur, `headers()` veya `cookies()` kullanmaz.
+4. **Ekstra yapılandırma yok** – Sayfalarınız `app/[locale]/` altında olduğunda, Next.js her locale için otomatik olarak bir HTML dosyası üretir.

package/frequent_questions/tr/translated_path_url.md

@@ -0,0 +1,56 @@
+---
+createdAt: 2025-09-07
+updatedAt: 2025-09-07
+title: URL yolunu çevirebilir miyim?
+description: URL yolunu nasıl çevireceğinizi öğrenin.
+keywords:
+  - dizi
+  - içerik
+  - bildirim
+  - intlayer
+  - middleware
+  - proxy
+  - yönlendirme
+  - önek
+  - locale
+  - url
+slugs:
+  - doc
+  - faq
+  - translated-path-url
+---
+
+# Aşağıdaki gibi url çevirmek mümkün mü:
+
+```bash
+en -> /product (önek yok) veya /en/product (önekli)
+fr -> /fr/produit
+es -> /es/producto
+```
+
+Intlayer, URL'leri bu şekilde çevirmeye izin vermez. Bunu başarmak için kendi middleware'inizi veya proxy'nizi kullanarak URL'leri yeniden yazmalısınız.
+
+Ancak, bir locale için url'ye önek eklemek için `getMultilingualUrl` fonksiyonunu kullanabilirsiniz.
+
+```ts
+import { getMultilingualUrl, Locales } from "intlayer";
+
+const url = getMultilingualUrl("/product");
+
+/**
+ * en -> /product (önek yok) veya /en/product (önekli)
+ * fr -> /fr/product
+ * es -> /es/product
+ */
+console.log(url);
+```
+
+Veya `getLocalizedUrl` fonksiyonunu kullanabilirsiniz:
+
+```ts
+import { getLocalizedUrl, Locales } from "intlayer";
+
+const url = getLocalizedUrl("/product", Locales.FRENCH);
+
+console.log(url); // /fr/product
+```

package/frequent_questions/tr/unknown_command.md

@@ -0,0 +1,98 @@
+---
+createdAt: 2025-09-07
+updatedAt: 2025-09-07
+title: Bilinmeyen komut
+description: Bilinmeyen komut hatasını nasıl düzelteceğinizi öğrenin.
+keywords:
+  - bilinmeyen
+  - komut
+  - hata
+  - intlayer
+  - fill
+  - build
+  - verbose
+  - terminal
+  - yeniden başlat
+  - local
+slugs:
+  - doc
+  - faq
+  - unknown-command
+---
+
+# hata: bilinmeyen komut fill / build / vb
+
+Eğer `npx intlayer fill --verbose` komutu şu hatayı veriyorsa:
+
+```
+hata: bilinmeyen komut 'fill'
+```
+
+ama `fill` komutunun olması gerektiğinden eminseniz, şu adımları izleyin:
+
+## 1. **En son sürümü kullandığınızdan emin olun**
+
+Şunu çalıştırın:
+
+```bash
+npx intlayer --version                  # mevcut intlayer sürümü
+npx intlayer@latest --version           # en güncel intlayer sürümü
+```
+
+Bu, `npx`'in en son sürümü çekmesini sağlar. Sonra tekrar deneyin:
+
+```bash
+npx intlayer@latest build --verbose
+```
+
+## 2. **Komutun kayıtlı olup olmadığını kontrol edin**
+
+Şunu çalıştırın:
+
+```bash
+npx intlayer --help                     # komutlar hakkında bilgi verir
+```
+
+Komut listesinde aradığınız komut var mı bakın.
+
+Repo'ya gidip, komutun CLI giriş noktasında export ve register edildiğinden emin olun. Intlayer CLI için `commander` framework'ü kullanır.
+
+CLI ile ilgili kod:
+https://github.com/aymericzip/intlayer/blob/main/packages/%40intlayer/cli/src/cli.ts
+
+## 4. **Terminali yeniden başlatın**
+
+Bazen yeni komutların tanınması için terminali yeniden başlatmak gerekir.
+
+## 5. **intlayer geliştiriyorsanız, yeniden derleyip linkleyin**
+
+Eğer intlayer'ı yerelde geliştiriyorsanız:
+
+```bash
+# intlayer dizininde
+npm install
+npm run build
+npm link
+```
+
+Sonra başka bir terminalde:
+
+```bash
+intlayer fill --verbose
+```
+
+Bu, üzerinde çalıştığınız yerel sürümü kullanır.
+
+## 6. **npx önbelleğini temizleyin (eski sürümde takılı kaldıysanız)**
+
+```bash
+npx clear-npx-cache
+```
+
+Veya intlayer paketlerinin önbelleğini manuel silin:
+
+```bash
+rm -rf ~/.npm/_npx
+```
+
+pnpm, yarn, bun gibi farklı paket yöneticileri kullanıyorsanız eşdeğer önbellek temizleme işlemini uygulayın.

package/legal/tr/privacy_notice.md

@@ -0,0 +1,83 @@
+---
+createdAt: 2025-09-07
+updatedAt: 2025-09-07
+title: Intlayer Gizlilik Bildirimi
+description: Intlayer'ın web sitesi ve CMS üzerinden topladığı bilgileri nasıl işlediğini öğrenin. Farklı formatlar ve kullanım durumları için dokümantasyonu takip edin.
+keywords:
+  - Uluslararasılaştırma
+  - Dokümantasyon
+  - Intlayer
+  - Gizlilik
+  - Bildirim
+  - Çerezler
+  - Takip
+  - Analitik
+  - Google Analytics
+  - Meta (Facebook) Pixel
+  - Kimlik Doğrulama
+  - Kullanıcı Verisi
+slugs:
+  - privacy-notice
+---
+
+# Intlayer Gizlilik Bildirimi
+
+## Giriş
+
+Intlayer olarak gizliliğe önem veriyoruz. Bu bildirim, web sitemiz ve CMS üzerinden toplanan bilgileri nasıl işlediğimizi açıklar.
+
+## İletişim
+
+Gizlilikle ilgili herhangi bir sorunuz veya endişeniz varsa, lütfen şu adresten bizimle iletişime geçin: [contact@intlayer.org](mailto:contact@intlayer.org).
+
+## Çerezler ve Takip Teknolojilerinin Kullanımı
+
+Web sitemizin kullanımını analiz etmek ve hizmetlerimizi geliştirmek için **Google Analytics** ve **Meta (Facebook) Pixel** kullanıyoruz. Bu araçlar, kullanıcıların cihazlarında saklanan çerezler aracılığıyla istatistikler ve diğer bilgileri üretir.
+
+Daha fazla bilgi için:
+
+- [Google gizlilik politikası](https://policies.google.com/privacy)
+- [Meta gizlilik politikası](https://www.facebook.com/privacy/policy)
+
+## Kimlik Doğrulama ve Kullanıcı Verisi
+
+Intlayer CMS'ye erişim için kullanıcı kimlik doğrulaması gereklidir. E-posta/şifre ile girişin yanı sıra **Google** ve **GitHub** ile üçüncü taraf oturum açma seçenekleri sunuyoruz.
+
+Kimlik doğrulama sırasında şu veriler toplanır:
+
+- E-posta adresi
+- Görünen ad (veya seçilen ad)
+
+Kullanıcılar ayrıca hesaplarına bağlı erişim anahtarları (token) ile de CMS'ye erişebilir. Bu anahtarlar da aynı kimlik doğrulama verilerine bağlıdır.
+
+## Veri Saklama ve Güvenlik
+
+Kullanıcı kimlik doğrulama verileri **cloud.mongodb.com** üzerinde barındırılan bir **MongoDB veritabanında** saklanır:
+
+- **Bölge:** AWS / Oregon (us-west-2)
+- **Tip:** Replica Set (3 düğüm)
+- **Şifre Güvenliği:** Tüm şifreler endüstri standardı yöntemlerle hash'lenir.
+
+Kimlik doğrulama ve güvenli CMS erişimi için gerekli olanlar dışında gereksiz hiçbir kişisel veri saklanmaz.
+
+## Üçüncü Taraflarla Veri Paylaşımı
+
+Kişisel verileriniz, analiz (Google Analytics, Facebook Pixel) veya kimlik doğrulama işlemleri (Google veya GitHub ile giriş) dışında üçüncü taraflarla **satılmaz veya paylaşılmaz**.
+
+## Kullanıcı Hakları
+
+Bir kullanıcı olarak şu haklara sahipsiniz:
+
+- Hakkınızda tuttuğumuz kişisel verilere erişme
+- Verilerinizin düzeltilmesini veya silinmesini talep etme
+- Erişimi iptal etme veya hesabınızı silme
+
+Verilerinizle ilgili herhangi bir talebiniz için [contact@intlayer.org](mailto:contact@intlayer.org) adresinden bize ulaşabilirsiniz.
+
+## Bu Bildirimdeki Değişiklikler
+
+Bu gizlilik bildirimi zaman zaman güncellenebilir. Kullanıcıların değişikliklerden haberdar olmak için bu sayfayı düzenli olarak kontrol etmeleri önerilir.
+
+---
+
+Daha resmi bir dil, GDPR/CCPA eklemeleri veya yasal sayfa için uyarlama isterseniz lütfen belirtin.

package/legal/tr/terms_of_service.md

@@ -0,0 +1,55 @@
+---
+createdAt: 2025-09-07
+updatedAt: 2025-09-07
+title: Intlayer Hizmet Koşulları
+description: Intlayer'ın web sitesi ve CMS üzerinden topladığı bilgileri nasıl işlediğini öğrenin. Farklı formatlar ve kullanım durumları için dokümantasyonu takip edin.
+keywords:
+  - Uluslararasılaştırma
+  - Dokümantasyon
+  - Intlayer
+  - Hizmet Koşulları
+  - Hizmet
+  - Kullanım
+  - Lisans
+  - Sorumluluk
+  - Gizlilik
+  - Katkı
+  - Atıf
+  - Koşul Değişikliği
+slugs:
+  - terms-of-service
+---
+
+# Intlayer Kullanım Koşulları
+
+## 1. Koşulların Kabulü
+
+Intlayer'ı kullanarak bu kullanım koşullarına bağlı kalmayı kabul etmiş olursunuz. Bu koşulları kabul etmiyorsanız lütfen aracı kullanmayın.
+
+## 2. Lisans
+
+Intlayer, **Apache 2.0 lisansı** ile dağıtılır. Bu lisans, kodun hem açık kaynak hem de ticari projelerde kullanılmasına, değiştirilmesine ve dağıtılmasına izin verir. Kullanıcılar kaynak kodunu değiştirebilir ve [katkı rehberimizde](https://github.com/aymericzip/intlayer/blob/main/CONTRIBUTING.md) belirtilen kurallara uygun olarak pull request ile katkı sunabilir. Ticari amaçla kodun izinsiz kopyalanması kesinlikle yasaktır.
+
+## 3. Ticari Kullanım
+
+Intlayer'ı ticari projelerde kullanabilirsiniz. Ancak, kodu doğrudan rakip araçlar üretmek için önemli bir dönüşüm veya değer katmadan yeniden kullanmak yasaktır.
+
+## 4. Sorumluluk
+
+Intlayer geliştiricileri, hata ve güvenlik açıklarını tespit ettiklerinde düzeltmek için çaba gösterir. Ancak, bu tür sorunlardan kaynaklanan kullanıcı altyapısındaki zararlardan sorumluluk kabul etmezler. Kullanıcıların sorunları [issue takip sistemimiz](https://github.com/aymericzip/intlayer/issues) üzerinden bildirmeleri teşvik edilir.
+
+## 5. Gizlilik
+
+Intlayer, kullanıcıların hiçbir kişisel verisini toplamaz veya saklamaz.
+
+## 6. Katkılar
+
+Kullanıcılar, katkı rehberimizde belirtilen kurallara uyarak Intlayer'a katkıda bulunmaya teşvik edilir. Sunulan her kod, belirlenen kalite standartlarına uygun olmalı ve entegrasyon öncesi geliştiriciler tarafından incelenir.
+
+## 7. Atıf
+
+Intlayer kodunu genişleten veya kullanan herhangi bir araç, Intlayer'ı açıkça kaynak olarak belirtmelidir. Bu atıf hem kaynak kodda hem de kullanıcıya veya tanıtım dokümantasyonunda görünür olmalıdır.
+
+## 8. Koşulların Değiştirilmesi
+
+Bu kullanım koşulları herhangi bir zamanda değiştirilebilir. Kullanıcılar, koşullardaki önemli değişikliklerden haberdar edilir ve Intlayer'ı kullanmaya devam etmek için bu değişiklikleri kabul etmeleri gerekir.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@intlayer/docs",
-  "version": "5.8.1",
+  "version": "6.0.0-canary.1",
   "private": false,
   "description": "Intlayer documentation",
   "keywords": [
@@ -48,31 +48,31 @@
     "legal"
   ],
   "dependencies": {
-    "@intlayer/config": "5.8.1",
-    "intlayer": "5.8.1"
+    "intlayer": "6.0.0-canary.1",
+    "@intlayer/config": "6.0.0-canary.1"
   },
   "devDependencies": {
     "@types/node": "^24.2.1",
     "concurrently": "^9.1.2",
-    "eslint": "^9.33.0",
+    "eslint": "^9.34.0",
     "fast-glob": "^3.3.3",
-    "prettier": "^3.5.3",
+    "prettier": "^3.6.2",
     "rimraf": "^6.0.1",
     "tsc-alias": "^1.8.16",
     "tsup": "^8.5.0",
     "tsx": "^4.19.4",
     "typescript": "^5.9.2",
-    "vitest": "^3.2.2",
-    "@intlayer/api": "5.8.1",
+    "vitest": "^3.2.4",
+    "@intlayer/api": "6.0.0-canary.1",
+    "@intlayer/cli": "6.0.0-canary.1",
     "@utils/ts-config": "1.0.4",
     "@utils/ts-config-types": "1.0.4",
-    "@utils/tsup-config": "1.0.4",
-    "@intlayer/cli": "5.8.1"
+    "@utils/tsup-config": "1.0.4"
   },
   "peerDependencies": {
-    "@intlayer/config": "5.8.1",
-    "@intlayer/api": "5.8.1",
-    "@intlayer/cli": "5.8.1"
+    "@intlayer/config": "6.0.0-canary.1",
+    "@intlayer/cli": "6.0.0-canary.1",
+    "@intlayer/api": "6.0.0-canary.1"
   },
   "engines": {
     "node": ">=14.18"