@intlayer/docs 8.2.2 → 8.2.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (41) hide show
  1. package/docs/ar/intlayer_with_nextjs_compiler.md +2 -0
  2. package/docs/ar/intlayer_with_nextjs_no_locale_path.md +1 -0
  3. package/docs/ar/per_locale_file.md +1 -1
  4. package/docs/de/intlayer_with_nextjs_16.md +1 -1
  5. package/docs/de/intlayer_with_nextjs_compiler.md +2 -0
  6. package/docs/de/per_locale_file.md +1 -1
  7. package/docs/en/intlayer_with_nextjs_compiler.md +2 -0
  8. package/docs/en/per_locale_file.md +1 -1
  9. package/docs/en-GB/intlayer_with_nextjs_compiler.md +2 -0
  10. package/docs/en-GB/per_locale_file.md +1 -1
  11. package/docs/es/intlayer_with_nextjs_compiler.md +2 -0
  12. package/docs/fr/intlayer_with_nextjs_15.md +1 -1
  13. package/docs/fr/intlayer_with_nextjs_compiler.md +2 -0
  14. package/docs/hi/intlayer_with_nextjs_compiler.md +2 -0
  15. package/docs/hi/per_locale_file.md +1 -1
  16. package/docs/id/intlayer_with_nextjs_compiler.md +2 -0
  17. package/docs/id/per_locale_file.md +1 -1
  18. package/docs/it/intlayer_with_nextjs_15.md +1 -1
  19. package/docs/it/intlayer_with_nextjs_compiler.md +2 -0
  20. package/docs/it/per_locale_file.md +1 -1
  21. package/docs/ja/intlayer_with_nextjs_compiler.md +2 -0
  22. package/docs/ja/intlayer_with_nextjs_no_locale_path.md +1 -0
  23. package/docs/ko/intlayer_with_nextjs_15.md +1 -1
  24. package/docs/ko/intlayer_with_nextjs_compiler.md +2 -0
  25. package/docs/pl/intlayer_with_nextjs_15.md +1 -1
  26. package/docs/pl/intlayer_with_nextjs_compiler.md +2 -0
  27. package/docs/pl/per_locale_file.md +1 -1
  28. package/docs/pt/intlayer_with_nextjs_compiler.md +2 -0
  29. package/docs/pt/per_locale_file.md +1 -1
  30. package/docs/ru/intlayer_with_nextjs_15.md +1 -1
  31. package/docs/ru/intlayer_with_nextjs_compiler.md +2 -0
  32. package/docs/tr/intlayer_with_nextjs_compiler.md +2 -0
  33. package/docs/tr/per_locale_file.md +1 -1
  34. package/docs/uk/intlayer_with_nextjs_compiler.md +2 -0
  35. package/docs/vi/intlayer_with_nextjs_15.md +1 -1
  36. package/docs/vi/intlayer_with_nextjs_compiler.md +2 -0
  37. package/docs/vi/intlayer_with_nextjs_no_locale_path.md +1 -0
  38. package/docs/vi/per_locale_file.md +1 -1
  39. package/docs/zh/intlayer_with_nextjs_compiler.md +2 -0
  40. package/package.json +8 -8
  41. /package/blog/en/{__per-component_vs_centralized_i18n.md → ___per-component_vs_centralized_i18n.md} +0 -0
