@intlayer/docs 8.4.6 → 8.4.8

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (33) hide show
  1. package/blog/en/next-i18next_vs_next-intl_vs_intlayer.md +1 -3
  2. package/blog/en-GB/next-i18next_vs_next-intl_vs_intlayer.md +1 -3
  3. package/blog/es/next-i18next_vs_next-intl_vs_intlayer.md +1 -3
  4. package/blog/id/next-i18next_vs_next-intl_vs_intlayer.md +1 -3
  5. package/blog/it/next-i18next_vs_next-intl_vs_intlayer.md +1 -3
  6. package/blog/ja/next-i18next_vs_next-intl_vs_intlayer.md +1 -3
  7. package/blog/ko/next-i18next_vs_next-intl_vs_intlayer.md +1 -3
  8. package/blog/uk/next-i18next_vs_next-intl_vs_intlayer.md +1 -3
  9. package/blog/vi/next-i18next_vs_next-intl_vs_intlayer.md +1 -3
  10. package/blog/zh/next-i18next_vs_next-intl_vs_intlayer.md +1 -3
  11. package/docs/ar/configuration.md +300 -264
  12. package/docs/cs/configuration.md +958 -0
  13. package/docs/de/configuration.md +285 -249
  14. package/docs/en/configuration.md +115 -137
  15. package/docs/en-GB/configuration.md +272 -237
  16. package/docs/es/configuration.md +161 -125
  17. package/docs/fr/configuration.md +137 -101
  18. package/docs/it/configuration.md +294 -259
  19. package/docs/ja/configuration.md +269 -233
  20. package/docs/nl/configuration.md +958 -0
  21. package/docs/pt/configuration.md +311 -275
  22. package/docs/ru/configuration.md +287 -272
  23. package/docs/tr/configuration.md +265 -229
  24. package/package.json +6 -6
  25. package/docs/bn/configuration.md +0 -922
  26. package/docs/hi/configuration.md +0 -922
  27. package/docs/id/configuration.md +0 -922
  28. package/docs/ko/configuration.md +0 -922
  29. package/docs/pl/configuration.md +0 -922
  30. package/docs/uk/configuration.md +0 -922
  31. package/docs/ur/configuration.md +0 -922
  32. package/docs/vi/configuration.md +0 -922
  33. package/docs/zh/configuration.md +0 -922
