@intlayer/docs 8.4.6 → 8.4.7
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.
- package/blog/en/next-i18next_vs_next-intl_vs_intlayer.md +1 -3
- package/blog/en-GB/next-i18next_vs_next-intl_vs_intlayer.md +1 -3
- package/blog/es/next-i18next_vs_next-intl_vs_intlayer.md +1 -3
- package/blog/id/next-i18next_vs_next-intl_vs_intlayer.md +1 -3
- package/blog/it/next-i18next_vs_next-intl_vs_intlayer.md +1 -3
- package/blog/ja/next-i18next_vs_next-intl_vs_intlayer.md +1 -3
- package/blog/ko/next-i18next_vs_next-intl_vs_intlayer.md +1 -3
- package/blog/uk/next-i18next_vs_next-intl_vs_intlayer.md +1 -3
- package/blog/vi/next-i18next_vs_next-intl_vs_intlayer.md +1 -3
- package/blog/zh/next-i18next_vs_next-intl_vs_intlayer.md +1 -3
- package/docs/en/configuration.md +115 -137
- package/docs/es/configuration.md +14 -6
- package/docs/fr/configuration.md +14 -6
- package/package.json +6 -6
- package/docs/ar/configuration.md +0 -922
- package/docs/bn/configuration.md +0 -922
- package/docs/de/configuration.md +0 -922
- package/docs/en-GB/configuration.md +0 -922
- package/docs/hi/configuration.md +0 -922
- package/docs/id/configuration.md +0 -922
- package/docs/it/configuration.md +0 -923
- package/docs/ja/configuration.md +0 -922
- package/docs/ko/configuration.md +0 -922
- package/docs/pl/configuration.md +0 -922
- package/docs/pt/configuration.md +0 -922
- package/docs/ru/configuration.md +0 -943
- package/docs/tr/configuration.md +0 -922
- package/docs/uk/configuration.md +0 -922
- package/docs/ur/configuration.md +0 -922
- package/docs/vi/configuration.md +0 -922
- package/docs/zh/configuration.md +0 -922
package/docs/tr/configuration.md
DELETED
|
@@ -1,922 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
createdAt: 2024-08-13
|
|
3
|
-
updatedAt: 2026-03-20
|
|
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.
|
|
6
|
-
keywords:
|
|
7
|
-
- Yapılandırma
|
|
8
|
-
- Ayarlar
|
|
9
|
-
- Özelleştirme
|
|
10
|
-
- Intlayer
|
|
11
|
-
- Seçenekler
|
|
12
|
-
slugs:
|
|
13
|
-
- doc
|
|
14
|
-
- concept
|
|
15
|
-
- configuration
|
|
16
|
-
history:
|
|
17
|
-
- version: 8.4.0
|
|
18
|
-
date: 2026-03-20
|
|
19
|
-
changes: 'compiler.output' ve 'dictionary.fill' için her dil için nesne notasyonu eklendi
|
|
20
|
-
- version: 8.3.0
|
|
21
|
-
date: 2026-03-11
|
|
22
|
-
changes: 'baseDir', 'content' yapılandırmasından 'system' yapılandırmasına taşındı
|
|
23
|
-
- version: 8.2.0
|
|
24
|
-
date: 2026-03-09
|
|
25
|
-
changes: Derleyici (compiler) seçenekleri güncellendi, 'output' ve 'noMetadata' desteği eklendi
|
|
26
|
-
- version: 8.1.7
|
|
27
|
-
date: 2026-02-25
|
|
28
|
-
changes: Derleyici seçenekleri güncellendi
|
|
29
|
-
- version: 8.1.5
|
|
30
|
-
date: 2026-02-23
|
|
31
|
-
changes: Derleyici seçeneği 'build-only' ve sözlük öneki eklendi
|
|
32
|
-
- version: 8.0.6
|
|
33
|
-
date: 2026-02-12
|
|
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
|
-
- version: 8.0.5
|
|
36
|
-
date: 2026-02-06
|
|
37
|
-
changes: Yapay zeka yapılandırmasına `dataSerialization` eklendi
|
|
38
|
-
- version: 8.0.0
|
|
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ı.
|
|
41
|
-
- version: 8.0.0
|
|
42
|
-
date: 2026-01-22
|
|
43
|
-
changes: Derleme yapılandırması `importMode`, `dictionary` yapılandırmasına taşındı.
|
|
44
|
-
- version: 8.0.0
|
|
45
|
-
date: 2026-01-22
|
|
46
|
-
changes: Yönlendirme yapılandırmasına `rewrite` seçeneği eklendi
|
|
47
|
-
- version: 8.0.0
|
|
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.
|
|
50
|
-
- version: 8.0.0
|
|
51
|
-
date: 2026-01-18
|
|
52
|
-
changes: Sözlük seçenekleri `location` ve `schema` eklendi
|
|
53
|
-
- version: 7.5.1
|
|
54
|
-
date: 2026-01-10
|
|
55
|
-
changes: JSON5 ve JSONC dosya formatları için destek eklendi
|
|
56
|
-
- version: 7.5.0
|
|
57
|
-
date: 2025-12-17
|
|
58
|
-
changes: `buildMode` seçeneği eklendi
|
|
59
|
-
- version: 7.0.0
|
|
60
|
-
date: 2025-10-25
|
|
61
|
-
changes: `dictionary` yapılandırması eklendi
|
|
62
|
-
- version: 7.0.0
|
|
63
|
-
date: 2025-10-21
|
|
64
|
-
changes: `middleware`, yönlendirme yapılandırması `routing` ile değiştirildi
|
|
65
|
-
- version: 7.0.0
|
|
66
|
-
date: 2025-10-12
|
|
67
|
-
changes: `formatCommand` seçeneği eklendi
|
|
68
|
-
- version: 6.2.0
|
|
69
|
-
date: 2025-10-12
|
|
70
|
-
changes: `excludedPath` seçeneği güncellendi
|
|
71
|
-
- version: 6.0.2
|
|
72
|
-
date: 2025-09-23
|
|
73
|
-
changes: `outputFormat` seçeneği eklendi
|
|
74
|
-
- version: 6.0.0
|
|
75
|
-
date: 2025-09-21
|
|
76
|
-
changes: `dictionaryOutput` alanı ve `i18nextResourcesDir` alanı kaldırıldı
|
|
77
|
-
- version: 6.0.0
|
|
78
|
-
date: 2025-09-16
|
|
79
|
-
changes: `live` içe aktarma modu eklendi
|
|
80
|
-
- version: 6.0.0
|
|
81
|
-
date: 2025-09-04
|
|
82
|
-
changes: `hotReload` alanı `liveSync` ile değiştirildi ve `liveSyncPort` ve `liveSyncURL` alanları eklendi
|
|
83
|
-
- version: 5.6.1
|
|
84
|
-
date: 2025-07-25
|
|
85
|
-
changes: `activateDynamicImport`, `importMode` seçeneği ile değiştirildi
|
|
86
|
-
- version: 5.6.0
|
|
87
|
-
date: 2025-07-13
|
|
88
|
-
changes: Varsayılan contentDir `['src']` yerine `['.']` olarak değiştirildi
|
|
89
|
-
- version: 5.5.11
|
|
90
|
-
date: 2025-06-29
|
|
91
|
-
changes: `docs` komutları eklendi
|
|
92
|
-
---
|
|
93
|
-
|
|
94
|
-
# Intlayer Yapılandırma Belgeleri
|
|
95
|
-
|
|
96
|
-
## Genel Bakış
|
|
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.
|
|
99
|
-
|
|
100
|
-
---
|
|
101
|
-
|
|
102
|
-
## İçindekiler
|
|
103
|
-
|
|
104
|
-
<TOC/>
|
|
105
|
-
|
|
106
|
-
---
|
|
107
|
-
|
|
108
|
-
## Desteklenen Yapılandırma Dosyası Formatları
|
|
109
|
-
|
|
110
|
-
Intlayer JSON, JS, MJS ve TS yapılandırma dosyası formatlarını kabul eder:
|
|
111
|
-
|
|
112
|
-
- `intlayer.config.ts`
|
|
113
|
-
- `intlayer.config.js`
|
|
114
|
-
- `intlayer.config.json`
|
|
115
|
-
- `intlayer.config.json5`
|
|
116
|
-
- `intlayer.config.jsonc`
|
|
117
|
-
- `intlayer.config.cjs`
|
|
118
|
-
- `intlayer.config.mjs`
|
|
119
|
-
- `.intlayerrc`
|
|
120
|
-
|
|
121
|
-
---
|
|
122
|
-
|
|
123
|
-
## Yapılandırma Dosyası Örneği
|
|
124
|
-
|
|
125
|
-
````typescript fileName="intlayer.config.ts" codeFormat="typescript"
|
|
126
|
-
import { Locales, type IntlayerConfig } from "intlayer";
|
|
127
|
-
import { nextjsRewrite } from "intlayer/routing";
|
|
128
|
-
import { z } from "zod";
|
|
129
|
-
|
|
130
|
-
/**
|
|
131
|
-
* Mevcut tüm seçenekleri gösteren Intlayer yapılandırma dosyası örneği.
|
|
132
|
-
*/
|
|
133
|
-
const config: IntlayerConfig = {
|
|
134
|
-
/**
|
|
135
|
-
* Uluslararasılaştırma ayarları yapılandırması.
|
|
136
|
-
*/
|
|
137
|
-
internationalization: {
|
|
138
|
-
/**
|
|
139
|
-
* Uygulamada desteklenen dillerin (locales) listesi.
|
|
140
|
-
* Varsayılan: [Locales.ENGLISH]
|
|
141
|
-
*/
|
|
142
|
-
locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],
|
|
143
|
-
|
|
144
|
-
/**
|
|
145
|
-
* Her sözlükte tanımlanması gereken zorunlu dillerin listesi.
|
|
146
|
-
* Boşsa, `strict` modunda tüm diller zorunludur.
|
|
147
|
-
* Varsayılan: []
|
|
148
|
-
*/
|
|
149
|
-
requiredLocales: [Locales.ENGLISH],
|
|
150
|
-
|
|
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.
|
|
154
|
-
* - "inclusive": Bildirilen bir dil eksikse uyarı verir.
|
|
155
|
-
* - "loose": Mevcut olan her dili kabul eder.
|
|
156
|
-
* Varsayılan: "inclusive"
|
|
157
|
-
*/
|
|
158
|
-
strictMode: "inclusive",
|
|
159
|
-
|
|
160
|
-
/**
|
|
161
|
-
* İstenen dil bulunamadığında geri dönüş (fallback) olarak kullanılan varsayılan dil.
|
|
162
|
-
* Varsayılan: Locales.ENGLISH
|
|
163
|
-
*/
|
|
164
|
-
defaultLocale: Locales.ENGLISH,
|
|
165
|
-
},
|
|
166
|
-
|
|
167
|
-
/**
|
|
168
|
-
* Sözlük işlemlerini ve geri dönüş davranışını kontrol eden ayarlar.
|
|
169
|
-
*/
|
|
170
|
-
dictionary: {
|
|
171
|
-
/**
|
|
172
|
-
* Sözlüklerin nasıl içe aktarılacağını kontrol eder.
|
|
173
|
-
* - "static": Derleme zamanında statik olarak içe aktarılır.
|
|
174
|
-
* - "dynamic": Suspense kullanılarak dinamik olarak içe aktarılır.
|
|
175
|
-
* - "fetch": Live Sync API aracılığıyla dinamik olarak çekilir.
|
|
176
|
-
* Varsayılan: "static"
|
|
177
|
-
*/
|
|
178
|
-
importMode: "static",
|
|
179
|
-
|
|
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.
|
|
183
|
-
* Varsayılan: true
|
|
184
|
-
*/
|
|
185
|
-
fill: true,
|
|
186
|
-
|
|
187
|
-
/**
|
|
188
|
-
* Sözlük dosyalarının fiziksel konumu.
|
|
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.
|
|
193
|
-
* Varsayılan: "local"
|
|
194
|
-
*/
|
|
195
|
-
location: "local",
|
|
196
|
-
|
|
197
|
-
/**
|
|
198
|
-
* İçeriğin otomatik olarak dönüştürülüp dönüştürülmeyeceği (ör. Markdown'dan HTML'e).
|
|
199
|
-
* Varsayılan: false
|
|
200
|
-
*/
|
|
201
|
-
contentAutoTransformation: false,
|
|
202
|
-
},
|
|
203
|
-
|
|
204
|
-
/**
|
|
205
|
-
* Yönlendirme ve ara yazılım yapılandırması.
|
|
206
|
-
*/
|
|
207
|
-
routing: {
|
|
208
|
-
/**
|
|
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).
|
|
212
|
-
* - "no-prefix": URL'de dil yok.
|
|
213
|
-
* - "search-params": ?locale=... kullanır
|
|
214
|
-
* Varsayılan: "prefix-no-default"
|
|
215
|
-
*/
|
|
216
|
-
mode: "prefix-no-default",
|
|
217
|
-
|
|
218
|
-
/**
|
|
219
|
-
* Kullanıcı tarafından seçilen dilin nerede saklanacağı.
|
|
220
|
-
* Seçenekler: 'cookie', 'localStorage', 'sessionStorage', 'header' veya bunların bir dizisi.
|
|
221
|
-
* Varsayılan: ['cookie', 'header']
|
|
222
|
-
*/
|
|
223
|
-
storage: ["cookie", "header"],
|
|
224
|
-
|
|
225
|
-
/**
|
|
226
|
-
* Uygulama URL'leri için temel yol.
|
|
227
|
-
* Varsayılan: ""
|
|
228
|
-
*/
|
|
229
|
-
basePath: "",
|
|
230
|
-
|
|
231
|
-
/**
|
|
232
|
-
* Dil bazlı belirli yollar için özel URL yeniden yazma (rewrite) kuralları.
|
|
233
|
-
*/
|
|
234
|
-
rewrite: nextjsRewrite({
|
|
235
|
-
"/[locale]/about": {
|
|
236
|
-
en: "/[locale]/about",
|
|
237
|
-
fr: "/[locale]/a-propos",
|
|
238
|
-
},
|
|
239
|
-
}),
|
|
240
|
-
},
|
|
241
|
-
|
|
242
|
-
/**
|
|
243
|
-
* İçerik dosyası bulma ve işleme ile ilgili ayarlar.
|
|
244
|
-
*/
|
|
245
|
-
content: {
|
|
246
|
-
/**
|
|
247
|
-
* Sözlükleri taramak için dosya uzantıları.
|
|
248
|
-
* Varsayılan: ['.content.ts', '.content.js', '.content.json', vb.]
|
|
249
|
-
*/
|
|
250
|
-
fileExtensions: [".content.ts", ".content.js", ".content.json"],
|
|
251
|
-
|
|
252
|
-
/**
|
|
253
|
-
* .content dosyalarının bulunduğu dizinler.
|
|
254
|
-
* Varsayılan: ["."]
|
|
255
|
-
*/
|
|
256
|
-
contentDir: ["src"],
|
|
257
|
-
|
|
258
|
-
/**
|
|
259
|
-
* Kaynak kodun bulunduğu yer.
|
|
260
|
-
* Derleme optimizasyonu ve kod dönüşümü için kullanılır.
|
|
261
|
-
* Varsayılan: ["."]
|
|
262
|
-
*/
|
|
263
|
-
codeDir: ["src"],
|
|
264
|
-
|
|
265
|
-
/**
|
|
266
|
-
* Taramadan hariç tutulan desenler.
|
|
267
|
-
* Varsayılan: ['node_modules', '.intlayer', vb.]
|
|
268
|
-
*/
|
|
269
|
-
excludedPath: ["node_modules"],
|
|
270
|
-
|
|
271
|
-
/**
|
|
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
|
|
274
|
-
*/
|
|
275
|
-
watch: true,
|
|
276
|
-
|
|
277
|
-
/**
|
|
278
|
-
* Yeni oluşturulan / güncellenen .content dosyalarını biçimlendirmek için kullanılan komut.
|
|
279
|
-
*/
|
|
280
|
-
formatCommand: 'npx prettier --write "{{file}}"',
|
|
281
|
-
},
|
|
282
|
-
|
|
283
|
-
/**
|
|
284
|
-
* Görsel Düzenleyici (Visual Editor) yapılandırması.
|
|
285
|
-
*/
|
|
286
|
-
editor: {
|
|
287
|
-
/**
|
|
288
|
-
* Görsel düzenleyicinin etkin olup olmadığı.
|
|
289
|
-
* Varsayılan: false
|
|
290
|
-
*/
|
|
291
|
-
enabled: true,
|
|
292
|
-
|
|
293
|
-
/**
|
|
294
|
-
* Kaynak doğrulama (origin validation) için uygulamanızın URL'si.
|
|
295
|
-
* Varsayılan: ""
|
|
296
|
-
*/
|
|
297
|
-
applicationURL: "http://localhost:3000",
|
|
298
|
-
|
|
299
|
-
/**
|
|
300
|
-
* Yerel düzenleyici sunucusu için bağlantı noktası.
|
|
301
|
-
* Varsayılan: 8000
|
|
302
|
-
*/
|
|
303
|
-
port: 8000,
|
|
304
|
-
|
|
305
|
-
/**
|
|
306
|
-
* Düzenleyici için genel URL.
|
|
307
|
-
* Varsayılan: "http://localhost:8000"
|
|
308
|
-
*/
|
|
309
|
-
editorURL: "http://localhost:8000",
|
|
310
|
-
|
|
311
|
-
/**
|
|
312
|
-
* Intlayer CMS URL'si.
|
|
313
|
-
* Varsayılan: "https://app.intlayer.org"
|
|
314
|
-
*/
|
|
315
|
-
cmsURL: "https://app.intlayer.org",
|
|
316
|
-
|
|
317
|
-
/**
|
|
318
|
-
* Arka uç API URL'si.
|
|
319
|
-
* Varsayılan: "https://back.intlayer.org"
|
|
320
|
-
*/
|
|
321
|
-
backendURL: "https://back.intlayer.org",
|
|
322
|
-
|
|
323
|
-
/**
|
|
324
|
-
* Gerçek zamanlı içerik senkronizasyonunun etkinleştirilip etkinleştirilmeyeceği.
|
|
325
|
-
* Varsayılan: false
|
|
326
|
-
*/
|
|
327
|
-
liveSync: true,
|
|
328
|
-
},
|
|
329
|
-
|
|
330
|
-
/**
|
|
331
|
-
* Yapay zeka tabanlı çeviri ve oluşturma ayarları.
|
|
332
|
-
*/
|
|
333
|
-
ai: {
|
|
334
|
-
/**
|
|
335
|
-
* Kullanılacak yapay zeka sağlayıcısı.
|
|
336
|
-
* Seçenekler: 'openai', 'anthropic', 'mistral', 'deepseek', 'gemini', 'ollama', 'openrouter', 'alibaba', 'fireworks', 'groq', 'huggingface', 'bedrock', 'googlevertex', 'togetherai'
|
|
337
|
-
* Varsayılan: 'openai'
|
|
338
|
-
*/
|
|
339
|
-
provider: "openai",
|
|
340
|
-
|
|
341
|
-
/**
|
|
342
|
-
* Kullanılacak seçili sağlayıcının modeli.
|
|
343
|
-
*/
|
|
344
|
-
model: "gpt-4o",
|
|
345
|
-
|
|
346
|
-
/**
|
|
347
|
-
* Sağlayıcı API anahtarı.
|
|
348
|
-
*/
|
|
349
|
-
apiKey: process.env.OPENAI_API_KEY,
|
|
350
|
-
|
|
351
|
-
/**
|
|
352
|
-
* Çeviriler oluşturulurken yapay zekayı yönlendirmek için genel bağlam.
|
|
353
|
-
*/
|
|
354
|
-
applicationContext: "Bu bir gezi rezervasyon uygulamasıdır.",
|
|
355
|
-
|
|
356
|
-
/**
|
|
357
|
-
* Yapay zeka API'si için temel yol URL'si.
|
|
358
|
-
*/
|
|
359
|
-
baseURL: "http://localhost:3000",
|
|
360
|
-
|
|
361
|
-
/**
|
|
362
|
-
* Veri Serileştirme (Data Serialization)
|
|
363
|
-
*
|
|
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.
|
|
367
|
-
*
|
|
368
|
-
* Varsayılan: "json"
|
|
369
|
-
*/
|
|
370
|
-
dataSerialization: "json",
|
|
371
|
-
},
|
|
372
|
-
|
|
373
|
-
/**
|
|
374
|
-
* Derleme ve optimizasyon ayarları.
|
|
375
|
-
*/
|
|
376
|
-
build: {
|
|
377
|
-
/**
|
|
378
|
-
* Derleme yürütme modu.
|
|
379
|
-
* - "auto": Uygulama derlemesi sırasında otomatik olarak derlenir.
|
|
380
|
-
* - "manual": Açık bir derleme komutu gerektirir.
|
|
381
|
-
* Varsayılan: "auto"
|
|
382
|
-
*/
|
|
383
|
-
mode: "auto",
|
|
384
|
-
|
|
385
|
-
/**
|
|
386
|
-
* Kullanılmayan sözlükleri kaldırarak nihai paketi optimize edip etmeyeceği.
|
|
387
|
-
* Varsayılan: Üretim ortamında true
|
|
388
|
-
*/
|
|
389
|
-
optimize: true,
|
|
390
|
-
|
|
391
|
-
/**
|
|
392
|
-
* Oluşturulan sözlük dosyaları için çıktı formatı.
|
|
393
|
-
* Varsayılan: ['cjs', 'esm']
|
|
394
|
-
*/
|
|
395
|
-
outputFormat: ["cjs", "esm"],
|
|
396
|
-
|
|
397
|
-
/**
|
|
398
|
-
* Derlemenin TypeScript türlerini (types) kontrol edip etmeyeceğini belirtir.
|
|
399
|
-
* Varsayılan: false
|
|
400
|
-
*/
|
|
401
|
-
checkTypes: false,
|
|
402
|
-
},
|
|
403
|
-
|
|
404
|
-
/**
|
|
405
|
-
* Günlükçü (Logger) yapılandırması.
|
|
406
|
-
*/
|
|
407
|
-
log: {
|
|
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.
|
|
413
|
-
* Varsayılan: "default"
|
|
414
|
-
*/
|
|
415
|
-
mode: "default",
|
|
416
|
-
|
|
417
|
-
/**
|
|
418
|
-
* Tüm günlük mesajları için ön ek.
|
|
419
|
-
* Varsayılan: "[intlayer]"
|
|
420
|
-
*/
|
|
421
|
-
prefix: "[intlayer]",
|
|
422
|
-
},
|
|
423
|
-
|
|
424
|
-
/**
|
|
425
|
-
* Sistem yapılandırması (Gelişmiş kullanım için)
|
|
426
|
-
*/
|
|
427
|
-
system: {
|
|
428
|
-
/**
|
|
429
|
-
* Yerelleştirilmiş sözlükleri saklamak için dizin.
|
|
430
|
-
*/
|
|
431
|
-
dictionariesDir: ".intlayer/dictionary",
|
|
432
|
-
|
|
433
|
-
/**
|
|
434
|
-
* TypeScript modül genişletme (module augmentation) için dizin.
|
|
435
|
-
*/
|
|
436
|
-
moduleAugmentationDir: ".intlayer/types",
|
|
437
|
-
|
|
438
|
-
/**
|
|
439
|
-
* Birleştirilmemiş sözlükleri saklamak için dizin.
|
|
440
|
-
*/
|
|
441
|
-
unmergedDictionariesDir: ".intlayer/unmerged_dictionary",
|
|
442
|
-
|
|
443
|
-
/**
|
|
444
|
-
* Sözlük türlerini saklamak için dizin.
|
|
445
|
-
*/
|
|
446
|
-
typesDir: ".intlayer/types",
|
|
447
|
-
|
|
448
|
-
/**
|
|
449
|
-
* Ana uygulama dosyalarının saklandığı dizin.
|
|
450
|
-
*/
|
|
451
|
-
mainDir: ".intlayer/main",
|
|
452
|
-
|
|
453
|
-
/**
|
|
454
|
-
* Yapılandırma dosyalarının saklandığı dizin.
|
|
455
|
-
*/
|
|
456
|
-
configDir: ".intlayer/config",
|
|
457
|
-
|
|
458
|
-
/**
|
|
459
|
-
* Önbellek dosyalarının saklandığı dizin.
|
|
460
|
-
*/
|
|
461
|
-
cacheDir: ".intlayer/cache",
|
|
462
|
-
},
|
|
463
|
-
|
|
464
|
-
/**
|
|
465
|
-
* Derleyici (Compiler) yapılandırması (Gelişmiş kullanım için)
|
|
466
|
-
*/
|
|
467
|
-
compiler: {
|
|
468
|
-
/**
|
|
469
|
-
* Derleyicinin etkin olup olmayacağını belirtir.
|
|
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.
|
|
474
|
-
*
|
|
475
|
-
* Varsayılan: false
|
|
476
|
-
*/
|
|
477
|
-
enabled: true,
|
|
478
|
-
|
|
479
|
-
/**
|
|
480
|
-
* Çıktı dosyaları için yolu tanımlar. `outputDir`'in yerini alır.
|
|
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.
|
|
484
|
-
*
|
|
485
|
-
* - Yola `{{locale}}` değişkenini dahil etmek, her dil için ayrı sözlüklerin oluşturulmasını tetikleyecektir.
|
|
486
|
-
*
|
|
487
|
-
* Örnek:
|
|
488
|
-
* ```ts
|
|
489
|
-
* {
|
|
490
|
-
* // Bileşenin yanında çok dilli .content.ts dosyaları oluşturun
|
|
491
|
-
* output: ({ fileName, extension }) => `./${fileName}${extension}`,
|
|
492
|
-
*
|
|
493
|
-
* // output: './{{fileName}}{{extension}}', // Şablon dizesi kullanarak eşdeğer
|
|
494
|
-
* }
|
|
495
|
-
* ```
|
|
496
|
-
*
|
|
497
|
-
* ```ts
|
|
498
|
-
* {
|
|
499
|
-
* // Proje kökünde dil başına merkezi JSON'lar oluşturun
|
|
500
|
-
* output: ({ key, locale }) => `/locales/${locale}/${key}.content.json`,
|
|
501
|
-
*
|
|
502
|
-
* // output: '/locales/{{locale}}/{{key}}.content.json', // Şablon dizesi kullanarak eşdeğer
|
|
503
|
-
* }
|
|
504
|
-
* ```
|
|
505
|
-
*
|
|
506
|
-
* Değişken listesi:
|
|
507
|
-
* - `fileName`: Dosya adı.
|
|
508
|
-
* - `key`: İçerik anahtarı (key).
|
|
509
|
-
* - `locale`: İçerik dili.
|
|
510
|
-
* - `extension`: Dosya uzantısı.
|
|
511
|
-
* - `componentFileName`: Bileşen dosya adı.
|
|
512
|
-
* - `componentExtension`: Bileşen dosya uzantısı.
|
|
513
|
-
* - `format`: Sözlük formatı.
|
|
514
|
-
* - `componentFormat`: Bileşen sözlük formatı.
|
|
515
|
-
* - `componentDirPath`: Bileşen dizin yolu.
|
|
516
|
-
*/
|
|
517
|
-
output: ({ locale, key }) => `compiler/${locale}/${key}.json`,
|
|
518
|
-
|
|
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.
|
|
522
|
-
*/
|
|
523
|
-
saveComponents: false,
|
|
524
|
-
|
|
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.
|
|
527
|
-
*/
|
|
528
|
-
noMetadata: false,
|
|
529
|
-
|
|
530
|
-
/**
|
|
531
|
-
* Sözlük anahtarı ön eki
|
|
532
|
-
*/
|
|
533
|
-
dictionaryKeyPrefix: "", // Ayıklanan sözlük anahtarlarına isteğe bağlı bir ön ek ekleyin
|
|
534
|
-
},
|
|
535
|
-
|
|
536
|
-
/**
|
|
537
|
-
* Sözlük içeriğini doğrulamak için özel şemalar (Schemas).
|
|
538
|
-
*/
|
|
539
|
-
schemas: {
|
|
540
|
-
"my-schema": z.object({
|
|
541
|
-
title: z.string(),
|
|
542
|
-
}),
|
|
543
|
-
},
|
|
544
|
-
|
|
545
|
-
/**
|
|
546
|
-
* Eklenti yapılandırması.
|
|
547
|
-
*/
|
|
548
|
-
plugins: [],
|
|
549
|
-
};
|
|
550
|
-
|
|
551
|
-
export default config;
|
|
552
|
-
````
|
|
553
|
-
|
|
554
|
-
---
|
|
555
|
-
|
|
556
|
-
## Yapılandırma Referansı (Configuration Reference)
|
|
557
|
-
|
|
558
|
-
Aşağıdaki bölümler, Intlayer'da mevcut olan çeşitli yapılandırma seçeneklerini açıklamaktadır.
|
|
559
|
-
|
|
560
|
-
---
|
|
561
|
-
|
|
562
|
-
### Uluslararasılaştırma Yapılandırması (Internationalization Configuration)
|
|
563
|
-
|
|
564
|
-
Uygulama için mevcut diller ve varsayılan dil dahil olmak üzere uluslararasılaştırma ile ilgili ayarları tanımlar.
|
|
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. |
|
|
572
|
-
|
|
573
|
-
---
|
|
574
|
-
|
|
575
|
-
### Düzenleyici Yapılandırması (Editor Configuration)
|
|
576
|
-
|
|
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 | 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 | 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. |
|
|
593
|
-
|
|
594
|
-
### Yönlendirme Yapılandırması (Routing Configuration)
|
|
595
|
-
|
|
596
|
-
URL yapısı, dil depolama ve ara yazılım işleme dahil olmak üzere yönlendirme davranışını kontrol eden ayarlar.
|
|
597
|
-
|
|
598
|
-
| Alan | Tür | Açıklama | Örnek | Not |
|
|
599
|
-
| ---------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
600
|
-
| `mode` | `'prefix-no-default' | 'prefix-all' | 'no-prefix' | '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 | 'cookie' | 'localStorage' | 'sessionStorage' | 'header' | CookiesAttributes | StorageAttributes | 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. |
|
|
604
|
-
|
|
605
|
-
**`rewrite` örneği**:
|
|
606
|
-
|
|
607
|
-
```typescript
|
|
608
|
-
routing: {
|
|
609
|
-
mode: "prefix-no-default", // Geri dönüş stratejisi
|
|
610
|
-
rewrite: nextjsRewrite({
|
|
611
|
-
"/about": {
|
|
612
|
-
en: "/about",
|
|
613
|
-
fr: "/a-propos",
|
|
614
|
-
},
|
|
615
|
-
"/product/[slug]": {
|
|
616
|
-
en: "/product/[slug]",
|
|
617
|
-
fr: "/produit/[slug]",
|
|
618
|
-
},
|
|
619
|
-
"/blog/[category]/[id]": {
|
|
620
|
-
en: "/blog/[category]/[id]",
|
|
621
|
-
fr: "/journal/[category]/[id]",
|
|
622
|
-
},
|
|
623
|
-
}),
|
|
624
|
-
}
|
|
625
|
-
```
|
|
626
|
-
|
|
627
|
-
#### Depolama Seçenekleri (Storage Options)
|
|
628
|
-
|
|
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' }`). |
|
|
635
|
-
|
|
636
|
-
#### Tanımlama Bilgisi Özellikleri (Cookie Attributes)
|
|
637
|
-
|
|
638
|
-
Tanımlama bilgisi depolamasını kullanırken ek tanımlama bilgisi özelliklerini yapılandırabilirsiniz:
|
|
639
|
-
|
|
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' | 'lax' | 'none'` | SameSite politikası. |
|
|
648
|
-
| `expires` | `Date | number` | Son kullanma tarihi veya gün sayısı. Varsayılan: `undefined` |
|
|
649
|
-
|
|
650
|
-
#### Dil Depolama Özellikleri (Locale Storage Attributes)
|
|
651
|
-
|
|
652
|
-
localStorage veya sessionStorage kullanırken:
|
|
653
|
-
|
|
654
|
-
| Alan | Tür | Açıklama |
|
|
655
|
-
| ------ | ---------------------------------------- | ------------------------------------------------------ |
|
|
656
|
-
| `type` | `'localStorage' | 'sessionStorage'` | Depolama türü. |
|
|
657
|
-
| `name` | `string` | Depolama anahtarı adı. Varsayılan: `'INTLAYER_LOCALE'` |
|
|
658
|
-
|
|
659
|
-
#### Yapılandırma Örnekleri
|
|
660
|
-
|
|
661
|
-
İşte yeni v7 yönlendirme yapısı için bazı yaygın yapılandırma örnekleri:
|
|
662
|
-
|
|
663
|
-
**Temel Yapılandırma (Varsayılan)**:
|
|
664
|
-
|
|
665
|
-
```typescript
|
|
666
|
-
import { Locales, type IntlayerConfig } from "intlayer";
|
|
667
|
-
// intlayer.config.ts
|
|
668
|
-
const config: IntlayerConfig = {
|
|
669
|
-
internationalization: {
|
|
670
|
-
locales: ["en", "fr", "es"],
|
|
671
|
-
defaultLocale: "en",
|
|
672
|
-
},
|
|
673
|
-
routing: {
|
|
674
|
-
mode: "prefix-no-default",
|
|
675
|
-
storage: "localStorage",
|
|
676
|
-
basePath: "",
|
|
677
|
-
},
|
|
678
|
-
};
|
|
679
|
-
|
|
680
|
-
export default config;
|
|
681
|
-
```
|
|
682
|
-
|
|
683
|
-
**GDPR Uyumlu Yapılandırma**:
|
|
684
|
-
|
|
685
|
-
```typescript
|
|
686
|
-
import { Locales, type IntlayerConfig } from "intlayer";
|
|
687
|
-
// intlayer.config.ts
|
|
688
|
-
const config: IntlayerConfig = {
|
|
689
|
-
internationalization: {
|
|
690
|
-
locales: ["en", "fr", "es"],
|
|
691
|
-
defaultLocale: "en",
|
|
692
|
-
},
|
|
693
|
-
routing: {
|
|
694
|
-
mode: "prefix-no-default",
|
|
695
|
-
storage: [
|
|
696
|
-
{
|
|
697
|
-
type: "localStorage",
|
|
698
|
-
name: "user-locale",
|
|
699
|
-
},
|
|
700
|
-
{
|
|
701
|
-
type: "cookie",
|
|
702
|
-
name: "user-locale",
|
|
703
|
-
secure: true,
|
|
704
|
-
sameSite: "strict",
|
|
705
|
-
httpOnly: false,
|
|
706
|
-
},
|
|
707
|
-
],
|
|
708
|
-
basePath: "",
|
|
709
|
-
},
|
|
710
|
-
};
|
|
711
|
-
|
|
712
|
-
export default config;
|
|
713
|
-
```
|
|
714
|
-
|
|
715
|
-
**Arama Parametreleri Modu (Search Parameters Mode)**:
|
|
716
|
-
|
|
717
|
-
```typescript
|
|
718
|
-
import { Locales, type IntlayerConfig } from "intlayer";
|
|
719
|
-
// intlayer.config.ts
|
|
720
|
-
const config: IntlayerConfig = {
|
|
721
|
-
internationalization: {
|
|
722
|
-
locales: ["en", "fr", "es"],
|
|
723
|
-
defaultLocale: "en",
|
|
724
|
-
},
|
|
725
|
-
routing: {
|
|
726
|
-
mode: "search-params",
|
|
727
|
-
storage: "localStorage",
|
|
728
|
-
basePath: "",
|
|
729
|
-
},
|
|
730
|
-
};
|
|
731
|
-
|
|
732
|
-
export default config;
|
|
733
|
-
```
|
|
734
|
-
|
|
735
|
-
**Özel Depolama ile Ön Eki Olmayan Mod (No Prefix Mode)**:
|
|
736
|
-
|
|
737
|
-
```typescript
|
|
738
|
-
import { Locales, type IntlayerConfig } from "intlayer";
|
|
739
|
-
// intlayer.config.ts
|
|
740
|
-
const config: IntlayerConfig = {
|
|
741
|
-
internationalization: {
|
|
742
|
-
locales: ["en", "fr", "es"],
|
|
743
|
-
defaultLocale: "en",
|
|
744
|
-
},
|
|
745
|
-
routing: {
|
|
746
|
-
mode: "no-prefix",
|
|
747
|
-
storage: {
|
|
748
|
-
type: "sessionStorage",
|
|
749
|
-
name: "app-locale",
|
|
750
|
-
},
|
|
751
|
-
basePath: "/my-app",
|
|
752
|
-
},
|
|
753
|
-
};
|
|
754
|
-
|
|
755
|
-
export default config;
|
|
756
|
-
```
|
|
757
|
-
|
|
758
|
-
**Dinamik Yollarla Özel URL Yeniden Yazma**:
|
|
759
|
-
|
|
760
|
-
```typescript
|
|
761
|
-
// intlayer.config.ts
|
|
762
|
-
import { nextjsRewrite } from "intlayer/routing";
|
|
763
|
-
|
|
764
|
-
const config: IntlayerConfig = {
|
|
765
|
-
internationalization: {
|
|
766
|
-
locales: ["en", "fr"],
|
|
767
|
-
defaultLocale: "en",
|
|
768
|
-
},
|
|
769
|
-
routing: {
|
|
770
|
-
mode: "prefix-no-default", // Yeniden yazılmayan yollar için geri dönüş stratejisi
|
|
771
|
-
storage: "cookie",
|
|
772
|
-
rewrite: nextjsRewrite({
|
|
773
|
-
"/about": {
|
|
774
|
-
en: "/about",
|
|
775
|
-
fr: "/a-propos",
|
|
776
|
-
},
|
|
777
|
-
"/product/[slug]": {
|
|
778
|
-
en: "/product/[slug]",
|
|
779
|
-
fr: "/produit/[slug]",
|
|
780
|
-
},
|
|
781
|
-
"/blog/[category]/[id]": {
|
|
782
|
-
en: "/blog/[category]/[id]",
|
|
783
|
-
fr: "/journal/[category]/[id]",
|
|
784
|
-
},
|
|
785
|
-
}),
|
|
786
|
-
},
|
|
787
|
-
};
|
|
788
|
-
|
|
789
|
-
export default config;
|
|
790
|
-
```
|
|
791
|
-
|
|
792
|
-
---
|
|
793
|
-
|
|
794
|
-
### İçerik Yapılandırması (Content Configuration)
|
|
795
|
-
|
|
796
|
-
Uygulama içindeki içerik işleme ile ilgili ayarlar (dizin adları, dosya uzantıları ve türetilmiş yapılandırmalar).
|
|
797
|
-
|
|
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. |
|
|
806
|
-
|
|
807
|
-
---
|
|
808
|
-
|
|
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:
|
|
814
|
-
|
|
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.
|
|
817
|
-
|
|
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.
|
|
819
|
-
|
|
820
|
-
| Alan | Tür | Açıklama | Örnek | Not |
|
|
821
|
-
| --------------------------- | ----------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------ | ---------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
822
|
-
| `fill` | `boolean | FilePathPattern | Partial<Record<Locale, boolean | 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' | 'dynamic' | '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' | 'remote' | 'hybrid' | 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**:
|
|
828
|
-
|
|
829
|
-
```ts
|
|
830
|
-
dictionary: {
|
|
831
|
-
fill: {
|
|
832
|
-
en: '/locales/en/{{key}}.content.json',
|
|
833
|
-
fr: ({ key }) => `/locales/fr/${key}.content.json`,
|
|
834
|
-
es: false,
|
|
835
|
-
}
|
|
836
|
-
}
|
|
837
|
-
```
|
|
838
|
-
|
|
839
|
-
---
|
|
840
|
-
|
|
841
|
-
### Yapay Zeka Yapılandırması (AI Configuration)
|
|
842
|
-
|
|
843
|
-
Derleme çevirisi gibi Intlayer'ın yapay zeka destekli özellikleri için ayarları tanımlar.
|
|
844
|
-
|
|
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' | '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. |
|
|
853
|
-
|
|
854
|
-
---
|
|
855
|
-
|
|
856
|
-
### Derleme Yapılandırması (Build Configuration)
|
|
857
|
-
|
|
858
|
-
Intlayer derleme süreci ve optimizasyon ayarları.
|
|
859
|
-
|
|
860
|
-
| Alan | Tür | Açıklama | Örnek | Not |
|
|
861
|
-
| -------------- | ------------------------ | ---------------------------------------------------------------------------------------------------------------------------- | ----- | --- |
|
|
862
|
-
| `mode` | `'auto' | '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' | '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` | | |
|
|
866
|
-
|
|
867
|
-
---
|
|
868
|
-
|
|
869
|
-
### Sistem Yapılandırması (System Configuration)
|
|
870
|
-
|
|
871
|
-
Bu ayarlar gelişmiş kullanım durumları ve Intlayer'ın dahili yapılandırması içindir.
|
|
872
|
-
|
|
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'` |
|
|
882
|
-
|
|
883
|
-
---
|
|
884
|
-
|
|
885
|
-
### Derleyici Yapılandırması (Compiler Configuration)
|
|
886
|
-
|
|
887
|
-
Intlayer derleyicisi (`intlayer compiler`) için ayarlar.
|
|
888
|
-
|
|
889
|
-
| Alan | Tür | Açıklama | Varsayılan |
|
|
890
|
-
| --------------------- | ------------------------ | ----------------------------------------------------------------------------------------------- | ---------- |
|
|
891
|
-
| `enabled` | `boolean` | Derleyicinin aktif olup olmadığını belirtir. | `false` |
|
|
892
|
-
| `output` | `string | 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. | `''` |
|
|
896
|
-
|
|
897
|
-
---
|
|
898
|
-
|
|
899
|
-
### Günlükçü Yapılandırması (Logger Configuration)
|
|
900
|
-
|
|
901
|
-
Intlayer günlük çıktısını özelleştirmek için ayarlar.
|
|
902
|
-
|
|
903
|
-
| Alan | Tür | Açıklama | Varsayılan |
|
|
904
|
-
| -------- | ---------------------------------------------- | --------------------- | -------------- |
|
|
905
|
-
| `mode` | `'default' | 'verbose' | 'disabled'` | Günlükleme modu. | `'default'` |
|
|
906
|
-
| `prefix` | `string` | Günlük mesajı ön eki. | `'[intlayer]'` |
|
|
907
|
-
|
|
908
|
-
---
|
|
909
|
-
|
|
910
|
-
### Özel Şemalar (Custom Schemas)
|
|
911
|
-
|
|
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. |
|
|
915
|
-
|
|
916
|
-
---
|
|
917
|
-
|
|
918
|
-
### Eklentiler (Plugins)
|
|
919
|
-
|
|
920
|
-
| Alan | Tür | Açıklama |
|
|
921
|
-
| --------- | ------------------ | -------------------------------------------------- |
|
|
922
|
-
| `plugins` | `IntlayerPlugin[]` | Etkinleştirilecek Intlayer eklentilerinin listesi. |
|