@intlayer/docs 5.7.4 → 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 CHANGED
@@ -14,7 +14,6 @@ keywords:
14
14
  slugs:
15
15
  - doc
16
16
  - concept
17
- - ar
18
17
  - ci-cd
19
18
  ---
20
19
 
@@ -272,10 +272,12 @@ module.exports = config;
272
272
  - **prefixDefault**:
273
273
 
274
274
  - _النوع_: `boolean`
275
- - _الافتراضي_: `true`
275
+ - _الافتراضي_: `false`
276
276
  - _الوصف_: ما إذا كان يجب تضمين اللغة الافتراضية في عنوان URL.
277
- - _مثال_: `false`
278
- - _ملاحظة_: إذا كانت القيمة `false`، فلن تحتوي عناوين URL الخاصة باللغة الافتراضية على بادئة اللغة.
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
- - _ملاحظة_: يؤثر هذا على كيفية بناء عناوين URL للتطبيق.
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
- - _ملاحظة_: إذا كانت القيمة `true`، فلن تحتوي عناوين URL على معلومات اللغة.
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
 
@@ -15,7 +15,6 @@ slugs:
15
15
  - doc
16
16
  - concept
17
17
  - content
18
- - ar
19
18
  - enumeration
20
19
  ---
21
20
 
package/docs/de/CI_CD.md CHANGED
@@ -14,7 +14,6 @@ keywords:
14
14
  slugs:
15
15
  - doc
16
16
  - concept
17
- - de
18
17
  - ci-cd
19
18
  ---
20
19
 
@@ -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_: `true`
271
+ - _Standard_: `false`
272
272
  - _Beschreibung_: Ob die Standardsprache in der URL enthalten sein soll.
273
- - _Beispiel_: `false`
274
- - _Hinweis_: Wenn `false`, enthalten URLs für die Standardsprache kein Sprachpräfix.
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_: Dies beeinflusst, wie URLs für die Anwendung erstellt werden.
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_: Wenn `true`, enthalten URLs keine Sprachinformationen.
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
 
@@ -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_: `true`
281
+ - _Default_: `false`
282
282
  - _Description_: Whether to include the default locale in the URL.
283
- - _Example_: `false`
284
- - _Note_: If `false`, URLs for the default locale will not have a locale prefix.
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_: This affects how URLs are constructed for the application.
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_: If `true`, URLs will not contain locale information.
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_: `true`
271
+ - _Default_: `false`
272
272
  - _Description_: Whether to include the default locale in the URL.
273
- - _Example_: `false`
274
- - _Note_: If `false`, URLs for the default locale will not have a locale prefix.
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_: This affects how URLs are constructed for the application.
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_: If `true`, URLs will not contain locale information.
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
 
@@ -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_: `true`
271
+ - _Por defecto_: `false`
272
272
  - _Descripción_: Indica si se debe incluir la configuración regional predeterminada en la URL.
273
- - _Ejemplo_: `false`
274
- - _Nota_: Si es `false`, las URLs para la configuración regional predeterminada no tendrán un prefijo de configuración regional.
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_: Esto afecta cómo se construyen las URLs para la aplicación.
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_: Si es `true`, las URLs no contendrán información de configuración regional.
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
 
@@ -15,7 +15,6 @@ slugs:
15
15
  - doc
16
16
  - concept
17
17
  - content
18
- - es
19
18
  - enumaration
20
19
  ---
21
20
 
@@ -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_ : `true`
272
- - _Description_ : Indique sil faut inclure la langue par défaut dans lURL.
273
- - _Exemple_ : `false`
274
- - _Remarque_ : Si `false`, les URL pour la langue par défaut n'auront pas de préfixe de langue.
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_ : Cela affecte la manière dont les URL sont construites pour l'application.
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_ : Indique s’il faut omettre le préfixe de langue dans les URL.
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_ : Si `true`, les URLs ne contiendront pas d'information de langue.
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
 
@@ -13,7 +13,6 @@ keywords:
13
13
  slugs:
14
14
  - doc
15
15
  - environment
16
- - fr
17
16
  - nextjs
18
17
  applicationTemplate: https://github.com/aymericzip/intlayer-next-15-template
19
18
  youtubeVideo: https://www.youtube.com/watch?v=e_PPG7PTqGU
@@ -270,10 +270,12 @@ module.exports = config;
270
270
  - **prefixDefault**:
271
271
 
272
272
  - _प्रकार_: `boolean`
273
- - _डिफ़ॉल्ट_: `true`
273
+ - _डिफ़ॉल्ट_: `false`
274
274
  - _विवरण_: क्या URL में डिफ़ॉल्ट लोकेल शामिल करना है।
275
- - _उदाहरण_: `false`
276
- - _नोट_: यदि `false`, तो डिफ़ॉल्ट लोकेल के लिए URL में लोकेल प्रीफ़िक्स नहीं होगा।
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
- - _नोट_: यह एप्लिकेशन के लिए URL कैसे बनाए जाते हैं, इसे प्रभावित करता है।
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
- - _नोट_: यदि `true`, तो URL में लोकेल जानकारी शामिल नहीं होगी।
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
 
@@ -15,7 +15,6 @@ slugs:
15
15
  - doc
16
16
  - concept
17
17
  - content
18
- - hi
19
18
  - dictionary
20
19
  - enumeration
21
20
  ---
@@ -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_: `true`
271
+ - _Predefinito_: `false`
272
272
  - _Descrizione_: Indica se includere il locale predefinito nell'URL.