@@ -338,6 +338,8 @@ export default async function Page() {
338
338
  - يُستخدم **`IntlayerClientProvider`** لتوفير اللغة للأبناء في جانب العميل.
339
339
  - بينما يُستخدم **`IntlayerServerProvider`** لتوفير اللغة للأبناء في جانب الخادم.
340
340
 
341
+ > Layout and page cannot share a common server context because the server context system is based on a per-request data store (via [React's cache](https://react.dev/reference/react/cache) mechanism), causing each "context" to be re-created for different segments of the application. Placing the provider in a shared layout would break this isolation, preventing the correct propagation of the server context values to your server components.
342
+
341
343
  ### (اختياري) الخطوة 7: ملء الترجمات المفقودة
342
344
 
343
345
  يوفر Intlayer أداة CLI لمساعدتك في ملء الترجمات المفقودة. يمكنك استخدام الأمر `intlayer` لاختبار وملء الترجمات المفقودة من التعليمات البرمجية الخاصة بك.
@@ -728,6 +728,7 @@ const Page: NextPage = async () => {
728
728
 
729
729
  > لا يمكن أن يتشارك الـ layout والصفحة نفس سياق الخادم لأن نظام سياق الخادم يعتمد على مخزن بيانات لكل طلب (عبر آلية [React's cache](https://react.dev/reference/react/cache))، مما يجعل كل "context" يُعاد إنشاؤه لأجزاء مختلفة من التطبيق. وضع الـ provider في layout مشترك سيكسر هذا العزل، وسيمنع الانتشار الصحيح لقيم سياق الخادم إلى مكوناتك على الخادم.
730
730
 
731
+
731
732
  ```tsx {4,7} fileName="src/components/clientComponentExample/ClientComponentExample.tsx" codeFormat="typescript"
732
733
  "use client";
733
734
 
@@ -128,7 +128,7 @@ const config: IntlayerConfig = {
128
128
  export default config;
129
129
  ```
130
130
 
131
- باستخدام هذا التكوين، سيتم إنشاء جميع ملفات كل لغة مع تعيين اللغة الافتراضية إلى الإنجليزية. يتضمن ذلك أيضاً إنشاء ملفات `.content` باستخدام أمر `extract` والمترجم (compiler). (انظر [Compiler](https://intlayer.org/doc/compiler) أو [Extract](https://intlayer.org/doc/concept/cli/extract) لمزيد من المعلومات.)
131
+ باستخدام هذا التكوين، سيتم إنشاء جميع ملفات كل لغة مع تعيين اللغة الافتراضية إلى الإنجليزية. يتضمن ذلك أيضاً إنشاء ملفات `.content` باستخدام أمر `extract` والمترجم (compiler). (انظر [Compiler](https://intlayer.org/doc/compiler) أو [Extract](https://github.com/aymericzip/intlayer/edit/main/docs/docs/en/cli/extract.md) لمزيد من المعلومات.)
132
132
 
133
133
  ## تنسيق حسب اللغة
134
134
 
@@ -636,7 +636,7 @@ const Page = async ({ params }) => {
636
636
 
637
637
  > Layout und Seite können keinen gemeinsamen Server-Kontext teilen, da das Server-Kontext-System auf einem pro-Anfrage-Datenspeicher basiert (über den [React Cache](https://react.dev/reference/react/cache)-Mechanismus), wodurch jeder "Kontext" für verschiedene Segmente der Anwendung neu erstellt wird. Das Platzieren des Providers in einem gemeinsamen Layout würde diese Isolation aufheben und verhindern, dass die Server-Kontextwerte korrekt an Ihre Server-Komponenten weitergegeben werden.
638
638
 
639
- > Layout und Seite können keinen gemeinsamen Server-Kontext teilen, da das Server-Kontext-System auf einem pro-Anfrage-Datenspeicher basiert (über den [React-Cache](https://react.dev/reference/react/cache)-Mechanismus), wodurch jeder "Kontext" für verschiedene Segmente der Anwendung neu erstellt wird. Das Platzieren des Providers in einem gemeinsamen Layout würde diese Isolation aufheben und die korrekte Weitergabe der Server-Kontextwerte an Ihre Server-Komponenten verhindern.
639
+ > Layout und Seite können keinen gemeinsamen Server-Kontext teilen, da das Server-Kontext-System auf einem pro-Anfrage-Datenspeicher basiert (über den [React-Cache](https://react.dev/reference/react/cache)-Mechanismus), wodurch jeder "Kontext" für verschiedene Segmente der Anwendung neu erstellt wird. Das Platzieren des Providers in einem gemeinsamen Layout würde diese Isolation aufheben und die korrekte Weitergabe der Server-Kontextwerte an Ihre Server-Komponenten verhindern.
640
640
 
641
641
  ```tsx {4,7} fileName="src/components/ClientComponentExample.tsx" codeFormat="typescript"
642
642
  "use client";
@@ -338,6 +338,8 @@ export default async function Page() {
338
338
  - **`IntlayerClientProvider`** wird verwendet, um die Sprache für Client-Komponenten bereitzustellen.
339
339
  - **`IntlayerServerProvider`** wird verwendet, um die Sprache für Server-Kinder bereitzustellen.
340
340
 
341
+ > Layout and page cannot share a common server context because the server context system is based on a per-request data store (via [React's cache](https://react.dev/reference/react/cache) mechanism), causing each "context" to be re-created for different segments of the application. Placing the provider in a shared layout would break this isolation, preventing the correct propagation of the server context values to your server components.
342
+
341
343
  ### (Optional) Schritt 7: Fehlende Übersetzungen ausfüllen
342
344
 
343
345
  Intlayer bietet ein CLI-Tool an, um fehlende Übersetzungen auszufüllen. Sie können den Befehl `intlayer` verwenden, um fehlende Übersetzungen in Ihrem Code zu testen und auszufüllen.
@@ -128,7 +128,7 @@ const config: IntlayerConfig = {
128
128
  export default config;
129
129
  ```
130
130
 
131
- Mit dieser Konfiguration werden alle Per-Locale-Dateien mit der Standard-Locale Englisch generiert. Dies beinhaltet auch die Generierung von `.content`-Dateien unter Verwendung des `extract`-Befehls und des Compilers. (Siehe [Compiler](https://intlayer.org/doc/compiler) oder [Extract](https://intlayer.org/doc/concept/cli/extract) für weitere Informationen.)
131
+ Mit dieser Konfiguration werden alle Per-Locale-Dateien mit der Standard-Locale Englisch generiert. Dies beinhaltet auch die Generierung von `.content`-Dateien unter Verwendung des `extract`-Befehls und des Compilers. (Siehe [Compiler](https://intlayer.org/doc/compiler) oder [Extract](https://github.com/aymericzip/intlayer/edit/main/docs/docs/en/cli/extract.md) für weitere Informationen.)
132
132
 
133
133
  ## Pro-Locale-Format
134
134
 
@@ -338,6 +338,8 @@ export default async function Page() {
338
338
  - **`IntlayerClientProvider`** is used to provide the locale to client-side components.
339
339
  - **`IntlayerServerProvider`** is used to provide the locale to the server children.
340
340
 
341
+ > Layout and page cannot share a common server context because the server context system is based on a per-request data store (via [React's cache](https://react.dev/reference/react/cache) mechanism), causing each "context" to be re-created for different segments of the application. Placing the provider in a shared layout would break this isolation, preventing the correct propagation of the server context values to your server components.
342
+
341
343
  ### (Optional) Step 7: Fill missing translation
342
344
 
343
345
  Intlayer provide a CLI tool to help you fill missing translations. You can use the `intlayer` command to test and fill missing translations from your code.
@@ -167,7 +167,7 @@ const config: IntlayerConfig = {
167
167
  export default config;
168
168
  ```
169
169
 
170
- Using this configuration, all per-locale files will be generated with the default locale set to English. It also include generation of `.content` files using the `extract` command, and the compiler. (See [Compiler](https://intlayer.org/doc/compiler) or [Extract](https://intlayer.org/doc/concept/cli/extract) for more information.)
170
+ Using this configuration, all per-locale files will be generated with the default locale set to English. It also include generation of `.content` files using the `extract` command, and the compiler. (See [Compiler](https://intlayer.org/doc/compiler) or [Extract](https://github.com/aymericzip/intlayer/edit/main/docs/docs/en/cli/extract.md) for more information.)
171
171
 
172
172
  ## Single File with Multiple Translations
173
173
 
@@ -321,6 +321,8 @@ export default async function Page() {
321
321
  - **`IntlayerClientProvider`** is used to provide the locale to client-side components.
322
322
  - **`IntlayerServerProvider`** is used to provide the locale to the server children.
323
323
 
324
+ > Layout and page cannot share a common server context because the server context system is based on a per-request data store (via [React's cache](https://react.dev/reference/react/cache) mechanism), causing each "context" to be re-created for different segments of the application. Placing the provider in a shared layout would break this isolation, preventing the correct propagation of the server context values to your server components.
325
+
324
326
  ### (Optional) Step 7: Fill missing translation
325
327
 
326
328
  Intlayer provide a CLI tool to help you fill missing translations. You can use the `intlayer` command to test and fill missing translations from your code.
@@ -126,7 +126,7 @@ const config: IntlayerConfig = {
126
126
  export default config;
127
127
  ```
128
128
 
129
- Using this configuration, all per-locale files will be generated with the default locale set to English. It also includes generation of `.content` files using the `extract` command, and the compiler. (See [Compiler](https://intlayer.org/doc/compiler) or [Extract](https://intlayer.org/doc/concept/cli/extract) for more information.)
129
+ Using this configuration, all per-locale files will be generated with the default locale set to English. It also includes generation of `.content` files using the `extract` command, and the compiler. (See [Compiler](https://intlayer.org/doc/compiler) or [Extract](https://github.com/aymericzip/intlayer/edit/main/docs/docs/en/cli/extract.md) for more information.)
130
130
 
131
131
  ## Per-Locale Format
132
132
 
@@ -338,6 +338,8 @@ export default async function Page() {
338
338
  - **`IntlayerClientProvider`** se utiliza para proporcionar el locale a los componentes del lado del cliente.
339
339
  - **`IntlayerServerProvider`** se utiliza para proporcionar el locale a los hijos del servidor.
340
340
 
341
+ > Layout and page cannot share a common server context because the server context system is based on a per-request data store (via [React's cache](https://react.dev/reference/react/cache) mechanism), causing each "context" to be re-created for different segments of the application. Placing the provider in a shared layout would break this isolation, preventing the correct propagation of the server context values to your server components.
342
+
341
343
  ### (Opcional) Paso 7: Completar traducciones faltantes
342
344
 
343
345
  Intlayer proporciona una herramienta CLI para ayudarle a completar las traducciones faltantes. Puede utilizar el comando `intlayer` para probar y completar las traducciones faltantes de su código.
@@ -551,7 +551,7 @@ const Page = async ({ params }) => {
551
551
 
552
552
  > Le layout et la page ne peuvent pas partager un contexte serveur commun car le système de contexte serveur est basé sur un magasin de données par requête (via le mécanisme [cache de React](https://react.dev/reference/react/cache)), ce qui fait que chaque "contexte" est recréé pour différents segments de l'application. Placer le provider dans un layout partagé casserait cette isolation, empêchant la bonne propagation des valeurs du contexte serveur à vos composants serveur.
553
553
 
554
- > La mise en page (layout) et la page ne peuvent pas partager un contexte serveur commun car le système de contexte serveur est basé sur un magasin de données par requête (via le mécanisme [React's cache](https://react.dev/reference/react/cache)), ce qui entraîne la recréation de chaque "contexte" pour différents segments de l'application. Placer le provider dans une mise en page partagée briserait cette isolation, empêchant la bonne propagation des valeurs du contexte serveur à vos composants serveur.
554
+ > La mise en page (layout) et la page ne peuvent pas partager un contexte serveur commun car le système de contexte serveur est basé sur un magasin de données par requête (via le mécanisme [React's cache](https://react.dev/reference/react/cache)), ce qui entraîne la recréation de chaque "contexte" pour différents segments de l'application. Placer le provider dans une mise en page partagée briserait cette isolation, empêchant la bonne propagation des valeurs du contexte serveur à vos composants serveur.
555
555
 
556
556
  ```tsx {4,7} fileName="src/components/ClientComponentExample.tsx" codeFormat="typescript"
557
557
  "use client";
@@ -338,6 +338,8 @@ export default async function Page() {
338
338
  - **`IntlayerClientProvider`** est utilisé pour fournir la locale aux composants côté client.
339
339
  - **`IntlayerServerProvider`** est utilisé pour fournir la locale aux enfants serveurs.
340
340
 
341
+ > Layout and page cannot share a common server context because the server context system is based on a per-request data store (via [React's cache](https://react.dev/reference/react/cache) mechanism), causing each "context" to be re-created for different segments of the application. Placing the provider in a shared layout would break this isolation, preventing the correct propagation of the server context values to your server components.
342
+
341
343
  ### (Optionnel) Étape 7 : Remplir les traductions manquantes
342
344
 
343
345
  Intlayer fournit un outil CLI pour vous aider à remplir les traductions manquantes. Vous pouvez utiliser la commande `intlayer` pour tester et remplir les traductions manquantes de votre code.
@@ -338,6 +338,8 @@ export default async function Page() {
338
338
  - **`IntlayerClientProvider`** का उपयोग क्लाइंट साइड पर बच्चों को लोकेल प्रदान करने के लिए किया जाता है।
339
339
  - जबकि **`IntlayerServerProvider`** का उपयोग सर्वर साइड पर बच्चों को लोकेल प्रदान करने के लिए किया जाता है।
340
340
 
341
+ > Layout and page cannot share a common server context because the server context system is based on a per-request data store (via [React's cache](https://react.dev/reference/react/cache) mechanism), causing each "context" to be re-created for different segments of the application. Placing the provider in a shared layout would break this isolation, preventing the correct propagation of the server context values to your server components.
342
+
341
343
  ### (वैकल्पिक) चरण 7: छूटे हुए अनुवाद भरें
342
344
 
343
345
  Intlayer छूटे हुए अनुवादों को भरने में आपकी मदद करने के लिए एक CLI टूल प्रदान करता है। आप अपने कोड से छूटे हुए अनुवादों का परीक्षण करने और उन्हें भरने के लिए `intlayer` कमांड का उपयोग कर सकते हैं।
@@ -128,7 +128,7 @@ const config: IntlayerConfig = {
128
128
  export default config;
129
129
  ```
130
130
 
131
- इस कॉन्फ़िगरेशन का उपयोग करते हुए, सभी प्रति-लोकेल फ़ाइलें डिफ़ॉल्ट लोकेल को अंग्रेज़ी पर सेट करके जेनरेट की जाएंगी। इसमें `extract` कमांड और कंपाइलर का उपयोग करके `.content` फ़ाइलों का जनरेशन भी शामिल है। (अधिक जानकारी के लिए [Compiler](https://intlayer.org/doc/compiler) या [Extract](https://intlayer.org/doc/concept/cli/extract) देखें।)
131
+ इस कॉन्फ़िगरेशन का उपयोग करते हुए, सभी प्रति-लोकेल फ़ाइलें डिफ़ॉल्ट लोकेल को अंग्रेज़ी पर सेट करके जेनरेट की जाएंगी। इसमें `extract` कमांड और कंपाइलर का उपयोग करके `.content` फ़ाइलों का जनरेशन भी शामिल है। (अधिक जानकारी के लिए [Compiler](https://intlayer.org/doc/compiler) या [Extract](https://github.com/aymericzip/intlayer/edit/main/docs/docs/en/cli/extract.md) देखें।)
132
132
 
133
133
  ## प्रति-स्थान प्रारूप
134
134
 
@@ -338,6 +338,8 @@ export default async function Page() {
338
338
  - **`IntlayerClientProvider`** digunakan untuk menyediakan bahasa ke komponen sisi klien.
339
339
  - Sementara **`IntlayerServerProvider`** digunakan untuk menyediakan bahasa ke anak-anak server.
340
340
 
341
+ > Layout and page cannot share a common server context because the server context system is based on a per-request data store (via [React's cache](https://react.dev/reference/react/cache) mechanism), causing each "context" to be re-created for different segments of the application. Placing the provider in a shared layout would break this isolation, preventing the correct propagation of the server context values to your server components.
342
+
341
343
  ### (Opsional) Langkah 7: Isi terjemahan yang hilang
342
344
 
343
345
  Intlayer menyediakan alat CLI untuk membantu Anda mengisi terjemahan yang hilang. Anda dapat menggunakan perintah `intlayer` untuk menguji dan mengisi terjemahan yang hilang dari kode Anda.
@@ -128,7 +128,7 @@ const config: IntlayerConfig = {
128
128
  export default config;
129
129
  ```
130
130
 
131
- Dengan menggunakan konfigurasi ini, semua file per-locale akan dibuat dengan locale default yang diatur ke bahasa Inggris. Ini juga mencakup pembuatan file `.content` menggunakan perintah `extract`, dan compiler. (Lihat [Compiler](https://intlayer.org/doc/compiler) atau [Extract](https://intlayer.org/doc/concept/cli/extract) untuk informasi lebih lanjut.)
131
+ Dengan menggunakan konfigurasi ini, semua file per-locale akan dibuat dengan locale default yang diatur ke bahasa Inggris. Ini juga mencakup pembuatan file `.content` menggunakan perintah `extract`, dan compiler. (Lihat [Compiler](https://intlayer.org/doc/compiler) atau [Extract](https://github.com/aymericzip/intlayer/edit/main/docs/docs/en/cli/extract.md) untuk informasi lebih lanjut.)
132
132
 
133
133
  ## Format Per-Locale
134
134
 
@@ -544,7 +544,7 @@ const Page = async ({ params }) => {
544
544
 
545
545
  > Layout e pagina non possono condividere un contesto server comune perché il sistema di contesto server si basa su un archivio dati per richiesta (tramite il meccanismo [React's cache](https://react.dev/reference/react/cache)), causando la ricreazione di ogni "contesto" per segmenti diversi dell'applicazione. Posizionare il provider in un layout condiviso romperebbe questa isolamento, impedendo la corretta propagazione dei valori del contesto server ai componenti server.
546
546
 
547
- > Layout e pagina non possono condividere un contesto server comune perché il sistema di contesto server si basa su un archivio dati per richiesta (tramite il meccanismo [React's cache](https://react.dev/reference/react/cache)), causando la ricreazione di ogni "contesto" per diversi segmenti dell'applicazione. Posizionare il provider in un layout condiviso romperebbe questa isolazione, impedendo la corretta propagazione dei valori del contesto server ai tuoi componenti server.
547
+ > Layout e pagina non possono condividere un contesto server comune perché il sistema di contesto server si basa su un archivio dati per richiesta (tramite il meccanismo [React's cache](https://react.dev/reference/react/cache)), causando la ricreazione di ogni "contesto" per diversi segmenti dell'applicazione. Posizionare il provider in un layout condiviso romperebbe questa isolazione, impedendo la corretta propagazione dei valori del contesto server ai tuoi componenti server.
548
548
 
549
549
  ```tsx {4,7} fileName="src/components/ClientComponentExample.tsx" codeFormat="typescript"
550
550
  "use client";
@@ -338,6 +338,8 @@ export default async function Page() {
338
338
  - **`IntlayerClientProvider`** serve per fornire la lingua ai componenti client.
339
339
  - **`IntlayerServerProvider`** serve per fornire la lingua ai componenti server figli.
340
340
 
341
+ > Layout and page cannot share a common server context because the server context system is based on a per-request data store (via [React's cache](https://react.dev/reference/react/cache) mechanism), causing each "context" to be re-created for different segments of the application. Placing the provider in a shared layout would break this isolation, preventing the correct propagation of the server context values to your server components.
342
+
341
343
  ### (Opzionale) Passo 7: Completare le traduzioni mancanti
342
344
 
343
345
  Intlayer offre uno strumento CLI per completare le traduzioni mancanti. Usa il comando `intlayer` per testare e riempire le lacune nel codice.
@@ -128,7 +128,7 @@ const config: IntlayerConfig = {
128
128
  export default config;
129
129
  ```
130
130
 
131
- Utilizzando questa configurazione, tutti i file per-locale verranno generati con la locale predefinita impostata su inglese. Include anche la generazione di file `.content` utilizzando il comando `extract` e il compilatore. (Vedere [Compilatore](https://intlayer.org/doc/compiler) o [Extract](https://intlayer.org/doc/concept/cli/extract) per ulteriori informazioni.)
131
+ Utilizzando questa configurazione, tutti i file per-locale verranno generati con la locale predefinita impostata su inglese. Include anche la generazione di file `.content` utilizzando il comando `extract` e il compilatore. (Vedere [Compilatore](https://intlayer.org/doc/compiler) o [Extract](https://github.com/aymericzip/intlayer/edit/main/docs/docs/en/cli/extract.md) per ulteriori informazioni.)
132
132
 
133
133
  ## Formato per Locale
134
134
 
@@ -338,6 +338,8 @@ export default async function Page() {
338
338
  - **`IntlayerClientProvider`** は、クライアントサイドで子要素にロケールを提供するために使用されます。
339
339
  - 一方、 **`IntlayerServerProvider`** は、サーバーサイドで子要素にロケールを提供するために使用されます。
340
340
 
341
+ > Layout and page cannot share a common server context because the server context system is based on a per-request data store (via [React's cache](https://react.dev/reference/react/cache) mechanism), causing each "context" to be re-created for different segments of the application. Placing the provider in a shared layout would break this isolation, preventing the correct propagation of the server context values to your server components.
342
+
341
343
  ### (オプション) ステップ 7: 不足している翻訳を埋める
342
344
 
343
345
  Intlayerは、不足している翻訳を埋めるためのCLIツールを提供しています。 `intlayer` コマンドを使用して、コード内の不足している翻訳をテストして埋めることができます。
@@ -772,6 +772,7 @@ const Page: NextPage = async () => {
772
772
 
773
773
  > Layout と page は共通の server context を共有できません。server context システムはリクエスト単位のデータストア([React の cache](https://react.dev/reference/react/cache) 機構)に基づいており、アプリケーションの異なるセグメントごとに各 "context" が再作成されます。provider を共有 layout に配置するとこの分離が壊れ、server component に対する server context 値の正しい伝播が妨げられます。
774
774
 
775
+
775
776
  ```tsx {4,7} fileName="src/components/clientComponentExample/ClientComponentExample.tsx" codeFormat="typescript"
776
777
  "use client";
777
778
 
@@ -583,7 +583,7 @@ const Page = async ({ params }) => {
583
583
 
584
584
  > 레이아웃과 페이지는 공통 서버 컨텍스트를 공유할 수 없습니다. 서버 컨텍스트 시스템이 요청별 데이터 저장소([React의 cache](https://react.dev/reference/react/cache) 메커니즘)를 기반으로 하기 때문에 애플리케이션의 서로 다른 세그먼트마다 각 "컨텍스트"가 다시 생성됩니다. 공급자를 공유 레이아웃에 배치하면 이러한 격리가 깨져 서버 컴포넌트에 서버 컨텍스트 값이 올바르게 전파되지 않습니다.
585
585
 
586
- > 레이아웃과 페이지는 공통 서버 컨텍스트를 공유할 수 없습니다. 서버 컨텍스트 시스템이 요청별 데이터 저장소([React의 캐시](https://react.dev/reference/react/cache) 메커니즘)를 기반으로 하기 때문에 애플리케이션의 서로 다른 세그먼트마다 각 "컨텍스트"가 다시 생성됩니다. 제공자를 공유 레이아웃에 배치하면 이 격리가 깨져 서버 컨텍스트 값이 서버 컴포넌트에 올바르게 전달되지 않습니다.
586
+ > 레이아웃과 페이지는 공통 서버 컨텍스트를 공유할 수 없습니다. 서버 컨텍스트 시스템이 요청별 데이터 저장소([React의 캐시](https://react.dev/reference/react/cache) 메커니즘)를 기반으로 하기 때문에 애플리케이션의 서로 다른 세그먼트마다 각 "컨텍스트"가 다시 생성됩니다. 제공자를 공유 레이아웃에 배치하면 이 격리가 깨져 서버 컨텍스트 값이 서버 컴포넌트에 올바르게 전달되지 않습니다.
587
587
 
588
588
  ```tsx {4,7} fileName="src/components/ClientComponentExample.tsx" codeFormat="typescript"
589
589
  "use client";
@@ -321,6 +321,8 @@ export default async function Page() {
321
321
  - **`IntlayerClientProvider`**는 클라이언트 측에서 자식 요소에 로캘을 제공하는 데 사용됩니다.
322
322
  - 반면 **`IntlayerServerProvider`**는 서버 측에서 자식 요소에 로캘을 제공하는 데 사용됩니다.
323
323
 
324
+ > Layout and page cannot share a common server context because the server context system is based on a per-request data store (via [React's cache](https://react.dev/reference/react/cache) mechanism), causing each "context" to be re-created for different segments of the application. Placing the provider in a shared layout would break this isolation, preventing the correct propagation of the server context values to your server components.
325
+
324
326
  ### (선택 사항) 7단계: 누락된 번역 채우기
325
327
 
326
328
  Intlayer는 누락된 번역을 채울 수 있도록 CLI 도구를 제공합니다. `intlayer` 명령을 사용하여 코드에서 누락된 번역을 테스트하고 채울 수 있습니다.
@@ -617,7 +617,7 @@ const Page = async ({ params }) => {
617
617
 
618
618
  > Layout i strona nie mogą współdzielić wspólnego kontekstu serwera, ponieważ system kontekstu serwera opiera się na magazynie danych na żądanie (za pomocą mechanizmu [React's cache](https://react.dev/reference/react/cache)), co powoduje, że każdy "kontekst" jest tworzony na nowo dla różnych segmentów aplikacji. Umieszczenie providera w wspólnym layoucie złamałoby tę izolację, uniemożliwiając prawidłowe propagowanie wartości kontekstu serwera do komponentów serwerowych.
619
619
 
620
- > Layout i strona nie mogą współdzielić wspólnego kontekstu serwera, ponieważ system kontekstu serwera opiera się na magazynie danych na żądanie (za pomocą mechanizmu [React's cache](https://react.dev/reference/react/cache)), co powoduje, że każdy "kontekst" jest tworzony na nowo dla różnych segmentów aplikacji. Umieszczenie providera w współdzielonym layoucie złamałoby tę izolację, uniemożliwiając prawidłowe propagowanie wartości kontekstu serwera do komponentów serwerowych.
620
+ > Layout i strona nie mogą współdzielić wspólnego kontekstu serwera, ponieważ system kontekstu serwera opiera się na magazynie danych na żądanie (za pomocą mechanizmu [React's cache](https://react.dev/reference/react/cache)), co powoduje, że każdy "kontekst" jest tworzony na nowo dla różnych segmentów aplikacji. Umieszczenie providera w współdzielonym layoucie złamałoby tę izolację, uniemożliwiając prawidłowe propagowanie wartości kontekstu serwera do komponentów serwerowych.
621
621
 
622
622
  ```tsx {4,7} fileName="src/components/ClientComponentExample.tsx" codeFormat="typescript"
623
623
  "use client";
@@ -338,6 +338,8 @@ export default async function Page() {
338
338
  - **`IntlayerClientProvider`** służy do dostarczania języka dzięcom po stronie klienta (Client Side).
339
339
  - **`IntlayerServerProvider`** służy do dostarczania języka dzięcom po stronie serwera (Server Side).
340
340
 
341
+ > Layout and page cannot share a common server context because the server context system is based on a per-request data store (via [React's cache](https://react.dev/reference/react/cache) mechanism), causing each "context" to be re-created for different segments of the application. Placing the provider in a shared layout would break this isolation, preventing the correct propagation of the server context values to your server components.
342
+
341
343
  ### (Opcjonalnie) Krok 7: Uzupełnij brakujące tłumaczenia
342
344
 
343
345
  Intlayer udostępnia narzędzie CLI, które pomaga uzupełnić brakujące tłumaczenia. Możesz użyć polecenia `intlayer`, aby przetestować i uzupełnić brakujące tłumaczenia ze swojego kodu.
@@ -126,7 +126,7 @@ const config: IntlayerConfig = {
126
126
  export default config;
127
127
  ```
128
128
 
129
- Korzystając z tej konfiguracji, wszystkie pliki dla poszczególnych lokali będą generowane z domyślnym lokalem ustawionym na angielski. Obejmuje to również generowanie plików `.content` za pomocą polecenia `extract` oraz kompilatora. (Zobacz [Compiler](https://intlayer.org/doc/compiler) lub [Extract](https://intlayer.org/doc/concept/cli/extract), aby uzyskać więcej informacji.)
129
+ Korzystając z tej konfiguracji, wszystkie pliki dla poszczególnych lokali będą generowane z domyślnym lokalem ustawionym na angielski. Obejmuje to również generowanie plików `.content` za pomocą polecenia `extract` oraz kompilatora. (Zobacz [Compiler](https://intlayer.org/doc/compiler) lub [Extract](https://github.com/aymericzip/intlayer/edit/main/docs/docs/en/cli/extract.md), aby uzyskać więcej informacji.)
130
130
 
131
131
  ## Format per-locale
132
132
 
@@ -338,6 +338,8 @@ export default async function Page() {
338
338
  - **`IntlayerClientProvider`** é usado para fornecer o locale aos componentes do lado do cliente.
339
339
  - **`IntlayerServerProvider`** é usado para fornecer o locale aos filhos do servidor.
340
340
 
341
+ > Layout and page cannot share a common server context because the server context system is based on a per-request data store (via [React's cache](https://react.dev/reference/react/cache) mechanism), causing each "context" to be re-created for different segments of the application. Placing the provider in a shared layout would break this isolation, preventing the correct propagation of the server context values to your server components.
342
+
341
343
  ### (Opcional) Passo 7: Preencher traduções em falta
342
344
 
343
345
  O Intlayer fornece uma ferramenta CLI para ajudar a preencher traduções em falta. Pode usar o comando `intlayer` para testar e preencher as traduções em falta do seu código.
@@ -128,7 +128,7 @@ const config: IntlayerConfig = {
128
128
  export default config;
129
129
  ```
130
130
 
131
- Usando essa configuração, todos os arquivos por localidade serão gerados com a localidade padrão definida como Inglês. Isso também inclui a geração de arquivos `.content` usando o comando `extract` e o compiler. (Veja [Compiler](https://intlayer.org/doc/compiler) ou [Extract](https://intlayer.org/doc/concept/cli/extract) para mais informações.)
131
+ Usando essa configuração, todos os arquivos por localidade serão gerados com a localidade padrão definida como Inglês. Isso também inclui a geração de arquivos `.content` usando o comando `extract` e o compiler. (Veja [Compiler](https://intlayer.org/doc/compiler) ou [Extract](https://github.com/aymericzip/intlayer/edit/main/docs/docs/en/cli/extract.md) para mais informações.)
132
132
 
133
133
  ## Formato Por Localidade
134
134
 
@@ -548,7 +548,7 @@ const Page = async ({ params }) => {
548
548
 
549
549
  > Layout и страница не могут использовать общий серверный контекст, потому что система серверного контекста основана на хранилище данных для каждого запроса (через механизм [React's cache](https://react.dev/reference/react/cache)), из-за чего каждый "контекст" создаётся заново для разных сегментов приложения. Размещение провайдера в общем layout нарушит эту изоляцию и помешает правильной передаче значений серверного контекста вашим серверным компонентам.
550
550
 
551
- > Макет и страница не могут использовать общий серверный контекст, поскольку система серверного контекста основана на хранилище данных для каждого запроса (через механизм [кэша React](https://react.dev/reference/react/cache)), из-за чего каждый "контекст" создаётся заново для разных сегментов приложения. Размещение провайдера в общем макете нарушит эту изоляцию, что помешает правильной передаче значений серверного контекста вашим серверным компонентам.
551
+ > Макет и страница не могут использовать общий серверный контекст, поскольку система серверного контекста основана на хранилище данных для каждого запроса (через механизм [кэша React](https://react.dev/reference/react/cache)), из-за чего каждый "контекст" создаётся заново для разных сегментов приложения. Размещение провайдера в общем макете нарушит эту изоляцию, что помешает правильной передаче значений серверного контекста вашим серверным компонентам.
552
552
 
553
553
  ```tsx {4,7} fileName="src/components/ClientComponentExample.tsx" codeFormat="typescript"
554
554
  "use client";
@@ -338,6 +338,8 @@ export default async function Page() {
338
338
  - **`IntlayerClientProvider`** используется для предоставления языка компонентам на стороне клиента.
339
339
  - **`IntlayerServerProvider`** используется для предоставления языка дочерним элементам сервера.
340
340
 
341
+ > Layout and page cannot share a common server context because the server context system is based on a per-request data store (via [React's cache](https://react.dev/reference/react/cache) mechanism), causing each "context" to be re-created for different segments of the application. Placing the provider in a shared layout would break this isolation, preventing the correct propagation of the server context values to your server components.
342
+
341
343
  ### (Необязательно) Шаг 7: Заполнение недостающих переводов
342
344
 
343
345
  Intlayer предоставляет инструмент CLI, помогающий заполнить недостающие переводы. Вы можете использовать команду `intlayer` для проверки и заполнения недостающих переводов в вашем коде.
@@ -338,6 +338,8 @@ export default async function Page() {
338
338
  - **`IntlayerClientProvider`**, istemci tarafındaki bileşenlere dil sağlamak için kullanılır.
339
339
  - **`IntlayerServerProvider`** ise sunucu tarafındaki alt bileşenlere dil sağlamak için kullanılır.
340
340
 
341
+ > Layout and page cannot share a common server context because the server context system is based on a per-request data store (via [React's cache](https://react.dev/reference/react/cache) mechanism), causing each "context" to be re-created for different segments of the application. Placing the provider in a shared layout would break this isolation, preventing the correct propagation of the server context values to your server components.
342
+
341
343
  ### (İsteğe bağlı) Adım 7: Eksik çevirileri doldurma
342
344
 
343
345
  Intlayer, eksik çevirileri doldurmanıza yardımcı olacak bir CLI aracı sağlar. Kodunuzdaki eksik çevirileri test etmek ve doldurmak için `intlayer` komutunu kullanabilirsiniz.
@@ -126,7 +126,7 @@ const config: IntlayerConfig = {
126
126
  export default config;
127
127
  ```
128
128
 
129
- Bu yapılandırmayı kullanarak, tüm yerel ayar başına dosyalar varsayılan yerel ayar İngilizce olarak ayarlanmış şekilde oluşturulacaktır. Ayrıca `extract` komutu kullanılarak `.content` dosyalarının oluşturulmasını ve derleyiciyi (compiler) içerir. (Daha fazla bilgi için [Compiler](https://intlayer.org/doc/compiler) veya [Extract](https://intlayer.org/doc/concept/cli/extract) bölümlerine bakın.)
129
+ Bu yapılandırmayı kullanarak, tüm yerel ayar başına dosyalar varsayılan yerel ayar İngilizce olarak ayarlanmış şekilde oluşturulacaktır. Ayrıca `extract` komutu kullanılarak `.content` dosyalarının oluşturulmasını ve derleyiciyi (compiler) içerir. (Daha fazla bilgi için [Compiler](https://intlayer.org/doc/compiler) veya [Extract](https://github.com/aymericzip/intlayer/edit/main/docs/docs/en/cli/extract.md) bölümlerine bakın.)
130
130
 
131
131
  ## Yerel Ayar Başına Format
132
132
 
@@ -338,6 +338,8 @@ export default async function Page() {
338
338
  - **`IntlayerClientProvider`** використовується для розповсюдження мови до клієнтських компонентів-нащадків.
339
339
  - Водночас **`IntlayerServerProvider`** використовується для забезпечення мови серверним компонентам-нащадкам.
340
340
 
341
+ > Layout and page cannot share a common server context because the server context system is based on a per-request data store (via [React's cache](https://react.dev/reference/react/cache) mechanism), causing each "context" to be re-created for different segments of the application. Placing the provider in a shared layout would break this isolation, preventing the correct propagation of the server context values to your server components.
342
+
341
343
  ### (Опціонально) Крок 7: Заповнення відсутніх перекладів
342
344
 
343
345
  Intlayer надає CLI-інструмент, щоб допомогти вам заповнити відсутні переклади. Ви можете використовувати команду `intlayer` для перевірки та заповнення відсутніх перекладів із вашого коду.
@@ -659,7 +659,7 @@ const Page = async ({ params }) => {
659
659
 
660
660
  > Layout và trang không thể chia sẻ một ngữ cảnh server chung vì hệ thống ngữ cảnh server dựa trên kho dữ liệu theo từng yêu cầu (thông qua cơ chế [React's cache](https://react.dev/reference/react/cache)), khiến mỗi "context" được tạo lại cho các phân đoạn khác nhau của ứng dụng. Việc đặt provider trong một layout dùng chung sẽ phá vỡ sự cô lập này, ngăn cản việc truyền đúng giá trị ngữ cảnh server đến các component server của bạn.
661
661
 
662
- > Layout và trang không thể chia sẻ một context server chung vì hệ thống context server dựa trên kho dữ liệu theo từng yêu cầu (qua cơ chế [React's cache](https://react.dev/reference/react/cache)), dẫn đến mỗi "context" được tạo lại cho các phân đoạn khác nhau của ứng dụng. Việc đặt provider trong một layout dùng chung sẽ phá vỡ sự cô lập này, ngăn cản việc truyền đúng các giá trị context server đến các component server của bạn.
662
+ > Layout và trang không thể chia sẻ một context server chung vì hệ thống context server dựa trên kho dữ liệu theo từng yêu cầu (qua cơ chế [React's cache](https://react.dev/reference/react/cache)), dẫn đến mỗi "context" được tạo lại cho các phân đoạn khác nhau của ứng dụng. Việc đặt provider trong một layout dùng chung sẽ phá vỡ sự cô lập này, ngăn cản việc truyền đúng các giá trị context server đến các component server của bạn.
663
663
 
664
664
  ```tsx {4,7} fileName="src/components/ClientComponentExample.tsx" codeFormat="typescript"
665
665
  "use client";
@@ -338,6 +338,8 @@ export default async function Page() {
338
338
  - **`IntlayerClientProvider`** được sử dụng để cung cấp ngôn ngữ cho các thành phần con phía client.
339
339
  - Trong khi **`IntlayerServerProvider`** được sử dụng để cung cấp ngôn ngữ cho các thành phần con phía server.
340
340
 
341
+ > Layout and page cannot share a common server context because the server context system is based on a per-request data store (via [React's cache](https://react.dev/reference/react/cache) mechanism), causing each "context" to be re-created for different segments of the application. Placing the provider in a shared layout would break this isolation, preventing the correct propagation of the server context values to your server components.
342
+
341
343
  ### (Tùy chọn) Bước 7: Điền các bản dịch còn thiếu
342
344
 
343
345
  Intlayer cung cấp một công cụ CLI để giúp bạn điền các bản dịch còn thiếu. Bạn có thể sử dụng lệnh `intlayer` để kiểm tra và điền các bản dịch còn thiếu từ mã của mình.
@@ -720,6 +720,7 @@ const Page: NextPage = async () => {
720
720
 
721
721
  > Layout và page không thể chia sẻ cùng một server context vì hệ thống server context dựa trên một kho dữ liệu theo từng yêu cầu (thông qua cơ chế [React's cache](https://react.dev/reference/react/cache)), khiến mỗi "context" được tạo lại cho các đoạn khác nhau của ứng dụng. Đặt provider trong một layout chia sẻ sẽ phá vỡ sự cô lập này, ngăn việc truyền đúng các giá trị server context tới các server component của bạn.
722
722
 
723
+
723
724
  ```tsx {4,7} fileName="src/components/clientComponentExample/ClientComponentExample.tsx" codeFormat="typescript"
724
725
  "use client";
725
726
 
@@ -128,7 +128,7 @@ const config: IntlayerConfig = {
128
128
  export default config;
129
129
  ```
130
130
 
131
- Sử dụng cấu hình này, tất cả các tệp theo từng locale sẽ được tạo với locale mặc định được đặt là tiếng Anh. Nó cũng bao gồm việc tạo các tệp `.content` bằng cách sử dụng lệnh `extract` và compiler. (Xem [Compiler](https://intlayer.org/doc/compiler) hoặc [Extract](https://intlayer.org/doc/concept/cli/extract) để biết thêm thông tin.)
131
+ Sử dụng cấu hình này, tất cả các tệp theo từng locale sẽ được tạo với locale mặc định được đặt là tiếng Anh. Nó cũng bao gồm việc tạo các tệp `.content` bằng cách sử dụng lệnh `extract` và compiler. (Xem [Compiler](https://intlayer.org/doc/compiler) hoặc [Extract](https://github.com/aymericzip/intlayer/edit/main/docs/docs/en/cli/extract.md) để biết thêm thông tin.)
132
132
 
133
133
  ## Định dạng theo từng locale
134
134
 
@@ -338,6 +338,8 @@ export default async function Page() {
338
338
  - **`IntlayerClientProvider`** 用于在客户端向子组件提供语言环境。
339
339
  - 而 **`IntlayerServerProvider`** 用于在服务器端向子组件提供语言环境。
340
340
 
341
+ > Layout and page cannot share a common server context because the server context system is based on a per-request data store (via [React's cache](https://react.dev/reference/react/cache) mechanism), causing each "context" to be re-created for different segments of the application. Placing the provider in a shared layout would break this isolation, preventing the correct propagation of the server context values to your server components.
342
+
341
343
  ### (可选) 第 7 步:填写缺失的翻译
342
344
 
343
345
  Intlayer 提供了一个 CLI 工具来帮助您填写缺失的翻译。您可以使用 `intlayer` 命令来测试并从您的代码中填写缺失的翻译。
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@intlayer/docs",
3
- "version": "8.2.2",
3
+ "version": "8.2.4",
4
4
  "private": false,
5
5
  "description": "Intlayer documentation",
6
6
  "keywords": [
@@ -72,20 +72,20 @@
72
72
  "watch": "webpack --config ./webpack.config.ts --watch"
73
73
  },
74
74
  "dependencies": {
75
- "@intlayer/config": "8.2.2",
76
- "@intlayer/core": "8.2.2",
77
- "@intlayer/types": "8.2.2"
75
+ "@intlayer/config": "8.2.3",
76
+ "@intlayer/core": "8.2.3",
77
+ "@intlayer/types": "8.2.3"
78
78
  },
79
79
  "devDependencies": {
80
- "@intlayer/api": "8.2.2",
81
- "@intlayer/cli": "8.2.2",
82
- "@types/node": "25.3.3",
80
+ "@intlayer/api": "8.2.3",
81
+ "@intlayer/cli": "8.2.3",
82
+ "@types/node": "25.3.5",
83
83
  "@utils/ts-config": "1.0.4",
84
84
  "@utils/ts-config-types": "1.0.4",
85
85
  "@utils/tsdown-config": "1.0.4",
86
86
  "fast-glob": "3.3.3",
87
87
  "rimraf": "6.1.3",
88
- "tsdown": "0.20.3",
88
+ "tsdown": "0.21.0",
89
89
  "typescript": "5.9.3",
90
90
  "vitest": "4.0.18"
91
91
  },