@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,1118 +0,0 @@
1
- ---
2
- createdAt: 2024-08-13
3
- updatedAt: 2026-03-12
4
- title: कॉन्फ़िगरेशन
5
- description: अपने एप्लिकेशन के लिए Intlayer को कॉन्फ़िगर करना सीखें। Intlayer को अपनी आवश्यकताओं के अनुसार अनुकूलित करने के लिए विभिन्न सेटिंग्स और विकल्पों को समझें।
6
- keywords:
7
- - कॉन्फ़िगरेशन
8
- - सेटिंग्स
9
- - अनुकूलन
10
- - Intlayer
11
- - विकल्प
12
- slugs:
13
- - doc
14
- - concept
15
- - configuration
16
- history:
17
- - version: 8.3.0
18
- date: 2026-03-11
19
- changes: "'baseDir' को 'content' से 'system' कॉन्फिग में ले जाया गया"
20
- - version: 8.2.0
21
- date: 2026-03-09
22
- changes: कंपाइलर विकल्पों को अपडेट करें, 'output' और 'noMetadata' समर्थन जोड़ें
23
- - version: 8.1.7
24
- date: 2026-02-25
25
- changes: कंपाइलर विकल्पों को अपडेट करें
26
- - version: 8.0.6
27
- date: 2026-02-12
28
- changes: Open Router, Alibaba, Amazon, Google Vertex Bedrock, Fireworks, Groq, Hugging Face, और Together.ai प्रदाताओं के लिए समर्थन जोड़ें
29
- - version: 8.0.5
30
- date: 2026-02-06
31
- changes: AI कॉन्फ़िगरेशन में `dataSerialization` जोड़ें
32
- - version: 8.0.0
33
- date: 2026-01-22
34
- changes: आयात मोड निर्माण कॉन्फ़िगरेशन को शब्दकोश कॉन्फ़िगरेशन में ले जाएं।
35
- - version: 8.0.0
36
- date: 2026-01-18
37
- changes: सिस्टम कॉन्फ़िगरेशन को सामग्री कॉन्फ़िगरेशन से अलग करें। आंतरिक पथों को `system` गुण में ले जाएं। सामग्री फ़ाइलों को कोड परिवर्तन से अलग करने के लिए `codeDir` जोड़ें।
38
- - version: 8.0.0
39
- date: 2026-01-18
40
- changes: शब्दकोश विकल्प `location` और `schema` जोड़ें
41
- - version: 7.5.1
42
- date: 2026-01-10
43
- changes: JSON5 और JSONC फ़ाइल प्रारूपों के लिए समर्थन जोड़ा
44
- - version: 7.5.0
45
- date: 2025-12-17
46
- changes: "`buildMode` विकल्प जोड़ा"
47
- - version: 6.0.0
48
- date: 2025-09-16
49
- changes: "`live` आयात मोड जोड़ा"
50
- - version: 6.0.0
51
- date: 2025-09-04
52
- changes: "`hotReload` फ़ील्ड को `liveSync` से बदलें और `liveSyncPort` और `liveSyncURL` फ़ील्ड जोड़ें"
53
- - version: 5.6.1
54
- date: 2025-07-25
55
- changes: "`activateDynamicImport` को `importMode` विकल्प से बदलें"
56
- - version: 5.6.0
57
- date: 2025-07-13
58
- changes: डिफ़ॉल्ट contentDir को `['src']` से बदलकर `['.']` करें
59
- - version: 5.5.11
60
- date: 2025-06-29
61
- changes: "`docs` कमांड जोड़ें"
62
- ---
63
-
64
- # Intlayer कॉन्फ़िगरेशन दस्तावेज़ीकरण
65
-
66
- ## अवलोकन
67
-
68
- Intlayer कॉन्फ़िगरेशन फ़ाइलें प्लगइन के विभिन्न पहलुओं को अनुकूलित करने की अनुमति देती हैं, जैसे कि अंतर्राष्ट्रीयकरण, मिडलवेयर, और सामग्री प्रबंधन। यह दस्तावेज़ कॉन्फ़िगरेशन में प्रत्येक गुण का विस्तृत विवरण प्रदान करता है।
69
-
70
- ---
71
-
72
- ## विषयसूची
73
-
74
- <TOC/>
75
-
76
- ---
77
-
78
- ## कॉन्फ़िगरेशन फ़ाइल समर्थन
79
-
80
- Intlayer JSON, JS, MJS, और TS कॉन्फ़िगरेशन फ़ाइल स्वरूप स्वीकार करता है:
81
-
82
- - `intlayer.config.ts`
83
- - `intlayer.config.js`
84
- - `intlayer.config.json`
85
- - `intlayer.config.json5`
86
- - `intlayer.config.jsonc`
87
- - `intlayer.config.cjs`
88
- - `intlayer.config.mjs`
89
- - `.intlayerrc`
90
-
91
- ---
92
-
93
- ## उदाहरण कॉन्फ़िगरेशन फ़ाइल
94
-
95
- ````typescript fileName="intlayer.config.ts" codeFormat="typescript"
96
- import { Locales, type IntlayerConfig } from "intlayer";
97
- import { nextjsRewrite } from "intlayer/routing";
98
- import { z } from "zod";
99
-
100
- /**
101
- * Example Intlayer configuration file showing all available options.
102
- */
103
- const config: IntlayerConfig = {
104
- /**
105
- * Configuration for internationalization settings.
106
- */
107
- internationalization: {
108
- /**
109
- * List of supported locales in the application.
110
- * Default: [Locales.ENGLISH]
111
- */
112
- locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],
113
-
114
- /**
115
- * List of required locales that must be defined in every dictionary.
116
- * If empty, all locales are required in `strict` mode.
117
- * Default: []
118
- */
119
- requiredLocales: [Locales.ENGLISH],
120
-
121
- /**
122
- * Strictness level for internationalized content.
123
- * - "strict": Errors if any declared locale is missing or undeclared.
124
- * - "inclusive": Warnings if a declared locale is missing.
125
- * - "loose": Accepts any existing locale.
126
- * Default: "inclusive"
127
- */
128
- strictMode: "inclusive",
129
-
130
- /**
131
- * Default locale used as a fallback if the requested locale is not found.
132
- * Default: Locales.ENGLISH
133
- */
134
- defaultLocale: Locales.ENGLISH,
135
- },
136
-
137
- /**
138
- * Settings that control dictionary operations and fallback behavior.
139
- */
140
- dictionary: {
141
- /**
142
- * Controls how dictionaries are imported.
143
- * - "static": Statically imported at build time.
144
- * - "dynamic": Dynamically imported using Suspense.
145
- * - "fetch": Fetched dynamically via the live sync API.
146
- * Default: "static"
147
- */
148
- importMode: "static",
149
-
150
- /**
151
- * Strategy for auto-filling missing translations using AI.
152
- * Can be a boolean or a path pattern to store filled content.
153
- * Default: true
154
- */
155
- fill: true,
156
-
157
- /**
158
- * Physical location of the dictionary files.
159
- * - "local": Stored in the local filesystem.
160
- * - "remote": Stored in the Intlayer CMS.
161
- * - "hybrid": Stored in the local filesystem and the Intlayer CMS.
162
- * - "plugin" (or any custom string): Provided by a plugin or a custom source.
163
- * Default: "local"
164
- */
165
- location: "local",
166
-
167
- /**
168
- * Whether to automatically transform content (e.g., Markdown to HTML).
169
- * Default: false
170
- */
171
- contentAutoTransformation: false,
172
- },
173
-
174
- /**
175
- * Routing and middleware configuration.
176
- */
177
- routing: {
178
- /**
179
- * Locale routing strategy.
180
- * - "prefix-no-default": Prefix all except the default locale (e.g., /dashboard, /fr/dashboard).
181
- * - "prefix-all": Prefix all locales (e.g., /en/dashboard, /fr/dashboard).
182
- * - "no-prefix": No locale in the URL.
183
- * - "search-params": Use ?locale=...
184
- * Default: "prefix-no-default"
185
- */
186
- mode: "prefix-no-default",
187
-
188
- /**
189
- * Where to store the user's selected locale.
190
- * Options: 'cookie', 'localStorage', 'sessionStorage', 'header', or an array of these.
191
- * Default: ['cookie', 'header']
192
- */
193
- storage: ["cookie", "header"],
194
-
195
- /**
196
- * Base path for the application URLs.
197
- * Default: ""
198
- */
199
- basePath: "",
200
-
201
- /**
202
- * Custom URL rewriting rules for locale-specific paths.
203
- */
204
- rewrite: nextjsRewrite({
205
- "/[locale]/about": {
206
- en: "/[locale]/about",
207
- fr: "/[locale]/a-propos",
208
- },
209
- }),
210
- },
211
-
212
- /**
213
- * Settings for finding and processing content files.
214
- */
215
- content: {
216
- /**
217
- * File extensions to scan for dictionaries.
218
- * Default: ['.content.ts', '.content.js', '.content.json', etc.]
219
- */
220
- fileExtensions: [".content.ts", ".content.js", ".content.json"],
221
-
222
- /**
223
- * Directories where .content files are located.
224
- * Default: ["."]
225
- */
226
- contentDir: ["src"],
227
-
228
- /**
229
- * Directories where source code is located.
230
- * Used for build optimization and code transformation.
231
- * Default: ["."]
232
- */
233
- codeDir: ["src"],
234
-
235
- /**
236
- * Patterns to exclude from scanning.
237
- * Default: ['node_modules', '.intlayer', etc.]
238
- */
239
- excludedPath: ["node_modules"],
240
-
241
- /**
242
- * Whether to watch for changes and rebuild dictionaries in development.
243
- * Default: true in development
244
- */
245
- watch: true,
246
-
247
- /**
248
- * Command to format newly created / updated .content files.
249
- */
250
- formatCommand: 'npx prettier --write "{{file}}"',
251
- },
252
-
253
- /**
254
- * Visual Editor configuration.
255
- */
256
- editor: {
257
- /**
258
- * Whether the visual editor is enabled.
259
- * Default: false
260
- */
261
- enabled: true,
262
-
263
- /**
264
- * URL of your application for origin validation.
265
- * Default: ""
266
- */
267
- applicationURL: "http://localhost:3000",
268
-
269
- /**
270
- * Port for the local editor server.
271
- * Default: 8000
272
- */
273
- port: 8000,
274
-
275
- /**
276
- * Public URL for the editor.
277
- * Default: "http://localhost:8000"
278
- */
279
- editorURL: "http://localhost:8000",
280
-
281
- /**
282
- * Intlayer CMS URL.
283
- * Default: "https://app.intlayer.org"
284
- */
285
- cmsURL: "https://app.intlayer.org",
286
-
287
- /**
288
- * Backend API URL.
289
- * Default: "https://back.intlayer.org"
290
- */
291
- backendURL: "https://back.intlayer.org",
292
-
293
- /**
294
- * Whether to enable real-time content synchronization.
295
- * Default: false
296
- */
297
- liveSync: true,
298
- },
299
-
300
- /**
301
- * AI-powered translation and generation settings.
302
- */
303
- ai: {
304
- /**
305
- * AI provider to use.
306
- * Options: 'openai', 'anthropic', 'mistral', 'deepseek', 'gemini', 'ollama', 'openrouter', 'alibaba', 'fireworks', 'groq', 'huggingface', 'bedrock', 'googlevertex', 'togetherai'
307
- * Default: 'openai'
308
- */
309
- provider: "openai",
310
-
311
- /**
312
- * Model to use from the selected provider.
313
- */
314
- model: "gpt-4o",
315
-
316
- /**
317
- * Provider API key.
318
- */
319
- apiKey: process.env.OPENAI_API_KEY,
320
-
321
- /**
322
- * Global context to guide the AI in generating translations.
323
- */
324
- applicationContext: "This is a travel booking application.",
325
-
326
- /**
327
- * Base URL for the AI API.
328
- */
329
- baseURL: "http://localhost:3000",
330
-
331
- /**
332
- * डेटा क्रमांकन (सीरियलाइजेशन)
333
- *
334
- * विकल्प:
335
- * - "json": मानक, विश्वसनीय; अधिक टोकन का उपयोग करता है।
336
- * - "toon": कम टोकन, JSON की तुलना में कम सुसंगत।
337
- *
338
- * डिफ़ॉल्ट: "json"
339
- */
340
- dataSerialization: "json",
341
- },
342
-
343
- /**
344
- * Build and optimization settings.
345
- */
346
- build: {
347
- /**
348
- * Build execution mode.
349
- * - "auto": Automatic build during app build.
350
- * - "manual": Requires explicit build command.
351
- * Default: "auto"
352
- */
353
- mode: "auto",
354
-
355
- /**
356
- * Whether to optimize the final bundle by pruning unused dictionaries.
357
- * Default: true in production
358
- */
359
- optimize: true,
360
-
361
- /**
362
- * Output format for generated dictionary files.
363
- * Default: ['esm', 'cjs']
364
- */
365
- outputFormat: ["esm"],
366
-
367
- /**
368
- * Indicates if the build should check TypeScript types.
369
- * Default: false
370
- */
371
- checkTypes: false,
372
- },
373
-
374
- /**
375
- * Logger configuration.
376
- */
377
- log: {
378
- /**
379
- * Logging level.
380
- * - "default": Standard logging.
381
- * - "verbose": Detailed debug logging.
382
- * - "disabled": No logging.
383
- * Default: "default"
384
- */
385
- mode: "default",
386
-
387
- /**
388
- * Prefix for all log messages.
389
- * Default: "[intlayer]"
390
- */
391
- prefix: "[intlayer]",
392
- },
393
-
394
- /**
395
- * System configuration (Advanced use cases)
396
- */
397
- system: {
398
- /**
399
- * Directory for storing localization dictionaries.
400
- */
401
- dictionariesDir: ".intlayer/dictionary",
402
-
403
- /**
404
- * Directory for module augmentation.
405
- */
406
- moduleAugmentationDir: ".intlayer/types",
407
-
408
- /**
409
- * Directory for storing unmerged dictionaries.
410
- */
411
- unmergedDictionariesDir: ".intlayer/unmerged_dictionary",
412
-
413
- /**
414
- * Directory for storing dictionary types.
415
- */
416
- typesDir: ".intlayer/types",
417
-
418
- /**
419
- * Directory where main application files are stored.
420
- */
421
- mainDir: ".intlayer/main",
422
-
423
- /**
424
- * Directory where the configuration files are stored.
425
- */
426
- configDir: ".intlayer/config",
427
-
428
- /**
429
- * Directory where the cache files are stored.
430
- */
431
- cacheDir: ".intlayer/cache",
432
- },
433
-
434
- /**
435
- * Compiler configuration (Advanced use cases)
436
- */
437
- compiler: {
438
- /**
439
- * इंगित करता है कि क्या कंपाइलर सक्षम होना चाहिए।
440
- *
441
- * - false : कंपाइलर को अक्षम करता है।
442
- * - true : कंपाइलर को सक्षम करता है।
443
- * - "build-only" : स्टार्टअप समय को तेज करने के लिए विकास के दौरान कंपाइलर को छोड़ देता है।
444
- *
445
- * डिफ़ॉल्ट मान : false
446
- */
447
- enabled: true,
448
-
449
- /**
450
- * आउटपुट फ़ाइल पथ को परिभाषित करता है। `outputDir` को प्रतिस्थापित करता है।
451
- *
452
- * - `./` पथ घटक निर्देशिका के सापेक्ष हल किए जाते हैं।
453
- * - `/` पथ प्रोजेक्ट रूट (`baseDir`) के सापेक्ष हल किए जाते हैं।
454
- *
455
- * - पथ में `{{locale}}` चर डालने से भाषा द्वारा अलग किए गए शब्दकोश निर्माण सक्षम हो जाएंगे।
456
- *
457
- * उदाहरण:
458
- * ```ts
459
- * {
460
- * // घटक के बगल में बहुभाषी .content.ts फ़ाइलें बनाएँ
461
- * output: ({ fileName, extension }) => `./${fileName}${extension}`,
462
- *
463
- * // output: './{{fileName}}{{extension}}', // स्ट्रिंग टेम्प्लेट का उपयोग करके समकक्ष
464
- * }
465
- * ```
466
- *
467
- * ```ts
468
- * {
469
- * // प्रोजेक्ट रूट पर भाषा द्वारा केंद्रीकृत JSON फ़ाइलें बनाएँ
470
- * output: ({ key, locale }) => `/locales/${locale}/${key}.content.json`,
471
- *
472
- * // output: '/locales/{{locale}}/{{key}}.content.json', // स्ट्रिंग टेम्प्लेट का उपयोग करके समकक्ष
473
- * }
474
- * ```
475
- *
476
- * चर सूची:
477
- * - `fileName`: फ़ाइल का नाम।
478
- * - `key`: सामग्री की कुंजी।
479
- * - `locale`: सामग्री का स्थानीय मान (लोकल)।
480
- * - `extension`: फ़ाइल एक्सटेंशन।
481
- * - `componentFileName`: घटक फ़ाइल का नाम।
482
- * - `componentExtension`: घटक फ़ाइल एक्सटेंशन।
483
- * - `format`: शब्दकोश प्रारूप।
484
- * - `componentFormat`: घटक शब्दकोश प्रारूप।
485
- * - `componentDirPath`: घटक निर्देशिका पथ।
486
- */
487
- output: ({ locale, key }) => `compiler/${locale}/${key}.json`,
488
-
489
- /**
490
- * इंगित करता है कि क्या घटकों को रूपांतरित होने के बाद सहेजा जाना चाहिए।
491
- * इस तरह, कंपाइलer को ऐप को रूपांतरित करने के लिए केवल एक बार चलाया जा सकता है, और फिर इसे हटाया जा सकता है।
492
- */
493
- saveComponents: false,
494
-
495
- /**
496
- * उत्पन्न फ़ाइल में केवल सामग्री डालें। प्रति-लोकल i18next या ICU MessageFormat JSON आउटपुट के लिए उपयोगी।
497
- */
498
- noMetadata: false,
499
-
500
- /**
501
- * शब्दकोश कुंजी उपसर्ग
502
- */
503
- dictionaryKeyPrefix: "", // निकाली गई शब्दकोश कुंजियों के लिए वैकल्पिक उपसर्ग जोड़ें
504
- },
505
-
506
- /**
507
- * Custom schemas to validate the dictionaries content.
508
- */
509
- schemas: {
510
- "my-schema": z.object({
511
- title: z.string(),
512
- }),
513
- },
514
-
515
- /**
516
- * Plugins configuration.
517
- */
518
- plugins: [],
519
- };
520
-
521
- export default config;
522
- ````
523
-
524
- ## कॉन्फ़िगरेशन संदर्भ
525
-
526
- निम्नलिखित अनुभाग Intlayer के लिए उपलब्ध विभिन्न कॉन्फ़िगरेशन सेटिंग्स का वर्णन करते हैं।
527
-
528
- ---
529
-
530
- ### अंतरराष्ट्रीयकरण कॉन्फ़िगरेशन
531
-
532
- अंतरराष्ट्रीयकरण से संबंधित सेटिंग्स को परिभाषित करता है, जिसमें उपलब्ध भाषाएँ और एप्लिकेशन के लिए डिफ़ॉल्ट भाषा शामिल हैं।
533
-
534
- #### गुण
535
-
536
- - **locales**:
537
- - _प्रकार_: `string[]`
538
- - _डिफ़ॉल्ट_: `['en']`
539
- - _विवरण_: एप्लिकेशन में समर्थित भाषाओं की सूची।
540
- - _उदाहरण_: `['en', 'fr', 'es']`
541
-
542
- - **requiredLocales**:
543
- - _प्रकार_: `string[]`
544
- - _डिफ़ॉल्ट_: `[]`
545
- - _विवरण_: एप्लिकेशन में आवश्यक भाषाओं की सूची।
546
- - _उदाहरण_: `[]`
547
- - _नोट_: यदि खाली है, तो `strict` मोड में सभी लोकल्स आवश्यक हैं।
548
- - _नोट_: सुनिश्चित करें कि आवश्यक लोकल्स `locales` फ़ील्ड में भी परिभाषित हैं।
549
- - **strictMode**:
550
- - _प्रकार_: `string`
551
- - _डिफ़ॉल्ट_: `inclusive`
552
- - _विवरण_: टाइपस्क्रिप्ट का उपयोग करके अंतरराष्ट्रीयकृत सामग्री के मजबूत कार्यान्वयन सुनिश्चित करें।
553
- - _नोट_: यदि इसे "strict" पर सेट किया गया है, तो अनुवाद `t` फ़ंक्शन प्रत्येक घोषित लोकल को परिभाषित करने की आवश्यकता होगी। यदि कोई लोकल गायब है, या यदि कोई लोकल आपकी कॉन्फ़िग में घोषित नहीं है, तो यह एक त्रुटि फेंकेगा।
554
- - _नोट_: यदि इसे "inclusive" पर सेट किया गया है, तो अनुवाद `t` फ़ंक्शन प्रत्येक घोषित लोकल को परिभाषित करने की आवश्यकता होगी। यदि कोई लोकल गायब है, तो यह एक चेतावनी देगा। लेकिन यदि कोई लोकल आपकी कॉन्फ़िग में घोषित नहीं है, लेकिन मौजूद है, तो इसे स्वीकार करेगा।
555
- - _नोट_: यदि इसे "loose" पर सेट किया गया है, तो अनुवाद `t` फ़ंक्शन किसी भी मौजूदा लोकल को स्वीकार करेगा।
556
-
557
- - **defaultLocale**:
558
- - _प्रकार_: `string`
559
- - _डिफ़ॉल्ट_: `'en'`
560
- - _विवरण_: डिफ़ॉल्ट लोकल जो एक फॉलबैक के रूप में उपयोग किया जाता है यदि अनुरोधित लोकल नहीं मिलता है।
561
- - _उदाहरण_: `'en'`
562
- - _नोट_: इसका उपयोग उस लोकल को निर्धारित करने के लिए किया जाता है जब URL, कुकी, या हेडर में कोई लोकल निर्दिष्ट नहीं होता है।
563
-
564
- ---
565
-
566
- ### संपादक विन्यास
567
-
568
- एकीकृत संपादक से संबंधित सेटिंग्स को परिभाषित करता है, जिसमें सर्वर पोर्ट और सक्रिय स्थिति शामिल हैं।
569
-
570
- #### गुण
571
-
572
- - **applicationURL**:
573
- - _प्रकार_: `string`
574
- - _डिफ़ॉल्ट_: `http://localhost:3000`
575
- - _विवरण_: एप्लिकेशन का URL। सुरक्षा कारणों से संपादक की उत्पत्ति को सीमित करने के लिए उपयोग किया जाता है।
576
- - _उदाहरण_:
577
- - `'http://localhost:3000'`
578
- - `'https://example.com'`
579
- - `process.env.INTLAYER_EDITOR_URL`
580
- - _नोट_: एप्लिकेशन का URL। सुरक्षा कारणों से संपादक के मूल को प्रतिबंधित करने के लिए उपयोग किया जाता है। यदि इसे `'*'` पर सेट किया गया है, तो संपादक किसी भी मूल से सुलभ होगा।
581
-
582
- - **port**:
583
- - _प्रकार_: `number`
584
- - _डिफ़ॉल्ट_: `8000`
585
- - _विवरण_: विज़ुअल संपादक सर्वर द्वारा उपयोग किया जाने वाला पोर्ट।
586
-
587
- - **editorURL**:
588
- - _प्रकार_: `string`
589
- - _डिफ़ॉल्ट_: `'http://localhost:8000'`
590
- - _विवरण_: संपादक सर्वर का URL। सुरक्षा कारणों से संपादक के मूल को प्रतिबंधित करने के लिए उपयोग किया जाता है।
591
- - `'http://localhost:3000'`
592
- - `'https://example.com'`
593
- - `process.env.INTLAYER_EDITOR_URL`
594
- - _नोट_: एप्लिकेशन से पहुँचने के लिए एडिटर सर्वर का URL। सुरक्षा कारणों से उन मूलों को प्रतिबंधित करने के लिए उपयोग किया जाता है जो एप्लिकेशन के साथ इंटरैक्ट कर सकते हैं। यदि इसे `'*'` पर सेट किया गया है, तो एडिटर किसी भी मूल से सुलभ होगा। यदि पोर्ट बदला गया है, या यदि एडिटर किसी अलग डोमेन पर होस्ट किया गया है, तो इसे सेट किया जाना चाहिए।
595
-
596
- - **cmsURL**:
597
- - _प्रकार_: `string`
598
- - _डिफ़ॉल्ट_: `'https://intlayer.org'`
599
- - _विवरण_: Intlayer CMS का URL।
600
- - _उदाहरण_: `'https://intlayer.org'`
601
- - _नोट_: Intlayer CMS का URL।
602
-
603
- - **backendURL**:
604
- - _प्रकार_: `string`
605
- - _डिफ़ॉल्ट_: `https://back.intlayer.org`
606
- - _विवरण_: बैकएंड सर्वर का URL।
607
- - _उदाहरण_: `http://localhost:4000`
608
-
609
- - **enabled**:
610
- - _प्रकार_: `boolean`
611
- - _डिफ़ॉल्ट_: `true`
612
- - _विवरण_: यह दर्शाता है कि क्या एप्लिकेशन विज़ुअल एडिटर के साथ इंटरैक्ट करता है।
613
- - _उदाहरण_: `process.env.NODE_ENV !== 'production'`
614
- - _नोट_: यदि true है, तो एडिटर एप्लिकेशन के साथ इंटरैक्ट कर सकेगा। यदि false है, तो एडिटर एप्लिकेशन के साथ इंटरैक्ट नहीं कर सकेगा। किसी भी स्थिति में, एडिटर केवल विज़ुअल एडिटर द्वारा सक्षम किया जा सकता है। विशिष्ट वातावरणों के लिए एडिटर को अक्षम करना सुरक्षा लागू करने का एक तरीका है।
615
-
616
- - **clientId**:
617
- - _प्रकार_: `string` | `undefined`
618
- - _डिफ़ॉल्ट_: `undefined`
619
- - _विवरण_: clientId और clientSecret intlayer पैकेजों को oAuth2 प्रमाणीकरण का उपयोग करके बैकएंड के साथ प्रमाणीकरण करने की अनुमति देते हैं। एक एक्सेस टोकन का उपयोग परियोजना से संबंधित उपयोगकर्ता को प्रमाणित करने के लिए किया जाता है। एक्सेस टोकन प्राप्त करने के लिए, https://app.intlayer.org/project पर जाएं और एक खाता बनाएं।
620
- - _उदाहरण_: `true`
621
- - _नोट_: महत्वपूर्ण: clientId और clientSecret को गोपनीय रखा जाना चाहिए और सार्वजनिक रूप से साझा नहीं किया जाना चाहिए। कृपया इन्हें सुरक्षित स्थान पर रखें, जैसे कि पर्यावरण चर (environment variables) में।
622
-
623
- - **clientSecret**:
624
- - _प्रकार_: `string` | `undefined`
625
- - _डिफ़ॉल्ट_: `undefined`
626
- - _विवरण_: clientId और clientSecret intlayer पैकेजों को oAuth2 प्रमाणीकरण का उपयोग करके बैकएंड के साथ प्रमाणीकरण करने की अनुमति देते हैं। एक एक्सेस टोकन का उपयोग परियोजना से संबंधित उपयोगकर्ता को प्रमाणित करने के लिए किया जाता है। एक्सेस टोकन प्राप्त करने के लिए, https://app.intlayer.org/project पर जाएं और एक खाता बनाएं।
627
- - _उदाहरण_: `true`
628
- - _नोट_: महत्वपूर्ण: clientId और clientSecret को गोपनीय रखा जाना चाहिए और सार्वजनिक रूप से साझा नहीं किया जाना चाहिए। कृपया इन्हें सुरक्षित स्थान पर रखें, जैसे कि पर्यावरण चर।
629
-
630
- - **dictionaryPriorityStrategy**:
631
- - _प्रकार_: `string`
632
- - _डिफ़ॉल्ट_: `'local_first'`
633
- - _विवरण_: जब स्थानीय और दूरस्थ दोनों शब्दकोश मौजूद हों, तो शब्दकोशों को प्राथमिकता देने की रणनीति। यदि इसे `'distant_first'` पर सेट किया गया है, तो एप्लिकेशन दूरस्थ शब्दकोशों को स्थानीय शब्दकोशों पर प्राथमिकता देगा। यदि इसे `'local_first'` पर सेट किया गया है, तो एप्लिकेशन स्थानीय शब्दकोशों को दूरस्थ शब्दकोशों पर प्राथमिकता देगा।
634
- - _उदाहरण_: `'distant_first'`
635
-
636
- - **liveSync**:
637
- - _प्रकार_: `boolean`
638
- - _डिफ़ॉल्ट_: `false`
639
- - _विवरण_: यह संकेत करता है कि जब CMS / विज़ुअल एडिटर / बैकएंड में कोई परिवर्तन होता है, तो एप्लिकेशन सर्वर को एप्लिकेशन की सामग्री को हॉट रीलोड करना चाहिए या नहीं।
640
- - _उदाहरण_: `true`
641
- - _नोट_: उदाहरण के लिए, जब कोई नया शब्दकोश जोड़ा या अपडेट किया जाता है, तो एप्लिकेशन पृष्ठ में दिखाने के लिए सामग्री को अपडेट करेगा।
642
- - _नोट_: लाइव सिंक को एप्लिकेशन की सामग्री को किसी अन्य सर्वर पर बाहरीकरण करने की आवश्यकता होती है। इसका मतलब है कि यह एप्लिकेशन के प्रदर्शन को थोड़ा प्रभावित कर सकता है। इसे सीमित करने के लिए, हम सुझाव देते हैं कि एप्लिकेशन और लाइव सिंक सर्वर को एक ही मशीन पर होस्ट किया जाए। साथ ही, लाइव सिंक और `optimize` के संयोजन से लाइव सिंक सर्वर पर कई अनुरोध भेजे जा सकते हैं। आपकी इन्फ्रास्ट्रक्चर के आधार पर, हम दोनों विकल्पों और उनके संयोजन का परीक्षण करने की सलाह देते हैं।
643
-
644
- - **liveSyncPort**:
645
- - _प्रकार_: `number`
646
- - _डिफ़ॉल्ट_: `4000`
647
- - _विवरण_: लाइव सिंक सर्वर का पोर्ट।
648
- - _उदाहरण_: `4000`
649
- - _नोट_: लाइव सिंक सर्वर का पोर्ट।
650
-
651
- - **liveSyncURL**:
652
- - _प्रकार_: `string`
653
- - _डिफ़ॉल्ट_: `'http://localhost:{liveSyncPort}'`
654
- - _विवरण_: लाइव सिंक सर्वर का URL।
655
- - _उदाहरण_: `'https://example.com'`
656
- - _नोट_: डिफ़ॉल्ट रूप से localhost की ओर इशारा करता है लेकिन रिमोट लाइव सिंक सर्वर के मामले में इसे किसी भी URL में बदला जा सकता है।
657
-
658
- ### मिडलवेयर कॉन्फ़िगरेशन
659
-
660
- सेटिंग्स जो मिडलवेयर के व्यवहार को नियंत्रित करती हैं, जिसमें एप्लिकेशन कुकीज़, हेडर, और लोकल प्रबंधन के लिए URL प्रीफिक्स कैसे संभालता है शामिल है।
661
-
662
- #### गुण
663
-
664
- - **headerName**:
665
- - _प्रकार_: `string`
666
- - _डिफ़ॉल्ट_: `'x-intlayer-locale'`
667
- - _विवरण_: HTTP हेडर का नाम जिसका उपयोग लोकल निर्धारित करने के लिए किया जाता है।
668
- - _उदाहरण_: `'x-custom-locale'`
669
- - _नोट_: यह API-आधारित लोकल निर्धारण के लिए उपयोगी है।
670
-
671
- - **cookieName**:
672
- - _प्रकार_: `string`
673
- - _डिफ़ॉल्ट_: `'intlayer-locale'`
674
- - _विवरण_: लोकल को स्टोर करने के लिए उपयोग की जाने वाली कुकी का नाम।
675
- - _उदाहरण_: `'custom-locale'`
676
- - _नोट_: सत्रों के बीच लोकल को बनाए रखने के लिए उपयोग किया जाता है।
677
-
678
- - **prefixDefault**:
679
- - _प्रकार_: `boolean`
680
- - _डिफ़ॉल्ट_: `false`
681
- - _विवरण_: क्या URL में डिफ़ॉल्ट लोकल शामिल किया जाए।
682
- - _उदाहरण_: `true`
683
- - _नोट_:
684
- - यदि `true` और `defaultLocale = 'en'`: पथ = `/en/dashboard` या `/fr/dashboard`
685
- - यदि `false` और `defaultLocale = 'en'`: पथ = `/dashboard` या `/fr/dashboard`
686
-
687
- - **basePath**:
688
- - _प्रकार_: `string`
689
- - _डिफ़ॉल्ट_: `''`
690
- - _विवरण_: एप्लिकेशन URL के लिए बेस पथ।
691
- - _उदाहरण_: `'/my-app'`
692
- - _नोट_:
693
- - यदि एप्लिकेशन `https://example.com/my-app` पर होस्ट किया गया है
694
- - बेस पथ होगा `'/my-app'`
695
- - URL होगा `https://example.com/my-app/en`
696
- - यदि बेस पाथ सेट नहीं है, तो URL होगा `https://example.com/en`
697
-
698
- - **rewrite**:
699
- - _प्रकार_: `Record<string, StrictModeLocaleMap<string>>`
700
- - _डिफ़ॉल्ट_: `undefined`
701
- - _विवरण_: कस्टम URL रीराइट नियम जो विशिष्ट पथों के लिए डिफ़ॉल्ट रूटिंग मोड को ओवरराइड करते हैं। मानक रूटिंग व्यवहार से भिन्न भाषा-विशिष्ट पथों को परिभाषित करने की अनुमति देता है। `[param]` सिंटैक्स का उपयोग करके गतिशील रूट पैरामीटर का समर्थन करता है।
702
- - _उदाहरण_:
703
- ```typescript
704
- routing: {
705
- mode: "prefix-no-default", // फॉलबैक रणनीति
706
- rewrite: nextjsRewrite({
707
- "/[locale]/about": {
708
- en: "/[locale]/about",
709
- fr: "/[locale]/a-propos",
710
- },
711
- "/[locale]/product/[slug]": {
712
- en: "/[locale]/product/[slug]",
713
- fr: "/[locale]/produit/[slug]",
714
- },
715
- "/[locale]/blog/[category]/[id]": {
716
- en: "/[locale]/blog/[category]/[id]",
717
- fr: "/[locale]/journal/[category]/[id]",
718
- },
719
- }),
720
- }
721
- ```
722
- - _नोट_: रीराइट नियम डिफ़ॉल्ट `mode` व्यवहार पर प्राथमिकता लेते हैं। यदि कोई पथ रीराइट नियम से मेल खाता है, तो मानक भाषा उपसर्ग के बजाय रीराइट कॉन्फ़िगरेशन से स्थानीयकृत पथ का उपयोग किया जाएगा।
723
- - _नोट_: गतिशील रूट पैरामीटर कोष्ठक संकेतन (उदाहरण के लिए, `[slug]`, `[id]`) का उपयोग करके समर्थित हैं। पैरामीटर मान स्वचालित रूप से URL से निकाले जाते हैं और रीराइट किए गए पथ में इंटरपोलेट किए जाते हैं।
724
- - _नोट_: Next.js और Vite अनुप्रयोगों के साथ काम करता है। मिडलवेयर/प्रॉक्सी आने वाले अनुरोधों को आंतरिक रूट संरचना से मेल खाने के लिए स्वचालित रूप से रीराइट करेगा।
725
- - _नोट_: `getLocalizedUrl()` के साथ URL उत्पन्न करते समय, यदि वे प्रदान किए गए पथ से मेल खाते हैं, तो रीराइट नियम स्वचालित रूप से लागू होते हैं।
726
- - _संदर्भ_: अधिक जानकारी के लिए, देखें [कस्टम URL रीराइट](https://github.com/aymericzip/intlayer/blob/main/docs/docs/hi/custom_url_rewrites.md)।
727
-
728
- - **serverSetCookie**:
729
- - _प्रकार_: `string`
730
- - _डिफ़ॉल्ट_: `'always'`
731
- - _विवरण_: सर्वर पर लोकल कुकी सेट करने का नियम।
732
- - _विकल्प_: `'always'`, `'never'`
733
- - _उदाहरण_: `'never'`
734
- - _नोट_: नियंत्रित करता है कि लोकल कुकी हर अनुरोध पर सेट की जाए या कभी नहीं।
735
-
736
- - **noPrefix**:
737
- - _प्रकार_: `boolean`
738
- - _डिफ़ॉल्ट_: `false`
739
- - _विवरण_: क्या URL से लोकल प्रीफिक्स को हटाना है।
740
- - _उदाहरण_: `true`
741
- - _नोट_:
742
- - यदि `true`: URL में कोई प्रीफिक्स नहीं होगा
743
- - यदि `false`: URL में प्रीफिक्स होगा
744
- - `basePath = '/my-app'` के साथ उदाहरण:
745
- - यदि `noPrefix = false`: URL होगा `https://example.com/my-app/en`
746
- - यदि `noPrefix = true`: URL होगा `https://example.com`
747
-
748
- ---
749
-
750
- ### सामग्री विन्यास
751
-
752
- ऐप्लिकेशन के भीतर सामग्री प्रबंधन से संबंधित सेटिंग्स, जिनमें निर्देशिका नाम, फ़ाइल एक्सटेंशन, और व्युत्पन्न विन्यास शामिल हैं।
753
-
754
- #### गुण
755
-
756
- - **autoFill**:
757
- - _प्रकार_: `boolean | string | FilePathPattern | { [key in Locales]?: string }`
758
- - _डिफ़ॉल्ट_: `undefined`
759
- - _विवरण_: यह संकेत करता है कि सामग्री को AI का उपयोग करके स्वचालित रूप से कैसे भरा जाना चाहिए। इसे वैश्विक रूप से `intlayer.config.ts` फ़ाइल में घोषित किया जा सकता है।
760
- - _उदाहरण_: true
761
- - _उदाहरण_: `'./{{fileName}}.content.json'`
762
- - _उदाहरण_: `{ fr: './{{fileName}}.fr.content.json', es: './{{fileName}}.es.content.json' }`
763
- - _नोट_: ऑटो फिल कॉन्फ़िगरेशन। यह हो सकता है:
764
- - boolean: सभी लोकल के लिए ऑटो फिल सक्षम करें
765
- - string: एकल फ़ाइल या वेरिएबल्स के साथ टेम्पलेट का पथ
766
- - object: प्रति-लोकल फ़ाइल पथ
767
-
768
- - **watch**:
769
- - _प्रकार_: `boolean`
770
- - _डिफ़ॉल्ट_: `process.env.NODE_ENV === 'development'`
771
- - _विवरण_: यह संकेत करता है कि Intlayer को ऐप में सामग्री घोषणा फ़ाइलों में परिवर्तनों के लिए देखना चाहिए ताकि संबंधित शब्दकोशों को पुनर्निर्मित किया जा सके।
772
-
773
- - **fileExtensions**:
774
- - _प्रकार_: `string[]`
775
- - _डिफ़ॉल्ट_: `['.content.ts', '.content.js', '.content.cjs', '.content.mjs', '.content.json', '.content.tsx', '.content.jsx']`
776
- - _विवरण_: शब्दकोश बनाने के दौरान खोजने के लिए फ़ाइल एक्सटेंशन।
777
- - _उदाहरण_: `['.data.ts', '.data.js', '.data.json']`
778
- - _टिप्पणी_: फ़ाइल एक्सटेंशन को कस्टमाइज़ करने से टकराव से बचा जा सकता है।
779
-
780
- - **dictionaryOutput**:
781
- - _प्रकार_: `string[]`
782
- - _डिफ़ॉल्ट_: `['intlayer']`
783
- - _विवरण_: उपयोग करने के लिए शब्दकोश आउटपुट का प्रकार, जैसे `'intlayer'` या `'i18next'`।
784
-
785
- - **contentDir**:
786
- - _प्रकार_: `string[]`
787
- - _डिफ़ॉल्ट_: `['.']`
788
- - _उदाहरण_: `['src', '../../ui-library', require.resolve("@my-package/content")]`
789
- - _विवरण_: वह डायरेक्टरी पथ जहाँ सामग्री परिभाषा फ़ाइलें (`.content.*`) संग्रहीत होती हैं।
790
- - _टिप्पणी_: यह शब्दकोशों को पुनर्निर्माण करने के लिए सामग्री फ़ाइलों को देखने के लिए उपयोग किया जाता है।
791
-
792
- - **codeDir**:
793
- - _प्रकार_: `string[]`
794
- - _डिफ़ॉल्ट_: `['.']`
795
- - _उदाहरण_: `['src', '../../ui-library']`
796
- - _विवरण_: वह डायरेक्टरी पथ जहाँ कोड संग्रहीत होता है, आधार निर्देशिका के सापेक्ष।
797
- - _टिप्पणी_: यह कोड फ़ाइलों को रूपांतरित करने (छाँटना, अनुकूलन) के लिए देखने के लिए उपयोग किया जाता है। इसे `contentDir` से अलग रखने से सामग्री फ़ाइलों के अनावश्यक स्कैन से बचकर बिल्ड प्रदर्शन में सुधार हो सकता है।
798
-
799
- - **dictionariesDir**:
800
- - _प्रकार_: `string`
801
- - _डिफ़ॉल्ट_: `'.intlayer/dictionaries'`
802
- - _विवरण_: मध्यवर्ती या आउटपुट परिणामों को संग्रहीत करने के लिए डायरेक्टरी पथ।
803
-
804
- - **moduleAugmentationDir**:
805
- - _प्रकार_: `string`
806
- - _डिफ़ॉल्ट_: `'.intlayer/types'`
807
- - _विवरण_: मॉड्यूल ऑगमेंटेशन के लिए डायरेक्टरी, जो बेहतर IDE सुझाव और टाइप जांच की अनुमति देती है।
808
- - _उदाहरण_: `'intlayer-types'`
809
- - _नोट_: सुनिश्चित करें कि इसे `tsconfig.json` में शामिल किया गया है।
810
-
811
- - **unmergedDictionariesDir**:
812
- - _प्रकार_: `string`
813
- - _डिफ़ॉल्ट_: `'.intlayer/unmerged_dictionary'`
814
- - _विवरण_: बिना मर्ज किए गए शब्दकोशों को संग्रहीत करने के लिए डायरेक्टरी।
815
- - _उदाहरण_: `'translations'`
816
-
817
- - **dictionariesDir**:
818
- - _प्रकार_: `string`
819
- - _डिफ़ॉल्ट_: `'.intlayer/dictionary'`
820
- - _विवरण_: स्थानीयकरण शब्दकोशों को संग्रहीत करने के लिए निर्देशिका।
821
- - _उदाहरण_: `'translations'`
822
-
823
- - **i18nextResourcesDir**:
824
- - _प्रकार_: `string`
825
- - _डिफ़ॉल्ट_: `'i18next_dictionary'`
826
- - _विवरण_: i18n शब्दकोशों को संग्रहीत करने के लिए निर्देशिका।
827
- - _उदाहरण_: `'translations'`
828
- - _नोट_: सुनिश्चित करें कि यह निर्देशिका i18next आउटपुट प्रकार के लिए कॉन्फ़िगर की गई हो।
829
-
830
- - **typesDir**:
831
- - _प्रकार_: `string`
832
- - _डिफ़ॉल्ट_: `'types'`
833
- - _विवरण_: शब्दकोश प्रकारों को संग्रहीत करने के लिए निर्देशिका।
834
- - _उदाहरण_: `'intlayer-types'`
835
-
836
- - **mainDir**:
837
- - _प्रकार_: `string`
838
- - _डिफ़ॉल्ट_: `'main'`
839
- - _विवरण_: मुख्य एप्लिकेशन फ़ाइलों को संग्रहीत करने के लिए निर्देशिका।
840
- - _उदाहरण_: `'intlayer-main'`
841
-
842
- - **excludedPath**:
843
- - _प्रकार_: `string[]`
844
- - _डिफ़ॉल्ट_: `['node_modules']`
845
- - _विवरण_: सामग्री खोज से बाहर किए गए निर्देशिकाएँ।
846
- - _नोट_: यह सेटिंग अभी उपयोग में नहीं है, लेकिन भविष्य में लागू करने की योजना है।
847
-
848
- ---
849
-
850
- ### सिस्टम कॉन्फ़िगरेशन
851
-
852
- Intlayer के आंतरिक पथों और आउटपुट परिणामों से संबंधित सेटिंग्स। ये सेटिंग्स आमतौर पर आंतरिक होती हैं और उपयोगकर्ता द्वारा संशोधित करने की आवश्यकता नहीं होनी चाहिए।
853
-
854
- #### गुण
855
-
856
- - **baseDir**:
857
- - _प्रकार_: `string`
858
- - _डिफ़ॉल्ट_: `process.cwd()`
859
- - _विवरण_: परियोजना के लिए मूल निर्देशिका।
860
- - _उदाहरण_: `'/path/to/project'`
861
- - _टिप्पणी_: इसका उपयोग सभी Intlayer-संबंधित निर्देशिकाओं को हल करने के लिए किया जाता है।
862
-
863
- ### शब्दकोश कॉन्फ़िगरेशन
864
-
865
- सेटिंग्स जो शब्दकोश संचालन को नियंत्रित करती हैं, जिसमें ऑटो-फिल व्यवहार और सामग्री जनरेशन शामिल है।
866
-
867
- यह शब्दकोश कॉन्फ़िगरेशन दो मुख्य उद्देश्यों को पूरा करता है:
868
-
869
- 1. **डिफ़ॉल्ट मान**: सामग्री घोषणा फ़ाइलें बनाते समय डिफ़ॉल्ट मान परिभाषित करें
870
- 2. **फॉलबैक व्यवहार**: विशिष्ट फ़ील्ड परिभाषित नहीं होने पर फॉलबैक मान प्रदान करें, जिससे आप शब्दकोश संचालन व्यवहार को वैश्विक रूप से परिभाषित कर सकें
871
-
872
- सामग्री घोषणा फ़ाइलों और कॉन्फ़िगरेशन मानों को कैसे लागू किया जाता है, इसके बारे में अधिक जानकारी के लिए, [सामग्री फ़ाइल दस्तावेज़](https://github.com/aymericzip/intlayer/blob/main/docs/docs/hi/dictionary/content_file.md) देखें।
873
-
874
- #### गुण
875
-
876
- - **fill**
877
- - **description**
878
- - **locale**
879
- - **location**
880
- - **priority**
881
- - **live**
882
- - **schema**
883
- - **title**
884
- - **tags**
885
- - **version**
886
-
887
- ---
888
-
889
- ### लॉगर कॉन्फ़िगरेशन
890
-
891
- सेटिंग्स जो लॉगर को नियंत्रित करती हैं, जिसमें उपयोग के लिए उपसर्ग शामिल है।
892
-
893
- #### गुण
894
-
895
- - **mode**:
896
- - _प्रकार_: `string`
897
- - _डिफ़ॉल्ट_: `default`
898
- - _विवरण_: लॉगर के मोड को दर्शाता है।
899
- - _विकल्प_: `default`, `verbose`, `disabled`
900
- - _उदाहरण_: `default`
901
- - _नोट_: लॉगर का मोड। verbose मोड अधिक जानकारी लॉग करेगा, लेकिन इसे डिबगिंग के लिए उपयोग किया जा सकता है। disabled मोड लॉगर को अक्षम कर देगा।
902
-
903
- - **prefix**:
904
- - _प्रकार_: `string`
905
- - _डिफ़ॉल्ट_: `'[intlayer] '`
906
- - _विवरण_: लॉगर का उपसर्ग।
907
- - _उदाहरण_: `'[my custom prefix] '`
908
- - _नोट_: लॉगर का उपसर्ग।
909
-
910
- ### एआई कॉन्फ़िगरेशन
911
-
912
- सेटिंग्स जो Intlayer की एआई विशेषताओं को नियंत्रित करती हैं, जिसमें प्रदाता, मॉडल, और API कुंजी शामिल हैं।
913
-
914
- यह कॉन्फ़िगरेशन वैकल्पिक है यदि आप [Intlayer डैशबोर्ड](https://app.intlayer.org/project) पर एक एक्सेस कुंजी का उपयोग करके पंजीकृत हैं। Intlayer स्वचालित रूप से आपकी आवश्यकताओं के लिए सबसे कुशल और लागत-प्रभावी एआई समाधान का प्रबंधन करेगा। डिफ़ॉल्ट विकल्पों का उपयोग करने से बेहतर दीर्घकालिक रखरखाव सुनिश्चित होता है क्योंकि Intlayer लगातार सबसे प्रासंगिक मॉडलों का उपयोग करने के लिए अपडेट होता रहता है।
915
-
916
- यदि आप अपनी स्वयं की API कुंजी या विशिष्ट मॉडल का उपयोग करना पसंद करते हैं, तो आप अपनी कस्टम एआई कॉन्फ़िगरेशन परिभाषित कर सकते हैं।
917
- यह AI कॉन्फ़िगरेशन आपके Intlayer पर्यावरण में वैश्विक रूप से उपयोग किया जाएगा। CLI कमांड इन सेटिंग्स का उपयोग कमांड्स (जैसे `fill`) के लिए डिफ़ॉल्ट के रूप में करेंगे, साथ ही SDK, विज़ुअल एडिटर, और CMS भी इनका उपयोग करेंगे। आप कमांड पैरामीटर का उपयोग करके विशिष्ट उपयोग मामलों के लिए इन डिफ़ॉल्ट मानों को ओवरराइड कर सकते हैं।
918
-
919
- Intlayer बेहतर लचीलापन और विकल्प के लिए कई AI प्रदाताओं का समर्थन करता है। वर्तमान में समर्थित प्रदाता हैं:
920
-
921
- - **OpenAI** (डिफ़ॉल्ट)
922
- - **Anthropic Claude**
923
- - **Mistral AI**
924
- - **DeepSeek**
925
- - **Google Gemini**
926
- - **Meta Llama**
927
- - **Ollama**
928
- - **OpenRouter**
929
- - **Alibaba Cloud**
930
- - **Fireworks**
931
- - **Hugging Face**
932
- - **Groq**
933
- - **Amazon Bedrock**
934
- - **Google AI Studio**
935
- - **Google Vertex**
936
- - **Together.ai**
937
- - **ollama**
938
-
939
- #### गुण
940
-
941
- - **provider**:
942
- - _प्रकार_: `string`
943
- - _डिफ़ॉल्ट_: `'openai'`
944
- - _विवरण_: Intlayer की AI सुविधाओं के लिए उपयोग करने वाला प्रदाता।
945
- - _विकल्प_: `'openai'`, `'anthropic'`, `'mistral'`, `'deepseek'`, `'gemini'`, `'ollama'`, `'openrouter'`, `'alibaba'`, `'fireworks'`, `'groq'`, `'huggingface'`, `'bedrock'`, `'googleaistudio'`, `'googlevertex'`, `'togetherai'`
946
- - _उदाहरण_: `'anthropic'`
947
- - _नोट_: विभिन्न प्रदाताओं के लिए अलग-अलग API कुंजी और मूल्य निर्धारण मॉडल हो सकते हैं।
948
-
949
- - **model**:
950
- - _प्रकार_: `string`
951
- - _डिफ़ॉल्ट_: कोई नहीं
952
- - _विवरण_: Intlayer की AI सुविधाओं के लिए उपयोग किया जाने वाला मॉडल।
953
- - _उदाहरण_: `'gpt-4o-2024-11-20'`
954
- - _नोट_: उपयोग किए जाने वाले विशिष्ट मॉडल प्रदाता के अनुसार भिन्न हो सकते हैं।
955
-
956
- - **temperature**:
957
- - _प्रकार_: `number`
958
- - _डिफ़ॉल्ट_: कोई नहीं
959
- - _विवरण_: तापमान AI की प्रतिक्रियाओं की यादृच्छिकता को नियंत्रित करता है।
960
- - _उदाहरण_: `0.1`
961
- - _नोट_: उच्च तापमान AI को अधिक रचनात्मक और कम पूर्वानुमेय बनाता है।
962
-
963
- - **apiKey**:
964
- - _प्रकार_: `string`
965
- - _डिफ़ॉल्ट_: कोई नहीं
966
- - _विवरण_: चुने गए प्रदाता के लिए आपकी API कुंजी।
967
- - _उदाहरण_: `process.env.OPENAI_API_KEY`
968
- - _नोट_: महत्वपूर्ण: API कुंजियाँ गोपनीय रखनी चाहिए और सार्वजनिक रूप से साझा नहीं करनी चाहिए। कृपया सुनिश्चित करें कि इन्हें सुरक्षित स्थान पर रखा जाए, जैसे कि पर्यावरण चर (environment variables) में।
969
-
970
- - **applicationContext**:
971
- - _प्रकार_: `string`
972
- - _डिफ़ॉल्ट_: कोई नहीं
973
- - _विवरण_: आपके एप्लिकेशन के बारे में अतिरिक्त संदर्भ AI मॉडल को प्रदान करता है, जिससे यह अधिक सटीक और संदर्भानुसार उपयुक्त अनुवाद उत्पन्न कर सके। इसमें आपके ऐप के डोमेन, लक्षित दर्शक, टोन, या विशिष्ट शब्दावली की जानकारी शामिल हो सकती है।
974
-
975
- - **baseURL**:
976
- - _प्रकार_: `string`
977
- - _डिफ़ॉल्ट_: कोई नहीं
978
- - _विवरण_: AI API के लिए आधार URL।
979
- - _उदाहरण_: `'https://api.openai.com/v1'`
980
- - _नोट_: स्थानीय या कस्टम AI API एंडपॉइंट को इंगित करने के लिए उपयोग किया जा सकता है।
981
-
982
- - **dataSerialization**:
983
- - _प्रकार_: `'json' | 'toon'`
984
- - _डिफ़ॉल्ट_: `'json'`
985
- - _विवरण_: Intlayer की AI सुविधाओं के लिए उपयोग किया जाने वाला डेटा सीरियलाइजेशन प्रारूप।
986
- - _उदाहरण_: `'toon'`
987
- - _नोट_: `json`: मानक, विश्वसनीय; अधिक टोकन का उपयोग करता है। `toon`: कम टोकन, JSON की तुलना में कम सुसंगत।
988
-
989
- ### बिल्ड कॉन्फ़िगरेशन
990
-
991
- सेटिंग्स जो नियंत्रित करती हैं कि Intlayer आपके एप्लिकेशन की अंतरराष्ट्रीयकरण को कैसे अनुकूलित और बिल्ड करता है।
992
-
993
- बिल्ड विकल्प `@intlayer/babel` और `@intlayer/swc` प्लगइन्स पर लागू होते हैं।
994
-
995
- > विकास मोड में, Intlayer विकास अनुभव को सरल बनाने के लिए शब्दकोशों के लिए स्थैतिक आयात का उपयोग करता है।
996
-
997
- > जब अनुकूलित किया जाता है, तो Intlayer शब्दकोश कॉल को अनुकूलित करने के लिए बदल देगा, ताकि अंतिम बंडल केवल उन शब्दकोशों को आयात करे जो वास्तव में उपयोग किए जाते हैं।
998
-
999
- #### गुण
1000
-
1001
- - **mode**:
1002
- - _प्रकार_: `'auto' | 'manual'`
1003
- - _डिफ़ॉल्ट_: `'auto'`
1004
- - _विवरण_: बिल्ड के मोड को नियंत्रित करता है।
1005
- - _उदाहरण_: `'manual'`
1006
- - _नोट_: यदि 'auto', तो एप्लिकेशन बनाए जाने पर बिल्ड स्वचालित रूप से सक्षम हो जाएगा।
1007
- - _नोट_: यदि 'manual', तो बिल्ड केवल तब सेट किया जाएगा जब बिल्ड कमांड निष्पादित की जाती है।
1008
- - _नोट_: शब्दकोश बिल्ड को अक्षम करने के लिए उपयोग किया जा सकता है, उदाहरण के लिए जब Node.js वातावरण में निष्पादन से बचना चाहिए।
1009
-
1010
- - **checkTypes**:
1011
- - _प्रकार_: `boolean`
1012
- - _डिफ़ॉल्ट_: `false`
1013
- - _विवरण_: इंगित करता है कि क्या बिल्ड को TypeScript प्रकारों की जांच करनी चाहिए और त्रुटियों को लॉग करना चाहिए।
1014
- - _नोट_: यह बिल्ड को धीमा कर सकता है।
1015
-
1016
- - **optimize**:
1017
- - _प्रकार_: `boolean`
1018
- - _डिफ़ॉल्ट_: `process.env.NODE_ENV === 'production'`
1019
- - _विवरण_: नियंत्रित करता है कि क्या बिल्ड को अनुकूलित किया जाना चाहिए।
1020
- - _उदाहरण_: `true`
1021
- - _नोट_: सक्षम होने पर, Intlayer शब्दकोशों के सभी कॉल को अनुकूलित करने के लिए बदल देगा। इस तरह अंतिम बंडल केवल उन शब्दकोशों को आयात करेगा जो उपयोग किए जाते हैं। सभी आयात स्थैतिक आयात के रूप में रहेंगे ताकि शब्दकोशों को लोड करते समय असिंक्रोनस प्रोसेसिंग से बचा जा सके।
1022
- - _नोट_: Intlayer `useIntlayer` के सभी कॉल्स को `importMode` विकल्प द्वारा परिभाषित मोड से और `getIntlayer` को `getDictionary` से बदल देगा।
1023
- - _नोट_: यह विकल्प `@intlayer/babel` और `@intlayer/swc` प्लगइन्स पर निर्भर करता है।
1024
- - _नोट_: सुनिश्चित करें कि सभी कुंजियाँ `useIntlayer` कॉल्स में स्थैतिक रूप से घोषित हों। उदाहरण के लिए `useIntlayer('navbar')`।
1025
-
1026
- - **outputFormat**:
1027
- - _प्रकार_: `'esm' | 'cjs'`
1028
- - _डिफ़ॉल्ट_: `'esm'`
1029
- - _विवरण_: शब्दकोशों के आउटपुट स्वरूप को नियंत्रित करता है।
1030
- - _उदाहरण_: `'cjs'`
1031
- - _नोट_: शब्दकोशों का आउटपुट स्वरूप।
1032
-
1033
- - **traversePattern**:
1034
- - _प्रकार_: `string[]`
1035
- - _डिफ़ॉल्ट_: `['**\/*.{js,ts,mjs,cjs,jsx,tsx}', '!**\/node_modules/**']`
1036
- - _विवरण_: पैटर्न जो यह परिभाषित करते हैं कि अनुकूलन के दौरान किन फ़ाइलों को ट्रैवर्स किया जाना चाहिए।
1037
- - _उदाहरण_: `['src/**\/*.{ts,tsx}', '../ui-library/**\/*.{ts,tsx}', '!**/node_modules/**']`
1038
- - _नोट_: इसका उपयोग संबंधित कोड फ़ाइलों तक अनुकूलन को सीमित करने और बिल्ड प्रदर्शन में सुधार करने के लिए करें।
1039
- - _नोट_: यदि `optimize` अक्षम है तो इस विकल्प को नजरअंदाज किया जाएगा।
1040
- - _नोट_: ग्लोब पैटर्न का उपयोग करें।
1041
-
1042
- ---
1043
-
1044
- ### कंपाइलर कॉन्फ़िगरेशन
1045
-
1046
- सेटिंग्स जो Intlayer कंपाइलर को नियंत्रित करती हैं, जो आपके घटकों से सीधे शब्दकोश निकालती हैं।
1047
-
1048
- #### गुण
1049
-
1050
- - **enabled**:
1051
- - _प्रकार_: `boolean | 'build-only'`
1052
- - _डिफ़ॉल्ट_: `true`
1053
- - _विवरण_: इंगित करता है कि क्या शब्दकोश निकालने के लिए कंपाइलर सक्षम होना चाहिए।
1054
- - _उदाहरण_: `'build-only'`
1055
- - _नोट_: इसे `'build-only'` पर सेट करने से डेवलपमेंट मोड के दौरान कंपाइलर छूट जाएगा ताकि बिल्ड समय तेज हो सके। यह केवल बिल्ड कमांड पर चलेगा।
1056
-
1057
- - **dictionaryKeyPrefix**:
1058
- - _प्रकार_: `string`
1059
- - _डिफ़ॉल्ट_: `''`
1060
- - _विवरण_: निकाले गए शब्दकोश कुंजियों के लिए उपसर्ग।
1061
- - _उदाहरण_: `'my-key-'`
1062
- - _नोट_: जब शब्दकोश निकाले जाते हैं, तो कुंजी फ़ाइल नाम के आधार पर उत्पन्न होती है। संघर्षों को रोकने के लिए उत्पन्न कुंजी में यह उपसर्ग जोड़ा जाता है।
1063
-
1064
- - **saveComponents**:
1065
- - _प्रकार_: `boolean`
1066
- - _डिफ़ॉल्ट_: `false`
1067
- - _विवरण_: इंगित करता है कि क्या घटकों को रूपांतरित होने के बाद सहेजा जाना चाहिए।
1068
- - _नोट_: यदि सही है, तो कंपाइलर मूल फ़ाइलों को रूपांतरित फ़ाइलों से बदल देगा। इस तरह, कंपाइलर को ऐप को रूपांतरित करने के लिए केवल एक बार चलाया जा सकता है, और फिर इसे हटाया जा सकता है।
1069
-
1070
- - **transformPattern**:
1071
- - _प्रकार_: `string | string[]`
1072
- - _डिफ़ॉल्ट_: `['**/*.{ts,tsx,jsx,js,cjs,mjs,svelte,vue}', '!**/node_modules/**']`
1073
- - _विवरण_: पैटर्न जो यह परिभाषित करते हैं कि अनुकूलन के दौरान किन फ़ाइलों को ट्रैवर्स किया जाना चाहिए।
1074
- - _उदाहरण_: `['src/**/*.{ts,tsx}', '!**/node_modules/**']`
1075
- - _नोट_: इसका उपयोग संबंधित कोड फ़ाइलों तक अनुकूलन को सीमित करने और बिल्ड प्रदर्शन में सुधार करने के लिए करें।
1076
-
1077
- - **excludePattern**:
1078
- - _प्रकार_: `string | string[]`
1079
- - _डिफ़ॉल्ट_: `['**/node_modules/**']`
1080
- - _विवरण_: पैटर्न जो यह परिभाषित करते हैं कि अनुकूलन के दौरान किन फ़ाइलों को बाहर रखा जाना चाहिए।
1081
- - _उदाहरण_: `['**/node_modules/**', '!**/node_modules/react/**']`
1082
-
1083
- - **output**:
1084
- - _प्रकार_: `FilePathPattern`
1085
- - _डिफ़ॉल्ट_: `undefined`
1086
- - _विवरण_: आउटपुट फ़ाइल पथ को परिभाषित करता है। `outputDir` को प्रतिस्थापित करता है। टेम्प्लेट स्ट्रिंग या फ़ंक्शन के माध्यम से डायनेमिक वैरिएबल का समर्थन करता है। समर्थित वैरिएबल: `{{fileName}}`, `{{key}}`, `{{locale}}`, `{{extension}}`, `{{componentFileName}}`, `{{componentExtension}}`, `{{format}}`, `{{componentFormat}}`, `{{componentDirPath}}` ।
1087
- - _नोट_: `./` से शुरू होने वाले पथ घटक निर्देशिका के सापेक्ष हल किए जाते हैं। `/` से शुरू होने वाले पथ प्रोजेक्ट रूट (`baseDir`) के सापेक्ष हल किए जाते हैं।
1088
- - _नोट_: पथ में `{{locale}}` वैरिएबल को शामिल करने से प्रति भाषा अलग शब्दकोश तैयार होंगे।
1089
- - _उदाहरण_:
1090
- - **घटक के पास बहु-भाषा फ़ाइलें बनाएँ**:
1091
- - स्ट्रिंग: `'./{{fileName}}{{extension}}'`
1092
- - फ़ंक्शन: `({ fileName, extension }) => \`./${fileName}${extension}\``
1093
-
1094
- - **प्रति भाषा केंद्रीकृत JSON फ़ाइलें आउटपुट करें**:
1095
- - स्ट्रिंग: `'/locales/{{locale}}/{{key}}.content.json'`
1096
- - फ़ंक्शन: `({ key, locale }) => \`/locales/${locale}/${key}.content.json\``
1097
-
1098
- - **noMetadata**:
1099
- - _प्रकार_: `boolean`
1100
- - _डिफ़ॉल्ट_: `false`
1101
- - _विवरण_: इंगित करता है कि फ़ाइल में मेटाडेटा सहेजा जाना चाहिए या नहीं। यदि सही है, तो कंपाइलर शब्दकोशों (कुंजी, सामग्री रैपर) के मेटाडेटा को नहीं बचाएगा। प्रति-लोकल i18next या ICU MessageFormat JSON आउटपुट के लिए उपयोगी।
1102
- - _नोट_: `loadJSON` प्लगइन के साथ उपयोग किए जाने पर उपयोगी।
1103
- - _उदाहरण_:
1104
- यदि `सही` है :
1105
- ```json
1106
- {
1107
- "key": "value"
1108
- }
1109
- ```
1110
- यदि `गलत` है :
1111
- ```json
1112
- {
1113
- "key": "value",
1114
- "content": {
1115
- "key": "value"
1116
- }
1117
- }
1118
- ```