273
- - _Esempio_: `false`
274
- - _Nota_: Se `false`, gli URL per la lingua predefinita non avranno un prefisso di lingua.
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_: Questo influisce su come vengono costruiti gli URL per l'applicazione.
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_: Se `true`, gli URL non conterranno informazioni sulla lingua.
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
 
@@ -15,7 +15,6 @@ slugs:
15
15
  - doc
16
16
  - concept
17
17
  - content
18
- - it
19
18
  - enumeration
20
19
  ---
21
20
 
@@ -14,7 +14,6 @@ keywords:
14
14
  - TypeScript
15
15
  slugs:
16
16
  - doc
17
- - it
18
17
  - vs-code-extension
19
18
  ---
20
19
 
@@ -268,10 +268,12 @@ module.exports = config;
268
268
  - **prefixDefault**:
269
269
 
270
270
  - _型_: `boolean`
271
- - _デフォルト_: `true`
271
+ - _デフォルト_: `false`
272
272
  - _説明_: デフォルトのロケールをURLに含めるかどうか。
273
- - _例_: `false`
274
- - _注意_: `false`の場合、デフォルトロケールのURLにはロケールプレフィックスが付きません。
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
- - _注意_: これはアプリケーションのURL構築に影響します。
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
- - _注意_: `true`の場合、URLにはロケール情報が含まれません。
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`
@@ -15,7 +15,6 @@ slugs:
15
15
  - doc
16
16
  - concept
17
17
  - content
18
- - ja
19
18
  - dictionary
20
19
  - enumeration
21
20
  ---
@@ -268,10 +268,12 @@ module.exports = config;
268
268
  - **prefixDefault**:
269
269
 
270
270
  - _유형_: `boolean`
271
- - _기본값_: `true`
271
+ - _기본값_: `false`
272
272
  - _설명_: 기본 로케일을 URL에 포함할지 여부입니다.
273
- - _예시_: `false`
274
- - _참고_: `false`로 설정하면 기본 로케일의 URL에는 로케일 접두사가 포함되지 않습니다.
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
- - _참고_: 이 설정은 애플리케이션의 URL 구성 방식에 영향을 미칩니다.
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
- - _참고_: `true`로 설정하면 URL에 로케일 정보가 포함되지 않습니다.
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
 
@@ -15,7 +15,6 @@ slugs:
15
15
  - doc
16
16
  - concept
17
17
  - content
18
- - ko
19
18
  - dictionary
20
19
  - enumeration
21
20
  ---
@@ -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_: `true`
273
+ - _Padrão_: `false`
274
274
  - _Descrição_: Indica se o idioma padrão deve ser incluído na URL.
275
- - _Exemplo_: `false`
276
- - _Nota_: Se `false`, as URLs para o idioma padrão não terão um prefixo de idioma.
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_: Isso afeta como as URLs são construídas para a aplicação.
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_: Se `true`, as URLs não conterão informações de idioma.
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
 
@@ -268,10 +268,12 @@ module.exports = config;
268
268
  - **prefixDefault**:
269
269
 
270
270
  - _Тип_: `boolean`
271
- - _По умолчанию_: `true`
271
+ - _По умолчанию_: `false`
272
272
  - _Описание_: Включать ли локаль по умолчанию в URL.
273
- - _Пример_: `false`
274
- - _Примечание_: Если `false`, URL для локали по умолчанию не будут содержать префикс локали.
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
- - _Примечание_: Это влияет на то, как формируются URL для приложения.
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
- - _Примечание_: Если `true`, URL не будут содержать информацию о локали.
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
 
@@ -15,7 +15,6 @@ slugs:
15
15
  - doc
16
16
  - concept
17
17
  - content
18
- - ru
19
18
  - dictionary
20
19
  - enumeration
21
20
  ---
@@ -14,7 +14,6 @@ keywords:
14
14
  - TypeScript
15
15
  slugs:
16
16
  - doc
17
- - ru
18
17
  - vs-code-extension
19
18
  ---
20
19
 
@@ -268,10 +268,12 @@ module.exports = config;
268
268
  - **prefixDefault**:
269
269
 
270
270
  - _类型_: `boolean`
271
- - _默认值_: `true`
271
+ - _默认值_: `false`
272
272
  - _描述_: 是否在 URL 中包含默认语言环境。
273
- - _示例_: `false`
274
- - _注意_: 如果为 `false`,默认语言环境的 URL 将不会有语言环境前缀。
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
- - _注意_: 这会影响应用程序 URL 的构建方式。
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
- - _注意_: 如果为 `true`,URL 将不包含语言环境信息。
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
 
@@ -15,7 +15,6 @@ slugs:
15
15
  - doc
16
16
  - concept
17
17
  - content
18
- - zh
19
18
  - enumeration
20
19
  ---
21
20
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@intlayer/docs",
3
- "version": "5.7.4",
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/config": "5.7.4",
53
- "intlayer": "5.7.4"
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
71
  "@utils/ts-config-types": "1.0.4",
70
- "@utils/tsup-config": "1.0.4",
71
- "@intlayer/api": "5.7.4",
72
- "@intlayer/cli": "5.7.4"
72
+ "@utils/tsup-config": "1.0.4"
73
73
  },
74
74
  "peerDependencies": {
75
- "@intlayer/api": "5.7.4",
76
- "@intlayer/cli": "5.7.4",
77
- "@intlayer/config": "5.7.4"
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"