@intlayer/docs 8.4.5 → 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.
Files changed (56) 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/dist/cjs/generated/docs.entry.cjs +20 -0
  12. package/dist/cjs/generated/docs.entry.cjs.map +1 -1
  13. package/dist/esm/generated/docs.entry.mjs +20 -0
  14. package/dist/esm/generated/docs.entry.mjs.map +1 -1
  15. package/dist/types/generated/docs.entry.d.ts +1 -0
  16. package/dist/types/generated/docs.entry.d.ts.map +1 -1
  17. package/docs/ar/intlayer_with_storybook.md +521 -0
  18. package/docs/bn/intlayer_with_hono.md +428 -0
  19. package/docs/de/intlayer_with_storybook.md +521 -0
  20. package/docs/en/configuration.md +160 -508
  21. package/docs/en/intlayer_with_storybook.md +521 -0
  22. package/docs/en-GB/intlayer_with_storybook.md +521 -0
  23. package/docs/es/configuration.md +387 -754
  24. package/docs/es/intlayer_with_storybook.md +521 -0
  25. package/docs/fr/configuration.md +384 -757
  26. package/docs/fr/intlayer_with_storybook.md +521 -0
  27. package/docs/hi/intlayer_with_storybook.md +521 -0
  28. package/docs/id/intlayer_with_storybook.md +521 -0
  29. package/docs/it/intlayer_with_storybook.md +521 -0
  30. package/docs/ja/intlayer_with_storybook.md +521 -0
  31. package/docs/ko/intlayer_with_storybook.md +521 -0
  32. package/docs/pl/intlayer_with_storybook.md +521 -0
  33. package/docs/pt/intlayer_with_storybook.md +521 -0
  34. package/docs/ru/intlayer_with_storybook.md +521 -0
  35. package/docs/tr/intlayer_with_storybook.md +521 -0
  36. package/docs/uk/intlayer_with_storybook.md +521 -0
  37. package/docs/ur/intlayer_with_hono.md +428 -0
  38. package/docs/vi/intlayer_with_storybook.md +521 -0
  39. package/docs/zh/intlayer_with_storybook.md +521 -0
  40. package/package.json +6 -6
  41. package/src/generated/docs.entry.ts +20 -0
  42. package/docs/ar/configuration.md +0 -1124
  43. package/docs/de/configuration.md +0 -1296
  44. package/docs/en-GB/configuration.md +0 -1123
  45. package/docs/hi/configuration.md +0 -1118
  46. package/docs/id/configuration.md +0 -1235
  47. package/docs/it/configuration.md +0 -1301
  48. package/docs/ja/configuration.md +0 -1121
  49. package/docs/ko/configuration.md +0 -1121
  50. package/docs/pl/configuration.md +0 -1226
  51. package/docs/pt/configuration.md +0 -1293
  52. package/docs/ru/configuration.md +0 -1112
  53. package/docs/tr/configuration.md +0 -1114
  54. package/docs/uk/configuration.md +0 -1241
  55. package/docs/vi/configuration.md +0 -1263
  56. package/docs/zh/configuration.md +0 -1115
