@intlayer/docs 8.4.6 → 8.4.8

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (33) hide show
  1. package/blog/en/next-i18next_vs_next-intl_vs_intlayer.md +1 -3
  2. package/blog/en-GB/next-i18next_vs_next-intl_vs_intlayer.md +1 -3
  3. package/blog/es/next-i18next_vs_next-intl_vs_intlayer.md +1 -3
  4. package/blog/id/next-i18next_vs_next-intl_vs_intlayer.md +1 -3
  5. package/blog/it/next-i18next_vs_next-intl_vs_intlayer.md +1 -3
  6. package/blog/ja/next-i18next_vs_next-intl_vs_intlayer.md +1 -3
  7. package/blog/ko/next-i18next_vs_next-intl_vs_intlayer.md +1 -3
  8. package/blog/uk/next-i18next_vs_next-intl_vs_intlayer.md +1 -3
  9. package/blog/vi/next-i18next_vs_next-intl_vs_intlayer.md +1 -3
  10. package/blog/zh/next-i18next_vs_next-intl_vs_intlayer.md +1 -3
  11. package/docs/ar/configuration.md +300 -264
  12. package/docs/cs/configuration.md +958 -0
  13. package/docs/de/configuration.md +285 -249
  14. package/docs/en/configuration.md +115 -137
  15. package/docs/en-GB/configuration.md +272 -237
  16. package/docs/es/configuration.md +161 -125
  17. package/docs/fr/configuration.md +137 -101
  18. package/docs/it/configuration.md +294 -259
  19. package/docs/ja/configuration.md +269 -233
  20. package/docs/nl/configuration.md +958 -0
  21. package/docs/pt/configuration.md +311 -275
  22. package/docs/ru/configuration.md +287 -272
  23. package/docs/tr/configuration.md +265 -229
  24. package/package.json +6 -6
  25. package/docs/bn/configuration.md +0 -922
  26. package/docs/hi/configuration.md +0 -922
  27. package/docs/id/configuration.md +0 -922
  28. package/docs/ko/configuration.md +0 -922
  29. package/docs/pl/configuration.md +0 -922
  30. package/docs/uk/configuration.md +0 -922
  31. package/docs/ur/configuration.md +0 -922
  32. package/docs/vi/configuration.md +0 -922
  33. package/docs/zh/configuration.md +0 -922
package/docs/tr/configuration.md CHANGED
@@ -2,7 +2,7 @@
2
2
  createdAt: 2024-08-13
3
3
  updatedAt: 2026-03-20
4
4
  title: Yapılandırma (Configuration)
5
- 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 mevcut çeşitli ayarları ve seçenekleri anlayın.
5
+ 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.
6
6
  keywords:
7
7
  - Yapılandırma
8
8
  - Ayarlar
@@ -16,40 +16,40 @@ slugs:
16
16
  history:
17
17
  - version: 8.4.0
18
18
  date: 2026-03-20
19
- changes: 'compiler.output' ve 'dictionary.fill' için her dil için nesne notasyonu eklendi
19
+ changes: 'compiler.output' ve 'dictionary.fill' için dil başına nesne notasyonu eklendi
20
20
  - version: 8.3.0
21
21
  date: 2026-03-11
22
22
  changes: 'baseDir', 'content' yapılandırmasından 'system' yapılandırmasına taşındı
23
23
  - version: 8.2.0
24
24
  date: 2026-03-09
25
- changes: Derleyici (compiler) seçenekleri güncellendi, 'output' ve 'noMetadata' desteği eklendi
25
+ changes: Derleyici seçenekleri güncellendi, 'output' ve 'noMetadata' desteği eklendi
26
26
  - version: 8.1.7
27
27
  date: 2026-02-25
28
28
  changes: Derleyici seçenekleri güncellendi
29
29
  - version: 8.1.5
30
30
  date: 2026-02-23
31
- changes: Derleyici seçeneği 'build-only' ve sözlük öneki eklendi
31
+ changes: 'build-only' derleyici seçeneği ve sözlük öneki eklendi
32
32
  - version: 8.0.6
33
33
  date: 2026-02-12
34
34
  changes: Open Router, Alibaba, Amazon, Google Vertex Bedrock, Fireworks, Groq, Hugging Face ve Together.ai sağlayıcıları için destek eklendi
35
35
  - version: 8.0.5
36
36
  date: 2026-02-06
37
- changes: Yapay zeka yapılandırmasına `dataSerialization` eklendi
37
+ changes: Yapay Zeka yapılandırmasına `dataSerialization` eklendi
38
38
  - version: 8.0.0
39
39
  date: 2026-01-24
40
- changes: Temel mekanizmayı daha iyi tanımlamak için `live` içe aktarma modu `fetch` olarak yeniden adlandırıldı.
40
+ changes: Alttaki mekanizmayı daha iyi tanımlamak için `live` içe aktarma modu `fetch` olarak yeniden adlandırıldı.
41
41
  - version: 8.0.0
42
42
  date: 2026-01-22
43
- changes: Derleme yapılandırması `importMode`, `dictionary` yapılandırmasına taşındı.
43
+ changes: `importMode` derleme yapılandırması `dictionary` yapılandırmasına taşındı.
44
44
  - version: 8.0.0
45
45
  date: 2026-01-22
46
46
  changes: Yönlendirme yapılandırmasına `rewrite` seçeneği eklendi
47
47
  - version: 8.0.0
48
48
  date: 2026-01-18
49
- changes: Sistem yapılandırması içerik yapılandırmasından ayrıldı. Dahili yollar `system` özelliğine taşındı. İçerik dosyalarını ve kod dönüşümünü ayırmak için `codeDir` eklendi.
49
+ changes: Sistem yapılandırması içerik yapılandırmasından ayrıldı. Dahili yollar `system` özelliğine taşındı. İçerik dosyalarını kod dönüşümünden ayırmak için `codeDir` eklendi.
50
50
  - version: 8.0.0
51
51
  date: 2026-01-18
52
- changes: Sözlük seçenekleri `location` ve `schema` eklendi
52
+ changes: `location` ve `schema` sözlük seçenekleri eklendi
53
53
  - version: 7.5.1
54
54
  date: 2026-01-10
55
55
  changes: JSON5 ve JSONC dosya formatları için destek eklendi
@@ -61,7 +61,7 @@ history:
61
61
  changes: `dictionary` yapılandırması eklendi
62
62
  - version: 7.0.0
63
63
  date: 2025-10-21
64
- changes: `middleware`, yönlendirme yapılandırması `routing` ile değiştirildi
64
+ changes: `middleware`, `routing` yapılandırması ile değiştirildi
65
65
  - version: 7.0.0
66
66
  date: 2025-10-12
67
67
  changes: `formatCommand` seçeneği eklendi
@@ -79,13 +79,13 @@ history:
79
79
  changes: `live` içe aktarma modu eklendi
80
80
  - version: 6.0.0
81
81
  date: 2025-09-04
82
- changes: `hotReload` alanı `liveSync` ile değiştirildi ve `liveSyncPort` ve `liveSyncURL` alanları eklendi
82
+ changes: `hotReload` alanı `liveSync` ile değiştirildi ve `liveSyncPort` ile `liveSyncURL` alanları eklendi
83
83
  - version: 5.6.1
84
84
  date: 2025-07-25
85
85
  changes: `activateDynamicImport`, `importMode` seçeneği ile değiştirildi
86
86
  - version: 5.6.0
87
87
  date: 2025-07-13
88
- changes: Varsayılan contentDir `['src']` yerine `['.']` olarak değiştirildi
88
+ changes: Varsayılan `contentDir`, `['src']` yerine `['.']` olarak değiştirildi
89
89
  - version: 5.5.11
90
90
  date: 2025-06-29
91
91
  changes: `docs` komutları eklendi
@@ -95,7 +95,7 @@ history:
95
95
 
96
96
  ## Genel Bakış
97
97
 
98
- Intlayer yapılandırma dosyaları, eklentinin uluslararasılaştırma (internationalization), ara yazılım (middleware) ve içerik işleme gibi çeşitli yönlerini özelleştirmenize olanak tanır. Bu belge, yapılandırmadaki her bir özelliğin derinlemesine açıklamasını sağlar.
98
+ Intlayer yapılandırma dosyaları, uluslararasılaştırma, ara yazılım (middleware) ve içerik yönetimi gibi eklentinin çeşitli yönlerini özelleştirmenize olanak tanır. Bu belge, yapılandırmadaki her özelliğin ayrıntılı bir açıklamasını sunar.
99
99
 
100
100
  ---
101
101
 
