@intlayer/docs 8.0.1 → 8.0.2

package/docs/hi/dictionary/insertion.md

@@ -35,23 +35,125 @@ Intlayer में, सम्मिलन कंटेंट `insertion` फ़
 
 ## सम्मिलन कंटेंट सेटअप करना
 
-अपने Intlayer प्रोजेक्ट में सम्मिलन कंटेंट सेटअप करने के लिए, एक कंटेंट मॉड्यूल बनाएं जिसमें आपके सम्मिलन परिभाषाएँ शामिल हों। नीचे विभिन्न प्रारूपों में उदाहरण दिए गए हैं।
-
-```typescript fileName="**/*.content.ts" contentDeclarationFormat="typescript"
-import { insert, type Dictionary } from "intlayer";
-
-const myInsertionContent = {
-  key: "my_key",
-  content: {
-    myInsertion: insert(
-      "नमस्ते, मेरा नाम {{name}} है और मेरी उम्र {{age}} वर्ष है!"
-    ),
-    myInsertion2: "नमस्ते, मेरा नाम {{name}} है और मेरी उम्र {{age}} वर्ष है!", // Since intlayer v8, insertion function is not required anymore. The content will be automatically decorated.
-  },
-} satisfies Dictionary;
-
-export default myInsertionContent;
-```
+अपने Intlayer प्रोजेक्ट में सम्मिलन कंटेंट सेटअप करने के लिए, एक कंटेंट मॉड्यूल बनाएं जिसमें आपके सम्मिलन परिभाषाएँ शामिल हों।
+
+<Tabs>
+  <Tab label="मैनुअल रैपिंग" value="manual-wrapping">
+    सम्मिलन कंटेंट को स्पष्ट रूप से घोषित करने के लिए `insert` फ़ंक्शन का उपयोग करें।
+
+    ```typescript fileName="**/*.content.ts" contentDeclarationFormat="typescript"
+    import { insert, type Dictionary } from "intlayer";
+
+    const myInsertionContent = {
+      key: "my_key",
+      content: {
+        myInsertion: insert(
+          "नमस्ते, मेरा नाम {{name}} है और मेरी उम्र {{age}} वर्ष है!"
+        ),
+      },
+    } satisfies Dictionary;
+
+    export default myInsertionContent;
+    ```
+
+    ```javascript fileName="**/*.content.mjs" contentDeclarationFormat="esm"
+    import { insert } from "intlayer";
+
+    /** @type {import('intlayer').Dictionary} */
+    const myInsertionContent = {
+      key: "my_key",
+      content: {
+        myInsertion: insert(
+          "नमस्ते, मेरा नाम {{name}} है और मेरी उम्र {{age}} वर्ष है!"
+        ),
+      },
+    };
+
+    export default myInsertionContent;
+    ```
+
+    ```javascript fileName="**/*.content.cjs" contentDeclarationFormat="commonjs"
+    const { insert } = require("intlayer");
+
+    /** @type {import('intlayer').Dictionary} */
+    const myInsertionContent = {
+      key: "my_key",
+      content: {
+        myInsertion: insert(
+          "नमस्ते, मेरा नाम {{name}} है और मेरी उम्र {{age}} वर्ष है!"
+        ),
+      },
+    };
+
+    module.exports = myInsertionContent;
+    ```
+
+    ```json5 fileName="**/*.content.json" contentDeclarationFormat="json"
+    {
+      "$schema": "https://intlayer.org/schema.json",
+      "key": "my_key",
+      "content": {
+        "myInsertion": {
+          "nodeType": "insertion",
+          "insertion": "नमस्ते, मेरा नाम {{name}} है और मेरी उम्र {{age}} वर्ष है!",
+        },
+      },
+    }
+    ```
+
+  </Tab>
+  <Tab label="स्वचालित पहचान" value="automatic-detection">
+    यदि स्ट्रिंग में सामान्य सम्मिलन संकेतक (जैसे `{{name}}`) हैं, तो Intlayer इसे स्वचालित रूप से बदल देगा।
+
+    ```typescript fileName="**/*.content.ts" contentDeclarationFormat="typescript"
+    import { type Dictionary } from "intlayer";
+
+    const myInsertionContent = {
+      key: "my_key",
+      content: {
+        myInsertion: "नमस्ते, मेरा नाम {{name}} है और मेरी उम्र {{age}} वर्ष है!",
+      },
+    } satisfies Dictionary;
+
+    export default myInsertionContent;
+    ```
+
+    ```javascript fileName="**/*.content.mjs" contentDeclarationFormat="esm"
+    /** @type {import('intlayer').Dictionary} */
+    const myInsertionContent = {
+      key: "my_key",
+      content: {
+        myInsertion: "नमस्ते, मेरा नाम {{name}} है और मेरी उम्र {{age}} वर्ष है!",
+      },
+    };
+
+    export default myInsertionContent;
+    ```
+
+    ```javascript fileName="**/*.content.cjs" contentDeclarationFormat="commonjs"
+    /** @type {import('intlayer').Dictionary} */
+    const myInsertionContent = {
+      key: "my_key",
+      content: {
+        myInsertion: "नमस्ते, मेरा नाम {{name}} है और मेरी उम्र {{age}} वर्ष है!",
+      },
+    };
+
+    module.exports = myInsertionContent;
+    ```
+
+    ```json5 fileName="**/*.content.json" contentDeclarationFormat="json"
+    {
+      "$schema": "https://intlayer.org/schema.json",
+      "key": "my_key",
+      "content": {
+        "myInsertion": "नमस्ते, मेरा नाम {{name}} है और मेरी उम्र {{age}} वर्ष है!",
+      },
+    }
+    ```
+
+  </Tab>
+</Tabs>
 
 ```javascript fileName="**/*.content.mjs" contentDeclarationFormat="esm"
 import { insert } from "intlayer";

package/docs/hi/intlayer_with_adonisjs.md

@@ -41,6 +41,16 @@ history:
 
 ## शुरू करना
 
+<iframe
+  src="https://stackblitz.com/github/aymericzip/intlayer-adonisjs-template?embed=1&ctl=1&file=intlayer.config.ts"
+  className="m-auto overflow-hidden rounded-lg border-0 max-md:size-full max-md:h-[700px] md:aspect-16/9 md:w-full"
+  title="Demo CodeSandbox - How to Internationalize your application using Intlayer"
+  sandbox="allow-forms allow-modals allow-popups allow-presentation allow-same-origin allow-scripts"
+  loading="lazy"
+/>
+
+See [Application Template](https://github.com/aymericzip/intlayer-adonisjs-template) on GitHub.
+
 ### स्थापना
 
 `adonis-intlayer` का उपयोग शुरू करने के लिए, npm का उपयोग करके पैकेज स्थापित करें:

package/docs/hi/intlayer_with_express.md

@@ -46,6 +46,16 @@ history:
 
 ## प्रारंभ करना
 
+<iframe
+  src="https://stackblitz.com/github/aymericzip/intlayer-express-template?embed=1&ctl=1&file=intlayer.config.ts"
+  className="m-auto overflow-hidden rounded-lg border-0 max-md:size-full max-md:h-[700px] md:aspect-16/9 md:w-full"
+  title="Demo CodeSandbox - How to Internationalize your application using Intlayer"
+  sandbox="allow-forms allow-modals allow-popups allow-presentation allow-same-origin allow-scripts"
+  loading="lazy"
+/>
+
+See [Application Template](https://github.com/aymericzip/intlayer-express-template) on GitHub.
+
 ### स्थापना
 
 `express-intlayer` का उपयोग शुरू करने के लिए, npm का उपयोग करके पैकेज स्थापित करें:

package/docs/hi/intlayer_with_fastify.md

@@ -40,6 +40,16 @@ history:
 
 ## आरंभ करना
 
+<iframe
+  src="https://stackblitz.com/github/aymericzip/intlayer-fastify-template?embed=1&ctl=1&file=intlayer.config.ts"
+  className="m-auto overflow-hidden rounded-lg border-0 max-md:size-full max-md:h-[700px] md:aspect-16/9 md:w-full"
+  title="Demo CodeSandbox - How to Internationalize your application using Intlayer"
+  sandbox="allow-forms allow-modals allow-popups allow-presentation allow-same-origin allow-scripts"
+  loading="lazy"
+/>
+
+See [Application Template](https://github.com/aymericzip/intlayer-fastify-template) on GitHub.
+
 ### इंस्टॉलेशन
 
 `fastify-intlayer` का उपयोग शुरू करने के लिए, npm का उपयोग करके पैकेज इंस्टॉल करें:

package/docs/hi/intlayer_with_hono.md

@@ -44,6 +44,16 @@ history:
 
 ## शुरुआत करना
 
+<iframe
+  src="https://stackblitz.com/github/aymericzip/intlayer-hono-template?embed=1&ctl=1&file=intlayer.config.ts"
+  className="m-auto overflow-hidden rounded-lg border-0 max-md:size-full max-md:h-[700px] md:aspect-16/9 md:w-full"
+  title="Demo CodeSandbox - How to Internationalize your application using Intlayer"
+  sandbox="allow-forms allow-modals allow-popups allow-presentation allow-same-origin allow-scripts"
+  loading="lazy"
+/>
+
+See [Application Template](https://github.com/aymericzip/intlayer-hono-template) on GitHub.
+
 ### स्थापना
 
 `hono-intlayer` का उपयोग शुरू करने के लिए, npm का उपयोग करके पैकेज स्थापित करें:

package/docs/hi/intlayer_with_nestjs.md

@@ -14,7 +14,7 @@ slugs:
   - doc
   - environment
   - nest
-applicationTemplate: https://github.com/AydinTheFirst/nestjs-intlayer
+applicationTemplate: https://github.com/aymericzip/intlayer-nestjs-template
 author: AydinTheFirst
 history:
   - version: 7.5.9
@@ -49,6 +49,16 @@ history:
 
 ## शुरुआत कैसे करें
 
+<iframe
+  src="https://stackblitz.com/github/aymericzip/intlayer-nestjs-template?embed=1&ctl=1&file=intlayer.config.ts"
+  className="m-auto overflow-hidden rounded-lg border-0 max-md:size-full max-md:h-[700px] md:aspect-16/9 md:w-full"
+  title="Demo CodeSandbox - How to Internationalize your application using Intlayer"
+  sandbox="allow-forms allow-modals allow-popups allow-presentation allow-same-origin allow-scripts"
+  loading="lazy"
+/>
+
+See [Application Template](https://github.com/aymericzip/intlayer-nestjs-template) on GitHub.
+
 ### नया NestJS प्रोजेक्ट बनाएं
 
 ```bash packageManager="npm"