@@ -1,1114 +0,0 @@
1
- ---
2
- createdAt: 2024-08-13
3
- updatedAt: 2026-03-12
4
- title: Yapılandırma
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.3.0
18
- date: 2026-03-11
19
- changes: 'baseDir''i ''content'' yapılandırmasından ''system'' yapılandırmasına taşıyın
20
- - version: 8.2.0
21
- date: 2026-03-09
22
- changes: Derleyici seçeneklerini güncelle, 'output' ve 'noMetadata' desteği ekle
23
- - version: 8.1.7
24
- date: 2026-02-25
25
- changes: Derleyici seçeneklerini güncelle
26
- - version: 8.0.6
27
- date: 2026-02-12
28
- changes: Open Router, Alibaba, Amazon, Google Vertex Bedrock, Fireworks, Groq, Hugging Face ve Together.ai sağlayıcıları için destek ekle
29
- - version: 8.0.5
30
- date: 2026-02-06
31
- changes: AI yapılandırmasına `dataSerialization` eklendi
32
- - version: 8.0.0
33
- date: 2026-01-22
34
- changes: importMode derleme yapılandırmasını sözlük yapılandırmasına taşıyın.
35
- - version: 8.0.0
36
- date: 2026-01-18
37
- changes: Sistem yapılandırmasını içerik yapılandırmasından ayırın. İç yolları `system` özelliğine taşıyın. İçerik dosyalarını kod dönüşümünden ayırmak için `codeDir` ekleyin.
38
- - version: 8.0.0
39
- date: 2026-01-18
40
- changes: Sözlük seçenekleri `location` ve `schema` eklendi
41
- - version: 7.5.1
42
- date: 2026-01-10
43
- changes: JSON5 ve JSONC dosya formatları için destek eklendi
44
- - version: 7.5.0
45
- date: 2025-12-17
46
- changes: `buildMode` seçeneği eklendi
47
- - version: 6.0.0
48
- date: 2025-09-16
49
- changes: `live` import modu eklendi
50
- - version: 6.0.0
51
- date: 2025-09-16
52
- changes: `live` import modu eklendi
53
- - version: 6.0.0
54
- date: 2025-09-04
55
- changes: `hotReload` alanı `liveSync` ile değiştirildi ve `liveSyncPort` ile `liveSyncURL` alanları eklendi
56
- - version: 5.6.1
57
- date: 2025-07-25
58
- changes: `activateDynamicImport` seçeneği `importMode` ile değiştirildi
59
- - version: 5.6.0
60
- date: 2025-07-13
61
- changes: Varsayılan contentDir `['src']`'den `['.']` olarak değiştirildi
62
- - version: 5.5.11
63
- date: 2025-06-29
64
- changes: `docs` komutları eklendi
65
- ---
66
-
67
- # Intlayer Yapılandırma Dokümantasyonu
68
-
69
- ## Genel Bakış
70
-
71
- Intlayer yapılandırma dosyaları, uluslararasılaştırma, ara katman (middleware) ve içerik işleme gibi eklentinin çeşitli yönlerinin özelleştirilmesine olanak tanır. Bu belge, yapılandırmadaki her bir özelliğin ayrıntılı açıklamasını sağlar.
72
-
73
- ---
74
-
75
- ## İçindekiler
76
-
77
- <TOC/>
78
-
79
- ---
80
-
81
- ## Yapılandırma Dosyası Desteği
82
-
83
- Intlayer, JSON, JS, MJS ve TS yapılandırma dosyası formatlarını kabul eder:
84
-
85
- - `intlayer.config.ts`
86
- - `intlayer.config.js`
87
- - `intlayer.config.json`
88
- - `intlayer.config.json5`
89
- - `intlayer.config.jsonc`
90
- - `intlayer.config.cjs`
91
- - `intlayer.config.mjs`
92
- - `.intlayerrc`
93
-
94
- ---
95
-
96
- ## Örnek yapılandırma dosyası
97
-
98
- ````typescript fileName="intlayer.config.ts" codeFormat="typescript"
99
- import { Locales, type IntlayerConfig } from "intlayer";
100
- import { nextjsRewrite } from "intlayer/routing";
101
- import { z } from "zod";
102
-
103
- /**
104
- * Example Intlayer configuration file showing all available options.
105
- */
106
- const config: IntlayerConfig = {
107
- /**
108
- * Configuration for internationalization settings.
109
- */
110
- internationalization: {
111
- /**
112
- * List of supported locales in the application.
113
- * Default: [Locales.ENGLISH]
114
- */
115
- locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],
116
-
117
- /**
118
- * List of required locales that must be defined in every dictionary.
119
- * If empty, all locales are required in `strict` mode.
120
- * Default: []
121
- */
122
- requiredLocales: [Locales.ENGLISH],
123
-
124
- /**
125
- * Strictness level for internationalized content.
126
- * - "strict": Errors if any declared locale is missing or undeclared.
127
- * - "inclusive": Warnings if a declared locale is missing.
128
- * - "loose": Accepts any existing locale.
129
- * Default: "inclusive"
130
- */
131
- strictMode: "inclusive",
132
-
133
- /**
134
- * Default locale used as a fallback if the requested locale is not found.
135
- * Default: Locales.ENGLISH
136
- */
137
- defaultLocale: Locales.ENGLISH,
138
- },
139
-
140
- /**
141
- * Settings that control dictionary operations and fallback behavior.
142
- */
143
- dictionary: {
144
- /**
145
- * Controls how dictionaries are imported.
146
- * - "static": Statically imported at build time.
147
- * - "dynamic": Dynamically imported using Suspense.
148
- * - "fetch": Fetched dynamically via the live sync API.
149
- * Default: "static"
150
- */
151
- importMode: "static",
152
-
153
- /**
154
- * Strategy for auto-filling missing translations using AI.
155
- * Can be a boolean or a path pattern to store filled content.
156
- * Default: true
157
- */
158
- fill: true,
159
-
160
- /**
161
- * Physical location of the dictionary files.
162
- * - "local": Stored in the local filesystem.
163
- * - "remote": Stored in the Intlayer CMS.
164
- * - "hybrid": Stored in the local filesystem and the Intlayer CMS.
165
- * - "plugin" (or any custom string): Provided by a plugin or a custom source.
166
- * Default: "local"
167
- */
168
- location: "local",
169
-
170
- /**
171
- * Whether to automatically transform content (e.g., Markdown to HTML).
172
- * Default: false
173
- */
174
- contentAutoTransformation: false,
175
- },
176
-
177
- /**
178
- * Routing and middleware configuration.
179
- */
180
- routing: {
181
- /**
182
- * Locale routing strategy.
183
- * - "prefix-no-default": Prefix all except the default locale (e.g., /dashboard, /fr/dashboard).
184
- * - "prefix-all": Prefix all locales (e.g., /en/dashboard, /fr/dashboard).
185
- * - "no-prefix": No locale in the URL.
186
- * - "search-params": Use ?locale=...
187
- * Default: "prefix-no-default"
188
- */
189
- mode: "prefix-no-default",
190
-
191
- /**
192
- * Where to store the user's selected locale.
193
- * Options: 'cookie', 'localStorage', 'sessionStorage', 'header', or an array of these.
194
- * Default: ['cookie', 'header']
195
- */
196
- storage: ["cookie", "header"],
197
-
198
- /**
199
- * Base path for the application URLs.
200
- * Default: ""
201
- */
202
- basePath: "",
203
-
204
- /**
205
- * Custom URL rewriting rules for locale-specific paths.
206
- */
207
- rewrite: nextjsRewrite({
208
- "/[locale]/about": {
209
- en: "/[locale]/about",
210
- fr: "/[locale]/a-propos",
211
- },
212
- }),
213
- },
214
-
215
- /**
216
- * Settings for finding and processing content files.
217
- */
218
- content: {
219
- /**
220
- * File extensions to scan for dictionaries.
221
- * Default: ['.content.ts', '.content.js', '.content.json', etc.]
222
- */
223
- fileExtensions: [".content.ts", ".content.js", ".content.json"],
224
-
225
- /**
226
- * Directories where .content files are located.
227
- * Default: ["."]
228
- */
229
- contentDir: ["src"],
230
-
231
- /**
232
- * Directories where source code is located.
233
- * Used for build optimization and code transformation.
234
- * Default: ["."]
235
- */
236
- codeDir: ["src"],
237
-
238
- /**
239
- * Patterns to exclude from scanning.
240
- * Default: ['node_modules', '.intlayer', etc.]
241
- */
242
- excludedPath: ["node_modules"],
243
-
244
- /**
245
- * Whether to watch for changes and rebuild dictionaries in development.
246
- * Default: true in development
247
- */
248
- watch: true,
249
-
250
- /**
251
- * Command to format newly created / updated .content files.
252
- */
253
- formatCommand: 'npx prettier --write "{{file}}"',
254
- },
255
-
256
- /**
257
- * Visual Editor configuration.
258
- */
259
- editor: {
260
- /**
261
- * Whether the visual editor is enabled.
262
- * Default: false
263
- */
264
- enabled: true,
265
-
266
- /**
267
- * URL of your application for origin validation.
268
- * Default: ""
269
- */
270
- applicationURL: "http://localhost:3000",
271
-
272
- /**
273
- * Port for the local editor server.
274
- * Default: 8000
275
- */
276
- port: 8000,
277
-
278
- /**
279
- * Public URL for the editor.
280
- * Default: "http://localhost:8000"
281
- */
282
- editorURL: "http://localhost:8000",
283
-
284
- /**
285
- * Intlayer CMS URL.
286
- * Default: "https://app.intlayer.org"
287
- */
288
- cmsURL: "https://app.intlayer.org",
289
-
290
- /**
291
- * Backend API URL.
292
- * Default: "https://back.intlayer.org"
293
- */
294
- backendURL: "https://back.intlayer.org",
295
-
296
- /**
297
- * Whether to enable real-time content synchronization.
298
- * Default: false
299
- */
300
- liveSync: true,
301
- },
302
-
303
- /**
304
- * AI-powered translation and generation settings.
305
- */
306
- ai: {
307
- /**
308
- * AI provider to use.
309
- * Options: 'openai', 'anthropic', 'mistral', 'deepseek', 'gemini', 'ollama', 'openrouter', 'alibaba', 'fireworks', 'groq', 'huggingface', 'bedrock', 'googlevertex', 'togetherai'
310
- * Default: 'openai'
311
- */
312
- provider: "openai",
313
-
314
- /**
315
- * Model to use from the selected provider.
316
- */
317
- model: "gpt-4o",
318
-
319
- /**
320
- * Provider API key.
321
- */
322
- apiKey: process.env.OPENAI_API_KEY,
323
-
324
- /**
325
- * Global context to guide the AI in generating translations.
326
- */
327
- applicationContext: "This is a travel booking application.",
328
-
329
- /**
330
- * Base URL for the AI API.
331
- */
332
- baseURL: "http://localhost:3000",
333
-
334
- /**
335
- * Veri Serileştirme
336
- *
337
- * Seçenekler:
338
- * - "json": Standart, güvenilir; daha fazla token kullanır.
339
- * - "toon": Daha az token, JSON'dan daha az tutarlı.
340
- *
341
- * Varsayılan: "json"
342
- */
343
- dataSerialization: "json",
344
- },
345
-
346
- /**
347
- * Build and optimization settings.
348
- */
349
- build: {
350
- /**
351
- * Build execution mode.
352
- * - "auto": Automatic build during app build.
353
- * - "manual": Requires explicit build command.
354
- * Default: "auto"
355
- */
356
- mode: "auto",
357
-
358
- /**
359
- * Whether to optimize the final bundle by pruning unused dictionaries.
360
- * Default: true in production
361
- */
362
- optimize: true,
363
-
364
- /**
365
- * Output format for generated dictionary files.
366
- * Default: ['esm', 'cjs']
367
- */
368
- outputFormat: ["esm"],
369
-
370
- /**
371
- * Indicates if the build should check TypeScript types.
372
- * Default: false
373
- */
374
- checkTypes: false,
375
- },
376
-
377
- /**
378
- * Logger configuration.
379
- */
380
- log: {
381
- /**
382
- * Logging level.
383
- * - "default": Standard logging.
384
- * - "verbose": Detailed debug logging.
385
- * - "disabled": No logging.
386
- * Default: "default"
387
- */
388
- mode: "default",
389
-
390
- /**
391
- * Prefix for all log messages.
392
- * Default: "[intlayer]"
393
- */
394
- prefix: "[intlayer]",
395
- },
396
-
397
- /**
398
- * System configuration (Advanced use cases)
399
- */
400
- system: {
401
- /**
402
- * Directory for storing localization dictionaries.
403
- */
404
- dictionariesDir: ".intlayer/dictionary",
405
-
406
- /**
407
- * Directory for module augmentation.
408
- */
409
- moduleAugmentationDir: ".intlayer/types",
410
-
411
- /**
412
- * Directory for storing unmerged dictionaries.
413
- */
414
- unmergedDictionariesDir: ".intlayer/unmerged_dictionary",
415
-
416
- /**
417
- * Directory for storing dictionary types.
418
- */
419
- typesDir: ".intlayer/types",
420
-
421
- /**
422
- * Directory where main application files are stored.
423
- */
424
- mainDir: ".intlayer/main",
425
-
426
- /**
427
- * Directory where the configuration files are stored.
428
- */
429
- configDir: ".intlayer/config",
430
-
431
- /**
432
- * Directory where the cache files are stored.
433
- */
434
- cacheDir: ".intlayer/cache",
435
- },
436
-
437
- /**
438
- * Compiler configuration (Advanced use cases)
439
- */
440
- compiler: {
441
- /**
442
- * Derleyicinin etkinleştirilip etkinleştirilmeyeceğini belirtir.
443
- *
444
- * - false : Derleyiciyi devre dışı bırakır.
445
- * - true : Derleyiciyi etkinleştirir.
446
- * - "build-only" : Başlangıç sürelerini hızlandırmak için geliştirme sırasında derleyiciyi atlar.
447
- *
448
- * Varsayılan değer : false
449
- */
450
- enabled: true,
451
-
452
- /**
453
- * Çıktı dosyalarının yolunu tanımlar. `outputDir` yerine geçer.
454
- *
455
- * - `./` ile başlayan yollar bileşen dizinine göre çözümlenir.
456
- * - `/` ile başlayan yollar projenin kök dizinine (`baseDir`) göre çözümlenir.
457
- *
458
- * - Yola `{{locale}}` değişkenini dahil etmek, dile göre ayrılmış sözlüklerin oluşturulmasını etkinleştirir.
459
- *
460
- * Örnek:
461
- * ```ts
462
- * {
463
- * // Bileşenin yanına çok dilli .content.ts dosyaları oluşturun
464
- * output: ({ fileName, extension }) => `./${fileName}${extension}`,
465
- *
466
- * // output: './{{fileName}}{{extension}}', // Şablon dizesi kullanarak eşdeğer
467
- * }
468
- * ```
469
- *
470
- * ```ts
471
- * {
472
- * // Proje kökünde dile göre merkezileştirilmiş JSON dosyaları oluşturun
473
- * output: ({ key, locale }) => `/locales/${locale}/${key}.content.json`,
474
- *
475
- * // output: '/locales/{{locale}}/{{key}}.content.json', // Şablon dizesi kullanarak eşdeğer
476
- * }
477
- * ```
478
- *
479
- * Değişken listesi:
480
- * - `fileName`: Dosya adı.
481
- * - `key`: İçerik anahtarı.
482
- * - `locale`: İçerik dili.
483
- * - `extension`: Dosya uzantısı.
484
- * - `componentFileName`: Bileşen dosya adı.
485
- * - `componentExtension`: Bileşen dosya uzantısı.
486
- * - `format`: Sözlük formatı.
487
- * - `componentFormat`: Bileşen sözlük formatı.
488
- * - `componentDirPath`: Bileşen dizin yolu.
489
- */
490
- output: ({ locale, key }) => `compiler/${locale}/${key}.json`,
491
-
492
- /**
493
- * Bileşenlerin dönüştürüldükten sonra kaydedilip kaydedilmeyeceğini belirtir.
494
- * Bu şekilde, derleyici uygulamayı dönüştürmek için yalnızca bir kez çalıştırılabilir ve ardından kaldırılabilir.
495
- */
496
- saveComponents: false,
497
-
498
- /**
499
- * Oluşturulan dosyaya yalnızca içeriği yerleştirin. Yerel ayar başına i18next veya ICU MessageFormat JSON çıktıları için yararlıdır.
500
- */
501
- noMetadata: false,
502
-
503
- /**
504
- * Sözlük anahtar öneki
505
- */
506
- dictionaryKeyPrefix: "", // Ayıklanan sözlük anahtarları için isteğe bağlı önek ekleyin
507
- },
508
-
509
- /**
510
- * Custom schemas to validate the dictionaries content.
511
- */
512
- schemas: {
513
- "my-schema": z.object({
514
- title: z.string(),
515
- }),
516
- },
517
-
518
- /**
519
- * Plugins configuration.
520
- */
521
- plugins: [],
522
- };
523
-
524
- export default config;
525
- ````
526
-
527
- ## Konfigürasyon Referansı
528
-
529
- Aşağıdaki bölümler, Intlayer için mevcut olan çeşitli konfigürasyon ayarlarını açıklamaktadır.
530
-
531
- ---
532
-
533
- ### Uluslararasılaştırma Konfigürasyonu
534
-
535
- Uygulama için mevcut yerel ayarları ve varsayılan yerel ayarı içeren uluslararasılaştırma ile ilgili ayarları tanımlar.
536
-
537
- #### Özellikler
538
-
539
- - **locales**:
540
- - _Tür_: `string[]`
541
- - _Varsayılan_: `['en']`
542
- - _Açıklama_: Uygulamada desteklenen yerel ayarların listesi.
543
- - _Örnek_: `['en', 'fr', 'es']`
544
-
545
- - **requiredLocales**:
546
- - _Tür_: `string[]`
547
- - _Varsayılan_: `[]`
548
- - _Açıklama_: Uygulamada zorunlu olan yerel ayarların listesi.
549
- - _Örnek_: `[]`
550
- - _Not_: Boşsa, `strict` modda tüm yerel ayarlar gereklidir.
551
- - _Not_: Gereken yerel ayarların `locales` alanında da tanımlandığından emin olun.
552
- - **strictMode**:
553
- - _Tür_: `string`
554
- - _Varsayılan_: `inclusive`
555
- - _Açıklama_: Typescript kullanarak uluslararasılaştırılmış içeriğin güçlü uygulamalarını sağlar.
556
- - _Not_: "strict" olarak ayarlanırsa, çeviri `t` fonksiyonu her bildirilen yerel ayarın tanımlanmasını gerektirir. Bir yerel ayar eksikse veya yapılandırmanızda bildirilmemişse, hata verir.
557
- - _Not_: "inclusive" olarak ayarlanırsa, çeviri `t` fonksiyonu her bildirilen yerel ayarın tanımlanmasını gerektirir. Bir yerel ayar eksikse uyarı verir. Ancak yapılandırmanızda bildirilmemiş ama mevcut olan bir yerel ayarı kabul eder.
558
- - _Not_: "loose" olarak ayarlanırsa, çeviri `t` fonksiyonu mevcut olan herhangi bir yerel ayarı kabul edecektir.
559
-
560
- - **defaultLocale**:
561
- - _Tür_: `string`
562
- - _Varsayılan_: `'en'`
563
- - _Açıklama_: İstenen yerel ayar bulunamadığında kullanılan varsayılan yerel ayar.
564
- - _Örnek_: `'en'`
565
- - _Not_: URL, çerez veya başlıkta yerel ayar belirtilmediğinde kullanılacak yerel ayarı belirlemek için kullanılır.
566
-
567
- ---
568
-
569
- ### Editör Yapılandırması
570
-
571
- Entegre editörle ilgili ayarları, sunucu portu ve aktiflik durumu dahil olmak üzere tanımlar.
572
-
573
- #### Özellikler
574
-
575
- - **applicationURL**:
576
- - _Tür_: `string`
577
- - _Varsayılan_: `http://localhost:3000`
578
- - _Açıklama_: Uygulamanın URL'si. Güvenlik nedenleriyle editörün kaynağını kısıtlamak için kullanılır.
579
- - _Örnek_:
580
- - `'http://localhost:3000'`
581
- - `'https://example.com'`
582
- - `process.env.INTLAYER_EDITOR_URL`
583
- - _Not_: Uygulamanın URL'si. Güvenlik nedenleriyle editörün kaynağını kısıtlamak için kullanılır. `'*'` olarak ayarlanırsa, editöre herhangi bir kaynaktan erişilebilir.
584
-
585
- - **port**:
586
- - _Tür_: `number`
587
- - _Varsayılan_: `8000`
588
- - _Açıklama_: Görsel editör sunucusunun kullandığı port.
589
-
590
- - **editorURL**:
591
- - _Tür_: `string`
592
- - _Varsayılan_: `'http://localhost:8000'`
593
- - _Açıklama_: Editör sunucusunun URL'si. Güvenlik nedenleriyle editörün kaynağını kısıtlamak için kullanılır.
594
- - `'http://localhost:3000'`
595
- - `'https://example.com'`
596
- - `process.env.INTLAYER_EDITOR_URL`
597
- - _Not_: Uygulamadan erişilecek editör sunucusunun URL'si. Güvenlik nedenleriyle uygulamayla etkileşime girebilecek kaynakları kısıtlamak için kullanılır. `'*'` olarak ayarlanırsa, editöre herhangi bir kaynaktan erişilebilir. Port değiştirildiğinde veya editör farklı bir alan adında barındırılıyorsa ayarlanmalıdır.
598
-
599
- - **cmsURL**:
600
- - _Tür_: `string`
601
- - _Varsayılan_: `'https://intlayer.org'`
602
- - _Açıklama_: Intlayer CMS'nin URL'si.
603
- - _Örnek_: `'https://intlayer.org'`
604
- - _Not_: Intlayer CMS'nin URL'si.
605
-
606
- - **backendURL**:
607
- - _Tür_: `string`
608
- - _Varsayılan_: `https://back.intlayer.org`
609
- - _Açıklama_: Backend sunucusunun URL'si.
610
- - _Örnek_: `http://localhost:4000`
611
-
612
- - **enabled**:
613
- - _Tür_: `boolean`
614
- - _Varsayılan_: `true`
615
- - _Açıklama_: Uygulamanın görsel editörle etkileşimde bulunup bulunmadığını belirtir.
616
- - _Örnek_: `process.env.NODE_ENV !== 'production'`
617
- - _Not_: Eğer true ise, editör uygulamayla etkileşimde bulunabilir. Eğer false ise, editör uygulamayla etkileşimde bulunamaz. Her durumda, editör yalnızca görsel editör tarafından etkinleştirilebilir. Belirli ortamlar için editörün devre dışı bırakılması, güvenliği sağlamak için bir yöntemdir.
618
-
619
- - **clientId**:
620
- - _Tür_: `string` | `undefined`
621
- - _Varsayılan_: `undefined`
622
- - _Açıklama_: clientId ve clientSecret, intlayer paketlerinin backend ile oAuth2 kimlik doğrulaması kullanarak kimlik doğrulaması yapmasını sağlar. Bir erişim belirteci, projeyle ilişkili kullanıcıyı doğrulamak için kullanılır. Bir erişim belirteci almak için https://app.intlayer.org/project adresine gidip bir hesap oluşturun.
623
- - _Örnek_: `true`
624
- - _Not_: Önemli: clientId ve clientSecret gizli tutulmalı ve kamuya açık şekilde paylaşılmamalıdır. Lütfen bunları ortam değişkenleri gibi güvenli bir yerde sakladığınızdan emin olun.
625
-
626
- - **clientSecret**:
627
- - _Tür_: `string` | `undefined`
628
- - _Varsayılan_: `undefined`
629
- - _Açıklama_: clientId ve clientSecret, intlayer paketlerinin backend ile oAuth2 kimlik doğrulaması kullanarak doğrulanmasını sağlar. Bir erişim belirteci, projeyle ilişkili kullanıcıyı doğrulamak için kullanılır. Bir erişim belirteci almak için https://app.intlayer.org/project adresine gidip bir hesap oluşturun.
630
- - _Örnek_: `true`
631
- - _Not_: Önemli: clientId ve clientSecret gizli tutulmalı ve kamuya açık şekilde paylaşılmamalıdır. Lütfen bunları ortam değişkenleri gibi güvenli bir yerde sakladığınızdan emin olun.
632
-
633
- - **dictionaryPriorityStrategy**:
634
- - _Tür_: `string`
635
- - _Varsayılan_: `'local_first'`
636
- - _Açıklama_: Hem yerel hem de uzak sözlüklerin mevcut olduğu durumlarda sözlüklerin önceliklendirilme stratejisi. `'distant_first'` olarak ayarlanırsa, uygulama uzak sözlüklere yerel sözlüklerden daha fazla öncelik verir. `'local_first'` olarak ayarlanırsa, uygulama yerel sözlüklere uzak sözlüklerden daha fazla öncelik verir.
637
- - _Örnek_: `'distant_first'`
638
-
639
- - **liveSync**:
640
- - _Tür_: `boolean`
641
- - _Varsayılan_: `false`
642
- - _Açıklama_: CMS / Görsel Editör / Backend üzerinde bir değişiklik algılandığında uygulama sunucusunun içeriği sıcak yeniden yükleyip yüklemeyeceğini belirtir.
643
- - _Örnek_: `true`
644
- - _Not_: Örneğin, yeni bir sözlük eklendiğinde veya güncellendiğinde, uygulama sayfada görüntülenecek içeriği günceller.
645
- - _Not_: Canlı senkronizasyon, uygulamanın içeriğini başka bir sunucuya dışa aktarmayı gerektirir. Bu, uygulamanın performansını biraz etkileyebilir. Bunu sınırlamak için, uygulamanın ve canlı senkronizasyon sunucusunun aynı makinede barındırılmasını öneriyoruz. Ayrıca, canlı senkronizasyon ile `optimize` kombinasyonu, canlı senkronizasyon sunucusuna önemli sayıda istek gönderebilir. Altyapınıza bağlı olarak, her iki seçeneği ve kombinasyonlarını test etmenizi öneririz.
646
-
647
- - **liveSyncPort**:
648
- - _Tür_: `number`
649
- - _Varsayılan_: `4000`
650
- - _Açıklama_: Canlı senkronizasyon sunucusunun portu.
651
- - _Örnek_: `4000`
652
- - _Not_: Canlı senkronizasyon sunucusunun portu.
653
-
654
- - **liveSyncURL**:
655
- - _Tür_: `string`
656
- - _Varsayılan_: `'http://localhost:{liveSyncPort}'`
657
- - _Açıklama_: Canlı senkronizasyon sunucusunun URL'si.
658
- - _Örnek_: `'https://example.com'`
659
- - _Not_: Varsayılan olarak localhost'a işaret eder ancak uzak bir canlı senkronizasyon sunucusu durumunda herhangi bir URL'ye değiştirilebilir.
660
-
661
- ### Ara Katman (Middleware) Yapılandırması
662
-
663
- Uygulamanın çerezleri, başlıkları ve yerel yönetimi için URL öneklerini nasıl yönettiğini kontrol eden ayarlar.
664
-
665
- #### Özellikler
666
-
667
- - **headerName**:
668
- - _Tür_: `string`
669
- - _Varsayılan_: `'x-intlayer-locale'`
670
- - _Açıklama_: Yerel ayarı belirlemek için kullanılan HTTP başlığının adı.
671
- - _Örnek_: `'x-custom-locale'`
672
- - _Not_: API tabanlı yerel belirleme için faydalıdır.
673
-
674
- - **cookieName**:
675
- - _Tür_: `string`
676
- - _Varsayılan_: `'intlayer-locale'`
677
- - _Açıklama_: Yerel ayarı saklamak için kullanılan çerezin adı.
678
- - _Örnek_: `'custom-locale'`
679
- - _Not_: Oturumlar arasında yerel ayarın korunması için kullanılır.
680
-
681
- - **prefixDefault**:
682
- - _Tür_: `boolean`
683
- - _Varsayılan_: `false`
684
- - _Açıklama_: Varsayılan yerel ayarın URL'de dahil edilip edilmeyeceği.
685
- - _Örnek_: `true`
686
- - _Not_:
687
- - Eğer `true` ve `defaultLocale = 'en'` ise: yol = `/en/dashboard` veya `/fr/dashboard`
688
- - Eğer `false` ve `defaultLocale = 'en'` ise: yol = `/dashboard` veya `/fr/dashboard`
689
-
690
- - **basePath**:
691
- - _Tür_: `string`
692
- - _Varsayılan_: `''`
693
- - _Açıklama_: Uygulama URL'leri için temel yol.
694
- - _Örnek_: `'/my-app'`
695
- - _Not_:
696
- - Uygulama `https://example.com/my-app` adresinde barındırılıyorsa
697
- - Temel yol `'/my-app'` olur
698
- - URL `https://example.com/my-app/en` olacaktır
699
- - Eğer base path ayarlanmazsa, URL `https://example.com/en` olacaktır.
700
-
701
- - **rewrite**:
702
- - _Tür_: `Record<string, StrictModeLocaleMap<string>>`
703
- - _Varsayılan_: `undefined`
704
- - _Açıklama_: Belirli yollar için varsayılan yönlendirme modunu geçersiz kılan özel URL yeniden yazma kuralları. Standart yönlendirme davranışından farklı dil-spesifik yollar tanımlamanıza olanak tanır. `[param]` sözdizimini kullanarak dinamik rota parametrelerini destekler.
705
- - _Örnek_:
706
- ```typescript
707
- routing: {
708
- mode: "prefix-no-default", // Yedek strateji
709
- rewrite: nextjsRewrite({
710
- "/[locale]/about": {
711
- en: "/[locale]/about",
712
- fr: "/[locale]/a-propos",
713
- },
714
- "/[locale]/product/[slug]": {
715
- en: "/[locale]/product/[slug]",
716
- fr: "/[locale]/produit/[slug]",
717
- },
718
- "/[locale]/blog/[category]/[id]": {
719
- en: "/[locale]/blog/[category]/[id]",
720
- fr: "/[locale]/journal/[category]/[id]",
721
- },
722
- }),
723
- }
724
- ```
725
- - _Not_: Yeniden yazma kuralları varsayılan `mode` davranışından önceliklidir. Bir yol bir yeniden yazma kuralıyla eşleşirse, standart dil öneki yerine yeniden yazma yapılandırmasından yerelleştirilmiş yol kullanılacaktır.
726
- - _Not_: Dinamik rota parametreleri köşeli ayraç gösterimi (örneğin, `[slug]`, `[id]`) kullanılarak desteklenir. Parametre değerleri URL'den otomatik olarak çıkarılır ve yeniden yazılan yola eklenir.
727
- - _Not_: Next.js ve Vite uygulamalarıyla çalışır. Middleware/proxy, gelen istekleri iç rota yapısıyla eşleşecek şekilde otomatik olarak yeniden yazacaktır.
728
- - _Not_: `getLocalizedUrl()` ile URL oluştururken, sağlanan yolla eşleşirlerse yeniden yazma kuralları otomatik olarak uygulanır.
729
- - _Referans_: Daha fazla bilgi için, [Özel URL Yeniden Yazma](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/custom_url_rewrites.md) konusuna bakın.
730
-
731
- - **serverSetCookie**:
732
- - _Tür_: `string`
733
- - _Varsayılan_: `'always'`
734
- - _Açıklama_: Sunucuda locale çerezinin ayarlanma kuralı.
735
- - _Seçenekler_: `'always'`, `'never'`
736
- - _Örnek_: `'never'`
737
- - _Not_: Locale çerezinin her istekte mi yoksa hiç mi ayarlanacağını kontrol eder.
738
-
739
- - **noPrefix**:
740
- - _Tür_: `boolean`
741
- - _Varsayılan_: `false`
742
- - _Açıklama_: URL'lerden locale önekinin çıkarılıp çıkarılmayacağı.
743
- - _Örnek_: `true`
744
- - _Not_:
745
- - Eğer `true` ise: URL'de önek olmaz
746
- - Eğer `false` ise: URL'de önek olur
747
- - `basePath = '/my-app'` örneği:
748
- - Eğer `noPrefix = false` ise: URL `https://example.com/my-app/en` olur
749
- - Eğer `noPrefix = true` ise: URL `https://example.com` olur
750
-
751
- ---
752
-
753
- ### İçerik Yapılandırması
754
-
755
- Uygulama içindeki içerik yönetimi ile ilgili ayarlar; dizin isimleri, dosya uzantıları ve türetilmiş yapılandırmalar dahil.
756
-
757
- #### Özellikler
758
-
759
- - **autoFill**:
760
- - _Tür_: `boolean | string | FilePathPattern | { [key in Locales]?: string }`
761
- - _Varsayılan_: `undefined`
762
- - _Açıklama_: İçeriğin yapay zeka kullanılarak otomatik olarak nasıl doldurulacağını belirtir. `intlayer.config.ts` dosyasında global olarak tanımlanabilir.
763
- - _Örnek_: true
764
- - _Örnek_: `'./{{fileName}}.content.json'`
765
- - _Örnek_: `{ fr: './{{fileName}}.fr.content.json', es: './{{fileName}}.es.content.json' }`
766
- - _Not_: Otomatik doldurma yapılandırması. Şunlar olabilir:
767
- - boolean: Tüm yereller için otomatik doldurmayı etkinleştirir
768
- - string: Değişkenler içeren tek bir dosya yolu veya şablon
769
- - object: Yerel bazında dosya yolları
770
-
771
- - **watch**:
772
- - _Tür_: `boolean`
773
- - _Varsayılan_: `process.env.NODE_ENV === 'development'`
774
- - _Açıklama_: Intlayer'ın uygulamadaki içerik beyan dosyalarındaki değişiklikleri izleyip ilgili sözlükleri yeniden oluşturup oluşturmayacağını belirtir.
775
-
776
- - **fileExtensions**:
777
- - _Tür_: `string[]`
778
- - _Varsayılan_: `['.content.ts', '.content.js', '.content.cjs', '.content.mjs', '.content.json', '.content.tsx', '.content.jsx']`
779
- - _Açıklama_: Sözlükler oluşturulurken aranacak dosya uzantıları.
780
- - _Örnek_: `['.data.ts', '.data.js', '.data.json']`
781
- - _Not_: Dosya uzantılarının özelleştirilmesi çakışmaları önlemeye yardımcı olabilir.
782
-
783
- - **dictionaryOutput**:
784
- - _Tür_: `string[]`
785
- - _Varsayılan_: `['intlayer']`
786
- - _Açıklama_: Kullanılacak sözlük çıktısı türü, örn. `'intlayer'` veya `'i18next'`.
787
-
788
- - **contentDir**:
789
- - _Tür_: `string[]`
790
- - _Varsayılan_: `['.']`
791
- - _Örnek_: `['src', '../../ui-library', require.resolve("@my-package/content")]`
792
- - _Açıklama_: İçerik tanım dosyalarının (`.content.*`) depolandığı dizin yolu.
793
- - _Not_: Bu, sözlükleri yeniden oluşturmak için içerik dosyalarını izlemek için kullanılır.
794
-
795
- - **codeDir**:
796
- - _Tür_: `string[]`
797
- - _Varsayılan_: `['.']`
798
- - _Örnek_: `['src', '../../ui-library']`
799
- - _Açıklama_: Kodun depolandığı dizin yolu, temel dizine göre.
800
- - _Not_: Bu, kod dosyalarını dönüştürmek (budama, optimizasyon) için izlemek için kullanılır. Bunu `contentDir`'den ayrı tutmak, içerik dosyalarının gereksiz taramalarından kaçınarak derleme performansını artırabilir.
801
-
802
- ---
803
-
804
- ### Sistem Yapılandırması
805
-
806
- Intlayer'ın iç yolları ve çıktı sonuçlarıyla ilgili ayarlar. Bu ayarlar genellikle dâhildir ve kullanıcı tarafından değiştirilmeleri gerekmez.
807
-
808
- #### Özellikler
809
-
810
- - **baseDir**:
811
- - _Tür_: `string`
812
- - _Varsayılan_: `process.cwd()`
813
- - _Açıklama_: Projenin temel dizini.
814
- - _Örnek_: `'/path/to/project'`
815
- - _Not_: Tüm Intlayer ile ilgili dizinlerin çözülmesinde kullanılır.
816
-
817
- - **dictionariesDir**:
818
- - _Tür_: `string`
819
- - _Varsayılan_: `'.intlayer/dictionary'`
820
- - _Açıklama_: Yerelleştirme sözlüklerinin saklandığı dizin.
821
- - _Örnek_: `'translations'`
822
-
823
- - **moduleAugmentationDir**:
824
- - _Tür_: `string`
825
- - _Varsayılan_: `'.intlayer/types'`
826
- - _Açıklama_: Modül genişletme için dizin, daha iyi IDE önerileri ve tip kontrolü sağlar.
827
- - _Örnek_: `'intlayer-types'`
828
- - _Not_: Bunu `tsconfig.json` dosyanıza eklediğinizden emin olun.
829
-
830
- - **unmergedDictionariesDir**:
831
- - _Tür_: `string`
832
- - _Varsayılan_: `'.intlayer/unmerged_dictionary'`
833
- - _Açıklama_: Birleştirilmemiş sözlüklerin depolanacağı dizin.
834
- - _Örnek_: `'translations'`
835
-
836
- - **typesDir**:
837
- - _Tür_: `string`
838
- - _Varsayılan_: `'types'`
839
- - _Açıklama_: Sözlük türlerinin saklandığı dizin.
840
- - _Örnek_: `'intlayer-types'`
841
-
842
- - **mainDir**:
843
- - _Tür_: `string`
844
- - _Varsayılan_: `'main'`
845
- - _Açıklama_: Ana uygulama dosyalarının saklandığı dizin.
846
- - _Örnek_: `'intlayer-main'`
847
-
848
- - **excludedPath**:
849
- - _Tür_: `string[]`
850
- - _Varsayılan_: `['node_modules']`
851
- - _Açıklama_: İçerik aramasından hariç tutulan dizinler.
852
- - _Not_: Bu ayar henüz kullanılmamaktadır, ancak gelecekte uygulanması planlanmaktadır.
853
-
854
- ### Sözlük Yapılandırması
855
-
856
- Sözlük işlemlerini kontrol eden ayarlar, otomatik doldurma davranışı ve içerik oluşturma dahil.
857
-
858
- Bu sözlük yapılandırması iki ana amaç için hizmet eder:
859
-
860
- 1. **Varsayılan Değerler**: İçerik bildirimi dosyaları oluştururken varsayılan değerleri tanımlayın
861
- 2. **Yedek Davranış**: Belirli alanlar tanımlanmadığında yedek değerler sağlayın, böylece sözlük işlem davranışını genel olarak tanımlayabilirsiniz
862
-
863
- İçerik bildirimi dosyaları ve yapılandırma değerlerinin nasıl uygulandığı hakkında daha fazla bilgi için, [İçerik Dosyası Dokümantasyonu](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/dictionary/content_file.md) bölümüne bakın.
864
-
865
- #### Özellikler
866
-
867
- - **fill**
868
- - **description**
869
- - **locale**
870
- - **location**
871
- - **importMode**:
872
- - _Not_: **Deprecated**: Use `dictionary.importMode` instead.
873
- - _Tip_: `'static' | 'dynamic' | 'fetch'`
874
- - _Varsayılan_: `'static'`
875
- - _Açıklama_: Controls how dictionaries are imported.
876
- - _Örnek_: `'dynamic'`
877
- - **priority**
878
- - **live**
879
- - **schema**
880
- - **title**
881
- - **tags**
882
- - **version**
883
-
884
- ---
885
-
886
- ### Logger Yapılandırması
887
-
888
- Logger'ı kontrol eden ayarlar, kullanılacak önek dahil.
889
-
890
- #### Özellikler
891
-
892
- - **mode**:
893
- - _Tür_: `string`
894
- - _Varsayılan_: `default`
895
- - _Açıklama_: Logger modunu belirtir.
896
- - _Seçenekler_: `default`, `verbose`, `disabled`
897
- - _Örnek_: `default`
898
- - _Not_: Logger modu. Verbose modu daha fazla bilgi kaydeder, ancak hata ayıklama amaçlı kullanılabilir. Disabled modu logger'ı devre dışı bırakır.
899
-
900
- - **prefix**:
901
- - _Tür_: `string`
902
- - _Varsayılan_: `'[intlayer] '`
903
- - _Açıklama_: Logger'ın öneki.
904
- - _Örnek_: `'[my custom prefix] '`
905
- - _Not_: Günlüğün ön eki.
906
-
907
- ### AI Yapılandırması
908
-
909
- Intlayer'ın AI özelliklerini kontrol eden ayarlar, sağlayıcı, model ve API anahtarı dahil.
910
-
911
- Bu yapılandırma, bir erişim anahtarı kullanarak [Intlayer Kontrol Paneli](https://app.intlayer.org/project) üzerinden kayıtlıysanız isteğe bağlıdır. Intlayer, ihtiyaçlarınız için en verimli ve maliyet-etkin AI çözümünü otomatik olarak yönetecektir. Varsayılan seçenekleri kullanmak, Intlayer'ın en uygun modelleri kullanmak için sürekli güncellenmesi nedeniyle uzun vadeli bakım kolaylığı sağlar.
912
-
913
- Kendi API anahtarınızı veya belirli bir modeli kullanmayı tercih ediyorsanız, özel AI yapılandırmanızı tanımlayabilirsiniz.
914
- Bu AI yapılandırması, Intlayer ortamınız genelinde kullanılacaktır. CLI komutları, bu ayarları komutlar için varsayılan olarak kullanacaktır (örneğin `fill`), ayrıca SDK, Görsel Editör ve CMS de bu ayarları kullanır. Belirli kullanım durumları için bu varsayılan değerleri komut parametreleriyle geçersiz kılabilirsiniz.
915
-
916
- Intlayer, artırılmış esneklik ve seçenek için birden fazla AI sağlayıcısını destekler. Şu anda desteklenen sağlayıcılar şunlardır:
917
-
918
- - **OpenAI** (varsayılan)
919
- - **Anthropic Claude**
920
- - **Mistral AI**
921
- - **DeepSeek**
922
- - **Google Gemini**
923
- - **Meta Llama**
924
- - **Ollama**
925
- - **OpenRouter**
926
- - **Alibaba Cloud**
927
- - **Fireworks**
928
- - **Hugging Face**
929
- - **Groq**
930
- - **Amazon Bedrock**
931
- - **Google AI Studio**
932
- - **Google Vertex**
933
- - **Together.ai**
934
- - **ollama**
935
-
936
- #### Özellikler
937
-
938
- - **provider**:
939
- - _Tür_: `string`
940
- - _Varsayılan_: `'openai'`
941
- - _Açıklama_: Intlayer'ın AI özellikleri için kullanılacak sağlayıcı.
942
- - _Seçenekler_: `'openai'`, `'anthropic'`, `'mistral'`, `'deepseek'`, `'gemini'`, `'ollama'`, `'openrouter'`, `'alibaba'`, `'fireworks'`, `'groq'`, `'huggingface'`, `'bedrock'`, `'googleaistudio'`, `'googlevertex'`, `'togetherai'`
943
- - _Örnek_: `'anthropic'`
944
- - _Not_: Farklı sağlayıcılar farklı API anahtarları gerektirebilir ve farklı fiyatlandırma modellerine sahip olabilir.
945
-
946
- - **model**:
947
- - _Tür_: `string`
948
- - _Varsayılan_: Yok
949
- - _Açıklama_: Intlayer'ın yapay zeka özellikleri için kullanılacak model.
950
- - _Örnek_: `'gpt-4o-2024-11-20'`
951
- - _Not_: Kullanılacak spesifik model sağlayıcıya göre değişir.
952
-
953
- - **temperature**:
954
- - _Tür_: `number`
955
- - _Varsayılan_: Yok
956
- - _Açıklama_: Sıcaklık, yapay zekanın yanıtlarının rastgeleliğini kontrol eder.
957
- - _Örnek_: `0.1`
958
- - _Not_: Daha yüksek bir sıcaklık, yapay zekayı daha yaratıcı ve daha az tahmin edilebilir yapar.
959
-
960
- - **apiKey**:
961
- - _Tür_: `string`
962
- - _Varsayılan_: Yok
963
- - _Açıklama_: Seçilen sağlayıcı için API anahtarınız.
964
- - _Not_: Önemli: API anahtarları gizli tutulmalı ve kamuya açık şekilde paylaşılmamalıdır. Lütfen bunları ortam değişkenleri gibi güvenli bir yerde sakladığınızdan emin olun.
965
-
966
- - **applicationContext**:
967
- - _Tür_: `string`
968
- - _Varsayılan_: Yok
969
- - _Açıklama_: AI modeline uygulamanız hakkında ek bağlam sağlar, böylece daha doğru ve bağlama uygun çeviriler oluşturmasına yardımcı olur. Bu, uygulamanızın alanı, hedef kitlesi, tonu veya belirli terminolojisi hakkında bilgiler içerebilir.
970
-
971
- - **baseURL**:
972
- - _Tür_: `string`
973
- - _Varsayılan_: Yok
974
- - _Açıklama_: AI API için temel URL.
975
- - _Örnek_: `'https://api.openai.com/v1'`
976
- - _Not_: Yerel veya özel bir AI API uç noktasını işaret etmek için kullanılabilir.
977
-
978
- - **dataSerialization**:
979
- - _Tür_: `'json' | 'toon'`
980
- - _Varsayılan_: `'json'`
981
- - _Açıklama_: Intlayer'ın AI özellikleri için kullanılacak veri serileştirme formatı.
982
- - _Örnek_: `'toon'`
983
- - _Not_: `json`: Standart, güvenilir; daha fazla jeton kullanır. `toon`: Daha az jeton, JSON'dan daha az tutarlı.
984
-
985
- ### Derleme Yapılandırması
986
-
987
- Intlayer'ın uygulamanızın uluslararasılaştırmasını nasıl optimize edip derleyeceğini kontrol eden ayarlar.
988
-
989
- Derleme seçenekleri `@intlayer/babel` ve `@intlayer/swc` eklentilerine uygulanır.
990
-
991
- > Geliştirme modunda, Intlayer geliştirme deneyimini basitleştirmek için sözlüklerde statik importlar kullanır.
992
-
993
- > Optimize edildiğinde, Intlayer chunking'i optimize etmek için sözlük çağrılarını değiştirir, böylece nihai paket yalnızca gerçekten kullanılan sözlükleri import eder.
994
-
995
- #### Özellikler
996
-
997
- - **mode**:
998
- - _Tür_: `'auto' | 'manual'`
999
- - _Varsayılan_: `'auto'`
1000
- - _Açıklama_: Derleme modunu kontrol eder.
1001
- - _Örnek_: `'manual'`
1002
- - _Not_: 'auto' ise, uygulama derlendiğinde derleme otomatik olarak etkinleştirilir.
1003
- - _Not_: 'manual' ise, derleme yalnızca derleme komutu çalıştırıldığında ayarlanır.
1004
- - _Not_: Sözlük derlemesini devre dışı bırakmak için kullanılabilir, örneğin Node.js ortamında yürütmeden kaçınılması gerektiğinde.
1005
-
1006
- - **checkTypes**:
1007
- - _Tip_: `boolean`
1008
- - _Varsayılan_: `false`
1009
- - _Açıklama_: Derlemenin TypeScript türlerini kontrol edip etmeyeceğini ve hataları kaydedip kaydetmeyeceğini belirtir.
1010
- - _Not_: Bu, derleme işlemini yavaşlatabilir.
1011
-
1012
- - **optimize**:
1013
- - _Tür_: `boolean`
1014
- - _Varsayılan_: `process.env.NODE_ENV === 'production'`
1015
- - _Açıklama_: Derlemenin optimize edilip edilmeyeceğini kontrol eder.
1016
- - _Örnek_: `true`
1017
- - _Not_: Etkinleştirildiğinde, Intlayer chunking'i optimize etmek için tüm sözlük çağrılarını değiştirir. Böylece nihai paket yalnızca kullanılan sözlükleri import eder. Tüm importlar, sözlüklerin yüklenmesi sırasında asenkron işlemi önlemek için statik import olarak kalır.
1018
- - _Not_: Intlayer, `useIntlayer` çağrılarının tümünü `importMode` seçeneği ile tanımlanan moda ve `getIntlayer` çağrılarını `getDictionary` ile değiştirir.
1019
- - _Not_: Bu seçenek `@intlayer/babel` ve `@intlayer/swc` eklentilerine dayanır.
1020
- - _Not_: `useIntlayer` çağrılarında tüm anahtarların statik olarak tanımlandığından emin olun. Örneğin `useIntlayer('navbar')`.
1021
-
1022
- - **outputFormat**:
1023
- - _Tür_: `'esm' | 'cjs'`
1024
- - _Varsayılan_: `'esm'`
1025
- - _Açıklama_: Sözlüklerin çıktı biçimini kontrol eder.
1026
- - _Örnek_: `'cjs'`
1027
- - _Not_: Sözlüklerin çıktı biçimi.
1028
-
1029
- - **traversePattern**:
1030
- - _Tür_: `string[]`
1031
- - _Varsayılan_: `['**\/*.{js,ts,mjs,cjs,jsx,tsx}', '!**\/node_modules/**']`
1032
- - _Açıklama_: Optimizasyon sırasında hangi dosyaların taranacağını tanımlayan desenler.
1033
- - _Örnek_: `['src/**\/*.{ts,tsx}', '../ui-library/**\/*.{ts,tsx}', '!**/node_modules/**']`
1034
- - _Not_: Optimizasyonu ilgili kod dosyalarıyla sınırlamak ve derleme performansını artırmak için bunu kullanın.
1035
- - _Not_: Bu seçenek `optimize` devre dışı bırakılırsa dikkate alınmaz.
1036
- - _Not_: Glob deseni kullanın.
1037
-
1038
- ---
1039
-
1040
- ### Derleyici Yapılandırması
1041
-
1042
- Sözlükleri doğrudan bileşenlerinizden çıkaran Intlayer derleyicisini kontrol eden ayarlar.
1043
-
1044
- #### Özellikler
1045
-
1046
- - **enabled**:
1047
- - _Tür_: `boolean | 'build-only'`
1048
- - _Varsayılan_: `true`
1049
- - _Açıklama_: Sözlükleri çıkarmak için derleyicinin etkinleştirilip etkinleştirilmeyeceğini belirtir.
1050
- - _Örnek_: `'build-only'`
1051
- - _Not_: `'build-only'` olarak ayarlanması, derleme sürelerini hızlandırmak için geliştirme modu sırasında derleyiciyi atlayacaktır. Yalnızca derleme komutlarında çalışacaktır.
1052
-
1053
- - **dictionaryKeyPrefix**:
1054
- - _Tür_: `string`
1055
- - _Varsayılan_: `''`
1056
- - _Açıklama_: Çıkarılan sözlük anahtarları için önek.
1057
- - _Örnek_: `'my-key-'`
1058
- - _Not_: Sözlükler çıkarıldığında, anahtar dosya adına göre oluşturulur. Bu önek, çakışmaları önlemek için oluşturulan anahtara eklenir.
1059
-
1060
- - **saveComponents**:
1061
- - _Tür_: `boolean`
1062
- - _Varsayılan_: `false`
1063
- - _Açıklama_: Bileşenlerin dönüştürüldükten sonra kaydedilip kaydedilmeyeceğini belirtir.
1064
- - _Not_: Doğruysa, derleyici orijinal dosyaları dönüştürülmüş dosyalarla değiştirecektir. Bu şekilde, derleyici uygulamayı dönüştürmek için yalnızca bir kez çalıştırılabilir ve ardından kaldırılabilir.
1065
-
1066
- - **transformPattern**:
1067
- - _Tür_: `string | string[]`
1068
- - _Varsayılan_: `['**/*.{ts,tsx,jsx,js,cjs,mjs,svelte,vue}', '!**/node_modules/**']`
1069
- - _Açıklama_: Optimizasyon sırasında hangi dosyaların taranacağını tanımlayan desenler.
1070
- - _Örnek_: `['src/**/*.{ts,tsx}', '!**/node_modules/**']`
1071
- - _Not_: Optimizasyonu ilgili kod dosyalarıyla sınırlamak ve derleme performansını artırmak için bunu kullanın.
1072
-
1073
- - **excludePattern**:
1074
- - _Tür_: `string | string[]`
1075
- - _Varsayılan_: `['**/node_modules/**']`
1076
- - _Açıklama_: Optimizasyon sırasında hangi dosyaların hariç tutulacağını tanımlayan desenler.
1077
- - _Örnek_: `['**/node_modules/**', '!**/node_modules/react/**']`
1078
-
1079
- - **output**:
1080
- - _Tür_: `FilePathPattern`
1081
- - _Varsayılan_: `undefined`
1082
- - _Açıklama_: Çıktı dosyalarının yolunu tanımlar. `outputDir` yerine geçer. Şablon dizeleri veya bir fonksiyon aracılığıyla dinamik değişkenleri işler. Desteklenen değişkenler: `{{fileName}}`, `{{key}}`, `{{locale}}`, `{{extension}}`, `{{componentFileName}}`, `{{componentExtension}}`, `{{format}}`, `{{componentFormat}}` ve `{{componentDirPath}}`.
1083
- - _Not_: `./` ile başlayan yollar bileşen dizinine göre çözümlenir. `/` ile başlayan yollar projenin kök dizinine (`baseDir`) göre çözümlenir.
1084
- - _Not_: Yola `{{locale}}` değişkenini dahil etmek, dile göre ayrılmış sözlüklerin oluşturulmasını etkinleştirir.
1085
- - _Örnek_:
1086
- - **Bileşenin yanında çok dilli dosyalar oluşturun**:
1087
- - Dize: `'./{{fileName}}{{extension}}'`
1088
- - Fonksiyon: `({ fileName, extension }) => \`./${fileName}${extension}\``
1089
-
1090
- - **Dil başına merkezi JSON dosyaları çıktılayın**:
1091
- - Dize: `'/locales/{{locale}}/{{key}}.content.json'`
1092
- - Fonksiyon: `({ key, locale }) => \`/locales/${locale}/${key}.content.json\``
1093
-
1094
- - **noMetadata**:
1095
- - _Tür_: `boolean`
1096
- - _Varsayılan_: `false`
1097
- - _Açıklama_: Meta verilerin dosyaya kaydedilip kaydedilmeyeceğini belirtir. Doğruysa, derleyici sözlüklerin meta verilerini (anahtar, içerik sarmalayıcı) kaydetmez. Dil başına i18next veya ICU MessageFormat JSON çıktıları için kullanışlıdır.
1098
- - _Not_: `loadJSON` eklentisi ile kullanıldığında kullanışlıdır.
1099
- - _Örnek_:
1100
- Eğer `true` ise :
1101
- ```json
1102
- {
1103
- "key": "value"
1104
- }
1105
- ```
1106
- Eğer `false` ise :
1107
- ```json
1108
- {
1109
- "key": "value",
1110
- "content": {
1111
- "key": "value"
1112
- }
1113
- }
1114
- ```