@intlayer/docs 5.7.3 → 5.7.5
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/docs/ar/CI_CD.md +0 -1
- package/docs/ar/configuration.md +42 -5
- package/docs/ar/dictionary/enumeration.md +0 -1
- package/docs/de/CI_CD.md +0 -1
- package/docs/de/configuration.md +42 -5
- package/docs/en/configuration.md +42 -5
- package/docs/en-GB/configuration.md +42 -5
- package/docs/es/configuration.md +42 -5
- package/docs/es/dictionary/enumeration.md +0 -1
- package/docs/fr/configuration.md +44 -7
- package/docs/fr/intlayer_with_nextjs_15.md +0 -1
- package/docs/hi/configuration.md +42 -5
- package/docs/hi/dictionary/enumeration.md +0 -1
- package/docs/it/configuration.md +42 -5
- package/docs/it/dictionary/enumeration.md +0 -1
- package/docs/it/vs_code_extension.md +0 -1
- package/docs/ja/configuration.md +43 -28
- package/docs/ja/dictionary/enumeration.md +0 -1
- package/docs/ko/configuration.md +42 -5
- package/docs/ko/dictionary/enumeration.md +0 -1
- package/docs/pt/configuration.md +42 -5
- package/docs/ru/configuration.md +42 -5
- package/docs/ru/dictionary/enumeration.md +0 -1
- package/docs/ru/vs_code_extension.md +0 -1
- package/docs/zh/configuration.md +42 -5
- package/docs/zh/dictionary/enumeration.md +0 -1
- package/package.json +9 -9
package/docs/ar/CI_CD.md
CHANGED
package/docs/ar/configuration.md
CHANGED
|
@@ -272,10 +272,12 @@ module.exports = config;
|
|
|
272
272
|
- **prefixDefault**:
|
|
273
273
|
|
|
274
274
|
- _النوع_: `boolean`
|
|
275
|
-
- _الافتراضي_: `
|
|
275
|
+
- _الافتراضي_: `false`
|
|
276
276
|
- _الوصف_: ما إذا كان يجب تضمين اللغة الافتراضية في عنوان URL.
|
|
277
|
-
- _مثال_: `
|
|
278
|
-
- _ملاحظة_:
|
|
277
|
+
- _مثال_: `true`
|
|
278
|
+
- _ملاحظة_:
|
|
279
|
+
- إذا كانت القيمة `true` و `defaultLocale = 'en'`: path = `/en/dashboard` أو `/fr/dashboard`
|
|
280
|
+
- إذا كانت القيمة `false` و `defaultLocale = 'en'`: path = `/dashboard` أو `/fr/dashboard`
|
|
279
281
|
|
|
280
282
|
- **basePath**:
|
|
281
283
|
|
|
@@ -283,7 +285,11 @@ module.exports = config;
|
|
|
283
285
|
- _القيمة الافتراضية_: `''`
|
|
284
286
|
- _الوصف_: المسار الأساسي لعناوين URL الخاصة بالتطبيق.
|
|
285
287
|
- _مثال_: `'/my-app'`
|
|
286
|
-
- _ملاحظة_:
|
|
288
|
+
- _ملاحظة_:
|
|
289
|
+
- إذا كان التطبيق مستضافًا على `https://example.com/my-app`
|
|
290
|
+
- المسار الأساسي هو `'/my-app'`
|
|
291
|
+
- سيكون عنوان URL `https://example.com/my-app/en`
|
|
292
|
+
- إذا لم يتم تعيين المسار الأساسي، سيكون عنوان URL `https://example.com/en`
|
|
287
293
|
|
|
288
294
|
- **serverSetCookie**:
|
|
289
295
|
|
|
@@ -295,11 +301,42 @@ module.exports = config;
|
|
|
295
301
|
- _ملاحظة_: يتحكم في ما إذا كان يتم تعيين الكوكي الخاص باللغة مع كل طلب أو لا.
|
|
296
302
|
|
|
297
303
|
- **noPrefix**:
|
|
304
|
+
|
|
298
305
|
- _النوع_: `boolean`
|
|
299
306
|
- _القيمة الافتراضية_: `false`
|
|
300
307
|
- _الوصف_: ما إذا كان يجب حذف بادئة اللغة من عناوين URL.
|
|
301
308
|
- _مثال_: `true`
|
|
302
|
-
- _ملاحظة_:
|
|
309
|
+
- _ملاحظة_:
|
|
310
|
+
- إذا كانت القيمة `true`: لا توجد بادئة في عنوان URL
|
|
311
|
+
- إذا كانت القيمة `false`: توجد بادئة في عنوان URL
|
|
312
|
+
- مثال مع `basePath = '/my-app'`:
|
|
313
|
+
- إذا كانت `noPrefix = false`: سيكون عنوان URL `https://example.com/my-app/en`
|
|
314
|
+
- إذا كانت `noPrefix = true`: سيكون عنوان URL `https://example.com`
|
|
315
|
+
|
|
316
|
+
- **detectLocaleOnPrefetchNoPrefix**:
|
|
317
|
+
|
|
318
|
+
- _النوع_: `boolean`
|
|
319
|
+
- _القيمة الافتراضية_: `false`
|
|
320
|
+
- _الوصف_: يتحكم في ما إذا كان اكتشاف اللغة يحدث أثناء طلبات التحميل المسبق لـ Next.js.
|
|
321
|
+
- _مثال_: `true`
|
|
322
|
+
- _ملاحظة_: يؤثر هذا الإعداد على كيفية تعامل Next.js مع التحميل المسبق للغة:
|
|
323
|
+
- **سيناريو المثال:**
|
|
324
|
+
- لغة متصفح المستخدم هي `'fr'`
|
|
325
|
+
- الصفحة الحالية هي `/fr/about`
|
|
326
|
+
- الرابط يحمل مسبقًا `/about`
|
|
327
|
+
- **مع `detectLocaleOnPrefetchNoPrefix: true`:**
|
|
328
|
+
- التحميل المسبق يكتشف اللغة `'fr'` من المتصفح
|
|
329
|
+
- يعيد توجيه التحميل المسبق إلى `/fr/about`
|
|
330
|
+
- **مع `detectLocaleOnPrefetchNoPrefix: false` (الافتراضي):**
|
|
331
|
+
- التحميل المسبق يستخدم اللغة الافتراضية
|
|
332
|
+
- يعيد توجيه التحميل المسبق إلى `/en/about` (بافتراض أن `'en'` هي الافتراضية)
|
|
333
|
+
- **متى تستخدم `true`:**
|
|
334
|
+
- تطبيقك يستخدم روابط داخلية غير محلية (مثل `<a href="/about">`)
|
|
335
|
+
- تريد سلوك اكتشاف لغة متسق بين الطلبات العادية وطلبات التحميل المسبق
|
|
336
|
+
- **متى تستخدم `false` (الافتراضي):**
|
|
337
|
+
- تطبيقك يستخدم روابط ببادئة لغة (مثل `<a href="/fr/about">`)
|
|
338
|
+
- تريد تحسين أداء التحميل المسبق
|
|
339
|
+
- تريد تجنب حلقات إعادة التوجيه المحتملة
|
|
303
340
|
|
|
304
341
|
---
|
|
305
342
|
|
package/docs/de/CI_CD.md
CHANGED
package/docs/de/configuration.md
CHANGED
|
@@ -268,10 +268,12 @@ Einstellungen, die das Verhalten der Middleware steuern, einschließlich der Han
|
|
|
268
268
|
- **prefixDefault**:
|
|
269
269
|
|
|
270
270
|
- _Typ_: `boolean`
|
|
271
|
-
- _Standard_: `
|
|
271
|
+
- _Standard_: `false`
|
|
272
272
|
- _Beschreibung_: Ob die Standardsprache in der URL enthalten sein soll.
|
|
273
|
-
- _Beispiel_: `
|
|
274
|
-
- _Hinweis_:
|
|
273
|
+
- _Beispiel_: `true`
|
|
274
|
+
- _Hinweis_:
|
|
275
|
+
- Wenn `true` und `defaultLocale = 'en'`: path = `/en/dashboard` oder `/fr/dashboard`
|
|
276
|
+
- Wenn `false` und `defaultLocale = 'en'`: path = `/dashboard` oder `/fr/dashboard`
|
|
275
277
|
|
|
276
278
|
- **basePath**:
|
|
277
279
|
|
|
@@ -279,7 +281,11 @@ Einstellungen, die das Verhalten der Middleware steuern, einschließlich der Han
|
|
|
279
281
|
- _Standard_: `''`
|
|
280
282
|
- _Beschreibung_: Der Basis-Pfad für die Anwendungs-URLs.
|
|
281
283
|
- _Beispiel_: `'/my-app'`
|
|
282
|
-
- _Hinweis_:
|
|
284
|
+
- _Hinweis_:
|
|
285
|
+
- Wenn die Anwendung auf `https://example.com/my-app` gehostet wird
|
|
286
|
+
- Der Basis-Pfad ist `'/my-app'`
|
|
287
|
+
- Die URL wird `https://example.com/my-app/en` sein
|
|
288
|
+
- Wenn der Basis-Pfad nicht gesetzt ist, wird die URL `https://example.com/en` sein
|
|
283
289
|
|
|
284
290
|
- **serverSetCookie**:
|
|
285
291
|
|
|
@@ -291,11 +297,42 @@ Einstellungen, die das Verhalten der Middleware steuern, einschließlich der Han
|
|
|
291
297
|
- _Hinweis_: Steuert, ob das Sprach-Cookie bei jeder Anfrage oder nie gesetzt wird.
|
|
292
298
|
|
|
293
299
|
- **noPrefix**:
|
|
300
|
+
|
|
294
301
|
- _Typ_: `boolean`
|
|
295
302
|
- _Standard_: `false`
|
|
296
303
|
- _Beschreibung_: Ob das Sprachpräfix in URLs weggelassen werden soll.
|
|
297
304
|
- _Beispiel_: `true`
|
|
298
|
-
- _Hinweis_:
|
|
305
|
+
- _Hinweis_:
|
|
306
|
+
- Wenn `true`: Kein Präfix in der URL
|
|
307
|
+
- Wenn `false`: Präfix in der URL
|
|
308
|
+
- Beispiel mit `basePath = '/my-app'`:
|
|
309
|
+
- Wenn `noPrefix = false`: URL wird `https://example.com/my-app/en` sein
|
|
310
|
+
- Wenn `noPrefix = true`: URL wird `https://example.com` sein
|
|
311
|
+
|
|
312
|
+
- **detectLocaleOnPrefetchNoPrefix**:
|
|
313
|
+
|
|
314
|
+
- _Typ_: `boolean`
|
|
315
|
+
- _Standard_: `false`
|
|
316
|
+
- _Beschreibung_: Steuert, ob die Spracherkennung während Next.js Prefetch-Anfragen stattfindet.
|
|
317
|
+
- _Beispiel_: `true`
|
|
318
|
+
- _Hinweis_: Diese Einstellung beeinflusst, wie Next.js mit Sprach-Prefetching umgeht:
|
|
319
|
+
- **Beispielszenario:**
|
|
320
|
+
- Die Browsersprache des Benutzers ist `'fr'`
|
|
321
|
+
- Die aktuelle Seite ist `/fr/about`
|
|
322
|
+
- Link prefetcht `/about`
|
|
323
|
+
- **Mit `detectLocaleOnPrefetchNoPrefix: true`:**
|
|
324
|
+
- Prefetch erkennt `'fr'` Sprache vom Browser
|
|
325
|
+
- Leitet Prefetch zu `/fr/about` weiter
|
|
326
|
+
- **Mit `detectLocaleOnPrefetchNoPrefix: false` (Standard):**
|
|
327
|
+
- Prefetch verwendet Standardsprache
|
|
328
|
+
- Leitet Prefetch zu `/en/about` weiter (angenommen `'en'` ist Standard)
|
|
329
|
+
- **Wann `true` verwenden:**
|
|
330
|
+
- Ihre App verwendet nicht-lokalisierte interne Links (z.B. `<a href="/about">`)
|
|
331
|
+
- Sie möchten konsistentes Spracherkennungsverhalten zwischen normalen und Prefetch-Anfragen
|
|
332
|
+
- **Wann `false` verwenden (Standard):**
|
|
333
|
+
- Ihre App verwendet sprachpräfixierte Links (z.B. `<a href="/fr/about">`)
|
|
334
|
+
- Sie möchten Prefetching-Performance optimieren
|
|
335
|
+
- Sie möchten potenzielle Weiterleitungsschleifen vermeiden
|
|
299
336
|
|
|
300
337
|
---
|
|
301
338
|
|
package/docs/en/configuration.md
CHANGED
|
@@ -278,10 +278,12 @@ Settings that control middleware behavior, including how the application handles
|
|
|
278
278
|
- **prefixDefault**:
|
|
279
279
|
|
|
280
280
|
- _Type_: `boolean`
|
|
281
|
-
- _Default_: `
|
|
281
|
+
- _Default_: `false`
|
|
282
282
|
- _Description_: Whether to include the default locale in the URL.
|
|
283
|
-
- _Example_: `
|
|
284
|
-
- _Note_:
|
|
283
|
+
- _Example_: `true`
|
|
284
|
+
- _Note_:
|
|
285
|
+
- If `true` and `defaultLocale = 'en'`: path = `/en/dashboard` or `/fr/dashboard`
|
|
286
|
+
- If `false` and `defaultLocale = 'en'`: path = `/dashboard` or `/fr/dashboard`
|
|
285
287
|
|
|
286
288
|
- **basePath**:
|
|
287
289
|
|
|
@@ -289,7 +291,11 @@ Settings that control middleware behavior, including how the application handles
|
|
|
289
291
|
- _Default_: `''`
|
|
290
292
|
- _Description_: The base path for the application URLs.
|
|
291
293
|
- _Example_: `'/my-app'`
|
|
292
|
-
- _Note_:
|
|
294
|
+
- _Note_:
|
|
295
|
+
- If the application is hosted at `https://example.com/my-app`
|
|
296
|
+
- The base path is `'/my-app'`
|
|
297
|
+
- The URL will be `https://example.com/my-app/en`
|
|
298
|
+
- If the base path is not set, the URL will be `https://example.com/en`
|
|
293
299
|
|
|
294
300
|
- **serverSetCookie**:
|
|
295
301
|
|
|
@@ -301,11 +307,42 @@ Settings that control middleware behavior, including how the application handles
|
|
|
301
307
|
- _Note_: Controls whether the locale cookie is set on every request or never.
|
|
302
308
|
|
|
303
309
|
- **noPrefix**:
|
|
310
|
+
|
|
304
311
|
- _Type_: `boolean`
|
|
305
312
|
- _Default_: `false`
|
|
306
313
|
- _Description_: Whether to omit the locale prefix from URLs.
|
|
307
314
|
- _Example_: `true`
|
|
308
|
-
- _Note_:
|
|
315
|
+
- _Note_:
|
|
316
|
+
- If `true`: No prefix in the URL
|
|
317
|
+
- If `false`: Prefix in the URL
|
|
318
|
+
- Example with `basePath = '/my-app'`:
|
|
319
|
+
- If `noPrefix = false`: URL will be `https://example.com/my-app/en`
|
|
320
|
+
- If `noPrefix = true`: URL will be `https://example.com`
|
|
321
|
+
|
|
322
|
+
- **detectLocaleOnPrefetchNoPrefix**:
|
|
323
|
+
|
|
324
|
+
- _Type_: `boolean`
|
|
325
|
+
- _Default_: `false`
|
|
326
|
+
- _Description_: Controls whether locale detection occurs during Next.js prefetch requests.
|
|
327
|
+
- _Example_: `true`
|
|
328
|
+
- _Note_: This setting affects how Next.js handles locale prefetching:
|
|
329
|
+
- **Example scenario:**
|
|
330
|
+
- User's browser language is `'fr'`
|
|
331
|
+
- Current page is `/fr/about`
|
|
332
|
+
- Link prefetches `/about`
|
|
333
|
+
- **With `detectLocaleOnPrefetchNoPrefix: true`:**
|
|
334
|
+
- Prefetch detects `'fr'` locale from browser
|
|
335
|
+
- Redirects prefetch to `/fr/about`
|
|
336
|
+
- **With `detectLocaleOnPrefetchNoPrefix: false` (default):**
|
|
337
|
+
- Prefetch uses default locale
|
|
338
|
+
- Redirects prefetch to `/en/about` (assuming `'en'` is default)
|
|
339
|
+
- **When to use `true`:**
|
|
340
|
+
- Your app uses non-localized internal links (e.g. `<a href="/about">`)
|
|
341
|
+
- You want consistent locale detection behavior between regular and prefetch requests
|
|
342
|
+
- **When to use `false` (default):**
|
|
343
|
+
- Your app uses locale-prefixed links (e.g. `<a href="/fr/about">`)
|
|
344
|
+
- You want to optimize prefetching performance
|
|
345
|
+
- You want to avoid potential redirect loops
|
|
309
346
|
|
|
310
347
|
---
|
|
311
348
|
|
|
@@ -268,10 +268,12 @@ Settings that control middleware behaviour, including how the application handle
|
|
|
268
268
|
- **prefixDefault**:
|
|
269
269
|
|
|
270
270
|
- _Type_: `boolean`
|
|
271
|
-
- _Default_: `
|
|
271
|
+
- _Default_: `false`
|
|
272
272
|
- _Description_: Whether to include the default locale in the URL.
|
|
273
|
-
- _Example_: `
|
|
274
|
-
- _Note_:
|
|
273
|
+
- _Example_: `true`
|
|
274
|
+
- _Note_:
|
|
275
|
+
- If `true` and `defaultLocale = 'en'`: path = `/en/dashboard` or `/fr/dashboard`
|
|
276
|
+
- If `false` and `defaultLocale = 'en'`: path = `/dashboard` or `/fr/dashboard`
|
|
275
277
|
|
|
276
278
|
- **basePath**:
|
|
277
279
|
|
|
@@ -279,7 +281,11 @@ Settings that control middleware behaviour, including how the application handle
|
|
|
279
281
|
- _Default_: `''`
|
|
280
282
|
- _Description_: The base path for the application URLs.
|
|
281
283
|
- _Example_: `'/my-app'`
|
|
282
|
-
- _Note_:
|
|
284
|
+
- _Note_:
|
|
285
|
+
- If the application is hosted at `https://example.com/my-app`
|
|
286
|
+
- The base path is `'/my-app'`
|
|
287
|
+
- The URL will be `https://example.com/my-app/en`
|
|
288
|
+
- If the base path is not set, the URL will be `https://example.com/en`
|
|
283
289
|
|
|
284
290
|
- **serverSetCookie**:
|
|
285
291
|
|
|
@@ -291,11 +297,42 @@ Settings that control middleware behaviour, including how the application handle
|
|
|
291
297
|
- _Note_: Controls whether the locale cookie is set on every request or never.
|
|
292
298
|
|
|
293
299
|
- **noPrefix**:
|
|
300
|
+
|
|
294
301
|
- _Type_: `boolean`
|
|
295
302
|
- _Default_: `false`
|
|
296
303
|
- _Description_: Whether to omit the locale prefix from URLs.
|
|
297
304
|
- _Example_: `true`
|
|
298
|
-
- _Note_:
|
|
305
|
+
- _Note_:
|
|
306
|
+
- If `true`: No prefix in the URL
|
|
307
|
+
- If `false`: Prefix in the URL
|
|
308
|
+
- Example with `basePath = '/my-app'`:
|
|
309
|
+
- If `noPrefix = false`: URL will be `https://example.com/my-app/en`
|
|
310
|
+
- If `noPrefix = true`: URL will be `https://example.com`
|
|
311
|
+
|
|
312
|
+
- **detectLocaleOnPrefetchNoPrefix**:
|
|
313
|
+
|
|
314
|
+
- _Type_: `boolean`
|
|
315
|
+
- _Default_: `false`
|
|
316
|
+
- _Description_: Controls whether locale detection occurs during Next.js prefetch requests.
|
|
317
|
+
- _Example_: `true`
|
|
318
|
+
- _Note_: This setting affects how Next.js handles locale prefetching:
|
|
319
|
+
- **Example scenario:**
|
|
320
|
+
- User's browser language is `'fr'`
|
|
321
|
+
- Current page is `/fr/about`
|
|
322
|
+
- Link prefetches `/about`
|
|
323
|
+
- **With `detectLocaleOnPrefetchNoPrefix: true`:**
|
|
324
|
+
- Prefetch detects `'fr'` locale from browser
|
|
325
|
+
- Redirects prefetch to `/fr/about`
|
|
326
|
+
- **With `detectLocaleOnPrefetchNoPrefix: false` (default):**
|
|
327
|
+
- Prefetch uses default locale
|
|
328
|
+
- Redirects prefetch to `/en/about` (assuming `'en'` is default)
|
|
329
|
+
- **When to use `true`:**
|
|
330
|
+
- Your app uses non-localised internal links (e.g. `<a href="/about">`)
|
|
331
|
+
- You want consistent locale detection behaviour between regular and prefetch requests
|
|
332
|
+
- **When to use `false` (default):**
|
|
333
|
+
- Your app uses locale-prefixed links (e.g. `<a href="/fr/about">`)
|
|
334
|
+
- You want to optimise prefetching performance
|
|
335
|
+
- You want to avoid potential redirect loops
|
|
299
336
|
|
|
300
337
|
---
|
|
301
338
|
|
package/docs/es/configuration.md
CHANGED
|
@@ -268,10 +268,12 @@ Configuraciones que controlan el comportamiento del middleware, incluyendo cómo
|
|
|
268
268
|
- **prefixDefault**:
|
|
269
269
|
|
|
270
270
|
- _Tipo_: `boolean`
|
|
271
|
-
- _Por defecto_: `
|
|
271
|
+
- _Por defecto_: `false`
|
|
272
272
|
- _Descripción_: Indica si se debe incluir la configuración regional predeterminada en la URL.
|
|
273
|
-
- _Ejemplo_: `
|
|
274
|
-
- _Nota_:
|
|
273
|
+
- _Ejemplo_: `true`
|
|
274
|
+
- _Nota_:
|
|
275
|
+
- Si `true` y `defaultLocale = 'en'`: path = `/en/dashboard` o `/fr/dashboard`
|
|
276
|
+
- Si `false` y `defaultLocale = 'en'`: path = `/dashboard` o `/fr/dashboard`
|
|
275
277
|
|
|
276
278
|
- **basePath**:
|
|
277
279
|
|
|
@@ -279,7 +281,11 @@ Configuraciones que controlan el comportamiento del middleware, incluyendo cómo
|
|
|
279
281
|
- _Por defecto_: `''`
|
|
280
282
|
- _Descripción_: La ruta base para las URLs de la aplicación.
|
|
281
283
|
- _Ejemplo_: `'/my-app'`
|
|
282
|
-
- _Nota_:
|
|
284
|
+
- _Nota_:
|
|
285
|
+
- Si la aplicación está alojada en `https://example.com/my-app`
|
|
286
|
+
- La ruta base es `'/my-app'`
|
|
287
|
+
- La URL será `https://example.com/my-app/en`
|
|
288
|
+
- Si la ruta base no está configurada, la URL será `https://example.com/en`
|
|
283
289
|
|
|
284
290
|
- **serverSetCookie**:
|
|
285
291
|
|
|
@@ -291,11 +297,42 @@ Configuraciones que controlan el comportamiento del middleware, incluyendo cómo
|
|
|
291
297
|
- _Nota_: Controla si la cookie de configuración regional se establece en cada solicitud o nunca.
|
|
292
298
|
|
|
293
299
|
- **noPrefix**:
|
|
300
|
+
|
|
294
301
|
- _Tipo_: `boolean`
|
|
295
302
|
- _Por defecto_: `false`
|
|
296
303
|
- _Descripción_: Indica si se debe omitir el prefijo de configuración regional en las URLs.
|
|
297
304
|
- _Ejemplo_: `true`
|
|
298
|
-
- _Nota_:
|
|
305
|
+
- _Nota_:
|
|
306
|
+
- Si `true`: Sin prefijo en la URL
|
|
307
|
+
- Si `false`: Prefijo en la URL
|
|
308
|
+
- Ejemplo con `basePath = '/my-app'`:
|
|
309
|
+
- Si `noPrefix = false`: La URL será `https://example.com/my-app/en`
|
|
310
|
+
- Si `noPrefix = true`: La URL será `https://example.com`
|
|
311
|
+
|
|
312
|
+
- **detectLocaleOnPrefetchNoPrefix**:
|
|
313
|
+
|
|
314
|
+
- _Tipo_: `boolean`
|
|
315
|
+
- _Por defecto_: `false`
|
|
316
|
+
- _Descripción_: Controla si la detección de configuración regional ocurre durante las solicitudes de precarga de Next.js.
|
|
317
|
+
- _Ejemplo_: `true`
|
|
318
|
+
- _Nota_: Esta configuración afecta cómo Next.js maneja la precarga de configuración regional:
|
|
319
|
+
- **Escenario de ejemplo:**
|
|
320
|
+
- El idioma del navegador del usuario es `'fr'`
|
|
321
|
+
- La página actual es `/fr/about`
|
|
322
|
+
- El enlace precarga `/about`
|
|
323
|
+
- **Con `detectLocaleOnPrefetchNoPrefix: true`:**
|
|
324
|
+
- La precarga detecta la configuración regional `'fr'` desde el navegador
|
|
325
|
+
- Redirige la precarga a `/fr/about`
|
|
326
|
+
- **Con `detectLocaleOnPrefetchNoPrefix: false` (por defecto):**
|
|
327
|
+
- La precarga usa la configuración regional predeterminada
|
|
328
|
+
- Redirige la precarga a `/en/about` (asumiendo que `'en'` es la predeterminada)
|
|
329
|
+
- **Cuándo usar `true`:**
|
|
330
|
+
- Tu aplicación usa enlaces internos no localizados (ej. `<a href="/about">`)
|
|
331
|
+
- Quieres comportamiento consistente de detección de configuración regional entre solicitudes normales y de precarga
|
|
332
|
+
- **Cuándo usar `false` (por defecto):**
|
|
333
|
+
- Tu aplicación usa enlaces con prefijo de configuración regional (ej. `<a href="/fr/about">`)
|
|
334
|
+
- Quieres optimizar el rendimiento de precarga
|
|
335
|
+
- Quieres evitar bucles de redirección potenciales
|
|
299
336
|
|
|
300
337
|
---
|
|
301
338
|
|
package/docs/fr/configuration.md
CHANGED
|
@@ -268,10 +268,12 @@ Paramètres qui contrôlent le comportement du middleware, y compris la gestion
|
|
|
268
268
|
- **prefixDefault** :
|
|
269
269
|
|
|
270
270
|
- _Type_ : `boolean`
|
|
271
|
-
- _Par défaut_ : `
|
|
272
|
-
- _Description_ : Indique s
|
|
273
|
-
- _Exemple_ : `
|
|
274
|
-
- _Remarque_ :
|
|
271
|
+
- _Par défaut_ : `false`
|
|
272
|
+
- _Description_ : Indique s'il faut inclure la langue par défaut dans l'URL.
|
|
273
|
+
- _Exemple_ : `true`
|
|
274
|
+
- _Remarque_ :
|
|
275
|
+
- Si `true` et `defaultLocale = 'en'` : path = `/en/dashboard` ou `/fr/dashboard`
|
|
276
|
+
- Si `false` et `defaultLocale = 'en'` : path = `/dashboard` ou `/fr/dashboard`
|
|
275
277
|
|
|
276
278
|
- **basePath** :
|
|
277
279
|
|
|
@@ -279,7 +281,11 @@ Paramètres qui contrôlent le comportement du middleware, y compris la gestion
|
|
|
279
281
|
- _Par défaut_ : `''`
|
|
280
282
|
- _Description_ : Le chemin de base pour les URL de l'application.
|
|
281
283
|
- _Exemple_ : `'/my-app'`
|
|
282
|
-
- _Remarque_ :
|
|
284
|
+
- _Remarque_ :
|
|
285
|
+
- Si l'application est hébergée sur `https://example.com/my-app`
|
|
286
|
+
- Le chemin de base est `'/my-app'`
|
|
287
|
+
- L'URL sera `https://example.com/my-app/en`
|
|
288
|
+
- Si le chemin de base n'est pas défini, l'URL sera `https://example.com/en`
|
|
283
289
|
|
|
284
290
|
- **serverSetCookie** :
|
|
285
291
|
|
|
@@ -291,11 +297,42 @@ Paramètres qui contrôlent le comportement du middleware, y compris la gestion
|
|
|
291
297
|
- _Remarque_ : Contrôle si le cookie de langue est défini à chaque requête ou jamais.
|
|
292
298
|
|
|
293
299
|
- **noPrefix** :
|
|
300
|
+
|
|
301
|
+
- _Type_ : `boolean`
|
|
302
|
+
- _Par défaut_ : `false`
|
|
303
|
+
- _Description_ : Indique s'il faut omettre le préfixe de langue dans les URL.
|
|
304
|
+
- _Exemple_ : `true`
|
|
305
|
+
- _Remarque_ :
|
|
306
|
+
- Si `true` : Pas de préfixe dans l'URL
|
|
307
|
+
- Si `false` : Préfixe dans l'URL
|
|
308
|
+
- Exemple avec `basePath = '/my-app'` :
|
|
309
|
+
- Si `noPrefix = false` : L'URL sera `https://example.com/my-app/en`
|
|
310
|
+
- Si `noPrefix = true` : L'URL sera `https://example.com`
|
|
311
|
+
|
|
312
|
+
- **detectLocaleOnPrefetchNoPrefix** :
|
|
313
|
+
|
|
294
314
|
- _Type_ : `boolean`
|
|
295
315
|
- _Par défaut_ : `false`
|
|
296
|
-
- _Description_ :
|
|
316
|
+
- _Description_ : Contrôle si la détection de langue se produit lors des requêtes de préchargement Next.js.
|
|
297
317
|
- _Exemple_ : `true`
|
|
298
|
-
- _Remarque_ :
|
|
318
|
+
- _Remarque_ : Ce paramètre affecte la façon dont Next.js gère le préchargement de langue :
|
|
319
|
+
- **Scénario d'exemple :**
|
|
320
|
+
- La langue du navigateur de l'utilisateur est `'fr'`
|
|
321
|
+
- La page actuelle est `/fr/about`
|
|
322
|
+
- Le lien précharge `/about`
|
|
323
|
+
- **Avec `detectLocaleOnPrefetchNoPrefix: true` :**
|
|
324
|
+
- Le préchargement détecte la langue `'fr'` depuis le navigateur
|
|
325
|
+
- Redirige le préchargement vers `/fr/about`
|
|
326
|
+
- **Avec `detectLocaleOnPrefetchNoPrefix: false` (par défaut) :**
|
|
327
|
+
- Le préchargement utilise la langue par défaut
|
|
328
|
+
- Redirige le préchargement vers `/en/about` (en supposant que `'en'` est la langue par défaut)
|
|
329
|
+
- **Quand utiliser `true` :**
|
|
330
|
+
- Votre application utilise des liens internes non localisés (ex. `<a href="/about">`)
|
|
331
|
+
- Vous voulez un comportement de détection de langue cohérent entre les requêtes normales et de préchargement
|
|
332
|
+
- **Quand utiliser `false` (par défaut) :**
|
|
333
|
+
- Votre application utilise des liens avec préfixe de langue (ex. `<a href="/fr/about">`)
|
|
334
|
+
- Vous voulez optimiser les performances de préchargement
|
|
335
|
+
- Vous voulez éviter les boucles de redirection potentielles
|
|
299
336
|
|
|
300
337
|
---
|
|
301
338
|
|
package/docs/hi/configuration.md
CHANGED
|
@@ -270,10 +270,12 @@ module.exports = config;
|
|
|
270
270
|
- **prefixDefault**:
|
|
271
271
|
|
|
272
272
|
- _प्रकार_: `boolean`
|
|
273
|
-
- _डिफ़ॉल्ट_: `
|
|
273
|
+
- _डिफ़ॉल्ट_: `false`
|
|
274
274
|
- _विवरण_: क्या URL में डिफ़ॉल्ट लोकेल शामिल करना है।
|
|
275
|
-
- _उदाहरण_: `
|
|
276
|
-
- _नोट_:
|
|
275
|
+
- _उदाहरण_: `true`
|
|
276
|
+
- _नोट_:
|
|
277
|
+
- यदि `true` और `defaultLocale = 'en'`: path = `/en/dashboard` या `/fr/dashboard`
|
|
278
|
+
- यदि `false` और `defaultLocale = 'en'`: path = `/dashboard` या `/fr/dashboard`
|
|
277
279
|
|
|
278
280
|
- **basePath**:
|
|
279
281
|
|
|
@@ -281,7 +283,11 @@ module.exports = config;
|
|
|
281
283
|
- _डिफ़ॉल्ट_: `''`
|
|
282
284
|
- _विवरण_: एप्लिकेशन URL के लिए बेस पथ।
|
|
283
285
|
- _उदाहरण_: `'/my-app'`
|
|
284
|
-
- _नोट_:
|
|
286
|
+
- _नोट_:
|
|
287
|
+
- यदि एप्लिकेशन `https://example.com/my-app` पर होस्ट की गई है
|
|
288
|
+
- बेस पथ `'/my-app'` है
|
|
289
|
+
- URL `https://example.com/my-app/en` होगा
|
|
290
|
+
- यदि बेस पथ सेट नहीं है, तो URL `https://example.com/en` होगा
|
|
285
291
|
|
|
286
292
|
- **serverSetCookie**:
|
|
287
293
|
|
|
@@ -293,11 +299,42 @@ module.exports = config;
|
|
|
293
299
|
- _नोट_: नियंत्रित करता है कि लोकेल कुकी हर अनुरोध पर सेट की जाए या कभी नहीं।
|
|
294
300
|
|
|
295
301
|
- **noPrefix**:
|
|
302
|
+
|
|
296
303
|
- _प्रकार_: `boolean`
|
|
297
304
|
- _डिफ़ॉल्ट_: `false`
|
|
298
305
|
- _विवरण_: क्या URL से लोकेल प्रीफ़िक्स हटाना है।
|
|
299
306
|
- _उदाहरण_: `true`
|
|
300
|
-
- _नोट_:
|
|
307
|
+
- _नोट_:
|
|
308
|
+
- यदि `true`: URL में कोई प्रीफ़िक्स नहीं
|
|
309
|
+
- यदि `false`: URL में प्रीफ़िक्स है
|
|
310
|
+
- `basePath = '/my-app'` के साथ उदाहरण:
|
|
311
|
+
- यदि `noPrefix = false`: URL `https://example.com/my-app/en` होगा
|
|
312
|
+
- यदि `noPrefix = true`: URL `https://example.com` होगा
|
|
313
|
+
|
|
314
|
+
- **detectLocaleOnPrefetchNoPrefix**:
|
|
315
|
+
|
|
316
|
+
- _प्रकार_: `boolean`
|
|
317
|
+
- _डिफ़ॉल्ट_: `false`
|
|
318
|
+
- _विवरण_: नियंत्रित करता है कि Next.js प्रीफ़ेच अनुरोधों के दौरान लोकेल पता लगाना होता है या नहीं।
|
|
319
|
+
- _उदाहरण_: `true`
|
|
320
|
+
- _नोट_: यह सेटिंग प्रभावित करती है कि Next.js लोकेल प्रीफ़ेचिंग को कैसे संभालता है:
|
|
321
|
+
- **उदाहरण परिदृश्य:**
|
|
322
|
+
- उपयोगकर्ता का ब्राउज़र भाषा `'fr'` है
|
|
323
|
+
- वर्तमान पृष्ठ `/fr/about` है
|
|
324
|
+
- लिंक प्रीफ़ेच करता है `/about`
|
|
325
|
+
- **`detectLocaleOnPrefetchNoPrefix: true` के साथ:**
|
|
326
|
+
- प्रीफ़ेच ब्राउज़र से `'fr'` लोकेल का पता लगाता है
|
|
327
|
+
- प्रीफ़ेच को `/fr/about` पर रीडायरेक्ट करता है
|
|
328
|
+
- **`detectLocaleOnPrefetchNoPrefix: false` (डिफ़ॉल्ट) के साथ:**
|
|
329
|
+
- प्रीफ़ेच डिफ़ॉल्ट लोकेल का उपयोग करता है
|
|
330
|
+
- प्रीफ़ेच को `/en/about` पर रीडायरेक्ट करता है (यह मानते हुए कि `'en'` डिफ़ॉल्ट है)
|
|
331
|
+
- **कब `true` का उपयोग करें:**
|
|
332
|
+
- आपका ऐप गैर-स्थानीयकृत आंतरिक लिंक का उपयोग करता है (जैसे `<a href="/about">`)
|
|
333
|
+
- आप सामान्य और प्रीफ़ेच अनुरोधों के बीच सुसंगत लोकेल पता लगाने का व्यवहार चाहते हैं
|
|
334
|
+
- **कब `false` (डिफ़ॉल्ट) का उपयोग करें:**
|
|
335
|
+
- आपका ऐप लोकेल-प्रीफ़िक्स वाले लिंक का उपयोग करता है (जैसे `<a href="/fr/about">`)
|
|
336
|
+
- आप प्रीफ़ेचिंग प्रदर्शन को अनुकूलित करना चाहते हैं
|
|
337
|
+
- आप संभावित रीडायरेक्ट लूप से बचना चाहते हैं
|
|
301
338
|
|
|
302
339
|
---
|
|
303
340
|
|
package/docs/it/configuration.md
CHANGED
|
@@ -268,10 +268,12 @@ Impostazioni che controllano il comportamento del middleware, inclusa la gestion
|
|
|
268
268
|
- **prefixDefault**:
|
|
269
269
|
|
|
270
270
|
- _Tipo_: `boolean`
|
|
271
|
-
- _Predefinito_: `
|
|
271
|
+
- _Predefinito_: `false`
|
|
272
272
|
- _Descrizione_: Indica se includere il locale predefinito nell'URL.
|
|
273
|
-
- _Esempio_: `
|
|
274
|
-
- _Nota_:
|
|
273
|
+
- _Esempio_: `true`
|
|
274
|
+
- _Nota_:
|
|
275
|
+
- Se `true` e `defaultLocale = 'en'`: path = `/en/dashboard` o `/fr/dashboard`
|
|
276
|
+
- Se `false` e `defaultLocale = 'en'`: path = `/dashboard` o `/fr/dashboard`
|
|
275
277
|
|
|
276
278
|
- **basePath**:
|
|
277
279
|
|
|
@@ -279,7 +281,11 @@ Impostazioni che controllano il comportamento del middleware, inclusa la gestion
|
|
|
279
281
|
- _Predefinito_: `''`
|
|
280
282
|
- _Descrizione_: Il percorso base per gli URL dell'applicazione.
|
|
281
283
|
- _Esempio_: `'/my-app'`
|
|
282
|
-
- _Nota_:
|
|
284
|
+
- _Nota_:
|
|
285
|
+
- Se l'applicazione è ospitata su `https://example.com/my-app`
|
|
286
|
+
- Il percorso base è `'/my-app'`
|
|
287
|
+
- L'URL sarà `https://example.com/my-app/en`
|
|
288
|
+
- Se il percorso base non è impostato, l'URL sarà `https://example.com/en`
|
|
283
289
|
|
|
284
290
|
- **serverSetCookie**:
|
|
285
291
|
|
|
@@ -291,11 +297,42 @@ Impostazioni che controllano il comportamento del middleware, inclusa la gestion
|
|
|
291
297
|
- _Nota_: Controlla se il cookie della lingua viene impostato su ogni richiesta o mai.
|
|
292
298
|
|
|
293
299
|
- **noPrefix**:
|
|
300
|
+
|
|
294
301
|
- _Tipo_: `boolean`
|
|
295
302
|
- _Predefinito_: `false`
|
|
296
303
|
- _Descrizione_: Indica se omettere il prefisso della lingua dagli URL.
|
|
297
304
|
- _Esempio_: `true`
|
|
298
|
-
- _Nota_:
|
|
305
|
+
- _Nota_:
|
|
306
|
+
- Se `true`: Nessun prefisso nell'URL
|
|
307
|
+
- Se `false`: Prefisso nell'URL
|
|
308
|
+
- Esempio con `basePath = '/my-app'`:
|
|
309
|
+
- Se `noPrefix = false`: L'URL sarà `https://example.com/my-app/en`
|
|
310
|
+
- Se `noPrefix = true`: L'URL sarà `https://example.com`
|
|
311
|
+
|
|
312
|
+
- **detectLocaleOnPrefetchNoPrefix**:
|
|
313
|
+
|
|
314
|
+
- _Tipo_: `boolean`
|
|
315
|
+
- _Predefinito_: `false`
|
|
316
|
+
- _Descrizione_: Controlla se la rilevazione del locale avviene durante le richieste di prefetch di Next.js.
|
|
317
|
+
- _Esempio_: `true`
|
|
318
|
+
- _Nota_: Questa impostazione influisce su come Next.js gestisce il prefetch del locale:
|
|
319
|
+
- **Scenario di esempio:**
|
|
320
|
+
- La lingua del browser dell'utente è `'fr'`
|
|
321
|
+
- La pagina corrente è `/fr/about`
|
|
322
|
+
- Il link fa prefetch di `/about`
|
|
323
|
+
- **Con `detectLocaleOnPrefetchNoPrefix: true`:**
|
|
324
|
+
- Il prefetch rileva il locale `'fr'` dal browser
|
|
325
|
+
- Reindirizza il prefetch a `/fr/about`
|
|
326
|
+
- **Con `detectLocaleOnPrefetchNoPrefix: false` (predefinito):**
|
|
327
|
+
- Il prefetch usa il locale predefinito
|
|
328
|
+
- Reindirizza il prefetch a `/en/about` (assumendo che `'en'` sia il predefinito)
|
|
329
|
+
- **Quando usare `true`:**
|
|
330
|
+
- La tua app usa link interni non localizzati (es. `<a href="/about">`)
|
|
331
|
+
- Vuoi un comportamento di rilevazione del locale coerente tra richieste normali e di prefetch
|
|
332
|
+
- **Quando usare `false` (predefinito):**
|
|
333
|
+
- La tua app usa link con prefisso del locale (es. `<a href="/fr/about">`)
|
|
334
|
+
- Vuoi ottimizzare le prestazioni del prefetch
|
|
335
|
+
- Vuoi evitare potenziali loop di reindirizzamento
|
|
299
336
|
|
|
300
337
|
---
|
|
301
338
|
|
package/docs/ja/configuration.md
CHANGED
|
@@ -268,10 +268,12 @@ module.exports = config;
|
|
|
268
268
|
- **prefixDefault**:
|
|
269
269
|
|
|
270
270
|
- _型_: `boolean`
|
|
271
|
-
- _デフォルト_: `
|
|
271
|
+
- _デフォルト_: `false`
|
|
272
272
|
- _説明_: デフォルトのロケールをURLに含めるかどうか。
|
|
273
|
-
- _例_: `
|
|
274
|
-
- _注意_:
|
|
273
|
+
- _例_: `true`
|
|
274
|
+
- _注意_:
|
|
275
|
+
- `true`で`defaultLocale = 'en'`の場合: path = `/en/dashboard`または`/fr/dashboard`
|
|
276
|
+
- `false`で`defaultLocale = 'en'`の場合: path = `/dashboard`または`/fr/dashboard`
|
|
275
277
|
|
|
276
278
|
- **basePath**:
|
|
277
279
|
|
|
@@ -279,7 +281,11 @@ module.exports = config;
|
|
|
279
281
|
- _デフォルト_: `''`
|
|
280
282
|
- _説明_: アプリケーションURLのベースパス。
|
|
281
283
|
- _例_: `'/my-app'`
|
|
282
|
-
- _注意_:
|
|
284
|
+
- _注意_:
|
|
285
|
+
- アプリケーションが`https://example.com/my-app`でホストされている場合
|
|
286
|
+
- ベースパスは`'/my-app'`
|
|
287
|
+
- URLは`https://example.com/my-app/en`になります
|
|
288
|
+
- ベースパスが設定されていない場合、URLは`https://example.com/en`になります
|
|
283
289
|
|
|
284
290
|
- **serverSetCookie**:
|
|
285
291
|
|
|
@@ -291,11 +297,42 @@ module.exports = config;
|
|
|
291
297
|
- _注意_: ロケールクッキーをすべてのリクエストで設定するか、まったく設定しないかを制御します。
|
|
292
298
|
|
|
293
299
|
- **noPrefix**:
|
|
300
|
+
|
|
294
301
|
- _型_: `boolean`
|
|
295
302
|
- _デフォルト_: `false`
|
|
296
303
|
- _説明_: URLからロケールプレフィックスを省略するかどうか。
|
|
297
304
|
- _例_: `true`
|
|
298
|
-
- _注意_:
|
|
305
|
+
- _注意_:
|
|
306
|
+
- `true`の場合: URLにプレフィックスなし
|
|
307
|
+
- `false`の場合: URLにプレフィックスあり
|
|
308
|
+
- `basePath = '/my-app'`の例:
|
|
309
|
+
- `noPrefix = false`の場合: URLは`https://example.com/my-app/en`になります
|
|
310
|
+
- `noPrefix = true`の場合: URLは`https://example.com`になります
|
|
311
|
+
|
|
312
|
+
- **detectLocaleOnPrefetchNoPrefix**:
|
|
313
|
+
|
|
314
|
+
- _型_: `boolean`
|
|
315
|
+
- _デフォルト_: `false`
|
|
316
|
+
- _説明_: Next.jsのプリフェッチリクエスト中にロケール検出が行われるかどうかを制御します。
|
|
317
|
+
- _例_: `true`
|
|
318
|
+
- _注意_: この設定はNext.jsがロケールプリフェッチを処理する方法に影響します:
|
|
319
|
+
- **例のシナリオ:**
|
|
320
|
+
- ユーザーのブラウザ言語は`'fr'`
|
|
321
|
+
- 現在のページは`/fr/about`
|
|
322
|
+
- リンクが`/about`をプリフェッチ
|
|
323
|
+
- **`detectLocaleOnPrefetchNoPrefix: true`の場合:**
|
|
324
|
+
- プリフェッチがブラウザから`'fr'`ロケールを検出
|
|
325
|
+
- プリフェッチを`/fr/about`にリダイレクト
|
|
326
|
+
- **`detectLocaleOnPrefetchNoPrefix: false`(デフォルト)の場合:**
|
|
327
|
+
- プリフェッチがデフォルトロケールを使用
|
|
328
|
+
- プリフェッチを`/en/about`にリダイレクト(`'en'`がデフォルトと仮定)
|
|
329
|
+
- **`true`を使用する場合:**
|
|
330
|
+
- アプリが非ローカライズされた内部リンクを使用する場合(例: `<a href="/about">`)
|
|
331
|
+
- 通常のリクエストとプリフェッチリクエスト間で一貫したロケール検出動作を望む場合
|
|
332
|
+
- **`false`(デフォルト)を使用する場合:**
|
|
333
|
+
- アプリがロケールプレフィックス付きリンクを使用する場合(例: `<a href="/fr/about">`)
|
|
334
|
+
- プリフェッチパフォーマンスを最適化したい場合
|
|
335
|
+
- 潜在的なリダイレクトループを避けたい場合
|
|
299
336
|
|
|
300
337
|
---
|
|
301
338
|
|
|
@@ -505,26 +542,4 @@ Intlayerがアプリケーションの国際化をどのように最適化しビ
|
|
|
505
542
|
- _説明_: 辞書がどのようにインポートされるかを制御します。
|
|
506
543
|
- _例_: `'dynamic'`
|
|
507
544
|
- _注意_: 利用可能なモード:
|
|
508
|
-
- "static": 辞書が静的にインポートされます。`useIntlayer`を`useDictionary
|
|
509
|
-
- "dynamic": 辞書がSuspenseを使用して動的にインポートされます。`useIntlayer`を`useDictionaryDynamic`に置き換えます。
|
|
510
|
-
- "async": 辞書が非同期で動的にインポートされます。`useIntlayer`を`await useDictionaryAsync`に置き換えます。
|
|
511
|
-
- _注意_: 動的インポートはSuspenseに依存し、レンダリングパフォーマンスに若干の影響を与える可能性があります。
|
|
512
|
-
- _注意_: 無効にすると、使用されていない場合でもすべてのロケールが一度に読み込まれます。
|
|
513
|
-
- _注意_: このオプションは`@intlayer/babel`および`@intlayer/swc`プラグインに依存します。
|
|
514
|
-
- _注意_: すべてのキーが`useIntlayer`呼び出しで静的に宣言されていることを確認してください。例:`useIntlayer('navbar')`。
|
|
515
|
-
- _注意_: このオプションは`optimize`が無効の場合は無視されます。
|
|
516
|
-
- _注意_: ほとんどの場合、Reactアプリケーションには`"dynamic"`が、Vue.jsアプリケーションには`"async"`が使用されます。
|
|
517
|
-
- _注意_: このオプションは`getIntlayer`、`getDictionary`、`useDictionary`、`useDictionaryAsync`、`useDictionaryDynamic`関数に影響しません。
|
|
518
|
-
|
|
519
|
-
- **traversePattern**:
|
|
520
|
-
- _型_: `string[]`
|
|
521
|
-
- _デフォルト_: `['**/*.{js,ts,mjs,cjs,jsx,tsx,mjx,cjx}', '!**/node_modules/**']`
|
|
522
|
-
- _説明_: 最適化中にトラバースするファイルを定義するパターン。
|
|
523
|
-
- _例_: `['src/**/*.{ts,tsx}', '../ui-library/**/*.{ts,tsx}', '!**/node_modules/**']`
|
|
524
|
-
- _注意_: 関連するコードファイルに最適化を制限し、ビルドパフォーマンスを向上させるために使用します。
|
|
525
|
-
- _注意_: このオプションは`optimize`が無効の場合は無視されます。
|
|
526
|
-
- _注意_: globパターンを使用します。
|
|
527
|
-
|
|
528
|
-
## ドキュメント履歴
|
|
529
|
-
|
|
530
|
-
- 5.5.11 - 2025-06-29: `docs`コマンドを追加
|
|
545
|
+
- "static": 辞書が静的にインポートされます。`useIntlayer`を`useDictionary`
|
package/docs/ko/configuration.md
CHANGED
|
@@ -268,10 +268,12 @@ module.exports = config;
|
|
|
268
268
|
- **prefixDefault**:
|
|
269
269
|
|
|
270
270
|
- _유형_: `boolean`
|
|
271
|
-
- _기본값_: `
|
|
271
|
+
- _기본값_: `false`
|
|
272
272
|
- _설명_: 기본 로케일을 URL에 포함할지 여부입니다.
|
|
273
|
-
- _예시_: `
|
|
274
|
-
- _참고_:
|
|
273
|
+
- _예시_: `true`
|
|
274
|
+
- _참고_:
|
|
275
|
+
- `true`이고 `defaultLocale = 'en'`인 경우: path = `/en/dashboard` 또는 `/fr/dashboard`
|
|
276
|
+
- `false`이고 `defaultLocale = 'en'`인 경우: path = `/dashboard` 또는 `/fr/dashboard`
|
|
275
277
|
|
|
276
278
|
- **basePath**:
|
|
277
279
|
|
|
@@ -279,7 +281,11 @@ module.exports = config;
|
|
|
279
281
|
- _기본값_: `''`
|
|
280
282
|
- _설명_: 애플리케이션 URL의 기본 경로입니다.
|
|
281
283
|
- _예시_: `'/my-app'`
|
|
282
|
-
- _참고_:
|
|
284
|
+
- _참고_:
|
|
285
|
+
- 애플리케이션이 `https://example.com/my-app`에서 호스팅되는 경우
|
|
286
|
+
- 기본 경로는 `'/my-app'`
|
|
287
|
+
- URL은 `https://example.com/my-app/en`이 됩니다
|
|
288
|
+
- 기본 경로가 설정되지 않은 경우 URL은 `https://example.com/en`이 됩니다
|
|
283
289
|
|
|
284
290
|
- **serverSetCookie**:
|
|
285
291
|
|
|
@@ -291,11 +297,42 @@ module.exports = config;
|
|
|
291
297
|
- _참고_: 로케일 쿠키를 모든 요청에서 설정할지 또는 설정하지 않을지를 제어합니다.
|
|
292
298
|
|
|
293
299
|
- **noPrefix**:
|
|
300
|
+
|
|
294
301
|
- _유형_: `boolean`
|
|
295
302
|
- _기본값_: `false`
|
|
296
303
|
- _설명_: URL에서 로케일 접두사를 생략할지 여부를 나타냅니다.
|
|
297
304
|
- _예시_: `true`
|
|
298
|
-
- _참고_:
|
|
305
|
+
- _참고_:
|
|
306
|
+
- `true`인 경우: URL에 접두사 없음
|
|
307
|
+
- `false`인 경우: URL에 접두사 있음
|
|
308
|
+
- `basePath = '/my-app'` 예시:
|
|
309
|
+
- `noPrefix = false`인 경우: URL은 `https://example.com/my-app/en`이 됩니다
|
|
310
|
+
- `noPrefix = true`인 경우: URL은 `https://example.com`이 됩니다
|
|
311
|
+
|
|
312
|
+
- **detectLocaleOnPrefetchNoPrefix**:
|
|
313
|
+
|
|
314
|
+
- _유형_: `boolean`
|
|
315
|
+
- _기본값_: `false`
|
|
316
|
+
- _설명_: Next.js 프리페치 요청 중 로케일 감지가 발생하는지 제어합니다.
|
|
317
|
+
- _예시_: `true`
|
|
318
|
+
- _참고_: 이 설정은 Next.js가 로케일 프리페치를 처리하는 방식에 영향을 미칩니다:
|
|
319
|
+
- **예시 시나리오:**
|
|
320
|
+
- 사용자의 브라우저 언어는 `'fr'`
|
|
321
|
+
- 현재 페이지는 `/fr/about`
|
|
322
|
+
- 링크가 `/about`을 프리페치
|
|
323
|
+
- **`detectLocaleOnPrefetchNoPrefix: true`인 경우:**
|
|
324
|
+
- 프리페치가 브라우저에서 `'fr'` 로케일을 감지
|
|
325
|
+
- 프리페치를 `/fr/about`으로 리다이렉트
|
|
326
|
+
- **`detectLocaleOnPrefetchNoPrefix: false`(기본값)인 경우:**
|
|
327
|
+
- 프리페치가 기본 로케일을 사용
|
|
328
|
+
- 프리페치를 `/en/about`으로 리다이렉트(`'en'`이 기본값이라고 가정)
|
|
329
|
+
- **`true`를 사용하는 경우:**
|
|
330
|
+
- 앱이 비로컬라이즈된 내부 링크를 사용하는 경우(예: `<a href="/about">`)
|
|
331
|
+
- 일반 요청과 프리페치 요청 간에 일관된 로케일 감지 동작을 원하는 경우
|
|
332
|
+
- **`false`(기본값)를 사용하는 경우:**
|
|
333
|
+
- 앱이 로케일 접두사가 있는 링크를 사용하는 경우(예: `<a href="/fr/about">`)
|
|
334
|
+
- 프리페치 성능을 최적화하고 싶은 경우
|
|
335
|
+
- 잠재적인 리다이렉트 루프를 피하고 싶은 경우
|
|
299
336
|
|
|
300
337
|
---
|
|
301
338
|
|
package/docs/pt/configuration.md
CHANGED
|
@@ -270,10 +270,12 @@ Configurações que controlam o comportamento do middleware, incluindo como a ap
|
|
|
270
270
|
- **prefixDefault**:
|
|
271
271
|
|
|
272
272
|
- _Tipo_: `boolean`
|
|
273
|
-
- _Padrão_: `
|
|
273
|
+
- _Padrão_: `false`
|
|
274
274
|
- _Descrição_: Indica se o idioma padrão deve ser incluído na URL.
|
|
275
|
-
- _Exemplo_: `
|
|
276
|
-
- _Nota_:
|
|
275
|
+
- _Exemplo_: `true`
|
|
276
|
+
- _Nota_:
|
|
277
|
+
- Se `true` e `defaultLocale = 'en'`: path = `/en/dashboard` ou `/fr/dashboard`
|
|
278
|
+
- Se `false` e `defaultLocale = 'en'`: path = `/dashboard` ou `/fr/dashboard`
|
|
277
279
|
|
|
278
280
|
- **basePath**:
|
|
279
281
|
|
|
@@ -281,7 +283,11 @@ Configurações que controlam o comportamento do middleware, incluindo como a ap
|
|
|
281
283
|
- _Padrão_: `''`
|
|
282
284
|
- _Descrição_: O caminho base para as URLs da aplicação.
|
|
283
285
|
- _Exemplo_: `'/my-app'`
|
|
284
|
-
- _Nota_:
|
|
286
|
+
- _Nota_:
|
|
287
|
+
- Se a aplicação está hospedada em `https://example.com/my-app`
|
|
288
|
+
- O caminho base é `'/my-app'`
|
|
289
|
+
- A URL será `https://example.com/my-app/en`
|
|
290
|
+
- Se o caminho base não estiver definido, a URL será `https://example.com/en`
|
|
285
291
|
|
|
286
292
|
- **serverSetCookie**:
|
|
287
293
|
|
|
@@ -293,11 +299,42 @@ Configurações que controlam o comportamento do middleware, incluindo como a ap
|
|
|
293
299
|
- _Nota_: Controla se o cookie de idioma é definido em todas as requisições ou nunca.
|
|
294
300
|
|
|
295
301
|
- **noPrefix**:
|
|
302
|
+
|
|
296
303
|
- _Tipo_: `boolean`
|
|
297
304
|
- _Padrão_: `false`
|
|
298
305
|
- _Descrição_: Indica se o prefixo de idioma deve ser omitido das URLs.
|
|
299
306
|
- _Exemplo_: `true`
|
|
300
|
-
- _Nota_:
|
|
307
|
+
- _Nota_:
|
|
308
|
+
- Se `true`: Sem prefixo na URL
|
|
309
|
+
- Se `false`: Prefixo na URL
|
|
310
|
+
- Exemplo com `basePath = '/my-app'`:
|
|
311
|
+
- Se `noPrefix = false`: A URL será `https://example.com/my-app/en`
|
|
312
|
+
- Se `noPrefix = true`: A URL será `https://example.com`
|
|
313
|
+
|
|
314
|
+
- **detectLocaleOnPrefetchNoPrefix**:
|
|
315
|
+
|
|
316
|
+
- _Tipo_: `boolean`
|
|
317
|
+
- _Padrão_: `false`
|
|
318
|
+
- _Descrição_: Controla se a detecção de idioma ocorre durante as requisições de prefetch do Next.js.
|
|
319
|
+
- _Exemplo_: `true`
|
|
320
|
+
- _Nota_: Esta configuração afeta como o Next.js gerencia o prefetch de idioma:
|
|
321
|
+
- **Cenário de exemplo:**
|
|
322
|
+
- O idioma do navegador do usuário é `'fr'`
|
|
323
|
+
- A página atual é `/fr/about`
|
|
324
|
+
- O link faz prefetch de `/about`
|
|
325
|
+
- **Com `detectLocaleOnPrefetchNoPrefix: true`:**
|
|
326
|
+
- O prefetch detecta o idioma `'fr'` do navegador
|
|
327
|
+
- Redireciona o prefetch para `/fr/about`
|
|
328
|
+
- **Com `detectLocaleOnPrefetchNoPrefix: false` (padrão):**
|
|
329
|
+
- O prefetch usa o idioma padrão
|
|
330
|
+
- Redireciona o prefetch para `/en/about` (assumindo que `'en'` é o padrão)
|
|
331
|
+
- **Quando usar `true`:**
|
|
332
|
+
- Sua aplicação usa links internos não localizados (ex. `<a href="/about">`)
|
|
333
|
+
- Você quer comportamento consistente de detecção de idioma entre requisições normais e de prefetch
|
|
334
|
+
- **Quando usar `false` (padrão):**
|
|
335
|
+
- Sua aplicação usa links com prefixo de idioma (ex. `<a href="/fr/about">`)
|
|
336
|
+
- Você quer otimizar a performance do prefetch
|
|
337
|
+
- Você quer evitar loops de redirecionamento potenciais
|
|
301
338
|
|
|
302
339
|
---
|
|
303
340
|
|
package/docs/ru/configuration.md
CHANGED
|
@@ -268,10 +268,12 @@ module.exports = config;
|
|
|
268
268
|
- **prefixDefault**:
|
|
269
269
|
|
|
270
270
|
- _Тип_: `boolean`
|
|
271
|
-
- _По умолчанию_: `
|
|
271
|
+
- _По умолчанию_: `false`
|
|
272
272
|
- _Описание_: Включать ли локаль по умолчанию в URL.
|
|
273
|
-
- _Пример_: `
|
|
274
|
-
- _Примечание_:
|
|
273
|
+
- _Пример_: `true`
|
|
274
|
+
- _Примечание_:
|
|
275
|
+
- Если `true` и `defaultLocale = 'en'`: path = `/en/dashboard` или `/fr/dashboard`
|
|
276
|
+
- Если `false` и `defaultLocale = 'en'`: path = `/dashboard` или `/fr/dashboard`
|
|
275
277
|
|
|
276
278
|
- **basePath**:
|
|
277
279
|
|
|
@@ -279,7 +281,11 @@ module.exports = config;
|
|
|
279
281
|
- _По умолчанию_: `''`
|
|
280
282
|
- _Описание_: Базовый путь для URL приложения.
|
|
281
283
|
- _Пример_: `'/my-app'`
|
|
282
|
-
- _Примечание_:
|
|
284
|
+
- _Примечание_:
|
|
285
|
+
- Если приложение размещено на `https://example.com/my-app`
|
|
286
|
+
- Базовый путь `'/my-app'`
|
|
287
|
+
- URL будет `https://example.com/my-app/en`
|
|
288
|
+
- Если базовый путь не установлен, URL будет `https://example.com/en`
|
|
283
289
|
|
|
284
290
|
- **serverSetCookie**:
|
|
285
291
|
|
|
@@ -291,11 +297,42 @@ module.exports = config;
|
|
|
291
297
|
- _Примечание_: Управляет, устанавливается ли cookie локали при каждом запросе или никогда.
|
|
292
298
|
|
|
293
299
|
- **noPrefix**:
|
|
300
|
+
|
|
294
301
|
- _Тип_: `boolean`
|
|
295
302
|
- _По умолчанию_: `false`
|
|
296
303
|
- _Описание_: Исключать ли префикс локали из URL.
|
|
297
304
|
- _Пример_: `true`
|
|
298
|
-
- _Примечание_:
|
|
305
|
+
- _Примечание_:
|
|
306
|
+
- Если `true`: Без префикса в URL
|
|
307
|
+
- Если `false`: С префиксом в URL
|
|
308
|
+
- Пример с `basePath = '/my-app'`:
|
|
309
|
+
- Если `noPrefix = false`: URL будет `https://example.com/my-app/en`
|
|
310
|
+
- Если `noPrefix = true`: URL будет `https://example.com`
|
|
311
|
+
|
|
312
|
+
- **detectLocaleOnPrefetchNoPrefix**:
|
|
313
|
+
|
|
314
|
+
- _Тип_: `boolean`
|
|
315
|
+
- _По умолчанию_: `false`
|
|
316
|
+
- _Описание_: Управляет, происходит ли обнаружение локали во время запросов предварительной загрузки Next.js.
|
|
317
|
+
- _Пример_: `true`
|
|
318
|
+
- _Примечание_: Эта настройка влияет на то, как Next.js обрабатывает предварительную загрузку локали:
|
|
319
|
+
- **Пример сценария:**
|
|
320
|
+
- Язык браузера пользователя `'fr'`
|
|
321
|
+
- Текущая страница `/fr/about`
|
|
322
|
+
- Ссылка предварительно загружает `/about`
|
|
323
|
+
- **С `detectLocaleOnPrefetchNoPrefix: true`:**
|
|
324
|
+
- Предварительная загрузка обнаруживает локаль `'fr'` из браузера
|
|
325
|
+
- Перенаправляет предварительную загрузку на `/fr/about`
|
|
326
|
+
- **С `detectLocaleOnPrefetchNoPrefix: false` (по умолчанию):**
|
|
327
|
+
- Предварительная загрузка использует локаль по умолчанию
|
|
328
|
+
- Перенаправляет предварительную загрузку на `/en/about` (предполагая, что `'en'` по умолчанию)
|
|
329
|
+
- **Когда использовать `true`:**
|
|
330
|
+
- Ваше приложение использует нелокализованные внутренние ссылки (например, `<a href="/about">`)
|
|
331
|
+
- Вы хотите согласованное поведение обнаружения локали между обычными и предварительными запросами
|
|
332
|
+
- **Когда использовать `false` (по умолчанию):**
|
|
333
|
+
- Ваше приложение использует ссылки с префиксом локали (например, `<a href="/fr/about">`)
|
|
334
|
+
- Вы хотите оптимизировать производительность предварительной загрузки
|
|
335
|
+
- Вы хотите избежать потенциальных циклов перенаправления
|
|
299
336
|
|
|
300
337
|
---
|
|
301
338
|
|
package/docs/zh/configuration.md
CHANGED
|
@@ -268,10 +268,12 @@ module.exports = config;
|
|
|
268
268
|
- **prefixDefault**:
|
|
269
269
|
|
|
270
270
|
- _类型_: `boolean`
|
|
271
|
-
- _默认值_: `
|
|
271
|
+
- _默认值_: `false`
|
|
272
272
|
- _描述_: 是否在 URL 中包含默认语言环境。
|
|
273
|
-
- _示例_: `
|
|
274
|
-
- _注意_:
|
|
273
|
+
- _示例_: `true`
|
|
274
|
+
- _注意_:
|
|
275
|
+
- 如果 `true` 且 `defaultLocale = 'en'`: path = `/en/dashboard` 或 `/fr/dashboard`
|
|
276
|
+
- 如果 `false` 且 `defaultLocale = 'en'`: path = `/dashboard` 或 `/fr/dashboard`
|
|
275
277
|
|
|
276
278
|
- **basePath**:
|
|
277
279
|
|
|
@@ -279,7 +281,11 @@ module.exports = config;
|
|
|
279
281
|
- _默认值_: `''`
|
|
280
282
|
- _描述_: 应用程序 URL 的基础路径。
|
|
281
283
|
- _示例_: `'/my-app'`
|
|
282
|
-
- _注意_:
|
|
284
|
+
- _注意_:
|
|
285
|
+
- 如果应用程序托管在 `https://example.com/my-app`
|
|
286
|
+
- 基础路径是 `'/my-app'`
|
|
287
|
+
- URL 将是 `https://example.com/my-app/en`
|
|
288
|
+
- 如果基础路径未设置,URL 将是 `https://example.com/en`
|
|
283
289
|
|
|
284
290
|
- **serverSetCookie**:
|
|
285
291
|
|
|
@@ -291,11 +297,42 @@ module.exports = config;
|
|
|
291
297
|
- _注意_: 控制是否在每个请求上设置语言环境 Cookie 或从不设置。
|
|
292
298
|
|
|
293
299
|
- **noPrefix**:
|
|
300
|
+
|
|
294
301
|
- _类型_: `boolean`
|
|
295
302
|
- _默认值_: `false`
|
|
296
303
|
- _描述_: 是否从 URL 中省略语言环境前缀。
|
|
297
304
|
- _示例_: `true`
|
|
298
|
-
- _注意_:
|
|
305
|
+
- _注意_:
|
|
306
|
+
- 如果 `true`: URL 中没有前缀
|
|
307
|
+
- 如果 `false`: URL 中有前缀
|
|
308
|
+
- 使用 `basePath = '/my-app'` 的示例:
|
|
309
|
+
- 如果 `noPrefix = false`: URL 将是 `https://example.com/my-app/en`
|
|
310
|
+
- 如果 `noPrefix = true`: URL 将是 `https://example.com`
|
|
311
|
+
|
|
312
|
+
- **detectLocaleOnPrefetchNoPrefix**:
|
|
313
|
+
|
|
314
|
+
- _类型_: `boolean`
|
|
315
|
+
- _默认值_: `false`
|
|
316
|
+
- _描述_: 控制是否在 Next.js 预取请求期间进行语言环境检测。
|
|
317
|
+
- _示例_: `true`
|
|
318
|
+
- _注意_: 此设置影响 Next.js 处理语言环境预取的方式:
|
|
319
|
+
- **示例场景:**
|
|
320
|
+
- 用户的浏览器语言是 `'fr'`
|
|
321
|
+
- 当前页面是 `/fr/about`
|
|
322
|
+
- 链接预取 `/about`
|
|
323
|
+
- **使用 `detectLocaleOnPrefetchNoPrefix: true`:**
|
|
324
|
+
- 预取从浏览器检测到 `'fr'` 语言环境
|
|
325
|
+
- 将预取重定向到 `/fr/about`
|
|
326
|
+
- **使用 `detectLocaleOnPrefetchNoPrefix: false` (默认):**
|
|
327
|
+
- 预取使用默认语言环境
|
|
328
|
+
- 将预取重定向到 `/en/about` (假设 `'en'` 是默认值)
|
|
329
|
+
- **何时使用 `true`:**
|
|
330
|
+
- 您的应用程序使用非本地化的内部链接 (例如 `<a href="/about">`)
|
|
331
|
+
- 您希望在常规请求和预取请求之间保持一致的语言环境检测行为
|
|
332
|
+
- **何时使用 `false` (默认):**
|
|
333
|
+
- 您的应用程序使用带语言环境前缀的链接 (例如 `<a href="/fr/about">`)
|
|
334
|
+
- 您希望优化预取性能
|
|
335
|
+
- 您希望避免潜在的重定向循环
|
|
299
336
|
|
|
300
337
|
---
|
|
301
338
|
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@intlayer/docs",
|
|
3
|
-
"version": "5.7.
|
|
3
|
+
"version": "5.7.5",
|
|
4
4
|
"private": false,
|
|
5
5
|
"description": "Intlayer documentation",
|
|
6
6
|
"keywords": [
|
|
@@ -49,8 +49,8 @@
|
|
|
49
49
|
"legal"
|
|
50
50
|
],
|
|
51
51
|
"dependencies": {
|
|
52
|
-
"intlayer": "5.7.
|
|
53
|
-
"
|
|
52
|
+
"@intlayer/config": "5.7.5",
|
|
53
|
+
"intlayer": "5.7.5"
|
|
54
54
|
},
|
|
55
55
|
"devDependencies": {
|
|
56
56
|
"@types/node": "^22.15.30",
|
|
@@ -65,16 +65,16 @@
|
|
|
65
65
|
"tsx": "^4.19.4",
|
|
66
66
|
"typescript": "^5.8.3",
|
|
67
67
|
"vitest": "^3.2.2",
|
|
68
|
+
"@intlayer/api": "5.7.5",
|
|
69
|
+
"@intlayer/cli": "5.7.5",
|
|
68
70
|
"@utils/ts-config": "1.0.4",
|
|
69
|
-
"@utils/tsup-config": "1.0.4",
|
|
70
71
|
"@utils/ts-config-types": "1.0.4",
|
|
71
|
-
"@
|
|
72
|
-
"@intlayer/cli": "5.7.3"
|
|
72
|
+
"@utils/tsup-config": "1.0.4"
|
|
73
73
|
},
|
|
74
74
|
"peerDependencies": {
|
|
75
|
-
"@intlayer/api": "5.7.
|
|
76
|
-
"@intlayer/
|
|
77
|
-
"@intlayer/
|
|
75
|
+
"@intlayer/api": "5.7.5",
|
|
76
|
+
"@intlayer/cli": "5.7.5",
|
|
77
|
+
"@intlayer/config": "5.7.5"
|
|
78
78
|
},
|
|
79
79
|
"engines": {
|
|
80
80
|
"node": ">=14.18"
|