package/docs/id/dictionary/html.md

@@ -44,8 +44,9 @@ Anda dapat menyatakan konten HTML menggunakan fungsi `html` atau cukup sebagai s
 
     const htmlDictionary = {
       key: "app",
+      contentAutoTransformation: true, // dapat diatur di file konfigurasi
       content: {
-        myHtmlContent: html("<p>Hello <strong>World</strong></p>"),
+        myHtmlContent:  html("<p>Hello <strong>World</strong></p>"),
       },
     } satisfies Dictionary;
 
@@ -59,8 +60,9 @@ Anda dapat menyatakan konten HTML menggunakan fungsi `html` atau cukup sebagai s
     ```typescript fileName="htmlDictionary.content.ts"
     export default {
       key: "app",
+      contentAutoTransformation: true, // dapat diatur di file konfigurasi
       content: {
-        myHtmlContent: "<p>Hello <strong>World</strong></p>",
+        myHtmlContent:  "<p>Hello <strong>World</strong></p>",
       },
     };
     ```

package/docs/id/dictionary/insertion.md

@@ -35,23 +35,125 @@ Saat diintegrasikan dengan React Intlayer atau Next Intlayer, Anda cukup menyedi
 
 ## Menyiapkan Konten Penyisipan
 
-Untuk menyiapkan konten penyisipan dalam proyek Intlayer Anda, buat modul konten yang mencakup definisi penyisipan Anda. Berikut adalah contoh dalam berbagai format.
-
-```typescript fileName="**/*.content.ts" contentDeclarationFormat="typescript"
-import { insert, type Dictionary } from "intlayer";
-
-const myInsertionContent = {
-  key: "my_key",
-  content: {
-    myInsertion: insert(
-      "Halo, nama saya {{name}} dan saya berumur {{age}} tahun!"
-    ),
-    myInsertion2: "Halo, nama saya {{name}} dan saya berumur {{age}} tahun!", // Since intlayer v8, insertion function is not required anymore. The content will be automatically decorated.
-  },
-} satisfies Dictionary;
-
-export default myInsertionContent;
-```
+Untuk menyiapkan konten penyisipan dalam proyek Intlayer Anda, buat modul konten yang mencakup definisi penyisipan Anda.
+
+<Tabs>
+  <Tab label="Pembungkusan Manual" value="manual-wrapping">
+    Gunakan fungsi `insert` untuk mendeklarasikan konten penyisipan secara eksplisit.
+
+    ```typescript fileName="**/*.content.ts" contentDeclarationFormat="typescript"
+    import { insert, type Dictionary } from "intlayer";
+
+    const myInsertionContent = {
+      key: "my_key",
+      content: {
+        myInsertion: insert(
+          "Halo, nama saya {{name}} dan saya berumur {{age}} tahun!"
+        ),
+      },
+    } satisfies Dictionary;
+
+    export default myInsertionContent;
+    ```
+
+    ```javascript fileName="**/*.content.mjs" contentDeclarationFormat="esm"
+    import { insert } from "intlayer";
+
+    /** @type {import('intlayer').Dictionary} */
+    const myInsertionContent = {
+      key: "my_key",
+      content: {
+        myInsertion: insert(
+          "Halo, nama saya {{name}} dan saya berumur {{age}} tahun!"
+        ),
+      },
+    };
+
+    export default myInsertionContent;
+    ```
+
+    ```javascript fileName="**/*.content.cjs" contentDeclarationFormat="commonjs"
+    const { insert } = require("intlayer");
+
+    /** @type {import('intlayer').Dictionary} */
+    const myInsertionContent = {
+      key: "my_key",
+      content: {
+        myInsertion: insert(
+          "Halo, nama saya {{name}} dan saya berumur {{age}} tahun!"
+        ),
+      },
+    };
+
+    module.exports = myInsertionContent;
+    ```
+
+    ```json5 fileName="**/*.content.json" contentDeclarationFormat="json"
+    {
+      "$schema": "https://intlayer.org/schema.json",
+      "key": "my_key",
+      "content": {
+        "myInsertion": {
+          "nodeType": "insertion",
+          "insertion": "Halo, nama saya {{name}} dan saya berumur {{age}} tahun!",
+        },
+      },
+    }
+    ```
+
+  </Tab>
+  <Tab label="Deteksi Otomatis" value="automatic-detection">
+    Jika string mengandung indikator penyisipan umum (seperti `{{name}}`), Intlayer akan secara otomatis mengubahnya.
+
+    ```typescript fileName="**/*.content.ts" contentDeclarationFormat="typescript"
+    import { type Dictionary } from "intlayer";
+
+    const myInsertionContent = {
+      key: "my_key",
+      content: {
+        myInsertion: "Halo, nama saya {{name}} dan saya berumur {{age}} tahun!",
+      },
+    } satisfies Dictionary;
+
+    export default myInsertionContent;
+    ```
+
+    ```javascript fileName="**/*.content.mjs" contentDeclarationFormat="esm"
+    /** @type {import('intlayer').Dictionary} */
+    const myInsertionContent = {
+      key: "my_key",
+      content: {
+        myInsertion: "Halo, nama saya {{name}} dan saya berumur {{age}} tahun!",
+      },
+    };
+
+    export default myInsertionContent;
+    ```
+
+    ```javascript fileName="**/*.content.cjs" contentDeclarationFormat="commonjs"
+    /** @type {import('intlayer').Dictionary} */
+    const myInsertionContent = {
+      key: "my_key",
+      content: {
+        myInsertion: "Halo, nama saya {{name}} dan saya berumur {{age}} tahun!",
+      },
+    };
+
+    module.exports = myInsertionContent;
+    ```
+
+    ```json5 fileName="**/*.content.json" contentDeclarationFormat="json"
+    {
+      "$schema": "https://intlayer.org/schema.json",
+      "key": "my_key",
+      "content": {
+        "myInsertion": "Halo, nama saya {{name}} dan saya berumur {{age}} tahun!",
+      },
+    }
+    ```
+
+  </Tab>
+</Tabs>
 
 ```javascript fileName="**/*.content.mjs" contentDeclarationFormat="esm"
 import { insert } from "intlayer";

package/docs/id/intlayer_with_adonisjs.md

@@ -41,6 +41,16 @@ Dengan menginternasionalkan backend, aplikasi Anda tidak hanya menghormati perbe
 
 ## Memulai
 
+<iframe
+  src="https://stackblitz.com/github/aymericzip/intlayer-adonisjs-template?embed=1&ctl=1&file=intlayer.config.ts"
+  className="m-auto overflow-hidden rounded-lg border-0 max-md:size-full max-md:h-[700px] md:aspect-16/9 md:w-full"
+  title="Demo CodeSandbox - How to Internationalize your application using Intlayer"
+  sandbox="allow-forms allow-modals allow-popups allow-presentation allow-same-origin allow-scripts"
+  loading="lazy"
+/>
+
+Lihat [Application Template](https://github.com/aymericzip/intlayer-adonisjs-template) di GitHub.
+
 ### Instalasi
 
 Untuk mulai menggunakan `adonis-intlayer`, instal paket menggunakan npm:

package/docs/id/intlayer_with_express.md

@@ -44,6 +44,16 @@ Dengan menginternasionalisasi backend, aplikasi Anda tidak hanya menghormati per
 
 ## Memulai
 
+<iframe
+  src="https://stackblitz.com/github/aymericzip/intlayer-express-template?embed=1&ctl=1&file=intlayer.config.ts"
+  className="m-auto overflow-hidden rounded-lg border-0 max-md:size-full max-md:h-[700px] md:aspect-16/9 md:w-full"
+  title="Demo CodeSandbox - How to Internationalize your application using Intlayer"
+  sandbox="allow-forms allow-modals allow-popups allow-presentation allow-same-origin allow-scripts"
+  loading="lazy"
+/>
+
+Lihat [Application Template](https://github.com/aymericzip/intlayer-express-template) di GitHub.
+
 ### Instalasi
 
 Untuk mulai menggunakan `express-intlayer`, instal paket menggunakan npm:

package/docs/id/intlayer_with_fastify.md

@@ -46,6 +46,16 @@ Dengan melakukan internasionalisasi pada backend, aplikasi Anda tidak hanya meng
 
 ## Memulai
 
+<iframe
+  src="https://stackblitz.com/github/aymericzip/intlayer-fastify-template?embed=1&ctl=1&file=intlayer.config.ts"
+  className="m-auto overflow-hidden rounded-lg border-0 max-md:size-full max-md:h-[700px] md:aspect-16/9 md:w-full"
+  title="Demo CodeSandbox - How to Internationalize your application using Intlayer"
+  sandbox="allow-forms allow-modals allow-popups allow-presentation allow-same-origin allow-scripts"
+  loading="lazy"
+/>
+
+Lihat [Application Template](https://github.com/aymericzip/intlayer-fastify-template) di GitHub.
+
 ### Instalasi
 
 Untuk mulai menggunakan `fastify-intlayer`, pasang paket menggunakan npm:

package/docs/id/intlayer_with_hono.md

@@ -44,6 +44,16 @@ Dengan menginternasionalisasi backend, aplikasi Anda tidak hanya menghormati per
 
 ## Memulai
 
+<iframe
+  src="https://stackblitz.com/github/aymericzip/intlayer-hono-template?embed=1&ctl=1&file=intlayer.config.ts"
+  className="m-auto overflow-hidden rounded-lg border-0 max-md:size-full max-md:h-[700px] md:aspect-16/9 md:w-full"
+  title="Demo CodeSandbox - How to Internationalize your application using Intlayer"
+  sandbox="allow-forms allow-modals allow-popups allow-presentation allow-same-origin allow-scripts"
+  loading="lazy"
+/>
+
+Lihat [Application Template](https://github.com/aymericzip/intlayer-hono-template) di GitHub.
+
 ### Instalasi
 
 Untuk mulai menggunakan `hono-intlayer`, instal paket menggunakan npm:

package/docs/it/dictionary/html.md

@@ -46,8 +46,9 @@ Puoi dichiarare contenuti HTML usando la funzione `html` o semplicemente come st
 
     const htmlDictionary = {
       key: "app",
+      contentAutoTransformation: true, // può essere impostato nel file di configurazione
       content: {
-        myHtmlContent: html("<p>Ciao <strong>Mondo</strong></p>"),
+        myHtmlContent:  html("<p>Ciao <strong>Mondo</strong></p>"),
       },
     } satisfies Dictionary;
 
@@ -61,8 +62,9 @@ Puoi dichiarare contenuti HTML usando la funzione `html` o semplicemente come st
     ```typescript fileName="htmlDictionary.content.ts"
     export default {
       key: "app",
+      contentAutoTransformation: true, // può essere impostato nel file di configurazione
       content: {
-        myHtmlContent: "<p>Ciao <strong>Mondo</strong></p>",
+        myHtmlContent:  "<p>Ciao <strong>Mondo</strong></p>",
       },
     };
     ```