@intlayer/docs 5.8.1 → 6.0.0-canary.0

package/docs/tr/packages/express-intlayer/t.md

@@ -0,0 +1,459 @@
+---
+createdAt: 2025-09-07
+updatedAt: 2025-09-07
+title: t Fonksiyonu Dokümantasyonu | express-intlayer
+description: express-intlayer paketi için t fonksiyonunun nasıl kullanılacağını görün
+keywords:
+  - t
+  - çeviri
+  - Intlayer
+  - Uluslararasılaştırma
+  - Dokümantasyon
+  - Express
+  - JavaScript
+  - React
+slugs:
+  - doc
+  - packages
+  - express-intlayer
+  - t
+---
+
+# Dokümantasyon: `express-intlayer` Paketinde `t` Fonksiyonu
+
+`express-intlayer` paketindeki `t` fonksiyonu, Express uygulamanızda yerelleştirilmiş yanıtlar sağlamak için temel yardımcıdır. Kullanıcının tercih ettiği dile göre içeriği dinamik olarak seçerek uluslararasılaştırmayı (i18n) basitleştirir.
+
+---
+
+## Genel Bakış
+
+`t` fonksiyonu, verilen bir dil seti için çevirileri tanımlamak ve almak için kullanılır. İstemcinin istek ayarlarına göre (örneğin `Accept-Language` başlığı) döndürülecek uygun dili otomatik olarak belirler. Tercih edilen dil mevcut değilse, yapılandırmanızda belirtilen varsayılan yerel ayara zarif bir şekilde geri döner.
+
+---
+
+## Temel Özellikler
+
+- **Dinamik Yerelleştirme**: İstemci için en uygun çeviriyi otomatik olarak seçer.
+- **Varsayılan Yerel Ayara Geri Dönme**: İstemcinin tercih ettiği dil mevcut değilse, kullanıcı deneyimini sürdürmek için varsayılan yerel ayara geri döner.
+- **Hafif ve Hızlı**: Yüksek performanslı uygulamalar için tasarlanmış, minimum ek yük sağlar.
+- **Katı Mod Desteği**: Güvenilir davranış için bildirilen yerel ayarlara katı uyumu zorunlu kılar.
+
+---
+
+## Fonksiyon İmzası
+
+```typescript
+t(translations: Record<string, string>): string;
+```
+
+### Parametreler
+
+- `translations`: Anahtarların yerel kodlar (örneğin `en`, `fr`, `es-MX`) ve değerlerin karşılık gelen çevrilmiş dizeler olduğu bir nesne.
+
+### Döndürür
+
+- İstemcinin tercih ettiği dildeki içeriği temsil eden bir dize.
+
+---
+
+## Uluslararasılaştırma İstek İşleyicisini Yükleme
+
+`express-intlayer` tarafından sağlanan uluslararasılaştırma işlevinin doğru çalışmasını sağlamak için, Express uygulamanızın başında uluslararasılaştırma ara yazılımını **yüklemeniz gerekir**. Bu, `t` fonksiyonunu etkinleştirir ve yerel algılama ve çeviri işlemenin düzgün yapılmasını sağlar.
+
+Tüm yolların uluslararasılaştırmadan faydalanmasını sağlamak için `app.use(intlayer())` ara yazılımını uygulamanızdaki **herhangi bir yoldan önce** yerleştirin:
+
+```typescript {7} fileName="src/index.ts" codeFormat="typescript"
+import express, { type Express } from "express";
+import { intlayer } from "express-intlayer";
+
+const app: Express = express();
+
+// Uluslararasılaştırma istek işleyicisini yükle
+app.use(intlayer());
+
+// Ara yazılım yükledikten sonra yollarınızı tanımlayın
+app.get("/", (_req, res) => {
+  res.send(
+    t({
+      en: "Hello, World!",
+      fr: "Bonjour le monde!",
+      es: "¡Hola, Mundo!",
+    })
+  );
+});
+```
+
+```javascript {7} fileName="src/index.mjs" codeFormat="esm"
+import express from "express";
+import { intlayer } from "express-intlayer";
+
+const app = express();
+
+// Uluslararasılaştırma istek işleyicisini yükle
+app.use(intlayer());
+
+// Ara yazılım yükledikten sonra yollarınızı tanımlayın
+app.get("/", (_req, res) => {
+  res.send(
+    t({
+      en: "Hello, World!",
+      fr: "Bonjour le monde!",
+      es: "¡Hola, Mundo!",
+    })
+  );
+});
+```
+
+```javascript {7} fileName="src/index.cjs" codeFormat="commonjs"
+const express = require("express");
+const { intlayer } = require("express-intlayer");
+
+const app = express();
+
+// Uluslararasılaştırma istek işleyicisini yükle
+app.use(intlayer());
+
+// Ara yazılım yükledikten sonra yollarınızı tanımlayın
+app.get("/", (_req, res) => {
+  res.send(
+    t({
+      en: "Hello, World!",
+      fr: "Bonjour le monde!",
+      es: "¡Hola, Mundo!",
+    })
+  );
+});
+```
+
+### Neden Gerekli
+
+- **Yerel Algılama**: `intlayer` ara yazılımı, başlıklara, çerezlere veya diğer yapılandırılmış yöntemlere göre kullanıcının tercih ettiği yerel ayarı algılamak için gelen istekleri işler.
+- **Çeviri Bağlamı**: `t` fonksiyonunun doğru çalışması için gerekli bağlamı kurar, çevirilerin doğru dilde döndürülmesini sağlar.
+- **Hata Önleme**: Bu ara yazılım olmadan, `t` fonksiyonunu kullanmak, gerekli yerel bilgileri mevcut olmadığı için çalışma zamanı hatalarına neden olur.
+
+---
+
+## Kullanım Örnekleri
+
+### Temel Örnek
+
+Farklı dillerde yerelleştirilmiş içerik sunun:
+
+```typescript fileName="src/index.ts" codeFormat="typescript"
+app.get("/", (_req, res) => {
+  res.send(
+    t({
+      en: "Welcome!",
+      fr: "Bienvenue!",
+      es: "¡Bienvenido!",
+    })
+  );
+});
+```
+
+```javascript fileName="src/index.mjs" codeFormat="esm"
+app.get("/", (_req, res) => {
+  res.send(
+    t({
+      en: "Welcome!",
+      fr: "Bienvenue!",
+      es: "¡Bienvenido!",
+    })
+  );
+});
+```
+
+```javascript fileName="src/index.cjs" codeFormat="commonjs"
+app.get("/", (_req, res) => {
+  res.send(
+    t({
+      en: "Welcome!",
+      fr: "Bienvenue!",
+      es: "¡Bienvenido!",
+    })
+  );
+});
+```
+
+**İstemci İstekleri:**
+
+- `Accept-Language: fr` ile bir istemci `Bienvenue!` alır.
+- `Accept-Language: es` ile bir istemci `¡Bienvenido!` alır.
+- `Accept-Language: de` ile bir istemci `Welcome!` alır (varsayılan yerel ayar).
+
+### Hataları İşleme
+
+Hata mesajlarını birden fazla dilde sağlayın:
+
+```typescript fileName="src/index.ts" codeFormat="typescript"
+app.get("/error", (_req, res) => {
+  res.status(500).send(
+    t({
+      en: "An unexpected error occurred.",
+      fr: "Une erreur inattendue s'est produite.",
+      es: "Ocurrió un error inesperado.",
+    })
+  );
+});
+```
+
+```javascript fileName="src/index.mjs" codeFormat="esm"
+app.get("/error", (_req, res) => {
+  res.status(500).send(
+    t({
+      en: "An unexpected error occurred.",
+      fr: "Une erreur inattendue s'est produite.",
+      es: "Ocurrió un error inesperado.",
+    })
+  );
+});
+```
+
+```javascript fileName="src/index.cjs" codeFormat="commonjs"
+app.get("/error", (_req, res) => {
+  res.status(500).send(
+    t({
+      en: "An unexpected error occurred.",
+      fr: "Une erreur inattendue s'est produite.",
+      es: "Ocurrió un error inesperado.",
+    })
+  );
+});
+```
+
+---
+
+### Yerel Varyantları Kullanma
+
+Yerel ayara özel varyantlar için çeviriler belirtin:
+
+```typescript fileName="src/index.ts" codeFormat="typescript"
+app.get("/greet", (_req, res) => {
+  res.send(
+    t({
+      en: "Hello!",
+      "en-GB": "Hello, mate!",
+      fr: "Bonjour!",
+      "es-MX": "¡Hola, amigo!",
+      "es-ES": "¡Hola!",
+    })
+  );
+});
+```
+
+```javascript fileName="src/index.cjs" codeFormat="commonjs"
+app.get("/greet", (_req, res) => {
+  res.send(
+    t({
+      en: "Hello!",
+      "en-GB": "Hello, mate!",
+      fr: "Bonjour!",
+      "es-MX": "¡Hola, amigo!",
+      "es-ES": "¡Hola!",
+    })
+  );
+});
+```
+
+```javascript fileName="src/index.mjs" codeFormat="esm"
+app.get("/greet", (_req, res) => {
+  res.send(
+    t({
+      en: "Hello!",
+      "en-GB": "Hello, mate!",
+      fr: "Bonjour!",
+      "es-MX": "¡Hola, amigo!",
+      "es-ES": "¡Hola!",
+    })
+  );
+});
+```
+
+---
+
+## Gelişmiş Konular
+
+### Geri Dönme Mekanizması
+
+Tercih edilen yerel mevcut değilse, `t` fonksiyonu yapılandırmada tanımlanan varsayılan yerel ayara geri döner:
+
+```typescript {5-6} fileName="intlayer.config.ts" codeFormat="typescript"
+import { Locales, type IntlayerConfig } from "intlayer";
+
+const config = {
+  internationalization: {
+    locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],
+    defaultLocale: Locales.ENGLISH,
+  },
+} satisfies IntlayerConfig;
+
+export default config;
+```
+
+```javascript {5-6} fileName="intlayer.config.mjs" codeFormat="esm"
+import { Locales } from "intlayer";
+
+/** @type {import('intlayer').IntlayerConfig} */
+const config = {
+  internationalization: {
+    locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],
+    defaultLocale: Locales.ENGLISH,
+  },
+};
+
+export default config;
+```
+
+```javascript {5-6} fileName="intlayer.config.cjs" codeFormat="commonjs"
+const { Locales } = require("intlayer");
+
+/** @type {import('intlayer').IntlayerConfig} */
+const config = {
+  internationalization: {
+    locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],
+    defaultLocale: Locales.ENGLISH,
+  },
+};
+
+module.exports = config;
+```
+
+Örneğin:
+
+- `defaultLocale` `Locales.CHINESE` ise ve bir istemci `Locales.DUTCH` isterse, döndürülen çeviri `Locales.CHINESE` değerine varsayılan olur.
+- `defaultLocale` tanımlanmamışsa, `t` fonksiyonu `Locales.ENGLISH` değerine geri döner.
+
+---
+
+### Katı Mod Zorunluluk
+
+`t` fonksiyonunu bildirilen yerel ayarlara katı uyumu zorunlu kılmak için yapılandırın:
+
+| Mod         | Davranış                                                                                                   |
+| ----------- | ---------------------------------------------------------------------------------------------------------- |
+| `strict`    | Tüm bildirilen yerel ayarlar için çeviriler sağlanmalıdır. Eksik yerel ayarlar hata atar.                  |
+| `inclusive` | Bildirilen yerel ayarlar için çeviriler gereklidir. Eksik yerel ayarlar uyarı tetikler ancak kabul edilir. |
+| `loose`     | Bildirilen olmayan herhangi bir mevcut yerel ayar kabul edilir.                                            |
+
+Yapılandırma Örneği:
+
+```typescript {7} fileName="intlayer.config.ts" codeFormat="typescript"
+import { type IntlayerConfig } from "intlayer";
+
+const config = {
+  // ... Mevcut yapılandırmanız
+  internationalization: {
+    // ... Mevcut uluslararasılaştırma yapılandırmanız
+    strictMode: "strict", // Katı modu zorunlu kıl
+  },
+} satisfies IntlayerConfig;
+
+export default config;
+```
+
+```javascript {7} fileName="intlayer.config.mjs" codeFormat="esm"
+import { type IntlayerConfig } from "intlayer";
+
+const config = {
+  // ... Mevcut yapılandırmanız
+  internationalization: {
+    // ... Mevcut uluslararasılaştırma yapılandırmanız
+    strictMode: "strict", // Katı modu zorunlu kıl
+  },
+};
+
+export default config;
+```
+
+```javascript {7} fileName="intlayer.config.cjs" codeFormat="commonjs"
+/** @type {import('intlayer').IntlayerConfig} */
+const config = {
+  // ... Mevcut yapılandırmanız
+  internationalization: {
+    // ... Mevcut uluslararasılaştırma yapılandırmanız
+    strictMode: "strict", // Katı modu zorunlu kıl
+  },
+};
+
+module.exports = config;
+```
+
+---
+
+### TypeScript Entegrasyonu
+
+`t` fonksiyonu TypeScript ile kullanıldığında tür güvenlidir. Tür güvenli çeviriler nesnesi tanımlayın:
+
+```typescript fileName="src/index.ts" codeFormat="typescript"
+import { type LanguageContent } from "express-intlayer";
+
+const translations: LanguageContent<string> = {
+  en: "Good morning!",
+  fr: "Bonjour!",
+  es: "¡Buenos días!",
+};
+
+app.get("/morning", (_req, res) => {
+  res.send(t(translations));
+});
+```
+
+```javascript fileName="src/index.mjs" codeFormat="esm"
+import { type LanguageContent } from "express-intlayer";
+
+/** @type {import('express-intlayer').LanguageContent<string>} */
+const translations = {
+  en: "Good morning!",
+  fr: "Bonjour!",
+  es: "¡Buenos días!",
+};
+
+app.get("/morning", (_req, res) => {
+  res.send(t(translations));
+});
+```
+
+```javascript fileName="src/index.cjs" codeFormat="commonjs"
+const { type LanguageContent } = require("express-intlayer");
+
+/** @type {import('express-intlayer').LanguageContent<string>} */
+const translations = {
+  en: "Good morning!",
+  fr: "Bonjour!",
+  es: "¡Buenos días!",
+};
+
+app.get("/morning", (_req, res) => {
+  res.send(t(translations));
+});
+```
+
+---
+
+### Yaygın Hatalar ve Sorun Giderme
+
+| Sorun                     | Neden                                    | Çözüm                                                                 |
+| ------------------------- | ---------------------------------------- | --------------------------------------------------------------------- |
+| `t` fonksiyonu çalışmıyor | Ara yazılım yüklenmemiş                  | `app.use(intlayer())` öğesinin yollar öncesi eklendiğinden emin olun. |
+| Eksik çeviriler hatası    | Tüm yerel ayarlar olmadan katı mod etkin | Tüm gerekli çevirileri sağlayın.                                      |
+
+---
+
+## Etkili Kullanım İçin İpuçları
+
+1. **Çevirileri Merkezi Hale Getirin**: Bakım kolaylığını artırmak için merkezi bir modül veya JSON dosyaları kullanarak çevirileri yönetin.
+2. **Çevirileri Doğrulayın**: Gereksiz geri dönmeyi önlemek için her dil varyantının karşılık gelen bir çeviriye sahip olduğundan emin olun.
+3. **Ön Uç i18n ile Birleştirin**: Uygulamada sorunsuz bir kullanıcı deneyimi için ön uç uluslararasılaştırmayla senkronize edin.
+4. **Performansı Ölçün**: Minimum etkiyi sağlamak için çeviriler ekledikten sonra uygulamanızın yanıt sürelerini test edin.
+
+---
+
+## Sonuç
+
+`t` fonksiyonu, arka uç uluslararasılaştırması için güçlü bir araçtır. Bunu etkili bir şekilde kullanarak, küresel bir kitle için daha kapsayıcı ve kullanıcı dostu bir uygulama oluşturabilirsiniz. Gelişmiş kullanım ve detaylı yapılandırma seçenekleri için [dokümantasyona](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/configuration.md) bakın.
+
+## Doküman Geçmişi
+
+| Sürüm  | Tarih      | Değişiklikler     |
+| ------ | ---------- | ----------------- |
+| 5.5.10 | 2025-06-29 | Geçmiş başlatıldı |