@@ -1,922 +0,0 @@
1
- ---
2
- createdAt: 2024-08-13
3
- updatedAt: 2026-03-20
4
- title: कॉन्फ़िगरेशन (Configuration)
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.4.0
18
- date: 2026-03-20
19
- changes: 'compiler.output' और 'dictionary.fill' के लिए प्रति-लोकेल ऑब्जेक्ट नोटेशन जोड़ा गया
20
- - version: 8.3.0
21
- date: 2026-03-11
22
- changes: 'baseDir' को 'content' कॉन्फ़िगरेशन से 'system' कॉन्फ़िगरेशन में स्थानांतरित किया गया
23
- - version: 8.2.0
24
- date: 2026-03-09
25
- changes: कंपाइलर (compiler) विकल्पों को अपडेट किया गया, 'output' और 'noMetadata' के लिए समर्थन जोड़ा गया
26
- - version: 8.1.7
27
- date: 2026-02-25
28
- changes: कंपाइलर विकल्पों को अपडेट किया गया
29
- - version: 8.1.5
30
- date: 2026-02-23
31
- changes: कंपाइलर विकल्प 'build-only' और डिक्शनरी प्रीफिक्स जोड़ा गया
32
- - version: 8.0.6
33
- date: 2026-02-12
34
- changes: Open Router, Alibaba, Amazon, Google Vertex Bedrock, Fireworks, Groq, Hugging Face और Together.ai प्रदाताओं के लिए समर्थन जोड़ा गया
35
- - version: 8.0.5
36
- date: 2026-02-06
37
- changes: AI कॉन्फ़िगरेशन में `dataSerialization` जोड़ा गया
38
- - version: 8.0.0
39
- date: 2026-01-24
40
- changes: अंतर्निहित तंत्र का बेहतर वर्णन करने के लिए आयात मोड `live` का नाम बदलकर `fetch` कर दिया गया।
41
- - version: 8.0.0
42
- date: 2026-01-22
43
- changes: बिल्ड कॉन्फ़िगरेशन `importMode` को `dictionary` कॉन्फ़िगरेशन में स्थानांतरित किया गया।
44
- - version: 8.0.0
45
- date: 2026-01-22
46
- changes: राउटिंग कॉन्फ़िगरेशन में `rewrite` विकल्प जोड़ा गया
47
- - version: 8.0.0
48
- date: 2026-01-18
49
- changes: सिस्टम कॉन्फ़िगरेशन को कंटेंट कॉन्फ़िगरेशन से अलग किया गया। आंतरिक पथों को `system` प्रॉपर्टी में स्थानांतरित किया गया। कंटेंट फ़ाइलों और कोड परिवर्तन को अलग करने के लिए `codeDir` जोड़ा गया।
50
- - version: 8.0.0
51
- date: 2026-01-18
52
- changes: डिक्शनरी विकल्प `location` और `schema` जोड़े गए
53
- - version: 7.5.1
54
- date: 2026-01-10
55
- changes: JSON5 और JSONC फ़ाइल स्वरूपों के लिए समर्थन जोड़ा गया
56
- - version: 7.5.0
57
- date: 2025-12-17
58
- changes: `buildMode` विकल्प जोड़ा गया
59
- - version: 7.0.0
60
- date: 2025-10-25
61
- changes: `dictionary` कॉन्फ़िगरेशन जोड़ा गया
62
- - version: 7.0.0
63
- date: 2025-10-21
64
- changes: `middleware` को राउटिंग कॉन्फ़िगरेशन `routing` से बदल दिया गया
65
- - version: 7.0.0
66
- date: 2025-10-12
67
- changes: `formatCommand` विकल्प जोड़ा गया
68
- - version: 6.2.0
69
- date: 2025-10-12
70
- changes: `excludedPath` विकल्प अपडेट किया गया
71
- - version: 6.0.2
72
- date: 2025-09-23
73
- changes: `outputFormat` विकल्प जोड़ा गया
74
- - version: 6.0.0
75
- date: 2025-09-21
76
- changes: `dictionaryOutput` फ़ील्ड और `i18nextResourcesDir` फ़ील्ड हटा दिए गए
77
- - version: 6.0.0
78
- date: 2025-09-16
79
- changes: `live` आयात मोड जोड़ा गया
80
- - version: 6.0.0
81
- date: 2025-09-04
82
- changes: `hotReload` फ़ील्ड को `liveSync` से बदल दिया गया, और `liveSyncPort` और `liveSyncURL` फ़ील्ड जोड़े गए
83
- - version: 5.6.1
84
- date: 2025-07-25
85
- changes: `activateDynamicImport` को `importMode` विकल्प से बदल दिया गया
86
- - version: 5.6.0
87
- date: 2025-07-13
88
- changes: डिफ़ॉल्ट contentDir को `['src']` से बदलकर `['.']` कर दिया गया
89
- - version: 5.5.11
90
- date: 2025-06-29
91
- changes: `docs` कमांड जोड़े गए
92
- ---
93
-
94
- # Intlayer कॉन्फ़िगरेशन दस्तावेज़
95
-
96
- ## अवलोकन
97
-
98
- Intlayer कॉन्फ़िगरेशन फ़ाइलें आपको प्लगइन के विभिन्न पहलुओं को अनुकूलित करने की अनुमति देती हैं, जैसे कि अंतर्राष्ट्रीयकरण (internationalization), मिडलवेयर और कंटेंट हैंडलिंग। यह दस्तावेज़ कॉन्फ़िगरेशन में प्रत्येक प्रॉपर्टी का विस्तृत विवरण प्रदान करता है।
99
-
100
- ---
101
-
102
- ## विषय सूची
103
-
104
- <TOC/>
105
-
106
- ---
107
-
108
- ## समर्थित कॉन्फ़िगरेशन फ़ाइल स्वरूप
109
-
110
- Intlayer JSON, JS, MJS, और TS कॉन्फ़िगरेशन फ़ाइल स्वरूपों को स्वीकार करता है:
111
-
112
- - `intlayer.config.ts`
113
- - `intlayer.config.js`
114
- - `intlayer.config.json`
115
- - `intlayer.config.json5`
116
- - `intlayer.config.jsonc`
117
- - `intlayer.config.cjs`
118
- - `intlayer.config.mjs`
119
- - `.intlayerrc`
120
-
121
- ---
122
-
123
- ## कॉन्फ़िगरेशन फ़ाइल उदाहरण
124
-
125
- ````typescript fileName="intlayer.config.ts" codeFormat="typescript"
126
- import { Locales, type IntlayerConfig } from "intlayer";
127
- import { nextjsRewrite } from "intlayer/routing";
128
- import { z } from "zod";
129
-
130
- /**
131
- * सभी उपलब्ध विकल्पों को प्रदर्शित करने वाला Intlayer कॉन्फ़िगरेशन फ़ाइल उदाहरण।
132
- */
133
- const config: IntlayerConfig = {
134
- /**
135
- * अंतर्राष्ट्रीयकरण सेटिंग्स कॉन्फ़िगरेशन।
136
- */
137
- internationalization: {
138
- /**
139
- * एप्लिकेशन में समर्थित लोकेल (locales) की सूची।
140
- * डिफ़ॉल्ट: [Locales.ENGLISH]
141
- */
142
- locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],
143
-
144
- /**
145
- * प्रत्येक डिक्शनरी में परिभाषित की जाने वाली अनिवार्य लोकेल की सूची।
146
- * यदि खाली है, तो `strict` मोड में सभी लोकेल अनिवार्य हैं।
147
- * डिफ़ॉल्ट: []
148
- */
149
- requiredLocales: [Locales.ENGLISH],
150
-
151
- /**
152
- * अंतर्राष्ट्रीयकृत कंटेंट के लिए सख्ती का स्तर।
153
- * - "strict": यदि कोई घोषित लोकेल अनुपस्थित है या घोषित नहीं है तो त्रुटि।
154
- * - "inclusive": यदि घोषित लोकेल अनुपस्थित है तो चेतावनी।
155
- * - "loose": किसी भी मौजूदा लोकेल को स्वीकार करता है।
156
- * डिफ़ॉल्ट: "inclusive"
157
- */
158
- strictMode: "inclusive",
159
-
160
- /**
161
- * अनुरोधित लोकेल न मिलने की स्थिति में फ़ालबैक के रूप में उपयोग की जाने वाली डिफ़ॉल्ट लोकेल।
162
- * डिफ़ॉल्ट: Locales.ENGLISH
163
- */
164
- defaultLocale: Locales.ENGLISH,
165
- },
166
-
167
- /**
168
- * डिक्शनरी संचालन और फ़ालबैक व्यवहार को नियंत्रित करने वाली सेटिंग्स।
169
- */
170
- dictionary: {
171
- /**
172
- * डिक्शनरी को आयात करने के तरीके को नियंत्रित करता है।
173
- * - "static": बिल्ड समय पर स्थिर रूप से आयातित।
174
- * - "dynamic": सस्पेंस का उपयोग करके गतिशील रूप से आयातित।
175
- * - "fetch": लाइव सिंक एपीआई के माध्यम से गतिशील रूप से प्राप्त।
176
- * डिफ़ॉल्ट: "static"
177
- */
178
- importMode: "static",
179
-
180
- /**
181
- * AI का उपयोग करके लुप्त अनुवादों को स्वचालित रूप से भरने की रणनीति।
182
- * यह एक बूलियन मान या भरे हुए कंटेंट को सहेजने के लिए एक पथ पैटर्न हो सकता है।
183
- * डिफ़ॉल्ट: true
184
- */
185
- fill: true,
186
-
187
- /**
188
- * डिक्शनरी फ़ाइलों का भौतिक स्थान।
189
- * - "local": स्थानीय फ़ाइल सिस्टम में संग्रहीत।
190
- * - "remote": Intlayer CMS में संग्रहीत।
191
- * - "hybrid": स्थानीय और Intlayer CMS दोनों में संग्रहीत।
192
- * - "plugin" (या कोई भी कस्टम स्ट्रिंग): प्लगइन या कस्टम स्रोत द्वारा प्रदान किया गया।
193
- * डिफ़ॉल्ट: "local"
194
- */
195
- location: "local",
196
-
197
- /**
198
- * क्या कंटेंट स्वचालित रूप से रूपांतरित होना चाहिए (जैसे: Markdown से HTML)।
199
- * डिफ़ॉल्ट: false
200
- */
201
- contentAutoTransformation: false,
202
- },
203
-
204
- /**
205
- * राउटिंग और मिडलवेयर कॉन्फ़िगरेशन।
206
- */
207
- routing: {
208
- /**
209
- * लोकेल राउटिंग रणनीति।
210
- * - "prefix-no-default": डिफ़ॉल्ट के अलावा सभी को प्रीफ़िक्स करता है (जैसे: /dashboard, /fr/dashboard)।
211
- * - "prefix-all": सभी लोकेल को प्रीफ़िक्स करता है (जैसे: /en/dashboard, /fr/dashboard)।
212
- * - "no-prefix": URL में कोई लोकेल नहीं।
213
- * - "search-params": ?locale=... का उपयोग करता है
214
- * डिफ़ॉल्ट: "prefix-no-default"
215
- */
216
- mode: "prefix-no-default",
217
-
218
- /**
219
- * उपयोगकर्ता द्वारा चुनी गई लोकेल को कहाँ संग्रहीत करना है।
220
- * विकल्प: 'cookie', 'localStorage', 'sessionStorage', 'header' या इनका संयोजन।
221
- * डिफ़ॉल्ट: ['cookie', 'header']
222
- */
223
- storage: ["cookie", "header"],
224
-
225
- /**
226
- * एप्लिकेशन URL के लिए मूल पथ (Base path)।
227
- * डिफ़ॉल्ट: ""
228
- */
229
- basePath: "",
230
-
231
- /**
232
- * प्रति लोकेल विशिष्ट पथों के लिए कस्टम URL रीराइट (rewrite) नियम।
233
- */
234
- rewrite: nextjsRewrite({
235
- "/[locale]/about": {
236
- en: "/[locale]/about",
237
- fr: "/[locale]/a-propos",
238
- },
239
- }),
240
- },
241
-
242
- /**
243
- * कंटेंट फ़ाइल ढूंढने और प्रसंस्करण से संबंधित सेटिंग्स।
244
- */
245
- content: {
246
- /**
247
- * डिक्शनरी को स्कैन करने के लिए फ़ाइल एक्सटेंशन।
248
- * डिफ़ॉल्ट: ['.content.ts', '.content.js', '.content.json', आदि]
249
- */
250
- fileExtensions: [".content.ts", ".content.js", ".content.json"],
251
-
252
- /**
253
- * निर्देशिका जहाँ .content फ़ाइलें स्थित हैं।
254
- * डिफ़ॉल्ट: ["."]
255
- */
256
- contentDir: ["src"],
257
-
258
- /**
259
- * स्रोत कोड कहाँ स्थित है।
260
- * बिल्ड ऑप्टिमाइज़ेशन और कोड परिवर्तन के लिए उपयोग किया जाता है।
261
- * डिफ़ॉल्ट: ["."]
262
- */
263
- codeDir: ["src"],
264
-
265
- /**
266
- * स्कैन से बाहर रखे गए पैटर्न।
267
- * डिफ़ॉल्ट: ['node_modules', '.intlayer', आदि]
268
- */
269
- excludedPath: ["node_modules"],
270
-
271
- /**
272
- * क्या विकास के दौरान परिवर्तनों की निगरानी करनी चाहिए और डिक्शनरी का पुनर्निर्माण करना चाहिए।
273
- * डिफ़ॉल्ट: विकास परिवेश में true
274
- */
275
- watch: true,
276
-
277
- /**
278
- * नई निर्मित/अपडेट की गई .content फ़ाइलों को फ़ॉर्मैट करने के लिए उपयोग किया जाने वाला कमांड।
279
- */
280
- formatCommand: 'npx prettier --write "{{file}}"',
281
- },
282
-
283
- /**
284
- * विजुअल एडिटर (Visual Editor) कॉन्फ़िगरेशन।
285
- */
286
- editor: {
287
- /**
288
- * क्या विजुअल एडिटर सक्षम है।
289
- * डिफ़ॉल्ट: false
290
- */
291
- enabled: true,
292
-
293
- /**
294
- * ऑरिजिन वैलिडेशन के लिए आपके एप्लिकेशन का URL।
295
- * डिफ़ॉल्ट: ""
296
- */
297
- applicationURL: "http://localhost:3000",
298
-
299
- /**
300
- * स्थानीय एडिटर सर्वर के लिए पोर्ट।
301
- * डिफ़ॉल्ट: 8000
302
- */
303
- port: 8000,
304
-
305
- /**
306
- * एडिटर के लिए सार्वजनिक URL।
307
- * डिफ़ॉल्ट: "http://localhost:8000"
308
- */
309
- editorURL: "http://localhost:8000",
310
-
311
- /**
312
- * Intlayer CMS URL।
313
- * डिफ़ॉल्ट: "https://app.intlayer.org"
314
- */
315
- cmsURL: "https://app.intlayer.org",
316
-
317
- /**
318
- * बैकएंड एपीआई URL।
319
- * डिफ़ॉल्ट: "https://back.intlayer.org"
320
- */
321
- backendURL: "https://back.intlayer.org",
322
-
323
- /**
324
- * क्या रीयल-टाइम कंटेंट सिंक सक्षम करना है।
325
- * डिफ़ॉल्ट: false
326
- */
327
- liveSync: true,
328
- },
329
-
330
- /**
331
- * AI-आधारित अनुवाद और निर्माण सेटिंग्स।
332
- */
333
- ai: {
334
- /**
335
- * उपयोग किए जाने वाले AI प्रदाता।
336
- * विकल्प: 'openai', 'anthropic', 'mistral', 'deepseek', 'gemini', 'ollama', 'openrouter', 'alibaba', 'fireworks', 'groq', 'huggingface', 'bedrock', 'googlevertex', 'togetherai'
337
- * डिफ़ॉल्ट: 'openai'
338
- */
339
- provider: "openai",
340
-
341
- /**
342
- * उपयोग करने के लिए चयनित प्रदाता का मॉडल।
343
- */
344
- model: "gpt-4o",
345
-
346
- /**
347
- * प्रदाता एपीआई कुंजी।
348
- */
349
- apiKey: process.env.OPENAI_API_KEY,
350
-
351
- /**
352
- * अनुवाद बनाते समय AI को निर्देशित करने के लिए वैश्विक संदर्भ।
353
- */
354
- applicationContext: "यह एक यात्रा बुकिंग एप्लिकेशन है।",
355
-
356
- /**
357
- * AI एपीआई के लिए बेस पाथ URL।
358
- */
359
- baseURL: "http://localhost:3000",
360
-
361
- /**
362
- * डेटा सीरियलाइजेशन (Data Serialization)
363
- *
364
- * विकल्प:
365
- * - "json": डिफ़ॉल्ट, मजबूत; अधिक टोकन की खपत करता है।
366
- * - "toon": कम टोकन की खपत करता है, JSON की तरह सुसंगत नहीं हो सकता है।
367
- *
368
- * डिफ़ॉल्ट: "json"
369
- */
370
- dataSerialization: "json",
371
- },
372
-
373
- /**
374
- * बिल्ड और ऑप्टिमाइज़ेशन सेटिंग्स।
375
- */
376
- build: {
377
- /**
378
- * बिल्ड निष्पादन मोड।
379
- * - "auto": एप्लिकेशन बिल्ड के दौरान स्वचालित रूप से बिल्ड किया जाएगा।
380
- * - "manual": स्पष्ट बिल्ड कमांड की आवश्यकता है।
381
- * डिफ़ॉल्ट: "auto"
382
- */
383
- mode: "auto",
384
-
385
- /**
386
- * क्या अप्रयुक्त डिक्शनरी को हटाकर अंतिम बंडल को ऑप्टिमाइज़ करना है।
387
- * डिफ़ॉल्ट: प्रोडक्शन परिवेश में true
388
- */
389
- optimize: true,
390
-
391
- /**
392
- * जनरेट की गई डिक्शनरी फ़ाइलों के लिए आउटपुट स्वरूप।
393
- * डिफ़ॉल्ट: ['cjs', 'esm']
394
- */
395
- outputFormat: ["cjs", "esm"],
396
-
397
- /**
398
- * इंगित करता है कि क्या बिल्ड को टाइपस्क्रिप्ट प्रकारों (TypeScript types) की जांच करनी चाहिए।
399
- * डिफ़ॉल्ट: false
400
- */
401
- checkTypes: false,
402
- },
403
-
404
- /**
405
- * लॉगर (Logger) कॉन्फ़िगरेशन।
406
- */
407
- log: {
408
- /**
409
- * लॉगिंग स्तर।
410
- * - "default": मानक लॉगिंग।
411
- * - "verbose": गहन डिबग लॉगिंग।
412
- * - "disabled": लॉगिंग अक्षम करें।
413
- * डिफ़ॉल्ट: "default"
414
- */
415
- mode: "default",
416
-
417
- /**
418
- * सभी लॉग संदेशों के लिए प्रीफ़िक्स।
419
- * डिफ़ॉल्ट: "[intlayer]"
420
- */
421
- prefix: "[intlayer]",
422
- },
423
-
424
- /**
425
- * सिस्टम कॉन्फ़िगरेशन (उन्नत उपयोग के लिए)
426
- */
427
- system: {
428
- /**
429
- * स्थानीयकृत डिक्शनरी को संग्रहीत करने के लिए निर्देशिका।
430
- */
431
- dictionariesDir: ".intlayer/dictionary",
432
-
433
- /**
434
- * टाइपस्क्रिप्ट मॉड्यूल वृद्धि (module augmentation) के लिए निर्देशिका।
435
- */
436
- moduleAugmentationDir: ".intlayer/types",
437
-
438
- /**
439
- * विलय नहीं की गई डिक्शनरी को संग्रहीत करने के लिए निर्देशिका।
440
- */
441
- unmergedDictionariesDir: ".intlayer/unmerged_dictionary",
442
-
443
- /**
444
- * डिक्शनरी प्रकारों को संग्रहीत करने के लिए निर्देशिका।
445
- */
446
- typesDir: ".intlayer/types",
447
-
448
- /**
449
- * मुख्य एप्लिकेशन फ़ाइलें जहाँ संग्रहीत हैं।
450
- */
451
- mainDir: ".intlayer/main",
452
-
453
- /**
454
- * कॉन्फ़िगरेशन फ़ाइलें जहाँ संग्रहीत हैं।
455
- */
456
- configDir: ".intlayer/config",
457
-
458
- /**
459
- * कैश फ़ाइलें जहाँ संग्रहीत हैं।
460
- */
461
- cacheDir: ".intlayer/cache",
462
- },
463
-
464
- /**
465
- * कंपाइलर (Compiler) कॉन्फ़िगरेशन (उन्नत उपयोग के लिए)
466
- */
467
- compiler: {
468
- /**
469
- * इंगित करता है कि क्या कंपाइलर सक्षम होना चाहिए।
470
- *
471
- * - false: कंपाइलर को अक्षम करता है।
472
- * - true: कंपाइलर को सक्षम करता है।
473
- * - "build-only": विकास के दौरान कंपाइलर को छोड़ देता है और स्टार्टअप समय को गति देता है।
474
- *
475
- * डिफ़ॉल्ट: false
476
- */
477
- enabled: true,
478
-
479
- /**
480
- * आउटपुट फ़ाइलों के लिए पथ परिभाषित करता है। `outputDir` की जगह लेता है।
481
- *
482
- * - `./` पथ घटक निर्देशिका के सापेक्ष हल किए जाते हैं।
483
- * - `/` पथ प्रोजेक्ट रूट (`baseDir`) के सापेक्ष हल किए जाते हैं।
484
- *
485
- * - पथ में `{{locale}}` वेरिएबल शामिल करने से प्रति भाषा अलग डिक्शनरी का निर्माण शुरू हो जाएगा।
486
- *
487
- * उदाहरण:
488
- * ```ts
489
- * {
490
- * // कंपोनेंट के बगल में बहुभाषी .content.ts फ़ाइलें बनाएँ
491
- * output: ({ fileName, extension }) => `./${fileName}${extension}`,
492
- *
493
- * // output: './{{fileName}}{{extension}}', // टेम्प्लेट स्ट्रिंग का उपयोग करके समकक्ष
494
- * }
495
- * ```
496
- *
497
- * ```ts
498
- * {
499
- * // प्रोजेक्ट रूट पर प्रति भाषा केंद्रीकृत JSON बनाएँ
500
- * output: ({ key, locale }) => `/locales/${locale}/${key}.content.json`,
501
- *
502
- * // output: '/locales/{{locale}}/{{key}}.content.json', // टेम्प्लेट स्ट्रिंग का उपयोग करके समकक्ष
503
- * }
504
- * ```
505
- *
506
- * वेरिएबल्स की सूची:
507
- * - `fileName`: फ़ाइल का नाम।
508
- * - `key`: कंटेंट की (key)।
509
- * - `locale`: कंटेंट लोकेल।
510
- * - `extension`: फ़ाइल एक्सटेंशन।
511
- * - `componentFileName`: कंपोनेंट फ़ाइल का नाम।
512
- * - `componentExtension`: कंपोनेंट फ़ाइल एक्सटेंशन।
513
- * - `format`: डिक्शनरी स्वरूप।
514
- * - `componentFormat`: कंपोनेंट डिक्शनरी स्वरूप।
515
- * - `componentDirPath`: कंपोनेंट निर्देशिका पथ।
516
- */
517
- output: ({ locale, key }) => `compiler/${locale}/${key}.json`,
518
-
519
- /**
520
- * इंगित करता है कि रूपांतरित होने के बाद कंपोनेंट को सहेजा जाना चाहिए या नहीं।
521
- * इस तरह, कंपाइलर आपके एप्लिकेशन को रूपांतरित करने के लिए केवल एक बार चल सकता है और फिर हटाया जा सकता है।
522
- */
523
- saveComponents: false,
524
-
525
- /**
526
- * केवल जनरेट की गई फ़ाइल में कंटेंट सम्मिलित करता है। i18next या ICU MessageFormat स्वरूप के प्रति भाषा JSON आउटपुट के लिए उपयोगी है।
527
- */
528
- noMetadata: false,
529
-
530
- /**
531
- * डिक्शनरी की (key) प्रीफ़िक्स
532
- */
533
- dictionaryKeyPrefix: "", // निकाले गए डिक्शनरी कीज़ में एक वैकल्पिक प्रीफ़िक्स जोड़ें
534
- },
535
-
536
- /**
537
- * डिक्शनरी के कंटेंट को सत्यापित करने के लिए कस्टम स्कीमा (Schemas)।
538
- */
539
- schemas: {
540
- "my-schema": z.object({
541
- title: z.string(),
542
- }),
543
- },
544
-
545
- /**
546
- * प्लगइन कॉन्फ़िगरेशन।
547
- */
548
- plugins: [],
549
- };
550
-
551
- export default config;
552
- ````
553
-
554
- ---
555
-
556
- ## कॉन्फ़िगरेशन संदर्भ (Configuration Reference)
557
-
558
- निम्नलिखित अनुभाग Intlayer में उपलब्ध विभिन्न कॉन्फ़िगरेशन विकल्पों का वर्णन करते हैं।
559
-
560
- ---
561
-
562
- ### अंतर्राष्ट्रीयकरण कॉन्फ़िगरेशन (Internationalization Configuration)
563
-
564
- उपलब्ध लोकेल और एप्लिकेशन के लिए डिफ़ॉल्ट लोकेल सहित अंतर्राष्ट्रीयकरण से संबंधित सेटिंग्स को परिभाषित करता है।
565
-
566
- | फ़ील्ड | प्रकार | विवरण | उदाहरण | नोट |
567
- | ----------------- | ---------- | -------------------------------------------------------------------------------------------------------------------------- | -------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
568
- | `locales` | `string[]` | एप्लिकेशन में समर्थित लोकेल की सूची। डिफ़ॉल्ट: `[Locales.ENGLISH]` | `['en', 'fr', 'es']` | |
569
- | `requiredLocales` | `string[]` | एप्लिकेशन में आवश्यक लोकेल की सूची। डिफ़ॉल्ट: `[]` | `[]` | यदि खाली है, तो `strict` मोड में सभी लोकेल आवश्यक हैं। सुनिश्चित करें कि आवश्यक लोकेल `locales` फ़ील्ड में भी परिभाषित हैं। |
570
- | `strictMode` | `string` | टाइपस्क्रिप्ट के उपयोग के माध्यम से अंतर्राष्ट्रीयकृत कंटेंट के मजबूत कार्यान्वयन सुनिश्चित करता है। डिफ़ॉल्ट: `inclusive` | | यदि `"strict"` है: `t` फ़ंक्शन के लिए प्रत्येक घोषित लोकेल को परिभाषित करना आवश्यक है — यदि कोई गायब है या घोषित नहीं है तो त्रुटि फेंकता है। यदि `"inclusive"` है: गायब लोकेल के लिए चेतावनी देता है लेकिन मौजूदा अघोषित लोकेल को स्वीकार करता है। यदि `"loose"` है: किसी भी मौजूदा लोकेल को स्वीकार करता है। |
571
- | `defaultLocale` | `string` | अनुरोधित लोकेल न मिलने पर फ़ालबैक के रूप में उपयोग की जाने वाली डिफ़ॉल्ट लोकेल। डिफ़ॉल्ट: `Locales.ENGLISH` | `'en'` | लोकेल निर्धारित करने के लिए उपयोग किया जाता है जब URL, कुकी या हेडर में कोई निर्दिष्ट नहीं होता है। |
572
-
573
- ---
574
-
575
- ### एडिटर कॉन्फ़िगरेशन (Editor Configuration)
576
-
577
- सर्वर पोर्ट और गतिविधि स्थिति सहित एकीकृत एडिटर से संबंधित सेटिंग्स को परिभाषित करता है।
578
-
579
- | फ़ील्ड | प्रकार | विवरण | उदाहरण | नोट |
580
- | ---------------------------- | ------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
581
- | `applicationURL` | `string` | आपके एप्लिकेशन का URL। डिफ़ॉल्ट: `''` | `'http://localhost:3000'`, `'https://example.com'`, `process.env.INTLAYER_EDITOR_URL` | सुरक्षा कारणों से एडिटर के ऑरिजिन को प्रतिबंधित करने के लिए उपयोग किया जाता है। यदि `'*'` सेट किया गया है, तो एडिटर को किसी भी ऑरिजिन से एक्सेस किया जा सकता है। |
582
- | `port` | `number` | विजुअल एडिटर सर्वर द्वारा उपयोग किया जाने वाला पोर्ट। डिफ़ॉल्ट: `8000` | | |
583
- | `editorURL` | `string` | एडिटर सर्वर URL। डिफ़ॉल्ट: `'http://localhost:8000'` | `'http://localhost:3000'`, `'https://example.com'`, `process.env.INTLAYER_EDITOR_URL` | उन ऑरिजिन्स को प्रतिबंधित करने के लिए उपयोग किया जाता है जो एप्लिकेशन के साथ इंटरैक्ट कर सकते हैं। यदि `'*'` सेट किया गया है, तो किसी भी ऑरिजिन से एक्सेस योग्य है। पोर्ट बदलने पर या एडिटर किसी अन्य डोमेन पर होस्ट होने पर सेट किया जाना चाहिए। |
584
- | `cmsURL` | `string` | Intlayer CMS URL। डिफ़ॉल्ट: `'https://intlayer.org'` | `'https://intlayer.org'` | |
585
- | `backendURL` | `string` | बैकएंड सर्वर URL। डिफ़ॉल्ट: `https://back.intlayer.org` | `http://localhost:4000` | |
586
- | `enabled` | `boolean` | इंगित करता है कि क्या ऐप विजुअल एडिटर के साथ इंटरैक्ट करेगा। डिफ़ॉल्ट: `true` | `process.env.NODE_ENV !== 'production'` | यदि `false` है, तो एडिटर ऐप के साथ इंटरैक्ट नहीं कर सकता है। विशिष्ट परिवेशों के लिए इसे अक्षम करने से सुरक्षा बढ़ जाती है। |
587
- | `clientId` | `string &#124; undefined` | oAuth2 का उपयोग करके बैकएंड के साथ प्रमाणित करने के लिए intlayer पैकेज को सक्षम करता है। एक्सेस टोकन प्राप्त करने के लिए, [intlayer.org/project](https://app.intlayer.org/project) पर जाएँ। डिफ़ॉल्ट: `undefined` | | गुप्त रखें; पर्यावरण चर (environment variables) में संग्रहीत करें। |
588
- | `clientSecret` | `string &#124; undefined` | oAuth2 का उपयोग करके बैकएंड के साथ प्रमाणित करने के लिए intlayer पैकेज को सक्षम करता है। एक्सेस टोकन प्राप्त करने के लिए, [intlayer.org/project](https://app.intlayer.org/project) पर जाएँ। डिफ़ॉल्ट: `undefined` | | गुप्त रखें; पर्यावरण चर में संग्रहीत करें। |
589
- | `dictionaryPriorityStrategy` | `string` | स्थानीय और रिमोट दोनों डिक्शनरी मौजूद होने पर डिक्शनरी प्राथमिकता रणनीति। डिफ़ॉल्ट: `'local_first'` | `'distant_first'` | `'distant_first'`: स्थानीय पर रिमोट को प्राथमिकता देता है। `'local_first'`: रिमोट पर स्थानीय को प्राथमिकता देता है। |
590
- | `liveSync` | `boolean` | इंगित करता है कि CMS / विजुअल एडिटर / बैकएंड में परिवर्तन मिलने पर ऐप सर्वर को हॉट रीलोड कंटेंट करना चाहिए या नहीं। डिफ़ॉल्ट: `true` | `true` | जब डिक्शनरी जोड़ा/अपडेट किया जाता है, तो ऐप पेज कंटेंट को अपडेट करता है। लाइव सिंक कंटेंट को दूसरे सर्वर पर आउटसोर्स करता है, जो प्रदर्शन को थोड़ा प्रभावित कर सकता है। दोनों को एक ही मशीन पर होस्ट करने की अनुशंसा की जाती है। |
591
- | `liveSyncPort` | `number` | लाइव सिंक सर्वर पोर्ट। डिफ़ॉल्ट: `4000` | `4000` | |
592
- | `liveSyncURL` | `string` | लाइव सिंक सर्वर URL। डिफ़ॉल्ट: `'http://localhost:{liveSyncPort}'` | `'https://example.com'` | डिफ़ॉल्ट रूप से localhost को इंगित करता है; इसे रिमोट लाइव सिंक सर्वर में बदला जा सकता है। |
593
-
594
- ### राउटिंग कॉन्फ़िगरेशन (Routing Configuration)
595
-
596
- URL संरचना, लोकेल स्टोरेज और मिडलवेयर हैंडलिंग सहित राउटिंग व्यवहार को नियंत्रित करने वाली सेटिंग्स।
597
-
598
- | फ़ील्ड | प्रकार | विवरण | उदाहरण | नोट |
599
- | ---------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
600
- | `mode` | `'prefix-no-default' &#124; 'prefix-all' &#124; 'no-prefix' &#124; 'search-params'` | लोकेल हैंडलिंग के लिए URL राउटिंग मोड। डिफ़ॉल्ट: `'prefix-no-default'` | `'prefix-no-default'`: `/dashboard` (en) या `/fr/dashboard` (fr)। `'prefix-all'`: `/en/dashboard` । `'no-prefix'`: लोकेल को अन्य माध्यमों से संभाला जाता है। `'search-params'`: `/dashboard?locale=fr` का उपयोग करता है | कुकी या लोकेल स्टोरेज प्रबंधन को प्रभावित नहीं करता है। |
601
- | `storage` | `false &#124; 'cookie' &#124; 'localStorage' &#124; 'sessionStorage' &#124; 'header' &#124; CookiesAttributes &#124; StorageAttributes &#124; Array` | क्लाइंट पर लोकेल संग्रहीत करने के लिए कॉन्फ़िगरेशन। डिफ़ॉल्ट: `['cookie', 'header']` | `'localStorage'`, `[{ type: 'cookie', name: 'custom-locale', secure: true }]` | नीचे दी गई स्टोरेज विकल्प तालिका देखें। |
602
- | `basePath` | `string` | एप्लिकेशन URL के लिए मूल पथ (Base path)। डिफ़ॉल्ट: `''` | `'/my-app'` | यदि एप्लिकेशन `https://example.com/my-app` पर है, तो basePath `'/my-app'` है और URL `https://example.com/my-app/en` की तरह हो जाते हैं। |
603
- | `rewrite` | `Record<string, StrictModeLocaleMap<string>>` | कस्टम URL रीराइट नियम जो विशिष्ट पथों के लिए डिफ़ॉल्ट राउटिंग मोड को ओवरराइड करते हैं। गतिशील मापदंडों (dynamic parameters) `[param]` का समर्थन करता है। डिफ़ॉल्ट: `undefined` | नीचे उदाहरण देखें | रीराइट नियम `mode` पर प्राथमिकता रखते हैं। Next.js और Vite के साथ काम करता है। `getLocalizedUrl()` स्वचालित रूप से मिलान नियमों को लागू करता है। [Custom URL Rewrites](https://github.com/aymericzip/intlayer/blob/main/docs/docs/hi/custom_url_rewrites.md) देखें। |
604
-
605
- **`rewrite` उदाहरण**:
606
-
607
- ```typescript
608
- routing: {
609
- mode: "prefix-no-default", // फ़ालबैक रणनीति
610
- rewrite: nextjsRewrite({
611
- "/about": {
612
- en: "/about",
613
- fr: "/a-propos",
614
- },
615
- "/product/[slug]": {
616
- en: "/product/[slug]",
617
- fr: "/produit/[slug]",
618
- },
619
- "/blog/[category]/[id]": {
620
- en: "/blog/[category]/[id]",
621
- fr: "/journal/[category]/[id]",
622
- },
623
- }),
624
- }
625
- ```
626
-
627
- #### स्टोरेज विकल्प (Storage Options)
628
-
629
- | मान | विवरण | नोट |
630
- | ------------------ | ----------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
631
- | `'cookie'` | लोकेल को कुकीज़ में सहेजता है — क्लाइंट और सर्वर साइड दोनों से एक्सेस योग्य। | GDPR अनुपालन के लिए, सुनिश्चित करें कि उचित उपयोगकर्ता सहमति प्राप्त की गई है। `CookiesAttributes` के माध्यम से अनुकूलन योग्य (`{ type: 'cookie', name: 'custom-locale', secure: true, httpOnly: false }`)। |
632
- | `'localStorage'` | बिना समाप्ति तिथि के ब्राउज़र में लोकेल सहेजता है — केवल क्लाइंट साइड। | जब तक स्पष्ट रूप से साफ़ नहीं किया जाता, तब तक समाप्त नहीं होता है। Intlayer प्रॉक्सी इसे एक्सेस नहीं कर सकता है। `StorageAttributes` के माध्यम से अनुकूलन योग्य (`{ type: 'localStorage', name: 'custom-locale' }`)। |
633
- | `'sessionStorage'` | पेज सत्र की अवधि के लिए लोकेल सहेजता है — केवल क्लाइंट साइड। | टैब/विंडो बंद होने पर साफ़ हो जाता है। Intlayer प्रॉक्सी इसे एक्सेस नहीं कर सकता है। `StorageAttributes` के माध्यम से अनुकूलन योग्य (`{ type: 'sessionStorage', name: 'custom-locale' }`)। |
634
- | `'header'` | HTTP हेडर के माध्यम से लोकेल को सहेजता या प्रसारित करता है — केवल सर्वर साइड। | एपीआई कॉल के लिए उपयोगी। क्लाइंट साइड एक्सेस नहीं कर सकता है। `StorageAttributes` के माध्यम से अनुकूलन योग्य (`{ type: 'header', name: 'custom-locale' }`)। |
635
-
636
- #### कुकी विशेषताएँ (Cookie Attributes)
637
-
638
- कुकी स्टोरेज का उपयोग करते समय, आप अतिरिक्त कुकी विशेषताओं को कॉन्फ़िगर कर सकते हैं:
639
-
640
- | फ़ील्ड | प्रकार | विवरण |
641
- | ---------- | ------------------------------------- | ------------------------------------------------------ |
642
- | `name` | `string` | कुकी का नाम। डिफ़ॉल्ट: `'INTLAYER_LOCALE'` |
643
- | `domain` | `string` | कुकी डोमेन। डिफ़ॉल्ट: `undefined` |
644
- | `path` | `string` | कुकी पथ। डिफ़ॉल्ट: `undefined` |
645
- | `secure` | `boolean` | HTTPS की आवश्यकता है। डिफ़ॉल्ट: `undefined` |
646
- | `httpOnly` | `boolean` | HTTP-only फ़्लैग। डिफ़ॉल्ट: `undefined` |
647
- | `sameSite` | `'strict' &#124; 'lax' &#124; 'none'` | SameSite नीति। |
648
- | `expires` | `Date &#124; number` | समाप्ति तिथि या दिनों की संख्या। डिफ़ॉल्ट: `undefined` |
649
-
650
- #### लोकेल स्टोरेज विशेषताएँ (Locale Storage Attributes)
651
-
652
- localStorage या sessionStorage का उपयोग करते समय:
653
-
654
- | फ़ील्ड | प्रकार | विवरण |
655
- | ------ | ---------------------------------------- | ------------------------------------------------------ |
656
- | `type` | `'localStorage' &#124; 'sessionStorage'` | स्टोरेज प्रकार। |
657
- | `name` | `string` | स्टोरेज की (key) का नाम। डिफ़ॉल्ट: `'INTLAYER_LOCALE'` |
658
-
659
- #### कॉन्फ़िगरेशन उदाहरण
660
-
661
- नई v7 राउटिंग संरचना के लिए यहाँ कुछ सामान्य कॉन्फ़िगरेशन उदाहरण दिए गए हैं:
662
-
663
- **मूल कॉन्फ़िगरेशन (डिफ़ॉल्ट)**:
664
-
665
- ```typescript
666
- import { Locales, type IntlayerConfig } from "intlayer";
667
- // intlayer.config.ts
668
- const config: IntlayerConfig = {
669
- internationalization: {
670
- locales: ["en", "fr", "es"],
671
- defaultLocale: "en",
672
- },
673
- routing: {
674
- mode: "prefix-no-default",
675
- storage: "localStorage",
676
- basePath: "",
677
- },
678
- };
679
-
680
- export default config;
681
- ```
682
-
683
- **GDPR अनुपालन कॉन्फ़िगरेशन**:
684
-
685
- ```typescript
686
- import { Locales, type IntlayerConfig } from "intlayer";
687
- // intlayer.config.ts
688
- const config: IntlayerConfig = {
689
- internationalization: {
690
- locales: ["en", "fr", "es"],
691
- defaultLocale: "en",
692
- },
693
- routing: {
694
- mode: "prefix-no-default",
695
- storage: [
696
- {
697
- type: "localStorage",
698
- name: "user-locale",
699
- },
700
- {
701
- type: "cookie",
702
- name: "user-locale",
703
- secure: true,
704
- sameSite: "strict",
705
- httpOnly: false,
706
- },
707
- ],
708
- basePath: "",
709
- },
710
- };
711
-
712
- export default config;
713
- ```
714
-
715
- **सर्च पैरामीटर्स मोड (Search Parameters Mode)**:
716
-
717
- ```typescript
718
- import { Locales, type IntlayerConfig } from "intlayer";
719
- // intlayer.config.ts
720
- const config: IntlayerConfig = {
721
- internationalization: {
722
- locales: ["en", "fr", "es"],
723
- defaultLocale: "en",
724
- },
725
- routing: {
726
- mode: "search-params",
727
- storage: "localStorage",
728
- basePath: "",
729
- },
730
- };
731
-
732
- export default config;
733
- ```
734
-
735
- **कस्टम स्टोरेज के साथ नो प्रीफ़िक्स मोड (No Prefix Mode)**:
736
-
737
- ```typescript
738
- import { Locales, type IntlayerConfig } from "intlayer";
739
- // intlayer.config.ts
740
- const config: IntlayerConfig = {
741
- internationalization: {
742
- locales: ["en", "fr", "es"],
743
- defaultLocale: "en",
744
- },
745
- routing: {
746
- mode: "no-prefix",
747
- storage: {
748
- type: "sessionStorage",
749
- name: "app-locale",
750
- },
751
- basePath: "/my-app",
752
- },
753
- };
754
-
755
- export default config;
756
- ```
757
-
758
- **गत्यात्मक पथों (Dynamic paths) के साथ कस्टम URL रीराइट**:
759
-
760
- ```typescript
761
- // intlayer.config.ts
762
- import { nextjsRewrite } from "intlayer/routing";
763
-
764
- const config: IntlayerConfig = {
765
- internationalization: {
766
- locales: ["en", "fr"],
767
- defaultLocale: "en",
768
- },
769
- routing: {
770
- mode: "prefix-no-default", // गैर-रीराइट पथों के लिए फ़ालबैक रणनीति
771
- storage: "cookie",
772
- rewrite: nextjsRewrite({
773
- "/about": {
774
- en: "/about",
775
- fr: "/a-propos",
776
- },
777
- "/product/[slug]": {
778
- en: "/product/[slug]",
779
- fr: "/produit/[slug]",
780
- },
781
- "/blog/[category]/[id]": {
782
- en: "/blog/[category]/[id]",
783
- fr: "/journal/[category]/[id]",
784
- },
785
- }),
786
- },
787
- };
788
-
789
- export default config;
790
- ```
791
-
792
- ---
793
-
794
- ### कंटेंट कॉन्फ़िगरेशन (Content Configuration)
795
-
796
- एप्लिकेशन के भीतर कंटेंट प्रसंस्करण से संबंधित सेटिंग्स (निर्देशिका नाम, फ़ाइल एक्सटेंशन और व्युत्पन्न कॉन्फ़िगरेशन)।
797
-
798
- | फ़ील्ड | प्रकार | विवरण | उदाहरण | नोट |
799
- | ---------------- | ---------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ |
800
- | `watch` | `boolean` | इंगित करता है कि क्या Intlayer को डिक्शनरी के पुनर्निर्माण के लिए कंटेंट घोषणा फ़ाइलों में परिवर्तनों की निगरानी करनी चाहिए। डिफ़ॉल्ट: `process.env.NODE_ENV === 'development'` | | |
801
- | `fileExtensions` | `string[]` | कंटेंट घोषणा फ़ाइलों को स्कैन करने के लिए उपयोग किए जाने वाले फ़ाइल एक्सटेंशन। डिफ़ॉल्ट: `['.content.ts', '.content.js', '.content.mjs', '.content.cjs', '.content.json', '.content.json5', '.content.jsonc']` | `['.content.ts', '.content.js']` | |
802
- | `contentDir` | `string[]` | कंटेंट घोषणा फ़ाइलें कहाँ स्थित हैं, उस निर्देशिका का पथ। डिफ़ॉल्ट: `['.' ]` | `['src/content']` | |
803
- | `codeDir` | `string[]` | आपके एप्लिकेशन की स्रोत कोड फ़ाइलें जहाँ स्थित हैं, उस निर्देशिका का पथ। डिफ़ॉल्ट: `['.' ]` | `['src']` | बिल्ड को ऑप्टिमाइज़ करने और यह सुनिश्चित करने के लिए उपयोग किया जाता है कि कोड परिवर्तन और हॉट रीलोड केवल आवश्यक फ़ाइलों पर लागू होते हैं। |
804
- | `excludedPath` | `string[]` | कंटेंट स्कैन से बाहर रखे गए पथ। डिफ़ॉल्ट: `['node_modules', '.intlayer', '.next', 'dist', 'build']` | `['src/styles']` | |
805
- | `formatCommand` | `string` | नई निर्मित या अपडेट की गई कंटेंट फ़ाइलों को फ़ॉर्मैट करने के लिए चलाया जाने वाला कमांड। डिफ़ॉल्ट: `undefined` | `'npx prettier --write "{{file}}"'` | कंटेंट निष्कर्षण के दौरान या विजुअल एडिटर के माध्यम से उपयोग किया जाता है। |
806
-
807
- ---
808
-
809
- ### डिक्शनरी कॉन्फ़िगरेशन (Dictionary Configuration)
810
-
811
- सेटिंग्स जो ऑटो-फिल व्यवहार और कंटेंट जनरेशन सहित डिक्शनरी संचालन को नियंत्रित करती हैं।
812
-
813
- इस डिक्शनरी कॉन्फ़िगरेशन के दो मुख्य उद्देश्य हैं:
814
-
815
- 1. **डिफ़ॉल्ट मान**: कंटेंट घोषणा फ़ाइलें बनाते समय डिफ़ॉल्ट मानों को परिभाषित करना।
816
- 2. **फ़ालबैक व्यवहार**: विशिष्ट फ़ील्ड परिभाषित न होने पर फ़ालबैक मान प्रदान करना, जिससे डिक्शनरी संचालन के व्यवहार को वैश्विक स्तर पर सेट किया जा सके।
817
-
818
- कंटेंट घोषणा फ़ाइलों और कॉन्फ़िगरेशन मानों को कैसे लागू किया जाता है, इसके बारे में अधिक जानकारी के लिए, [कंटेंट फ़ाइल दस्तावेज़](https://github.com/aymericzip/intlayer/blob/main/docs/docs/hi/dictionary/content_file.md) देखें।
819
-
820
- | फ़ील्ड | प्रकार | विवरण | उदाहरण | नोट |
821
- | --------------------------- | ----------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------ | ----------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
822
- | `fill` | `boolean &#124; FilePathPattern &#124; Partial<Record<Locale, boolean &#124; FilePathPattern>>` | ऑटो-फिल (AI अनुवाद) आउटपुट फ़ाइलें कैसे जेनरेट की जाती हैं, इसे नियंत्रित करता है। डिफ़ॉल्ट: `true` | नीचे उदाहरण देखें | `true`: डिफ़ॉल्ट पथ (स्रोत वाली ही फ़ाइल)। `false`: अक्षम। स्ट्रिंग/फ़ंक्शन टेम्प्लेट प्रति लोकेल फ़ाइलें जेनरेट करते हैं। प्रति-लोकेल ऑब्जेक्ट: प्रत्येक लोकेल अपने पैटर्न पर मैप होता है; `false` उस लोकेल को छोड़ देता है। `{{locale}}` को शामिल करने से प्रति-लोकेल जनरेशन ट्रिगर होता है। डिक्शनरी स्तर पर `fill` हमेशा इस वैश्विक कॉन्फ़िगरेशन पर प्राथमिकता लेता है। |
823
- | `importMode` | `'static' &#124; 'dynamic' &#124; 'fetch'` | डिक्शनरी को आयात करने के तरीके को नियंत्रित करता है। डिफ़ॉल्ट: `'static'` | `'dynamic'` | `'static'`: स्थिर रूप से आयातित। `'dynamic'`: 'Suspense' के माध्यम से गतिशील रूप से आयातित। `'fetch'`: 'Live Sync API' के माध्यम से गतिशील रूप से प्राप्त। `getIntlayer`, `getDictionary`, `useDictionary`, आदि को प्रभावित नहीं करता है। |
824
- | `location` | `'local' &#124; 'remote' &#124; 'hybrid' &#124; string` | डिक्शनरी कहाँ संग्रहीत हैं। डिफ़ॉल्ट: `'local'` | `'remote'` | `'local'`: फ़ाइल सिस्टम। `'remote'`: Intlayer CMS। `'hybrid'`: दोनों। |
825
- | `contentAutoTransformation` | `boolean` | क्या कंटेंट फ़ाइलों को स्वचालित रूप से रूपांतरित किया जाना चाहिए (जैसे: Markdown से HTML)। डिफ़ॉल्ट: `false` | `true` | @intlayer/markdown के माध्यम से मर्कडाउन फ़ील्ड को संसाधित करने के लिए उपयोगी। |
826
-
827
- **`fill` उदाहरण**:
828
-
829
- ```ts
830
- dictionary: {
831
- fill: {
832
- en: '/locales/en/{{key}}.content.json',
833
- fr: ({ key }) => `/locales/fr/${key}.content.json`,
834
- es: false,
835
- }
836
- }
837
- ```
838
-
839
- ---
840
-
841
- ### AI कॉन्फ़िगरेशन (AI Configuration)
842
-
843
- अनुवाद निर्माण जैसी Intlayer की AI-संचालित विशेषताओं के लिए सेटिंग्स को परिभाषित करता।
844
-
845
- | फ़ील्ड | प्रकार | विवरण | उदाहरण | नोट |
846
- | -------------------- | ---------------------- | ---------------------------------------------------------------------- | ------------------------------------------- | ----------------------------------------------------------------------------------------- |
847
- | `provider` | `string` | उपयोग किया जाने वाला AI प्रदाता। | `'openai'`, `'anthropic'`, `'googlevertex'` | |
848
- | `model` | `string` | उपयोग किया जाने वाला AI मॉडल। | `'gpt-4o'`, `'claude-3-5-sonnet-20240620'` | |
849
- | `apiKey` | `string` | चयनित प्रदाता के लिए एपीआई कुंजी। | `process.env.OPENAI_API_KEY` | |
850
- | `applicationContext` | `string` | AI अनुवाद सटीकता में सुधार के लिए आपके ऐप के बारे में अतिरिक्त संदर्भ। | `'बच्चों के लिए एक अध्ययन मंच।'` | |
851
- | `baseURL` | `string` | एपीआई कॉल के लिए वैकल्पिक बेस URL। | | यदि आप प्रॉक्सी या स्थानीय AI परिनियोजन (deployment) का उपयोग कर रहे हैं तो उपयोगी है। |
852
- | `dataSerialization` | `'json' &#124; 'toon'` | यह परिभाषित करता है कि AI को डेटा कैसे भेजा जाए। डिफ़ॉल्ट: `'json'` | `'json'` | `'json'`: अधिक मजबूत और सटीक। `'toon'`: कम टोकन की खपत करता है लेकिन कम स्थिर हो सकता है। |
853
-
854
- ---
855
-
856
- ### बिल्ड कॉन्फ़िगरेशन (Build Configuration)
857
-
858
- Intlayer बिल्ड प्रक्रिया और ऑप्टिमाइज़ेशन सेटिंग्स।
859
-
860
- | फ़ील्ड | प्रकार | विवरण | उदाहरण | नोट |
861
- | -------------- | ------------------------ | -------------------------------------------------------------------------------------------------------------------------------------- | ------ | --- |
862
- | `mode` | `'auto' &#124; 'manual'` | इंगित करता है कि ऐप के प्री-बिल्ड चरणों के दौरान Intlayer को स्वचालित रूप से चलना चाहिए या नहीं। डिफ़ॉल्ट: `'auto'` | | |
863
- | `optimize` | `boolean` | इंगित करता है कि संकलित (compiled) डिक्शनरी को रनटाइम के लिए ऑप्टिमाइज़ किया जाना चाहिए या नहीं। डिफ़ॉल्ट: प्रोडक्शन परिवेश में `true` | | |
864
- | `outputFormat` | `('cjs' &#124; 'esm')[]` | जनरेट की गई डिक्शनरी फ़ाइलों के लिए आउटपुट स्वरूप। डिफ़ॉल्ट: `['cjs', 'esm']` | | |
865
- | `checkTypes` | `boolean` | इंगित करता है कि क्या Intlayer को जनरेट की गई फ़ाइलों में प्रकारों (types) की जांच करनी चाहिए। डिफ़ॉल्ट: `false` | | |
866
-
867
- ---
868
-
869
- ### सिस्टम कॉन्फ़िगरेशन (System Configuration)
870
-
871
- ये सेटिंग्स उन्नत उपयोग के मामलों और Intlayer के आंतरिक कॉन्फ़िगरेशन के लिए हैं।
872
-
873
- | फ़ील्ड | प्रकार | विवरण | डिफ़ॉल्ट |
874
- | ------------------------- | -------- | ------------------------------------------- | --------------------------------- |
875
- | `dictionariesDir` | `string` | संकलित डिक्शनरी निर्देशिका। | `'.intlayer/dictionary'` |
876
- | `moduleAugmentationDir` | `string` | टाइपस्क्रिप्ट मॉड्यूल ऑगमेंटेशन निर्देशिका। | `'.intlayer/types'` |
877
- | `unmergedDictionariesDir` | `string` | विलय नहीं की गई डिक्शनरी निर्देशिका। | `'.intlayer/unmerged_dictionary'` |
878
- | `typesDir` | `string` | जनरेट की गई प्रकार निर्देशिका। | `'.intlayer/types'` |
879
- | `mainDir` | `string` | मुख्य Intlayer फ़ाइल निर्देशिका। | `'.intlayer/main'` |
880
- | `configDir` | `string` | संकलित कॉन्फ़िगरेशन फ़ाइल निर्देशिका। | `'.intlayer/config'` |
881
- | `cacheDir` | `string` | कैश फ़ाइल निर्देशिका। | `'.intlayer/cache'` |
882
-
883
- ---
884
-
885
- ### कंपाइलर कॉन्फ़िगरेशन (Compiler Configuration)
886
-
887
- Intlayer कंपाइलर (`intlayer compiler`) के लिए सेटिंग्स।
888
-
889
- | फ़ील्ड | प्रकार | विवरण | डिफ़ॉल्ट |
890
- | --------------------- | ------------------------ | ---------------------------------------------------------------------------------------------- | -------- |
891
- | `enabled` | `boolean` | इंगित करता है कि कंपाइलर सक्रिय है या नहीं। | `false` |
892
- | `output` | `string &#124; Function` | निकाले गए डिक्शनरी के लिए आउटपुट पथ। | |
893
- | `saveComponents` | `boolean` | इंगित करता है कि क्या रूपांतरित संस्करणों के साथ मूल स्रोत फ़ाइलों को ओवरराइट किया जाना चाहिए। | `false` |
894
- | `noMetadata` | `boolean` | यदि `true` है, तो कंपाइलर जनरेट की गई फ़ाइलों में मेटाडेटा शामिल नहीं करेगा। | `false` |
895
- | `dictionaryKeyPrefix` | `string` | वैकल्पिक डिक्शनरी की (key) प्रीफ़िक्स। | `''` |
896
-
897
- ---
898
-
899
- ### लॉगर कॉन्फ़िगरेशन (Logger Configuration)
900
-
901
- Intlayer लॉग आउटपुट को अनुकूलित करने की सेटिंग्स।
902
-
903
- | फ़ील्ड | प्रकार | विवरण | डिफ़ॉल्ट |
904
- | -------- | ---------------------------------------------- | --------------------- | -------------- |
905
- | `mode` | `'default' &#124; 'verbose' &#124; 'disabled'` | लॉगिंग मोड। | `'default'` |
906
- | `prefix` | `string` | लॉग संदेश प्रीफ़िक्स। | `'[intlayer]'` |
907
-
908
- ---
909
-
910
- ### कस्टम स्कीमा (Custom Schemas)
911
-
912
- | फ़ील्ड | प्रकार | विवरण |
913
- | --------- | --------------------------- | --------------------------------------------------------------------------------------------- |
914
- | `schemas` | `Record<string, ZodSchema>` | आपको अपनी डिक्शनरी की संरचना को मान्य करने के लिए Zod स्कीमा परिभाषित करने की अनुमति देता है। |
915
-
916
- ---
917
-
918
- ### प्लगइन्स (Plugins)
919
-
920
- | फ़ील्ड | प्रकार | विवरण |
921
- | --------- | ------------------ | ------------------------------------------- |
922
- | `plugins` | `IntlayerPlugin[]` | सक्रिय होने वाले Intlayer प्लगइन्स की सूची। |