@@ -105,9 +105,9 @@ Intlayer yapılandırma dosyaları, eklentinin uluslararasılaştırma (internat
105
105
 
106
106
  ---
107
107
 
108
- ## Desteklenen Yapılandırma Dosyası Formatları
108
+ ## Yapılandırma Dosyası Desteği
109
109
 
110
- Intlayer JSON, JS, MJS ve TS yapılandırma dosyası formatlarını kabul eder:
110
+ Intlayer, JSON, JS, MJS ve TS yapılandırma dosyası formatlarını kabul eder:
111
111
 
112
112
  - `intlayer.config.ts`
113
113
  - `intlayer.config.js`
@@ -120,7 +120,7 @@ Intlayer JSON, JS, MJS ve TS yapılandırma dosyası formatlarını kabul eder:
120
120
 
121
121
  ---
122
122
 
123
- ## Yapılandırma Dosyası Örneği
123
+ ## Örnek Yapılandırma Dosyası
124
124
 
125
125
  ````typescript fileName="intlayer.config.ts" codeFormat="typescript"
126
126
  import { Locales, type IntlayerConfig } from "intlayer";
@@ -132,27 +132,27 @@ import { z } from "zod";
132
132
  */
133
133
  const config: IntlayerConfig = {
134
134
  /**
135
- * Uluslararasılaştırma ayarları yapılandırması.
135
+ * Uluslararasılaştırma ayarları için yapılandırma.
136
136
  */
137
137
  internationalization: {
138
138
  /**
139
- * Uygulamada desteklenen dillerin (locales) listesi.
139
+ * Uygulamada desteklenen dillerin listesi.
140
140
  * Varsayılan: [Locales.ENGLISH]
141
141
  */
142
142
  locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],
143
143
 
144
144
  /**
145
145
  * Her sözlükte tanımlanması gereken zorunlu dillerin listesi.
146
- * Boşsa, `strict` modunda tüm diller zorunludur.
146
+ * Boşsa, `strict` modda tüm diller zorunludur.
147
147
  * Varsayılan: []
148
148
  */
149
149
  requiredLocales: [Locales.ENGLISH],
150
150
 
151
151
  /**
152
- * Uluslararasılaştırılmış içerik için katılik düzeyi.
153
- * - "strict": Bildirilen herhangi bir dil eksikse veya bildirilmemişse hata verir.
152
+ * Uluslararasılaştırılmış içerik için katılık seviyesi.
153
+ * - "strict": Bildirilen bir dil eksikse veya bildirilmemişse hata verir.
154
154
  * - "inclusive": Bildirilen bir dil eksikse uyarı verir.
155
- * - "loose": Mevcut olan her dili kabul eder.
155
+ * - "loose": Mevcut herhangi bir dili kabul eder.
156
156
  * Varsayılan: "inclusive"
157
157
  */
158
158
  strictMode: "inclusive",
@@ -172,14 +172,14 @@ const config: IntlayerConfig = {
172
172
  * Sözlüklerin nasıl içe aktarılacağını kontrol eder.
173
173
  * - "static": Derleme zamanında statik olarak içe aktarılır.
174
174
  * - "dynamic": Suspense kullanılarak dinamik olarak içe aktarılır.
175
- * - "fetch": Live Sync API aracılığıyla dinamik olarak çekilir.
175
+ * - "fetch": Live Sync API aracılığıyla dinamik olarak getirilir.
176
176
  * Varsayılan: "static"
177
177
  */
178
178
  importMode: "static",
179
179
 
180
180
  /**
181
- * Yapay zeka kullanarak eksik çevirileri otomatik olarak doldurma stratejisi.
182
- * Mantıksal bir değer veya doldurulan içeriği kaydetmek için bir yol deseni olabilir.
181
+ * Eksik çevirileri yapay zeka kullanarak otomatik doldurma stratejisi.
182
+ * Bir boolean değer veya doldurulan içeriği saklamak için bir yol kalıbı olabilir.
183
183
  * Varsayılan: true
184
184
  */
185
185
  fill: true,
@@ -187,15 +187,15 @@ const config: IntlayerConfig = {
187
187
  /**
188
188
  * Sözlük dosyalarının fiziksel konumu.
189
189
  * - "local": Yerel dosya sisteminde saklanır.
190
- * - "remote": Intlayer CMS'te saklanır.
191
- * - "hybrid": Hem yerel hem de Intlayer CMS'te saklanır.
192
- * - "plugin" (veya herhangi bir özel dize): Bir eklenti veya özel kaynak tarafından sağlanır.
190
+ * - "remote": Intlayer CMS'de saklanır.
191
+ * - "hybrid": Hem yerel dosya sisteminde hem de Intlayer CMS'de saklanır.
192
+ * - "plugin" (veya herhangi bir özel dize): Bir eklenti veya özel bir kaynak tarafından sağlanır.
193
193
  * Varsayılan: "local"
194
194
  */
195
195
  location: "local",
196
196
 
197
197
  /**
198
- * İçeriğin otomatik olarak dönüştürülüp dönüştürülmeyeceği (ör. Markdown'dan HTML'e).
198
+ * İçeriklerin otomatik olarak dönüştürülüp dönüştürülmeyeceği (örneğin Markdown'dan HTML'e).
199
199
  * Varsayılan: false
200
200
  */
201
201
  contentAutoTransformation: false,
@@ -207,16 +207,16 @@ const config: IntlayerConfig = {
207
207
  routing: {
208
208
  /**
209
209
  * Dil yönlendirme stratejisi.
210
- * - "prefix-no-default": Varsayılan dışındaki herkese ön ek ekler (ör. /dashboard, /fr/dashboard).
211
- * - "prefix-all": Tüm dillere ön ek ekler (ör. /en/dashboard, /fr/dashboard).
210
+ * - "prefix-no-default": Varsayılan dil dışındaki tüm diller için önek (örneğin /dashboard, /fr/dashboard).
211
+ * - "prefix-all": Tüm diller için önek (örneğin /en/dashboard, /fr/dashboard).
212
212
  * - "no-prefix": URL'de dil yok.
213
- * - "search-params": ?locale=... kullanır
213
+ * - "search-params": ?locale=... kullanır.
214
214
  * Varsayılan: "prefix-no-default"
215
215
  */
216
216
  mode: "prefix-no-default",
217
217
 
218
218
  /**
219
- * Kullanıcı tarafından seçilen dilin nerede saklanacağı.
219
+ * Kullanıcının seçtiği dilin nerede saklanacağı.
220
220
  * Seçenekler: 'cookie', 'localStorage', 'sessionStorage', 'header' veya bunların bir dizisi.
221
221
  * Varsayılan: ['cookie', 'header']
222
222
  */
@@ -229,7 +229,7 @@ const config: IntlayerConfig = {
229
229
  basePath: "",
230
230
 
231
231
  /**
232
- * Dil bazlı belirli yollar için özel URL yeniden yazma (rewrite) kuralları.
232
+ * Dile özel yollar için özel URL yeniden yazma kuralları.
233
233
  */
234
234
  rewrite: nextjsRewrite({
235
235
  "/[locale]/about": {
@@ -240,11 +240,11 @@ const config: IntlayerConfig = {
240
240
  },
241
241
 
242
242
  /**
243
- * İçerik dosyası bulma ve işleme ile ilgili ayarlar.
243
+ * İçerik dosyalarını bulma ve işleme ayarları.
244
244
  */
245
245
  content: {
246
246
  /**
247
- * Sözlükleri taramak için dosya uzantıları.
247
+ * Sözlükler için taranacak dosya uzantıları.
248
248
  * Varsayılan: ['.content.ts', '.content.js', '.content.json', vb.]
249
249
  */
250
250
  fileExtensions: [".content.ts", ".content.js", ".content.json"],
@@ -256,54 +256,54 @@ const config: IntlayerConfig = {
256
256
  contentDir: ["src"],
257
257
 
258
258
  /**
259
- * Kaynak kodun bulunduğu yer.
259
+ * Kaynak kodun bulunduğu dizin.
260
260
  * Derleme optimizasyonu ve kod dönüşümü için kullanılır.
261
261
  * Varsayılan: ["."]
262
262
  */
263
263
  codeDir: ["src"],
264
264
 
265
265
  /**
266
- * Taramadan hariç tutulan desenler.
266
+ * Taramadan hariç tutulacak kalıplar.
267
267
  * Varsayılan: ['node_modules', '.intlayer', vb.]
268
268
  */
269
269
  excludedPath: ["node_modules"],
270
270
 
271
271
  /**
272
272
  * Geliştirme sırasında değişikliklerin izlenip izlenmeyeceği ve sözlüklerin yeniden oluşturulup oluşturulmayacağı.
273
- * Varsayılan: Geliştirme ortamında true
273
+ * Varsayılan: Geliştirmede true
274
274
  */
275
275
  watch: true,
276
276
 
277
277
  /**
278
- * Yeni oluşturulan / güncellenen .content dosyalarını biçimlendirmek için kullanılan komut.
278
+ * Yeni oluşturulan / güncellenen .content dosyalarını biçimlendirmek için komut.
279
279
  */
280
280
  formatCommand: 'npx prettier --write "{{file}}"',
281
281
  },
282
282
 
283
283
  /**
284
- * Görsel Düzenleyici (Visual Editor) yapılandırması.
284
+ * Görsel Editör yapılandırması.
285
285
  */
286
286
  editor: {
287
287
  /**
288
- * Görsel düzenleyicinin etkin olup olmadığı.
288
+ * Görsel editörün etkin olup olmadığı.
289
289
  * Varsayılan: false
290
290
  */
291
291
  enabled: true,
292
292
 
293
293
  /**
294
- * Kaynak doğrulama (origin validation) için uygulamanızın URL'si.
294
+ * Kaynak doğrulaması için uygulamanızın URL'si.
295
295
  * Varsayılan: ""
296
296
  */
297
297
  applicationURL: "http://localhost:3000",
298
298
 
299
299
  /**
300
- * Yerel düzenleyici sunucusu için bağlantı noktası.
300
+ * Yerel editör sunucusu için port.
301
301
  * Varsayılan: 8000
302
302
  */
303
303
  port: 8000,
304
304
 
305
305
  /**
306
- * Düzenleyici için genel URL.
306
+ * Editör için genel URL.
307
307
  * Varsayılan: "http://localhost:8000"
308
308
  */
309
309
  editorURL: "http://localhost:8000",
@@ -328,7 +328,7 @@ const config: IntlayerConfig = {
328
328
  },
329
329
 
330
330
  /**
331
- * Yapay zeka tabanlı çeviri ve oluşturma ayarları.
331
+ * Yapay zeka destekli çeviri ve oluşturma ayarları.
332
332
  */
333
333
  ai: {
334
334
  /**
@@ -339,31 +339,31 @@ const config: IntlayerConfig = {
339
339
  provider: "openai",
340
340
 
341
341
  /**
342
- * Kullanılacak seçili sağlayıcının modeli.
342
+ * Seçilen sağlayıcıdan kullanılacak model.
343
343
  */
344
344
  model: "gpt-4o",
345
345
 
346
346
  /**
347
- * Sağlayıcı API anahtarı.
347
+ * Sağlayıcının API anahtarı.
348
348
  */
349
349
  apiKey: process.env.OPENAI_API_KEY,
350
350
 
351
351
  /**
352
- * Çeviriler oluşturulurken yapay zekayı yönlendirmek için genel bağlam.
352
+ * Çeviri oluştururken yapay zekaya rehberlik edecek küresel bağlam.
353
353
  */
354
- applicationContext: "Bu bir gezi rezervasyon uygulamasıdır.",
354
+ applicationContext: "Bu bir seyahat rezervasyon uygulamasıdır.",
355
355
 
356
356
  /**
357
- * Yapay zeka API'si için temel yol URL'si.
357
+ * Yapay zeka API'si için temel URL.
358
358
  */
359
359
  baseURL: "http://localhost:3000",
360
360
 
361
361
  /**
362
- * Veri Serileştirme (Data Serialization)
362
+ * Veri Serileştirme
363
363
  *
364
364
  * Seçenekler:
365
- * - "json": Varsayılan, sağlam; daha fazla belirteç tüketir.
366
- * - "toon": Daha az belirteç tüketir, JSON kadar tutarlı olmayabilir.
365
+ * - "json": Varsayılan, güvenilir; daha fazla token tüketir.
366
+ * - "toon": Daha az token, JSON kadar tutarlı değil.
367
367
  *
368
368
  * Varsayılan: "json"
369
369
  */
@@ -376,15 +376,15 @@ const config: IntlayerConfig = {
376
376
  build: {
377
377
  /**
378
378
  * Derleme yürütme modu.
379
- * - "auto": Uygulama derlemesi sırasında otomatik olarak derlenir.
379
+ * - "auto": Uygulama derlemesi sırasında otomatik derleme.
380
380
  * - "manual": Açık bir derleme komutu gerektirir.
381
381
  * Varsayılan: "auto"
382
382
  */
383
383
  mode: "auto",
384
384
 
385
385
  /**
386
- * Kullanılmayan sözlükleri kaldırarak nihai paketi optimize edip etmeyeceği.
387
- * Varsayılan: Üretim ortamında true
386
+ * Kullanılmayan sözlükleri kaldırarak final paketinin optimize edilip edilmeyeceği.
387
+ * Varsayılan: Üretimde true
388
388
  */
389
389
  optimize: true,
390
390
 
@@ -395,34 +395,34 @@ const config: IntlayerConfig = {
395
395
  outputFormat: ["cjs", "esm"],
396
396
 
397
397
  /**
398
- * Derlemenin TypeScript türlerini (types) kontrol edip etmeyeceğini belirtir.
398
+ * Derlemenin TypeScript türlerini kontrol edip etmeyeceği.
399
399
  * Varsayılan: false
400
400
  */
401
401
  checkTypes: false,
402
402
  },
403
403
 
404
404
  /**
405
- * Günlükçü (Logger) yapılandırması.
405
+ * Logger yapılandırması.
406
406
  */
407
407
  log: {
408
408
  /**
409
- * Günlükleme düzeyi.
410
- * - "default": Standart günlükleme.
411
- * - "verbose": Derinlemesine hata ayıklama günlüğü.
412
- * - "disabled": Günlüklemeyi devre dışı bırakır.
409
+ * Günlük kaydı seviyesi.
410
+ * - "default": Standart günlük kaydı.
411
+ * - "verbose": Ayrıntılı hata ayıklama günlüğü.
412
+ * - "disabled": Günlük kaydı yok.
413
413
  * Varsayılan: "default"
414
414
  */
415
415
  mode: "default",
416
416
 
417
417
  /**
418
- * Tüm günlük mesajları için ön ek.
418
+ * Tüm günlük mesajları için önek.
419
419
  * Varsayılan: "[intlayer]"
420
420
  */
421
421
  prefix: "[intlayer]",
422
422
  },
423
423
 
424
424
  /**
425
- * Sistem yapılandırması (Gelişmiş kullanım için)
425
+ * Sistem Yapılandırması (Gelişmiş Kullanım Durumları)
426
426
  */
427
427
  system: {
428
428
  /**
@@ -431,7 +431,7 @@ const config: IntlayerConfig = {
431
431
  dictionariesDir: ".intlayer/dictionary",
432
432
 
433
433
  /**
434
- * TypeScript modül genişletme (module augmentation) için dizin.
434
+ * Modül genişletme (module augmentation) dizini.
435
435
  */
436
436
  moduleAugmentationDir: ".intlayer/types",
437
437
 
@@ -462,32 +462,32 @@ const config: IntlayerConfig = {
462
462
  },
463
463
 
464
464
  /**
465
- * Derleyici (Compiler) yapılandırması (Gelişmiş kullanım için)
465
+ * Derleyici Yapılandırması (Gelişmiş Kullanım Durumları)
466
466
  */
467
467
  compiler: {
468
468
  /**
469
- * Derleyicinin etkin olup olmayacağını belirtir.
469
+ * Derleyicinin etkin olup olmayacağı.
470
470
  *
471
- * - false: Derleyiciyi devre dışı bırakır.
472
- * - true: Derleyiciyi etkinleştirir.
473
- * - "build-only": Geliştirme sırasında derleyiciyi atlar ve başlatma süresini hızlandırır.
471
+ * - false: Derleyiciyi devre dışı bırak.
472
+ * - true: Derleyiciyi etkinleştir.
473
+ * - "build-only": Başlangıç sürelerini hızlandırmak için geliştirme sırasında derleyiciyi atla.
474
474
  *
475
475
  * Varsayılan: false
476
476
  */
477
477
  enabled: true,
478
478
 
479
479
  /**
480
- * Çıktı dosyaları için yolu tanımlar. `outputDir`'in yerini alır.
480
+ * Çıktı dosyaları için yolu belirler. `outputDir` yerine geçer.
481
481
  *
482
- * - `./` ile başlayan yollar bileşen dizinine göre çözümlenir.
483
- * - `/` ile başlayan yollar proje köküne (`baseDir`) göre çözümlenir.
482
+ * - `./` yolları bileşen dizinine göre çözümlenir.
483
+ * - `/` yolları proje köküne (`baseDir`) göre çözümlenir.
484
484
  *
485
- * - Yola `{{locale}}` değişkenini dahil etmek, her dil için ayrı sözlüklerin oluşturulmasını tetikleyecektir.
485
+ * - Yol içinde `{{locale}}` değişkeninin bulunması, dile göre ayrı sözlükler oluşturulmasını tetikler.
486
486
  *
487
487
  * Örnek:
488
488
  * ```ts
489
489
  * {
490
- * // Bileşenin yanında çok dilli .content.ts dosyaları oluşturun
490
+ * // Bileşenin yanında çok dilli .content.ts dosyaları oluştur
491
491
  * output: ({ fileName, extension }) => `./${fileName}${extension}`,
492
492
  *
493
493
  * // output: './{{fileName}}{{extension}}', // Şablon dizesi kullanarak eşdeğer
@@ -496,17 +496,17 @@ const config: IntlayerConfig = {
496
496
  *
497
497
  * ```ts
498
498
  * {
499
- * // Proje kökünde dil başına merkezi JSON'lar oluşturun
499
+ * // Proje kökünde dile göre merkezileştirilmiş JSON'lar oluştur
500
500
  * output: ({ key, locale }) => `/locales/${locale}/${key}.content.json`,
501
501
  *
502
502
  * // output: '/locales/{{locale}}/{{key}}.content.json', // Şablon dizesi kullanarak eşdeğer
503
503
  * }
504
504
  * ```
505
505
  *
506
- * Değişken listesi:
506
+ * Değişken Listesi:
507
507
  * - `fileName`: Dosya adı.
508
- * - `key`: İçerik anahtarı (key).
509
- * - `locale`: İçerik dili.
508
+ * - `key`: İçerik anahtarı.
509
+ * - `locale`: İçerik dili (locale).
510
510
  * - `extension`: Dosya uzantısı.
511
511
  * - `componentFileName`: Bileşen dosya adı.
512
512
  * - `componentExtension`: Bileşen dosya uzantısı.
@@ -517,24 +517,24 @@ const config: IntlayerConfig = {
517
517
  output: ({ locale, key }) => `compiler/${locale}/${key}.json`,
518
518
 
519
519
  /**
520
- * Bileşenlerin dönüştürüldükten sonra kaydedilip kaydedilmeyeceğini belirtir.
521
- * Bu şekilde, derleyici uygulamanızı dönüştürmek için yalnızca bir kez çalışabilir ve ardından kaldırılabilir.
520
+ * Dönüştürüldükten sonra bileşenlerin kaydedilip kaydedilmeyeceği.
521
+ * Bu sayede derleyici uygulamayı dönüştürmek için yalnızca bir kez çalıştırılabilir ve ardından kaldırılabilir.
522
522
  */
523
523
  saveComponents: false,
524
524
 
525
525
  /**
526
- * Oluşturulan dosyaya yalnızca içeriği ekler. i18next veya ICU MessageFormat formatı için dil başına JSON çıktısı için yararlıdır.
526
+ * Oluşturulan dosyaya yalnızca içeriği ekle. Dile göre i18next veya ICU MessageFormat JSON çıktıları için yararlıdır.
527
527
  */
528
528
  noMetadata: false,
529
529
 
530
530
  /**
531
- * Sözlük anahtarı ön eki
531
+ * Sözlük anahtar öneki
532
532
  */
533
- dictionaryKeyPrefix: "", // Ayıklanan sözlük anahtarlarına isteğe bağlı bir ön ek ekleyin
533
+ dictionaryKeyPrefix: "", // Çıkarılan sözlük anahtarları için isteğe bağlı önek ekleyin
534
534
  },
535
535
 
536
536
  /**
537
- * Sözlük içeriğini doğrulamak için özel şemalar (Schemas).
537
+ * Sözlüklerin içeriğini doğrulamak için özel şemalar.
538
538
  */
539
539
  schemas: {
540
540
  "my-schema": z.object({
@@ -553,56 +553,58 @@ export default config;
553
553
 
554
554
  ---
555
555
 
556
- ## Yapılandırma Referansı (Configuration Reference)
556
+ ## Yapılandırma Referansı
557
557
 
558
- Aşağıdaki bölümler, Intlayer'da mevcut olan çeşitli yapılandırma seçeneklerini açıklamaktadır.
558
+ Aşağıdaki bölümler Intlayer için mevcut olan çeşitli yapılandırma ayarlarını açıklamaktadır.
559
559
 
560
560
  ---
561
561
 
562
- ### Uluslararasılaştırma Yapılandırması (Internationalization Configuration)
562
+ ### Uluslararasılaştırma Yapılandırması
563
563
 
564
- Uygulama için mevcut diller ve varsayılan dil dahil olmak üzere uluslararasılaştırma ile ilgili ayarları tanımlar.
564
+ Mevcut diller ve uygulama için varsayılan dil de dahil olmak üzere uluslararasılaştırma ile ilgili ayarları tanımlar.
565
565
 
566
- | Alan | Tür | Açıklama | Örnek | Not |
567
- | ----------------- | ---------- | ------------------------------------------------------------------------------------------------------------------------------ | -------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
568
- | `locales` | `string[]` | Uygulamada destekleyen dillerin listesi. Varsayılan: `[Locales.ENGLISH]` | `['en', 'fr', 'es']` | |
569
- | `requiredLocales` | `string[]` | Uygulamada gerekli dillerin listesi. Varsayılan: `[]` | `[]` | Boşsa, `strict` modunda tüm diller gereklidir. Gerekli dillerin `locales` alanında da tanımlandığından emin olun. |
570
- | `strictMode` | `string` | TypeScript kullanımı yoluyla uluslararasılaştırılmış içeriğin sağlam bir şekilde uygulanmasını sağlar. Varsayılan: `inclusive` | | `"strict"` ise: `t` fonksiyonu bildirilen her dilin tanımlanmasını gerektirir — herhangi biri eksikse veya bildirilmemişse hata verir. `"inclusive"` ise: eksik diller için uyarır ancak bildirilmeyen dilleri kabul eder. `"loose"` ise: mevcut olan her dili kabul eder. |
571
- | `defaultLocale` | `string` | İstenen dil bulunamadığında geri dönüş olarak kullanılan varsayılan dil. Varsayılan: `Locales.ENGLISH` | `'en'` | URL'de, tanımlama bilgisinde veya başlıkta belirtilmediğinde dili belirlemek için kullanılır. |
566
+ | Alan | Açıklama | Tür | Varsayılan | Örnek | Not |
567
+ | ---------------- | -------------------------------------------------------------------------------------------------- | ---------- | ------------------- | -------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
568
+ | `locales` | Uygulamada desteklenen dillerin listesi. | `string[]` | `[Locales.ENGLISH]` | `['en', 'fr', 'es']` | |
569
+ | `requiredLocales` | Uygulamada gerekli olan dillerin listesi. | `string[]` | `[]` | `[]` | • Boşsa, `strict` modda tüm diller gereklidir.<br/>• Gerekli dillerin `locales` alanında da tanımlandığından emin olun. |
570
+ | `strictMode` | TypeScript kullanarak uluslararasılaştırılmış içeriğin sağlam uygulamalarını sağlar. | `string` | `'inclusive'` | | • `"strict"` ise: `t` fonksiyonu bildirilen her dilin tanımlanmış olmasını gerektirir — eksikse veya bildirilmemişse hata verir.<br/>• `"inclusive"` ise: Eksik diller için uyarı verir ancak bildirilmeyenlerin kullanımına izin verir.<br/>• `"loose"` ise: Mevcut herhangi bir dili kabul eder. |
571
+ | `defaultLocale` | İstenen dil bulunamadığında geri dönüş olarak kullanılan varsayılan dil. | `string` | `Locales.ENGLISH` | `'en'` | URL'de, tanımlama bilgisinde (cookie) veya üstbilgide (header) belirtilmediğinde dili belirlemek için kullanılır. |
572
572
 
573
573
  ---
574
574
 
575
- ### Düzenleyici Yapılandırması (Editor Configuration)
575
+ ### Editör Yapılandırması
576
+
577
+ Sunucu portu ve etkinleştirme durumu dahil olmak üzere yerleşik görsel editör ayarlarını tanımlar.
578
+
579
+ | Alan | Açıklama | Tür | Varsayılan | Örnek | Not |
580
+ | --------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ | --------------------------------- | ----------------------------------- | ----------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
581
+ | `applicationURL` | Uygulamanın URL'si. | `string` | `undefined` | `'http://localhost:3000'` <br/> `'https://example.com'` <br/> `process.env.INTLAYER_EDITOR_URL` | • Güvenlik nedeniyle editörün kaynağını kısıtlamak için kullanılır.<br/>• `'*'` olarak ayarlanırsa, editöre herhangi bir kaynaktan erişilebilir. |
582
+ | `port` | Görsel editör sunucusu tarafından kullanılan port. | `number` | `8000` | | |
583
+ | `editorURL` | Editör sunucusunun URL'si. | `string` | `'http://localhost:8000'` | `'http://localhost:3000'` <br/> `'https://example.com'` <br/> `process.env.INTLAYER_EDITOR_URL` | • Uygulama ile etkileşime girebilecek kaynakları kısıtlamak için kullanılır.<br/>• `'*'` olarak ayarlanırsa, herhangi bir kaynaktan erişilebilir.<br/>• Port değiştirilirse veya editör farklı bir alanda barındırılıyorsa ayarlanmalıdır. |
584
+ | `cmsURL` | Intlayer CMS URL'si. | `string` | `'https://app.intlayer.org'` | `'https://app.intlayer.org'` | |
585
+ | `backendURL` | Arka uç sunucusunun URL'si. | `string` | `https://back.intlayer.org` | `http://localhost:4000` | |
586
+ | `enabled` | Uygulamanın görsel editörle etkileşime girip girmeyeceği. | `boolean` | `false` | `process.env.NODE_ENV !== 'production'` | • `false` ise editör uygulama ile etkileşime giremez.<br/>• Belirli ortamlar için devre dışı bırakmak güvenliği artırır. |
587
+ | `clientId` | intlayer paketlerinin oAuth2 üzerinden arka uç ile kimlik doğrulaması yapmasına olanak tanır. Erişim belirteci almak için [intlayer.org/project](https://app.intlayer.org/project) adresine gidin. | `string` &#124; <br/> `undefined` | `undefined` | | Gizli tutulmalıdır; ortam değişkenlerinde saklayın. |
588
+ | `clientSecret` | intlayer paketlerinin oAuth2 üzerinden arka uç ile kimlik doğrulaması yapmasına olanak tanır. Erişim belirteci almak için [intlayer.org/project](https://app.intlayer.org/project) adresine gidin. | `string` &#124; <br/> `undefined` | `undefined` | | Gizli tutulmalıdır; ortam değişkenlerinde saklayın. |
589
+ | `dictionaryPriorityStrategy` | Hem yerel hem de uzak sözlükler mevcut olduğunda sözlüklere öncelik verme stratejisi. | `string` | `'local_first'` | `'distant_first'` | • `'distant_first'`: uzak sözlüklere yerellere göre öncelik verir.<br/>• `'local_first'`: yerellere uzaklara göre öncelik verir. |
590
+ | `liveSync` | CMS <br/> Görsel Editör <br/> Arka Uç'ta bir değişiklik algılandığında uygulama sunucusunun içeriği anında yeniden yükleyip yüklemeyeceği. | `boolean` | `true` | `true` | • Bir sözlük eklendiğinde/güncellendiğinde uygulama sayfa içeriğini yeniler.<br/>• Live Sync, içeriği başka bir sunucuya taşır ve bu performansı biraz etkileyebilir.<br/>• Her ikisinin de aynı makinede barındırılması önerilir. |
591
+ | `liveSyncPort` | Live Sync sunucusunun portu. | `number` | `4000` | `4000` | |
592
+ | `liveSyncURL` | Live Sync sunucusunun URL'si. | `string` | `'http://localhost:{liveSyncPort}'` | `'https://example.com'` | Varsayılan olarak localhost'u gösterir; uzak bir Live Sync sunucusu için değiştirilebilir. |
576
593
 
577
- Sunucu bağlantı noktası ve etkinlik durumu dahil olmak üzere entegre düzenleyici ile ilgili ayarları tanımlar.
578
-
579
- | Alan | Tür | Açıklama | Örnek | Not |
580
- | ---------------------------- | ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
581
- | `applicationURL` | `string` | Uygulamanızın URL'si. Varsayılan: `''` | `'http://localhost:3000'`, `'https://example.com'`, `process.env.INTLAYER_EDITOR_URL` | Güvenlik nedenleriyle düzenleyicinin kaynaklarını (origins) kısıtlamak için kullanılır. `'*'` olarak ayarlanırsa, düzenleyiciye herhangi bir kaynaktan erişilebilir. |
582
- | `port` | `number` | Görsel Düzenleyici sunucusu tarafından kullanılan bağlantı noktası. Varsayılan: `8000` | | |
583
- | `editorURL` | `string` | Düzenleyici sunucu URL'si. Varsayılan: `'http://localhost:8000'` | `'http://localhost:3000'`, `'https://example.com'`, `process.env.INTLAYER_EDITOR_URL` | Uygulama ile etkileşime girebilen kaynakları kısıtlamak için kullanılır. `'*'` olarak ayarlanırsa, herhangi bir kaynaktan erişilebilir. Bağlantı noktasını değiştirirseniz veya düzenleyici başka bir alanda barındırılıyorsa ayarlanmalıdır. |
584
- | `cmsURL` | `string` | Intlayer CMS URL'si. Varsayılan: `'https://intlayer.org'` | `'https://intlayer.org'` | |
585
- | `backendURL` | `string` | Arka uç sunucu URL'si. Varsayılan: `https://back.intlayer.org` | `http://localhost:4000` | |
586
- | `enabled` | `boolean` | Uygulamanın görsel düzenleyici ile etkileşime girip girmeyeceğini belirtir. Varsayılan: `true` | `process.env.NODE_ENV !== 'production'` | `false` ise, düzenleyici uygulama ile etkileşime giremez. Belirli ortamlar için devre dışı bırakılması güvenliği artırır. |
587
- | `clientId` | `string &#124; undefined` | oAuth2 kullanarak arka uçla kimlik doğrulaması yapmak için intlayer paketlerini etkinleştirir. Bir erişim belirteci almak için [intlayer.org/project](https://app.intlayer.org/project) adresine gidin. Varsayılan: `undefined` | | Gizli tutun; ortam değişkenlerinde saklayın. |
588
- | `clientSecret` | `string &#124; undefined` | oAuth2 kullanarak arka uçla kimlik doğrulaması yapmak için intlayer paketlerini etkinleştirir. Bir erişim belirteci almak için [intlayer.org/project](https://app.intlayer.org/project) adresine gidin. Varsayılan: `undefined` | | Gizli tutun; ortam değişkenlerinde saklayın. |
589
- | `dictionaryPriorityStrategy` | `string` | Hem yerel hem de uzak sözlükler mevcut olduğunda sözlük önceliklendirme stratejisi. Varsayılan: `'local_first'` | `'distant_first'` | `'distant_first'`: Uzak sözlüklere yerel olanlara göre öncelik verir. `'local_first'`: Yerel sözlüklere uzak olanlara göre öncelik verir. |
590
- | `liveSync` | `boolean` | CMS / Görsel Düzenleyici / Arka Uçta bir değişiklik algılandığında uygulama sunucusunun içeriği sıcak olarak yeniden yükleyip yüklemeyeceğini belirtir. Varsayılan: `true` | `true` | Bir sözlük eklendiğinde/güncellendiğinde uygulama sayfa içeriğini günceller. Canlı senkronizasyon (live sync), içeriği başka bir sunucuya dış kaynaklardan aktarır ve bu da performansı biraz etkileyebilir. Her ikisinin de aynı makinede barındırılması önerilir. |
591
- | `liveSyncPort` | `number` | Canlı senkronizasyon sunucu bağlantı noktası. Varsayılan: `4000` | `4000` | |
592
- | `liveSyncURL` | `string` | Canlı senkronizasyon sunucu URL'si. Varsayılan: `'http://localhost:{liveSyncPort}'` | `'https://example.com'` | Varsayılan olarak localhost'u gösterir; uzak bir canlı senkronizasyon sunucusuna değiştirilebilir. |
594
+ ---
593
595
 
594
- ### Yönlendirme Yapılandırması (Routing Configuration)
596
+ ### Yönlendirme Yapılandırması
595
597
 
596
- URL yapısı, dil depolama ve ara yazılım işleme dahil olmak üzere yönlendirme davranışını kontrol eden ayarlar.
598
+ URL yapısı, dil saklama ve ara yazılım yönetimi dahil olmak üzere yönlendirme davranışını kontrol eden ayarlar.
597
599
 
598
- | Alan | Tür | Açıklama | Örnek | Not |
599
- | ---------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
600
- | `mode` | `'prefix-no-default' &#124; 'prefix-all' &#124; 'no-prefix' &#124; 'search-params'` | Dil işleme için URL yönlendirme modu. Varsayılan: `'prefix-no-default'` | `'prefix-no-default'`: `/dashboard` (en) veya `/fr/dashboard` (fr). `'prefix-all'`: `/en/dashboard`. `'no-prefix'`: dil başka yollarla işlenir. `'search-params'`: `/dashboard?locale=fr` kullanır | Tanımlama bilgisi veya dil depolama yönetimini etkilemez. |
601
- | `storage` | `false &#124; 'cookie' &#124; 'localStorage' &#124; 'sessionStorage' &#124; 'header' &#124; CookiesAttributes &#124; StorageAttributes &#124; Array` | Dili istemcide saklamak için yapılandırma. Varsayılan: `['cookie', 'header']` | `'localStorage'`, `[{ type: 'cookie', name: 'custom-locale', secure: true }]` | Aşağıdaki Depolama Seçenekleri tablosuna bakın. |
602
- | `basePath` | `string` | Uygulama URL'leri için temel yol. Varsayılan: `''` | `'/my-app'` | Uygulama `https://example.com/my-app` üzerindeyse, basePath `'/my-app'` olur ve URL'ler `https://example.com/my-app/en` gibi olur. |
603
- | `rewrite` | `Record<string, StrictModeLocaleMap<string>>` | Belirli yollar için varsayılan yönlendirme modunu geçersiz kılan özel URL yeniden yazma kuralları. Dinamik parametreleri `[param]` destekler. Varsayılan: `undefined` | Aşağıdaki örneğe bakın | Yeniden yazma kuralları `mode` üzerinde önceliğe sahiptir. Next.js ve Vite ile çalışır. `getLocalizedUrl()` eşleşen kuralları otomatik olarak uygular. [Özel URL Yeniden Yazmaları](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/custom_url_rewrites.md) konusuna bakın. |
600
+ | Alan | Açıklama | Tür | Varsayılan | Örnek | Not |
601
+ | ---------- | ----------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
602
+ | `mode` | Dil yönetimi için URL yönlendirme modu. | `'prefix-no-default'` &#124; <br/> `'prefix-all'` &#124; <br/> `'no-prefix'` &#124; <br/> `'search-params'` | `'prefix-no-default'` | `'prefix-no-default'`: `/dashboard` (en) veya `/fr/dashboard` (fr). `'prefix-all'`: `/en/dashboard`. `'no-prefix'`: dil başka yollarla yönetilir. `'search-params'`: `/dashboard?locale=fr` | Tanımlama bilgisi (cookie) veya dil saklama yönetimini etkilemez. |
603
+ | `storage` | İstemcide dilin saklanması için yapılandırma. | `false` &#124; <br/> `'cookie'` &#124; <br/> `'localStorage'` &#124; <br/> `'sessionStorage'` &#124; <br/> `'header'` &#124; <br/> `CookiesAttributes` &#124; <br/> `StorageAttributes` &#124; <br/> `Array` | `['cookie', 'header']` | `'localStorage'` <br/> `[{ type: 'cookie', name: 'custom-locale', secure: true }]` | Aşağıdaki Saklama Seçenekleri tablosuna bakın. |
604
+ | `basePath` | Uygulama URL'leri için temel yol. | `string` | `''` | `'/my-app'` | Uygulama `https://example.com/my-app` adresindeyse, basePath `'/my-app'` olur ve URL'ler `https://example.com/my-app/en` şekline dönüşür. |
605
+ | `rewrite` | Belirli yollar için varsayılan yönlendirme modunu geçersiz kılan özel URL yeniden yazma kuralları. Dinamik `[param]` parametrelerini destekler. | `Record<string, StrictModeLocaleMap<string>>` | `undefined` | Aşağıdaki örneğe bakın | • Yeniden yazma kuralları `mode` üzerinde önceliğe sahiptir.<br/>• Next.js ve Vite ile çalışır.<br/>• `getLocalizedUrl()` eşleşen kuralları otomatik olarak uygular.<br/>• Şuna bakın: [Özel URL Yeniden Yazmaları](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/custom_url_rewrites.md). |
604
606
 
605
- **`rewrite` örneği**:
607
+ **`rewrite` Örneği**:
606
608
 
607
609
  ```typescript
608
610
  routing: {
@@ -624,37 +626,37 @@ routing: {
624
626
  }
625
627
  ```
626
628
 
627
- #### Depolama Seçenekleri (Storage Options)
629
+ #### Saklama Seçenekleri
628
630
 
629
- | Değer | Açıklama | Not |
630
- | ------------------ | --------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
631
- | `'cookie'` | Dili tanımlama bilgilerinde saklar — hem istemci hem de sunucu tarafından erişilebilir. | GDPR uyumluluğu için uygun kullanıcı onayının alındığından emin olun. `CookiesAttributes` aracılığıyla özelleştirilebilir (`{ type: 'cookie', name: 'custom-locale', secure: true, httpOnly: false }`). |
632
- | `'localStorage'` | Dili son kullanma tarihi olmadan tarayıcıda saklar — yalnızca istemci tarafı. | Açıkça temizlenene kadar süresi dolmaz. Intlayer proxy'si buna erişemez. `StorageAttributes` aracılığıyla özelleştirilebilir (`{ type: 'localStorage', name: 'custom-locale' }`). |
633
- | `'sessionStorage'` | Dili sayfa oturumu süresince saklar — yalnızca istemci tarafı. | Sekme/pencere kapatıldığında temizlenir. Intlayer proxy'si buna erişemez. `StorageAttributes` aracılığıyla özelleştirilebilir (`{ type: 'sessionStorage', name: 'custom-locale' }`). |
634
- | `'header'` | Dili HTTP başlıkları aracılığıyla saklar veya iletir — yalnızca sunucu tarafı. | API çağrıları için yararlıdır. İstemci tarafı erişemez. `StorageAttributes` aracılığıyla özelleştirilebilir (`{ type: 'header', name: 'custom-locale' }`). |
631
+ | Değer | Not | Açıklama |
632
+ | ------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------- |
633
+ | `'cookie'` | • GDPR uyumluluğu için uygun kullanıcı onayını aldığınızdan emin olun.<br/>• `CookiesAttributes` (`{ type: 'cookie', name: 'custom-locale', secure: true, httpOnly: false }`) aracılığıyla özelleştirilebilir. | Dili tanımlama bilgilerinde (cookies) saklar — hem istemci hem de sunucu tarafından erişilebilir. |
634
+ | `'localStorage'` | • Açıkça silinmedikçe süresi dolmaz.<br/>• Intlayer proxy'si buna erişemez.<br/>• `StorageAttributes` (`{ type: 'localStorage', name: 'custom-locale' }`) aracılığıyla özelleştirilebilir. | Dili tarayıcıda süresiz olarak saklar — sadece istemci tarafı. |
635
+ | `'sessionStorage'` | • Sekme/pencere kapatıldığında silinir.<br/>• Intlayer proxy'si buna erişemez.<br/>• `StorageAttributes` (`{ type: 'sessionStorage', name: 'custom-locale' }`) aracılığıyla özelleştirilebilir. | Dili sayfa oturumu süresince saklar — sadece istemci tarafı. |
636
+ | `'header'` | • API çağrıları için yararlıdır.<br/>• İstemci tarafı buna erişemez.<br/>• `StorageAttributes` (`{ type: 'header', name: 'custom-locale' }`) aracılığıyla özelleştirilebilir. | Dili HTTP üstbilgileri (headers) üzerinden aktarır — sadece sunucu tarafı. |
635
637
 
636
- #### Tanımlama Bilgisi Özellikleri (Cookie Attributes)
638
+ #### Tanımlama Bilgisi (Cookie) Nitelikleri
637
639
 
638
- Tanımlama bilgisi depolamasını kullanırken ek tanımlama bilgisi özelliklerini yapılandırabilirsiniz:
640
+ Tanımlama bilgisi saklama alanını kullanırken, ek nitelikler yapılandırabilirsiniz:
639
641
 
640
- | Alan | Tür | Açıklama |
641
- | ---------- | ------------------------------------- | ------------------------------------------------------------ |
642
- | `name` | `string` | Tanımlama bilgisinin adı. Varsayılan: `'INTLAYER_LOCALE'` |
643
- | `domain` | `string` | Tanımlama bilgisi alanı. Varsayılan: `undefined` |
644
- | `path` | `string` | Tanımlama bilgisi yolu. Varsayılan: `undefined` |
645
- | `secure` | `boolean` | HTTPS gerektirir. Varsayılan: `undefined` |
646
- | `httpOnly` | `boolean` | HTTP-only bayrağı. Varsayılan: `undefined` |
647
- | `sameSite` | `'strict' &#124; 'lax' &#124; 'none'` | SameSite politikası. |
648
- | `expires` | `Date &#124; number` | Son kullanma tarihi veya gün sayısı. Varsayılan: `undefined` |
642
+ | Alan | Açıklama | Tür |
643
+ | ---------- | -------------------------------------------- | ----------------------------------------------------- |
644
+ | `name` | Tanımlama bilgisi adı. Varsayılan: `'INTLAYER_LOCALE'` | `string` |
645
+ | `domain` | Tanımlama bilgisi alanı. Varsayılan: `undefined` | `string` |
646
+ | `path` | Tanımlama bilgisi yolu. Varsayılan: `undefined` | `string` |
647
+ | `secure` | HTTPS gerektirir. Varsayılan: `undefined` | `boolean` |
648
+ | `httpOnly` | HTTP-only bayrağı. Varsayılan: `undefined` | `boolean` |
649
+ | `sameSite` | SameSite politikası. | `'strict'` &#124; <br/> `'lax'` &#124; <br/> `'none'` |
650
+ | `expires` | Sona erme tarihi veya gün sayısı. Varsayılan: `undefined` | `Date` &#124; <br/> `number` |
649
651
 
650
- #### Dil Depolama Özellikleri (Locale Storage Attributes)
652
+ #### Saklama Nitelikleri
651
653
 
652
654
  localStorage veya sessionStorage kullanırken:
653
655
 
654
- | Alan | Tür | Açıklama |
655
- | ------ | ---------------------------------------- | ------------------------------------------------------ |
656
- | `type` | `'localStorage' &#124; 'sessionStorage'` | Depolama türü. |
657
- | `name` | `string` | Depolama anahtarı adı. Varsayılan: `'INTLAYER_LOCALE'` |
656
+ | Alan | Açıklama | Tür |
657
+ | ------ | ------------------------------------------- | ------------------------------------------------ |
658
+ | `type` | Saklama türü. | `'localStorage'` &#124; <br/> `'sessionStorage'` |
659
+ | `name` | Saklama anahtarı adı. Varsayılan: `'INTLAYER_LOCALE'` | `string` |
658
660
 
659
661
  #### Yapılandırma Örnekleri
660
662
 
@@ -712,7 +714,7 @@ const config: IntlayerConfig = {
712
714
  export default config;
713
715
  ```
714
716
 
715
- **Arama Parametreleri Modu (Search Parameters Mode)**:
717
+ **Arama Parametresi Modu**:
716
718
 
717
719
  ```typescript
718
720
  import { Locales, type IntlayerConfig } from "intlayer";
@@ -732,7 +734,7 @@ const config: IntlayerConfig = {
732
734
  export default config;
733
735
  ```
734
736
 
735
- **Özel Depolama ile Ön Eki Olmayan Mod (No Prefix Mode)**:
737
+ **Özel Saklama ile Öneksiz Mod**:
736
738
 
737
739
  ```typescript
738
740
  import { Locales, type IntlayerConfig } from "intlayer";
@@ -755,7 +757,7 @@ const config: IntlayerConfig = {
755
757
  export default config;
756
758
  ```
757
759
 
758
- **Dinamik Yollarla Özel URL Yeniden Yazma**:
760
+ **Dinamik Rotalar ile Özel URL Yeniden Yazma**:
759
761
 
760
762
  ```typescript
761
763
  // intlayer.config.ts
@@ -767,7 +769,7 @@ const config: IntlayerConfig = {
767
769
  defaultLocale: "en",
768
770
  },
769
771
  routing: {
770
- mode: "prefix-no-default", // Yeniden yazılmayan yollar için geri dönüş stratejisi
772
+ mode: "prefix-no-default", // Yeniden yazılmayan yollar için geri dönüş
771
773
  storage: "cookie",
772
774
  rewrite: nextjsRewrite({
773
775
  "/about": {
@@ -791,132 +793,166 @@ export default config;
791
793
 
792
794
  ---
793
795
 
794
- ### İçerik Yapılandırması (Content Configuration)
796
+ ### İçerik Yapılandırması
795
797
 
796
- Uygulama içindeki içerik işleme ile ilgili ayarlar (dizin adları, dosya uzantıları ve türetilmiş yapılandırmalar).
798
+ Dizin adları, dosya uzantıları ve türetilmiş yapılandırmalar dahil olmak üzere uygulama içindeki içeriğin nasıl yönetileceği ile ilgili ayarlar.
797
799
 
798
- | Alan | Tür | Açıklama | Örnek | Not |
799
- | ---------------- | ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- |
800
- | `watch` | `boolean` | Intlayer'ın sözlükleri yeniden oluşturmak için içerik bildirim dosyalarındaki değişiklikleri izleyip izlemeyeceğini belirtir. Varsayılan: `process.env.NODE_ENV === 'development'` | | |
801
- | `fileExtensions` | `string[]` | İçerik bildirim dosyalarını taramak için kullanılan dosya uzantıları. Varsayılan: `['.content.ts', '.content.js', '.content.mjs', '.content.cjs', '.content.json', '.content.json5', '.content.jsonc']` | `['.content.ts', '.content.js']` | |
802
- | `contentDir` | `string[]` | İçerik bildirim dosyalarının bulunduğu dizinlerin yolları. Varsayılan: `['.']` | `['src/content']` | |
803
- | `codeDir` | `string[]` | Uygulamanızın kaynak kod dosyalarının bulunduğu dizinlerin yolları. Varsayılan: `['.']` | `['src']` | Derlemeyi optimize etmek ve kod dönüşümü ve sıcak yeniden yüklemenin (hot reload) yalnızca gerekli dosyalara uygulanmasını sağlamak için kullanılır. |
804
- | `excludedPath` | `string[]` | İçerik taramasından hariç tutulan yollar. Varsayılan: `['node_modules', '.intlayer', '.next', 'dist', 'build']` | `['src/styles']` | |
805
- | `formatCommand` | `string` | Yeni oluşturulan veya güncellenen içerik dosyalarını biçimlendirmek için çalıştırılacak komut. Varsayılan: `undefined` | `'npx prettier --write "{{file}}"'` | İçerik ayıklama sırasında veya görsel düzenleyici aracılığıyla kullanılır. |
800
+ | Alan | Açıklama | Tür | Varsayılan | Örnek | Not |
801
+ | ---------------- | ---------------------------------------------------------------------------------------------------------- | ---------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------- |
802
+ | `watch` | Intlayer'ın sözlükleri yeniden oluşturmak için içerik bildirim dosyalarındaki değişiklikleri izleyip izlemeyeceği. | `boolean` | `true` | | |
803
+ | `fileExtensions` | Sözlükleri derlerken taranacak dosya uzantıları. | `string[]` | `['.content.ts', '.content.js', '.content.cjs', '.content.mjs', '.content.json', '.content.json5', '.content.jsonc', '.content.tsx', '.content.jsx']` | `['.data.ts', '.data.js', '.data.json']` | Özelleştirme çatışmaları önlemeye yardımcı olabilir. |
804
+ | `contentDir` | İçerik tanımlama dosyalarının (`.content.*`) saklandığı dizin yolu. | `string[]` | `['.']` | `['src', '../../ui-library', require.resolve("@my-package/content")]` | İçerik dosyalarını izlemek ve sözlükleri yeniden oluşturmak için kullanılır. |
805
+ | `codeDir` | Kodun saklandığı temel dizine göre dizin yolu. | `string[]` | `['.']` | `['src', '../../ui-library']` | • Dönüşüm (budama, optimizasyon) için kod dosyalarını izlemek için kullanılır.<br/>• `contentDir`den ayırmak performansı artırabilir. |
806
+ | `excludedPath` | İçerik taramasından hariç tutulan dizinler. | `string[]` | `['**/node_modules/**', '**/dist/**', '**/build/**', '**/.intlayer/**', '**/.next/**', '**/.nuxt/**', '**/.expo/**', '**/.vercel/**', '**/.turbo/**', '**/.tanstack/**']` | | Henüz kullanılmıyor; gelecekteki uygulama için planlandı. |
807
+ | `formatCommand` | Intlayer onları yerel olarak yazarken içerik dosyalarını biçimlendirme komutu. | `string` | `undefined` | `'npx prettier --write "{{file}}" --log-level silent'` (Prettier), `'npx biome format "{{file}}" --write --log-level none'` (Biome), `'npx eslint --fix "{{file}}" --quiet'` (ESLint) | • `{{file}}` dosya yolu ile değiştirilecektir.<br/>• Tanımlanmazsa, Intlayer bunu otomatik olarak algılar (prettier, biome, eslint'i test eder). |
806
808
 
807
809
  ---
808
810
 
809
- ### Sözlük Yapılandırması (Dictionary Configuration)
810
-
811
- Otomatik doldurma davranışı ve içerik oluşturma dahil olmak üzere sözlük işlemlerini kontrol eden ayarlar.
812
-
813
- Bu sözlük yapılandırmasının iki ana amacı vardır:
811
+ ### Sözlük Yapılandırması
814
812
 
815
- 1. **Varsayılan değerler**: İçerik bildirim dosyaları oluştururken varsayılan değerleri tanımlamak.
816
- 2. **Geri dönüş davranışı**: Belirli alanlar tanımlanmadığında geri dönüş değerleri sağlayarak sözlük işlemlerinin davranışını küresel olarak ayarlamanıza olanak tanır.
813
+ Otomatik doldurma davranışı ve içerik oluşturma dahil olmak üzere sözlük işlemlerini kontrol eden parametreler.
817
814
 
818
- İçerik bildirim dosyaları ve yapılandırma değerlerinin nasıl uygulandığı hakkında daha fazla bilgi için [içerik dosyası belgelerine](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/dictionary/content_file.md) bakın.
815
+ | Alan | Açıklama | Tür | Varsayılan | Örnek | Not |
816
+ | -------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------- | -------------- | ------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
817
+ | `fill` | Otomatik doldurma (yapay zeka çevirisi) çıktı dosyalarının nasıl oluşturulacağını kontrol eder. | `boolean` &#124; <br/> `FilePathPattern` &#124; <br/> `Partial<Record<Locale, boolean &#124; FilePathPattern>>` | `true` | `{ en: '/locales/en/{{key}}.json', fr: ({ key }) => '/locales/fr/${key}.json', es: false }` | • `true`: varsayılan yol (kaynakla aynı dosya).<br/>• `false`: devredışı.<br/>• Dize/fonksiyon kalıbı dil başına dosyalar oluşturur.<br/>• Dil başına nesne: her dil kendi kalıbına karşılık gelir; `false` o dili yok sayar.<br/>• `{{locale}}` eklemek dil başına oluşturmayı tetikler.<br/>• Sözlük düzeyindeki `fill` her zaman bu genel ayardan önceliklidir. |
818
+ | `description` | Editörün ve CMS'in sözlüğün amacını anlamasına yardımcı olur. Yapay zeka destekli çeviri oluşturma için bağlam olarak da kullanılır. | `string` | `undefined` | `'Kullanıcı profili bölümü'` | |
819
+ | `locale` | Sözlüğü dil başına bir formata dönüştürür. Bildirilen her alan bir çeviri düğümü olur. Yoksa, sözlük çok dilli olarak kabul edilir. | `LocalesValues` | `undefined` | `'en'` | Birden fazla dil için çeviriler içermek yerine sözlük belirli bir dil için olduğunda bunu kullanın. |
820
+ | `contentAutoTransformation` | İçerik dizelerini otomatik olarak tiplendirilmiş düğümlere (markdown, HTML veya ekleme) dönüştürür. | `boolean` &#124; <br/> `{ markdown?: boolean; html?: boolean; insertion?: boolean }` | `false` | `true` | • Markdown : `### Title` → `md('### Title')`.<br/>• HTML : `<div>Title</div>` → `html('<div>Title</div>')`.<br/>• Ekleme : `Merhaba {{name}}` → `insert('Merhaba {{name}}')`. |
821
+ | `location` | Sözlük dosyalarının nerede saklandığını ve CMS ile nasıl senkronize edildiğini belirtir. | `'local'` &#124; <br/> `'remote'` &#124; <br/> `'hybrid'` &#124; <br/> `'plugin'` &#124; <br/> `string` | `'local'` | `'hybrid'` | • `'local'`: sadece yerel olarak yönetilir.<br/>• `'remote'`: sadece uzaktan yönetilir (CMS).<br/>• `'hybrid'`: hem yerel hem de uzaktan yönetilir.<br/>• `'plugin'` veya özel dize: bir eklenti veya özel bir kaynak tarafından yönetilir. |
822
+ | `importMode` | Sözlüklerin nasıl içe aktarılacağını kontrol eder. | `'static'` &#124; <br/> `'dynamic'` &#124; <br/> `'fetch'` | `'static'` | `'dynamic'` | • `'static'`: statik olarak içe aktarılır.<br/>• `'dynamic'`: Suspense kullanılarak dinamik olarak içe aktarılır.<br/>• `'fetch'`: Live Sync API aracılığıyla getirilir; başarısız olursa `'dynamic'`e geri döner.<br/>• `@intlayer/babel` ve `@intlayer/swc` eklentilerini gerektirir.<br/>• Anahtarlar statik olarak bildirilmelidir.<br/>• `optimize` kapalıysa yok sayılır.<br/>• `getIntlayer`, `getDictionary` vb.'ni etkilemez. |
823
+ | `priority` | Sözlüğün önceliği. Sözlükler arasındaki çatışmaları çözerken yüksek değerler düşük değerleri yener. | `number` | `undefined` | `1` | |
824
+ | `live` | Kullanımdan kaldırıldı — bunun yerine `importMode: 'fetch'` kullanın. Sözlük içeriğinin Live Sync API aracılığıyla dinamik olarak getirilip getirilmeyeceğini belirtiyordu. | `boolean` | `undefined` | | v8.0.0'da `importMode: 'fetch'` olarak yeniden adlandırıldı. |
825
+ | `schema` | JSON şema doğrulaması için Intlayer tarafından otomatik olarak oluşturulur. | `'https://intlayer.org/schema.json'` | otomatik oluşturulur | | Manuel olarak düzenlemeyin. |
826
+ | `title` | Editörde ve CMS'de sözlüğü tanımlamaya yardımcı olur. | `string` | `undefined` | `'Kullanıcı Profili'` | |
827
+ | `tags` | Sözlükleri kategorize eder ve editör ile yapay zeka için bağlam veya talimatlar sağlar. | `string[]` | `undefined` | `['kullanıcı', 'profil']` | |
828
+ | `version` | Uzak sözlüğün sürümü; şu anda kullanılan sürümün izlenmesine yardımcı olur. | `string` | `undefined` | `'1.0.0'` | • CMS'de yönetilebilir.<br/>• Yerel olarak düzenlemeyin. |
819
829
 
820
- | Alan | Tür | Açıklama | Örnek | Not |
821
- | --------------------------- | ----------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------ | ---------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
822
- | `fill` | `boolean &#124; FilePathPattern &#124; Partial<Record<Locale, boolean &#124; FilePathPattern>>` | Otomatik doldurma (AI çevirisi) çıktı dosyalarının nasıl oluşturulduğunu kontrol eder. Varsayılan: `true` | Aşağıdaki örneğe bakın | `true`: Varsayılan yol (kaynakla aynı dosya). `false`: Devre dışı. Dize/fonksiyon şablonları dil başına dosyalar oluşturur. Dil başına nesne: her dil kendi desenine eşlenir; `false` o dili atlar. `{{locale}}` değişkeninin dahil edilmesi dil başına oluşturmayı tetikler. Sözlük düzeyindeki `fill` her zaman bu küresel yapılandırmadan önceliklidir. |
823
- | `importMode` | `'static' &#124; 'dynamic' &#124; 'fetch'` | Sözlüklerin nasıl içe aktarıldığını kontrol eder. Varsayılan: `'static'` | `'dynamic'` | `'static'`: Statik olarak içe aktarılır. `'dynamic'`: Suspense aracılığıyla dinamik olarak içe aktarılır. `'fetch'`: Live Sync API aracılığıyla dinamik olarak çekilir. `getIntlayer`, `getDictionary`, `useDictionary` vb. etkilemez. |
824
- | `location` | `'local' &#124; 'remote' &#124; 'hybrid' &#124; string` | Sözlüklerin nerede saklandığı. Varsayılan: `'local'` | `'remote'` | `'local'`: dosya sistemi. `'remote'`: Intlayer CMS. `'hybrid'`: her ikisi de. |
825
- | `contentAutoTransformation` | `boolean` | İçerik dosyalarının otomatik olarak dönüştürülüp dönüştürülmeyeceği (ör. Markdown'dan HTML'e). Varsayılan: `false` | `true` | @intlayer/markdown aracılığıyla Markdown alanlarını işlemek için yararlıdır. |
826
-
827
- **`fill` örneği**:
830
+ **`fill` Örneği**:
828
831
 
829
832
  ```ts
830
833
  dictionary: {
831
834
  fill: {
832
- en: '/locales/en/{{key}}.content.json',
835
+ en: "/locales/en/{{key}}.content.json",
833
836
  fr: ({ key }) => `/locales/fr/${key}.content.json`,
834
837
  es: false,
835
- }
836
- }
838
+ },
839
+ };
837
840
  ```
838
841
 
839
842
  ---
840
843
 
841
- ### Yapay Zeka Yapılandırması (AI Configuration)
844
+ ### Logger Yapılandırması
842
845
 
843
- Derleme çevirisi gibi Intlayer'ın yapay zeka destekli özellikleri için ayarları tanımlar.
846
+ Intlayer'dan gelen günlük çıkışını özelleştirmek için parametreler.
844
847
 
845
- | Alan | Tür | Açıklama | Örnek | Not |
846
- | -------------------- | ---------------------- | ------------------------------------------------------------------------------- | ------------------------------------------- | -------------------------------------------------------------------------------------------------- |
847
- | `provider` | `string` | Kullanılacak yapay zeka sağlayıcısı. | `'openai'`, `'anthropic'`, `'googlevertex'` | |
848
- | `model` | `string` | Kullanılacak yapay zeka modeli. | `'gpt-4o'`, `'claude-3-5-sonnet-20240620'` | |
849
- | `apiKey` | `string` | Seçilen sağlayıcı için API anahtarı. | `process.env.OPENAI_API_KEY` | |
850
- | `applicationContext` | `string` | Yapay zeka çeviri doğruluğunu iyileştirmek için uygulamanız hakkında ek bağlam. | `'Çocuklar için bir çalışma platformu.'` | |
851
- | `baseURL` | `string` | API çağrıları için isteğe bağlı temel yol URL'si. | | Bir proxy veya yerel yapay zeka dağıtımı kullanıyorsanız yararlıdır. |
852
- | `dataSerialization` | `'json' &#124; 'toon'` | Yapay zekaya verilerin nasıl gönderileceğini tanımlar. Varsayılan: `'json'` | `'json'` | `'json'`: daha sağlam ve kesin. `'toon'`: daha az belirteç tüketir ancak daha az kararlı olabilir. |
848
+ | Alan | Açıklama | Tür | Varsayılan | Örnek | Not |
849
+ | -------- | ---------------------------------------- | --------------------------------------------------------------- | ---------------- | ----------------------- | ----------------------------------------------------------------------------------------------------------------------- |
850
+ | `mode` | Logger modunu belirtir. | `'default'` &#124; <br/> `'verbose'` &#124; <br/> `'disabled'` | `'default'` | `'verbose'` | • `'verbose'`: hata ayıklama için daha fazla bilgi günlüğe kaydeder.<br/>• `'disabled'`: logger'ı tamamen devre dışı bırakır. |
851
+ | `prefix` | Günlük mesajları için önek. | `string` | `'[intlayer] '` | `'[özel öneğim] '` | |
853
852
 
854
853
  ---
855
854
 
856
- ### Derleme Yapılandırması (Build Configuration)
855
+ ### Yapay Zeka (AI) Yapılandırması
856
+
857
+ Sağlayıcı, model ve API anahtarı dahil olmak üzere Intlayer'ın yapay zeka özelliklerini kontrol eden ayarlar.
858
+
859
+ Bir erişim anahtarı ile [Intlayer Dashboard](https://app.intlayer.org/project)'a kayıtlıysanız bu yapılandırma isteğe bağlıdır. Intlayer, ihtiyaçlarınız için en verimli ve uygun maliyetli yapay zeka çözümünü otomatik olarak yönetecektir. Varsayılan seçeneklerin kullanılması, Intlayer en ilgili modelleri kullanmak üzere sürekli güncellendiğinden daha iyi uzun vadeli bakılabilirlik sağlar.
860
+
861
+ Kendi API anahtarınızı veya belirli bir modeli kullanmayı tercih ederseniz, özel yapay zeka yapılandırmanızı tanımlayabilirsiniz.
862
+ Bu yapay zeka yapılandırması, Intlayer ortamınızda küresel olarak kullanılacaktır. CLI komutları, `fill` gibi komutlar için varsayılan olarak bu ayarları kullanacaktır; aynı şekilde SDK, Görsel Editör ve CMS de öyle. Komut parametreleri aracılığıyla belirli kullanım durumları için bu varsayılan değerleri geçersiz kılabilirsiniz.
863
+
864
+ Intlayer, maksimum esneklik için birden fazla yapay zeka sağlayıcısını destekler. Şu anda desteklenen sağlayıcılar şunlardır:
865
+
866
+ - **OpenAI** (Varsayılan)
867
+ - **Anthropic Claude**
868
+ - **Mistral AI**
869
+ - **DeepSeek**
870
+ - **Google Gemini**
871
+ - **Google AI Studio**
872
+ - **Google Vertex**
873
+ - **Meta Llama**
874
+ - **Ollama**
875
+ - **OpenRouter**
876
+ - **Alibaba Cloud**
877
+ - **Fireworks**
878
+ - **Hugging Face**
879
+ - **Groq**
880
+ - **Amazon Bedrock**
881
+ - **Together.ai**
882
+
883
+ | Alan | Açıklama | Tür | Varsayılan | Örnek | Not |
884
+ | -------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------- | ------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
885
+ | `provider` | Intlayer yapay zeka özellikleri için kullanılacak sağlayıcı. | `'openai'` &#124; <br/> `'anthropic'` &#124; <br/> `'mistral'` &#124; <br/> `'deepseek'` &#124; <br/> `'gemini'` &#124; <br/> `'ollama'` &#124; <br/> `'openrouter'` &#124; <br/> `'alibaba'` &#124; <br/> `'fireworks'` &#124; <br/> `'groq'` &#124; <br/> `'huggingface'` &#124; <br/> `'bedrock'` &#124; <br/> `'googleaistudio'` &#124; <br/> `'googlevertex'` &#124; <br/> `'togetherai'` | `undefined` | `'anthropic'` | Farklı sağlayıcılar farklı API anahtarları gerektirir ve farklı fiyatlandırmalara sahiptir. |
886
+ | `model` | Yapay zeka özellikleri için kullanılacak model. | `string` | Yok | `'gpt-4o-2024-11-20'` | Belirli model sağlayıcıya göre değişir. |
887
+ | `temperature` | Yapay zeka yanıtlarının rastgeleliğini kontrol eder. | `number` | Yok | `0.1` | Daha yüksek sıcaklık = daha yaratıcı ve daha az tahmin edilebilir. |
888
+ | `apiKey` | Seçilen sağlayıcı için API anahtarınız. | `string` | Yok | `process.env.OPENAI_API_KEY` | Gizli tutulmalıdır; ortam değişkenlerinde saklayın. |
889
+ | `applicationContext` | Yapay zekanın daha doğru çeviriler üretmesine yardımcı olmak için uygulamanız hakkında ek bağlam (alan adı, hedef kitle, ton, terminoloji). | `string` | Yok | `'Kendi uygulama bağlamım'` | Kurallar eklemek için kullanılabilir (örneğin: `"URL'leri dönüştürmemelisiniz"`). |
890
+ | `baseURL` | Yapay zeka API'si için temel URL. | `string` | Yok | `'https://api.openai.com/v1'` <br/> `'http://localhost:5000'` | Yerel veya özel bir yapay zeka API uç noktasına işaret edebilir. |
891
+ | `dataSerialization` | Yapay zeka özellikleri için veri serileştirme formatı. | `'json'` &#124; <br/> `'toon'` | `undefined` | `'toon'` | • `'json'`: varsayılan, güvenilir; daha fazla token kullanır.<br/>• `'toon'`: daha az token, daha az tutarlı.<br/>• Modele bağlam olarak ek parametreler iletilir (akıl yürütme çabası vb.). |
857
892
 
858
- Intlayer derleme süreci ve optimizasyon ayarları.
893
+ ---
859
894
 
860
- | Alan | Tür | Açıklama | Örnek | Not |
861
- | -------------- | ------------------------ | ---------------------------------------------------------------------------------------------------------------------------- | ----- | --- |
862
- | `mode` | `'auto' &#124; 'manual'` | Uygulamanın ön derleme adımları sırasında Intlayer'ın otomatik olarak çalışıp çalışmayacağını belirtir. Varsayılan: `'auto'` | | |
863
- | `optimize` | `boolean` | Derlenmiş sözlüklerin çalışma zamanı için optimize edilip edilmeyeceğini belirtir. Varsayılan: Üretim ortamında `true` | | |
864
- | `outputFormat` | `('cjs' &#124; 'esm')[]` | Oluşturulan sözlük dosyaları için çıktı formatı. Varsayılan: `['cjs', 'esm']` | | |
865
- | `checkTypes` | `boolean` | Intlayer'ın oluşturulan dosyalardaki türleri kontrol edip etmeyeceğini belirtir. Varsayılan: `false` | | |
895
+ ### Derleme (Build) Yapılandırması
866
896
 
867
- ---
897
+ Intlayer'ın uygulamanızın uluslararasılaştırılmasını nasıl optimize ettiğini ve derlediğini kontrol eden parametreler.
868
898
 
869
- ### Sistem Yapılandırması (System Configuration)
899
+ Derleme seçenekleri `@intlayer/babel` ve `@intlayer/swc` eklentileri için geçerlidir.
870
900
 
871
- Bu ayarlar gelişmiş kullanım durumları ve Intlayer'ın dahili yapılandırması içindir.
901
+ > Geliştirme modunda Intlayer, geliştirme deneyimini basitleştirmek için sözlükler için statik içe aktarmalar kullanır.
902
+
903
+ > Optimizasyon sırasında Intlayer, yığınlamayı (chunking) optimize etmek için sözlük çağrılarını değiştirecektir, böylece final paketi yalnızca gerçekte kullanılan sözlükleri içe aktaracaktır.
872
904
 
873
- | Alan | Tür | Açıklama | Varsayılan |
874
- | ------------------------- | -------- | ---------------------------------------- | --------------------------------- |
875
- | `dictionariesDir` | `string` | Derlenmiş sözlükler dizini. | `'.intlayer/dictionary'` |
876
- | `moduleAugmentationDir` | `string` | TypeScript modül genişletme dizini. | `'.intlayer/types'` |
877
- | `unmergedDictionariesDir` | `string` | Birleştirilmemiş sözlükler dizini. | `'.intlayer/unmerged_dictionary'` |
878
- | `typesDir` | `string` | Oluşturulan türler dizini. | `'.intlayer/types'` |
879
- | `mainDir` | `string` | Ana Intlayer dosyası dizini. | `'.intlayer/main'` |
880
- | `configDir` | `string` | Derlenmiş yapılandırma dosyaları dizini. | `'.intlayer/config'` |
881
- | `cacheDir` | `string` | Önbellek dosyaları dizini. | `'.intlayer/cache'` |
905
+ | Alan | Açıklama | Tür | Varsayılan | Örnek | Not |
906
+ | ----------------- | ----------------------------------------------------------------------------------------------------- | -------------------------------- | --------------------------------------------------------- | ------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
907
+ | `mode` | Derleme modunu kontrol eder. | `'auto'` &#124; <br/> `'manual'` | `'auto'` | `'manual'` | • `'auto'`: uygulama derlemesi sırasında derleme otomatik olarak tetiklenir.<br/>• `'manual'`: yalnızca derleme komutu açıkça çağrıldığında yürütülür.<br/>• Sözlük derlemelerini devre dışı bırakmak için kullanılabilir (örneğin Node.js ortamlarında yürütmeyi durdurmak için). |
908
+ | `optimize` | Derlemenin optimize edilip edilmeyeceğini kontrol eder. | `boolean` | `undefined` | `process.env.NODE_ENV === 'production'` | • Tanımlanmazsa, optimizasyon framework derlemesinde (Vite/Next.js) tetiklenir.<br/>• `true` ise geliştirme modunda bile optimizasyonu zorlar.<br/>• `false` ise devre dışı bırakır.<br/>• Etkinse, yığınlamayı optimize etmek için sözlük çağrılarını yer değiştirir.<br/>• `@intlayer/babel` ve `@intlayer/swc` eklentilerini gerektirir. |
909
+ | `checkTypes` | Derlemenin TypeScript türlerini kontrol edip etmeyeceğini ve hataları günlüğe kaydedip kaydetmeyeceğini belirtir. | `boolean` | `false` | | Derleme sürecini yavaşlatabilir. |
910
+ | `outputFormat` | Sözlüklerin çıktı formatını kontrol eder. | `('esm' &#124; 'cjs')[]` | `['esm', 'cjs']` | `['cjs']` | |
911
+ | `traversePattern` | Optimizasyon sırasında hangi dosyaların taranacağını tanımlayan kalıplar. | `string[]` | `['**/*.{tsx,ts,js,mjs,cjs,jsx,vue,svelte,svte}', '!**/node_modules/**', '!**/dist/**', '!**/.intlayer/**', '!**/*.config.*', '!**/*.test.*', '!**/*.spec.*', '!**/*.stories.*']` | `['src/**/*.{ts,tsx}', '../ui-library/**/*.{ts,tsx}', '!**/node_modules/**']` | • Derleme performansını artırmak için optimizasyonu ilgili dosyalarla sınırlayın.<br/>• `optimize` kapalıysa yok sayılır.<br/>• Glob kalıplarını kullanır. |
882
912
 
883
913
  ---
884
914
 
885
- ### Derleyici Yapılandırması (Compiler Configuration)
915
+ ### Sistem Yapılandırması
886
916
 
887
- Intlayer derleyicisi (`intlayer compiler`) için ayarlar.
917
+ Bu ayarlar gelişmiş kullanım durumları ve Intlayer'ın dahili yapılandırması içindir.
888
918
 
889
- | Alan | Tür | Açıklama | Varsayılan |
890
- | --------------------- | ------------------------ | ----------------------------------------------------------------------------------------------- | ---------- |
891
- | `enabled` | `boolean` | Derleyicinin aktif olup olmadığını belirtir. | `false` |
892
- | `output` | `string &#124; Function` | Ayıklanan sözlükler için çıktı yolu. | |
893
- | `saveComponents` | `boolean` | Orijinal kaynak dosyaların dönüştürülmüş sürümlerle değiştirilip değiştirilmeyeceğini belirtir. | `false` |
894
- | `noMetadata` | `boolean` | `true` ise, derleyici oluşturulan dosyalara meta verileri dahil etmez. | `false` |
895
- | `dictionaryKeyPrefix` | `string` | İsteğe bağlı sözlük anahtarı ön eki. | `''` |
919
+ | Alan | Açıklama | Tür | Varsayılan | Örnek | Not |
920
+ | ------------------------- | ------------------------------------------------ | -------- | --------------------------------- | -------- | ------- |
921
+ | `dictionariesDir` | Derlenmiş sözlükler için dizin. | `string` | `'.intlayer/dictionary'` | | |
922
+ | `moduleAugmentationDir` | TypeScript modül genişletme dizini. | `string` | `'.intlayer/types'` | | |
923
+ | `unmergedDictionariesDir` | Birleştirilmemiş sözlükler için dizin. | `string` | `'.intlayer/unmerged_dictionary'` | | |
924
+ | `typesDir` | Oluşturulan türler için dizin. | `string` | `'.intlayer/types'` | | |
925
+ | `mainDir` | Intlayer ana dosyası için dizin. | `string` | `'.intlayer/main'` | | |
926
+ | `configDir` | Derlenmiş yapılandırma dosyaları için dizin. | `string` | `'.intlayer/config'` | | |
927
+ | `cacheDir` | Önbellek dosyaları için dizin. | `string` | `'.intlayer/cache'` | | |
896
928
 
897
929
  ---
898
930
 
899
- ### Günlükçü Yapılandırması (Logger Configuration)
931
+ ### Derleyici Yapılandırması
900
932
 
901
- Intlayer günlük çıktısını özelleştirmek için ayarlar.
933
+ Sözlükleri doğrudan bileşenlerinizden çıkaran Intlayer derleyicisini kontrol eden ayarlar.
902
934
 
903
- | Alan | Tür | Açıklama | Varsayılan |
904
- | -------- | ---------------------------------------------- | --------------------- | -------------- |
905
- | `mode` | `'default' &#124; 'verbose' &#124; 'disabled'` | Günlükleme modu. | `'default'` |
906
- | `prefix` | `string` | Günlük mesajı ön eki. | `'[intlayer]'` |
935
+ | Alan | Açıklama | Tür | Varsayılan | Örnek | Not |
936
+ | --------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------- | -------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
937
+ | `enabled` | Sözlüklerin çıkarılması için derleyicinin etkinleştirilip etkinleştirilmeyeceği. | `boolean` &#124; <br/> `'build-only'` | `true` | `'build-only'` | `'build-only'`, başlangıç sürelerini hızlandırmak için geliştirme sırasında derleyiciyi atlar; yalnızca derleme komutlarında yürütülür. |
938
+ | `dictionaryKeyPrefix` | Çıkarılan sözlük anahtarları için önek. | `string` | `''` | `'özel-önekim-'` | Çatışmaları önlemek için (dosya adına dayalı) oluşturulan anahtara eklenir. |
939
+ | `saveComponents` | Bileşenlerin dönüştürüldükten sonra kaydedilip kaydedilmeyeceği. | `boolean` | `false` | | • `true` ise, orijinal dosyaları dönüştürülmüş sürümleriyle değiştirir.<br/>• Derleyici bir çalıştırmadan sonra kaldırılabilir. |
940
+ | `output` | Çıktı dosyaları için yolu belirler. `outputDir` yerine geçer. Şablon değişkenlerini destekler: `{{fileName}}`, <br/> `{{key}}`, <br/> `{{locale}}`, <br/> `{{extension}}`, <br/> `{{componentFileName}}`, <br/> `{{componentExtension}}`, <br/> `{{format}}`, <br/> `{{componentFormat}}`, <br/> `{{componentDirPath}}`. | `boolean` &#124; <br/> `FilePathPattern` &#124; <br/> `Partial<Record<Locale, boolean &#124; FilePathPattern>>` | `undefined` | `'./{{fileName}}{{extension}}'` <br/> `'/locales/{{locale}}/{{key}}.json'` <br/> `{ en: ({ key }) => './locales/en/${key}.json', fr: '...', es: false }` | • `./` yolları bileşen dizinine göre çözümlenir.<br/>• `/` yolları köke göredir.<br/>• `{{locale}}` dil başına oluşturmayı tetikler.<br/>• Dil başına nesne notasyonunu destekler. |
941
+ | `noMetadata` | `true` ise, derleyici sözlük meta verilerini (anahtar, içerik sarmalayıcı) çıktıdan çıkarır. | `boolean` | `false` | `false` → `{"key":"anahtarım","content":{"key":"değer"}}` <br/> `true` → `{"key":"değer"}` | • i18next veya ICU MessageFormat JSON çıktıları için yararlıdır.<br/>• `loadJSON` eklentisi ile iyi çalışır. |
942
+ | `dictionaryKeyPrefix` | Sözlük anahtar öneki | `string` | `''` | | Çıkarılan sözlük anahtarları için isteğe bağlı önek ekleyin |
907
943
 
908
944
  ---
909
945
 
910
946
  ### Özel Şemalar (Custom Schemas)
911
947
 
912
- | Alan | Tür | Açıklama |
913
- | --------- | --------------------------- | --------------------------------------------------------------------------------- |
914
- | `schemas` | `Record<string, ZodSchema>` | Sözlüklerinizin yapısını doğrulamak için Zod şemaları tanımlamanıza olanak tanır. |
948
+ | Alan | Açıklama | Tür |
949
+ | --------- | ------------------------------------------------------------------------------ | --------------------------- |
950
+ | `schemas` | Sözlüklerinizin yapısını doğrulamak için Zod şemaları tanımlamanıza olanak tanır. | `Record<string, ZodSchema>` |
915
951
 
916
952
  ---
917
953
 
918
954
  ### Eklentiler (Plugins)
919
955
 
920
- | Alan | Tür | Açıklama |
921
- | --------- | ------------------ | -------------------------------------------------- |
922
- | `plugins` | `IntlayerPlugin[]` | Etkinleştirilecek Intlayer eklentilerinin listesi. |
956
+ | Alan | Açıklama | Tür |
957
+ | --------- | --------------------------------- | ------------------ |
958
+ | `plugins` | Etkinleştirilecek Intlayer eklentilerinin listesi. | `IntlayerPlugin[]` |