package/docs/tr/packages/intlayer/getConfiguration.md

@@ -0,0 +1,151 @@
+---
+createdAt: 2025-09-07
+updatedAt: 2025-09-07
+title: getConfiguration Fonksiyonu Dokümantasyonu | intlayer
+description: intlayer paketinde getConfiguration fonksiyonunun nasıl kullanılacağını görün
+keywords:
+  - getConfiguration
+  - çeviri
+  - Intlayer
+  - intlayer
+  - Uluslararasılaştırma
+  - Dokümantasyon
+  - Next.js
+  - JavaScript
+  - React
+slugs:
+  - doc
+  - packages
+  - intlayer
+  - getConfiguration
+---
+
+# Dokümantasyon: `intlayer` Paketinde `getConfiguration` Fonksiyonu
+
+## Açıklama
+
+`getConfiguration` fonksiyonu, ortam değişkenlerini çıkararak `intlayer` uygulaması için tüm yapılandırmayı alır. Bu fonksiyon, aynı yapılandırmayı hem istemci hem de sunucu tarafında kullanma esnekliği sağlar ve uygulamanın genelinde tutarlılığı garanti eder.
+
+---
+
+## Parametreler
+
+Fonksiyon herhangi bir parametre almaz. Bunun yerine, yapılandırma için ortam değişkenlerini kullanır.
+
+### Döndürür
+
+- **Tür**: `IntlayerConfig`
+- **Açıklama**: `intlayer` için tam yapılandırmayı içeren bir nesne. Yapılandırma aşağıdaki bölümleri içerir:
+  - `internationalization`: Yerel ayarlar ve katı mod ile ilgili ayarlar.
+  - `middleware`: URL ve çerez yönetimi ile ilgili ayarlar.
+  - `content`: İçerik dosyaları, dizinler ve desenlerle ilgili ayarlar.
+  - `editor`: Düzenleyiciye özel yapılandırmalar.
+
+Daha fazla detay için [Intlayer yapılandırma dokümantasyonuna](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/configuration.md) bakın.
+
+---
+
+## Kullanım Örneği
+
+### Tam Yapılandırmayı Alma
+
+```typescript codeFormat="typescript"
+import { getConfiguration } from "intlayer";
+
+const config = getConfiguration();
+console.log(config);
+// Çıktı:
+// {
+//   internationalization: { ... },
+//   middleware: { ... },
+//   content: { ... },
+//   editor: { ... }
+// }
+```
+
+```javascript codeFormat="esm"
+import { getConfiguration } from "intlayer";
+
+const config = getConfiguration();
+console.log(config);
+// Çıktı:
+// {
+//   internationalization: { ... },
+//   middleware: { ... },
+//   content: { ... },
+//   editor: { ... }
+// }
+```
+
+```javascript codeFormat="commonjs"
+const { getConfiguration } = require("intlayer");
+
+const config = getConfiguration();
+console.log(config);
+// Çıktı:
+// {
+//   internationalization: { ... },
+//   middleware: { ... },
+//   content: { ... },
+//   editor: { ... }
+// }
+```
+
+### `availableLocales` ve `defaultLocale` Çıkarma
+
+Yapılandırmanın `internationalization` bölümü, `locales` (kullanılabilir yerel ayarlar) ve `defaultLocale` (varsayılan dil) gibi yerel ayarlarla ilgili ayarları sağlar.
+
+```typescript codeFormat="typescript"
+import { getConfiguration } from "intlayer";
+
+const { internationalization, middleware } = getConfiguration();
+const { locales: availableLocales, defaultLocale } = internationalization;
+const { cookieName } = middleware;
+
+console.log(availableLocales); // Çıktı örneği: ["en", "fr", "es"]
+console.log(defaultLocale); // Çıktı örneği: "en"
+console.log(cookieName); // Çıktı: "INTLAYER_LOCALE"
+```
+
+```javascript codeFormat="esm"
+import { getConfiguration } from "intlayer";
+
+const { internationalization, middleware } = getConfiguration();
+const { locales: availableLocales, defaultLocale } = internationalization;
+const { cookieName } = middleware;
+
+console.log(availableLocales); // Çıktı örneği: ["en", "fr", "es"]
+console.log(defaultLocale); // Çıktı örneği: "en"
+console.log(cookieName); // Çıktı: "INTLAYER_LOCALE"
+```
+
+```javascript codeFormat="commonjs"
+const { getConfiguration } = require("intlayer");
+
+const { internationalization, middleware } = getConfiguration();
+const { locales: availableLocales, defaultLocale } = internationalization;
+const { cookieName } = middleware;
+
+console.log(availableLocales); // Çıktı örneği: ["en", "fr", "es"]
+console.log(defaultLocale); // Çıktı örneği: "en"
+console.log(cookieName); // Çıktı: "INTLAYER_LOCALE"
+```
+
+## Notlar
+
+- Bu fonksiyonu çağırmadan önce tüm gerekli ortam değişkenlerinin doğru şekilde ayarlandığından emin olun. Eksik değişkenler başlatma sırasında hatalara neden olur.
+- Bu fonksiyon hem istemci hem de sunucu tarafında kullanılabilir, bu da onu çok yönlü bir araç haline getirir.
+
+## Uygulamalarda Kullanım
+
+`getConfiguration` fonksiyonu, bir `intlayer` uygulamasının yapılandırmasını başlatmak ve yönetmek için temel bir yardımcıdır. Yerel ayarlar, ara yazılım ve içerik dizinleri gibi ayarlara erişim sağlayarak, çok dilli ve içerik odaklı uygulamalarda tutarlılık ve ölçeklenebilirlik sağlar.
+
+## Dokümantasyon Geçmişi
+
+| Sürüm  | Tarih      | Değişiklikler     |
+| ------ | ---------- | ----------------- |
+| 5.5.10 | 2025-06-29 | Geçmiş başlatıldı |
+
+```
+
+```