@intlayer/docs 5.8.1 → 6.0.0-canary.1

package/docs/it/dictionary/get_started.md

@@ -1,573 +0,0 @@
----
-createdAt: 2024-08-11
-updatedAt: 2025-06-29
-title: Dizionario | Iniziare
-description: Scopri come dichiarare e utilizzare dizionari nel tuo sito web multilingue. Segui i passaggi in questa documentazione online per configurare il tuo progetto in pochi minuti.
-keywords:
-  - Iniziare
-  - Internazionalizzazione
-  - Documentazione
-  - Intlayer
-  - Next.js
-  - JavaScript
-  - React
-slugs:
-  - doc
-  - concept
-  - content
----
-
-# Iniziare la dichiarazione del tuo contenuto
-
-<iframe title="i18n, Markdown, JSON… una soluzione unica per gestire tutto | Intlayer" class="m-auto aspect-[16/9] w-full overflow-hidden rounded-lg border-0" allow="autoplay; gyroscope;" loading="lazy" width="1080" height="auto" src="https://www.youtube.com/embed/1VHgSY_j9_I?autoplay=0&amp;origin=http://intlayer.org&amp;controls=0&amp;rel=1"/>
-
-## Estensioni dei file
-
-Per impostazione predefinita, Intlayer monitora tutti i file con le seguenti estensioni per le dichiarazioni di contenuto:
-
-- `.content.json`
-- `.content.ts`
-- `.content.tsx`
-- `.content.js`
-- `.content.jsx`
-- `.content.mjs`
-- `.content.mjx`
-- `.content.cjs`
-- `.content.cjx`
-
-L'applicazione cercherà per impostazione predefinita i file che corrispondono al pattern glob `./src/**/*.content.{json,ts,tsx,js,jsx,mjs,mjx,cjs,cjx}`.
-
-Queste estensioni predefinite sono adatte alla maggior parte delle applicazioni. Tuttavia, se hai requisiti specifici, consulta la [guida alla personalizzazione delle estensioni di contenuto](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/configuration.md#content-configuration) per le istruzioni su come gestirle.
-
-Per un elenco completo delle opzioni di configurazione, visita la documentazione sulla configurazione.
-
-## Dichiara il tuo contenuto
-
-Crea e gestisci i tuoi dizionari:
-
-```tsx fileName="src/example.content.tsx" contentDeclarationFormat="typescript"
-import { type ReactNode } from "react";
-import {
-  t,
-  enu,
-  cond,
-  nest,
-  md,
-  insert,
-  file,
-  type Dictionary,
-} from "intlayer";
-
-interface Content {
-  imbricatedContent: {
-    imbricatedContent2: {
-      stringContent: string;
-      numberContent: number;
-      booleanContent: boolean;
-      javaScriptContent: string;
-    };
-  };
-  multilingualContent: string;
-  quantityContent: string;
-  conditionalContent: string;
-  markdownContent: never;
-  externalContent: string;
-  insertionContent: string;
-  nestedContent: string;
-  fileContent: string;
-  jsxContent: ReactNode;
-}
-
-export default {
-  key: "page",
-  content: {
-    imbricatedContent: {
-      imbricatedContent2: {
-        stringContent: "Ciao Mondo", // Contenuto stringa
-        numberContent: 123, // Contenuto numero
-        booleanContent: true, // Contenuto booleano
-        javaScriptContent: `${process.env.NODE_ENV}`, // Contenuto JavaScript
-      },
-    },
-    multilingualContent: t({
-      en: "English content",
-      "en-GB": "English content (UK)",
-      fr: "French content",
-      es: "Spanish content",
-    }),
-    quantityContent: enu({
-      "<-1": "Meno di meno uno auto",
-      "-1": "Meno uno auto",
-      "0": "Nessuna auto",
-      "1": "Una auto",
-      ">5": "Alcune auto",
-      ">19": "Molte auto",
-    }),
-    conditionalContent: cond({
-      true: "La validazione è abilitata",
-      false: "La validazione è disabilitata",
-    }),
-    insertionContent: insert("Ciao {{name}}!"),
-    nestedContent: nest(
-      "navbar", // La chiave del dizionario da annidare
-      "login.button" // [Opzionale] Il percorso al contenuto da annidare
-    ),
-    fileContent: file("./path/to/file.txt"),
-    externalContent: fetch("https://example.com").then((res) => res.json()),
-    markdownContent: md("# Esempio di Markdown"),
-
-    /*
-     * Disponibile solo usando `react-intlayer` o `next-intlayer`
-     */
-    jsxContent: <h1>Il mio titolo</h1>,
-  },
-} satisfies Dictionary<Content>; // [opzionale] Dictionary è generico e ti permette di rafforzare il formato del tuo dizionario
-```
-
-```javascript fileName="src/example.content.mjx" contentDeclarationFormat="esm"
-import { t, enu, cond, nest, md, insert, file } from "intlayer";
-
-/** @type {import('intlayer').Dictionary} */
-export default {
-  key: "page",
-  content: {
-    imbricatedContent: {
-      imbricatedContent2: {
-        stringContent: "Ciao Mondo",
-        numberContent: 123,
-        booleanContent: true,
-        javaScriptContent: `${process.env.NODE_ENV}`, // Contenuto JavaScript dinamico
-      },
-      imbricatedArray: [1, 2, 3],
-    },
-    multilingualContent: t({
-      en: "English content",
-      "en-GB": "English content (UK)",
-      fr: "French content",
-      es: "Spanish content",
-    }),
-    quantityContent: enu({
-      "<-1": "Meno di meno uno auto",
-      "-1": "Meno uno auto",
-      "0": "Nessuna auto",
-      "1": "Una auto",
-      ">5": "Alcune auto",
-      ">19": "Molte auto",
-    }),
-    conditionalContent: cond({
-      true: "La validazione è abilitata",
-      false: "La validazione è disabilitata",
-    }),
-    insertionContent: insert("Ciao {{name}}!"),
-    nestedContent: nest(
-      "navbar", // La chiave del dizionario da annidare
-      "login.button" // [Opzionale] Il percorso al contenuto da annidare
-    ),
-    markdownContent: md("# Esempio di Markdown"),
-    fileContent: file("./path/to/file.txt"),
-    externalContent: fetch("https://example.com").then((res) => res.json())
-
-    // Disponibile solo usando `react-intlayer` o `next-intlayer`
-    jsxContent: <h1>Il mio titolo</h1>,
-  },
-};
-```
-
-```javascript fileName="src/example.content.cjx" contentDeclarationFormat="commonjs"
-const { t, enu, cond, nest, md, insert, file } = require("intlayer");
-
-/** @type {import('intlayer').Dictionary} */
-module.exports = {
-  key: "page",
-  content: {
-    imbricatedContent: {
-      imbricatedContent2: {
-        stringContent: "Ciao Mondo",
-        numberContent: 123,
-        booleanContent: true,
-        javaScriptContent: `${process.env.NODE_ENV}`, // Contenuto JavaScript dinamico
-      },
-      imbricatedArray: [1, 2, 3], // Array annidato
-    },
-    multilingualContent: t({
-      en: "English content",
-      "en-GB": "English content (UK)",
-      fr: "Contenuto francese",
-      es: "Contenuto spagnolo",
-    }),
-    quantityContent: enu({
-      "<-1": "Meno di meno uno auto",
-      "-1": "Meno uno auto",
-      "0": "Nessuna auto",
-      "1": "Una macchina",
-      ">5": "Alcune macchine",
-      ">19": "Molte macchine",
-    }),
-    conditionalContent: cond({
-      true: "La validazione è abilitata",
-      false: "La validazione è disabilitata",
-    }),
-    insertionContent: insert("Ciao {{name}}!"),
-    nestedContent: nest(
-      "navbar", // La chiave del dizionario da nidificare
-      "login.button" // [Opzionale] Il percorso al contenuto da nidificare
-    ),
-    markdownContent: md("# Esempio di Markdown"),
-    fileContent: file("./path/to/file.txt"),
-    externalContent: fetch("https://example.com").then((res) => res.json())
-
-    // Disponibile solo usando `react-intlayer` o `next-intlayer`
-    jsxContent: <h1>Il mio titolo</h1>,
-  },
-};
-```
-
-```json5 fileName="src/example.content.json"  contentDeclarationFormat="json"
-{
-  "$schema": "https://intlayer.org/schema.json",
-  "key": "page",
-  "content": {
-    "imbricatedContent": {
-      "imbricatedContent2": {
-        "stringContent": "Ciao Mondo",
-        "numberContent": 123,
-        "booleanContent": true,
-      },
-      "imbricatedArray": [1, 2, 3],
-    },
-    "multilingualContent": {
-      "nodeType": "translation",
-      "translation": {
-        "en": "Contenuto in inglese",
-        "en-GB": "Contenuto in inglese (UK)",
-        "fr": "Contenuto in francese",
-        "es": "Contenuto in spagnolo",
-      },
-    },
-    "quantityContent": {
-      "nodeType": "enumeration",
-      "enumeration": {
-        "0": "Nessuna macchina",
-        "1": "Una macchina",
-        "<-1": "Meno di meno una macchina",
-        "-1": "Meno una macchina",
-        ">5": "Alcune macchine",
-        ">19": "Molte macchine",
-      },
-    },
-    "conditionalContent": {
-      "nodeType": "condition",
-      "condition": {
-        "true": "La validazione è abilitata",
-        "false": "La validazione è disabilitata",
-      },
-    },
-    "insertionContent": {
-      "nodeType": "insertion",
-      "insertion": "Ciao {{name}}!",
-    },
-    "nestedContent": {
-      "nodeType": "nested",
-      "nested": { "dictionaryKey": "app" },
-    },
-    "markdownContent": {
-      "nodeType": "markdown",
-      "markdown": "# Esempio di Markdown",
-    },
-    "fileContent": {
-      "nodeType": "file",
-      "file": "./path/to/file.txt",
-    },
-    "jsxContent": {
-      "type": "h1",
-      "key": null,
-      "ref": null,
-      "props": {
-        "children": ["Il mio titolo"],
-      },
-    },
-  },
-}
-```
-
-## Imbricazione di funzioni
-
-Puoi senza problemi imbricare funzioni dentro altre funzioni.
-
-Esempio :
-
-```javascript fileName="src/example.content.tsx" contentDeclarationFormat="typescript"
-import { t, enu, cond, nest, md, type Dictionary } from "intlayer";
-
-const getName = async () => "John Doe";
-
-export default {
-  key: "page",
-  content: {
-    // `getIntlayer('page','en').hiMessage` restituisce `['Hi', ' ', 'John Doe']`
-    hiMessage: [
-      t({
-        en: "Hi",
-        fr: "Salut",
-        es: "Hola",
-      }),
-      " ",
-      getName(),
-    ],
-    // Contenuto composito che imbrica condizione, enumerazione e contenuto multilingue
-    // `getIntlayer('page','en').advancedContent(true)(10)` restituisce 'Multiple items found'
-    advancedContent: cond({
-      true: enu({
-        "0": t({
-          en: "No items found",
-          fr: "Aucun article trouvé",
-          es: "No se encontraron artículos",
-        }),
-        "1": t({
-          en: "One item found",
-          fr: "Un article trouvé",
-          es: "Se encontró un artículo",
-        }),
-        ">1": t({
-          en: "Multiple items found",
-          fr: "Plusieurs articles trouvés",
-          es: "Se encontraron múltiples artículos",
-        }),
-      }),
-      false: t({
-        en: "No valid data available",
-        fr: "Aucune donnée valide disponible",
-        es: "No hay datos válidos disponibles",
-      }),
-    }),
-  },
-} satisfies Dictionary;
-```
-
-```javascript fileName="src/example.content.mjx" contentDeclarationFormat="esm"
-import { t, enu, cond, nest, md } from "intlayer";
-
-const getName = async () => "John Doe";
-
-/** @type {import('intlayer').Dictionary} */
-export default {
-  key: "page",
-  content: {
-    // `getIntlayer('page','en').hiMessage` restituisce `['Hi', ' ', 'John Doe']`
-    hiMessage: [
-      t({
-        en: "Hi",
-        fr: "Salut",
-        es: "Hola",
-      }),
-      " ",
-      getName(),
-    ],
-    // Contenuto composito che imbrica condizione, enumerazione e contenuto multilingue
-    // `getIntlayer('page','en').advancedContent(true)(10)` restituisce 'Multiple items found'
-    advancedContent: cond({
-      true: enu({
-        "0": t({
-          en: "No items found",
-          fr: "Aucun article trouvé",
-          es: "No se encontraron artículos",
-        }),
-        "1": t({
-          en: "One item found",
-          fr: "Un article trouvé",
-          es: "Se encontró un artículo",
-        }),
-        ">1": t({
-          en: "Multiple items found",
-          fr: "Plusieurs articles trouvés",
-          es: "Se encontraron múltiples artículos",
-        }),
-      }),
-      false: t({
-        en: "No valid data available",
-        fr: "Aucune donnée valide disponible",
-        es: "No hay datos válidos disponibles",
-      }),
-    }),
-  },
-};
-
-/** @type {import('intlayer').Dictionary} */
-export default {
-  key: "page",
-  content: {
-    // `getIntlayer('page','en').hiMessage` restituisce `['Ciao', ' ', 'John Doe']`
-    hiMessage: [
-      t({
-        en: "Hi",
-        fr: "Salut",
-        es: "Hola",
-      }),
-      " ",
-      getName(),
-    ],
-    // Contenuto composito che combina condizione, enumerazione e contenuto multilingue
-    // `getIntlayer('page','en').advancedContent(true)(10) restituisce 'Più elementi trovati'`
-    advancedContent: cond({
-      true: enu({
-        "0": t({
-          en: "No items found",
-          fr: "Aucun article trouvé",
-          es: "No se encontraron artículos",
-        }),
-        "1": t({
-          en: "One item found",
-          fr: "Un article trouvé",
-          es: "Se encontró un artículo",
-/        }),
-        ">1": t({
-          en: "Multiple items found",
-          fr: "Plusieurs articles trouvés",
-          es: "Se encontraron múltiples artículos",
-        }),
-      }),
-      false: t({
-        en: "Nessun dato valido disponibile",
-        fr: "Aucune donnée valide disponible",
-        es: "No hay datos válidos disponibles",
-      }),
-    }),
-  },
-};
-```
-
-```javascript fileName="src/example.content.cjx" contentDeclarationFormat="commonjs"
-const { t, enu, cond, nest, md } = require("intlayer");
-
-const getName = async () => "John Doe";
-
-/** @type {import('intlayer').Dictionary} */
-module.exports = {
-  key: "page",
-  content: {
-    // `getIntlayer('page','en').hiMessage` restituisce `['Hi', ' ', 'John Doe']`
-    hiMessage: [
-      t({
-        en: "Hi",
-        fr: "Salut",
-        es: "Hola",
-      }),
-      " ",
-      getName(),
-    ],
-    // Contenuto composito che combina condizione, enumerazione e contenuto multilingue
-    // `getIntlayer('page','en').advancedContent(true)(10) restituisce 'Multiple items found'`
-    advancedContent: cond({
-      true: enu({
-        "0": t({
-          en: "No items found",
-          fr: "Aucun article trouvé",
-          es: "No se encontraron artículos",
-        }),
-        "1": t({
-          en: "One item found",
-          fr: "Un article trouvé",
-          es: "Se encontró un artículo",
-        }),
-        ">1": t({
-          en: "Multiple items found",
-          fr: "Plusieurs articles trouvés",
-          es: "Se encontraron múltiples artículos",
-        }),
-      }),
-      false: t({
-        en: "No valid data available",
-        fr: "Aucune donnée valide disponible",
-        es: "No hay datos válidos disponibles",
-      }),
-    }),
-  },
-};
-```
-
-```json5 fileName="src/example.content.json"  contentDeclarationFormat="json"
-{
-  "$schema": "https://intlayer.org/schema.json",
-  "key": "page",
-  "content": {
-    "hiMessage": {
-      "nodeType": "composite",
-      "composite": [
-        {
-          "nodeType": "translation",
-          "translation": {
-            en: "Hi",
-            fr: "Salut",
-            es: "Hola",
-          },
-        },
-        " ",
-        "John Doe",
-      ],
-    },
-    "advancedContent": {
-      "nodeType": "condition",
-      "condition": {
-        "true": {
-          "nodeType": "enumeration",
-          "enumeration": {
-            "0": {
-              "nodeType": "translation",
-              "translation": {
-                "en": "No items found",
-                "it": "Nessun elemento trovato",
-                "fr": "Aucun article trouvé",
-                "es": "No se encontraron artículos",
-              },
-            },
-            "1": {
-              "nodeType": "translation",
-              "translation": {
-                "en": "One item found",
-                "it": "Un elemento trovato",
-                "fr": "Un article trouvé",
-                "es": "Se encontró un artículo",
-              },
-            },
-            ">1": {
-              "nodeType": "translation",
-              "translation": {
-                "en": "Multiple items found",
-                "it": "Più elementi trovati",
-                "fr": "Plusieurs articles trouvés",
-                "es": "Se encontraron múltiples artículos",
-              },
-            },
-          },
-        },
-        "false": {
-          "nodeType": "translation",
-          "translation": {
-            "en": "No valid data available",
-            "fr": "Aucune donnée valide disponible",
-            "es": "No hay datos válidos disponibles",
-          },
-        },
-      },
-    },
-  },
-}
-```
-
-## Risorse Aggiuntive
-
-Per maggiori dettagli su Intlayer, fare riferimento alle seguenti risorse:
-
-- [Documentazione sulla Dichiarazione di Contenuti per Locale](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/dictionary/per_locale_file.md)
-- [Documentazione sul Contenuto di Traduzione](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/dictionary/translation.md)
-- [Documentazione sul Contenuto di Enumerazione](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/dictionary/enumeration.md)
-- [Documentazione del Contenuto Condizionale](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/dictionary/condition.md)
-- [Documentazione del Contenuto di Inserimento](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/dictionary/insertion.md)
-- [Documentazione del Contenuto File](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/dictionary/file.md)
-- [Documentazione del Contenuto Annidato](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/dictionary/nesting.md)
-- [Documentazione del Contenuto Markdown](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/dictionary/markdown.md)
-- [Documentazione del Contenuto di Recupero Funzioni](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/dictionary/function_fetching.md)
-
-## Cronologia del Documento
-
-- 5.5.10 - 2025-06-29: Storia iniziale

package/docs/ja/dictionary/content_extention_customization.md

@@ -1,113 +0,0 @@
----
-createdAt: 2025-02-07
-updatedAt: 2025-06-29
-title: コンテンツ拡張子のカスタマイズ
-description: コンテンツ宣言ファイルの拡張子をカスタマイズする方法を学びます。このドキュメントに従って、プロジェクトで条件を効率的に実装してください。
-keywords:
-  - コンテンツ拡張子のカスタマイズ
-  - ドキュメント
-  - Intlayer
-slugs:
-  - doc
-  - concept
-  - content
----
-
-# コンテンツ拡張子のカスタマイズ
-
-## コンテンツファイルの拡張子
-
-Intlayerでは、コンテンツ宣言ファイルの拡張子をカスタマイズすることができます。このカスタマイズにより、大規模プロジェクトの管理が柔軟になり、他のモジュールとの競合を回避するのに役立ちます。
-
-### デフォルトの拡張子
-
-デフォルトでは、Intlayerは以下の拡張子を持つすべてのファイルをコンテンツ宣言用として監視します：
-
-- `.content.json`
-- `.content.ts`
-- `.content.tsx`
-- `.content.js`
-- `.content.jsx`
-- `.content.mjs`
-- `.content.mjx`
-- `.content.cjs`
-- `.content.cjx`
-
-これらのデフォルト拡張子はほとんどのアプリケーションに適しています。しかし、特定のニーズがある場合は、カスタム拡張子を定義してビルドプロセスを効率化し、他のコンポーネントとの競合リスクを減らすことができます。
-
-### コンテンツ拡張子のカスタマイズ
-
-Intlayerがコンテンツ宣言ファイルを識別するために使用するファイル拡張子をカスタマイズするには、Intlayerの設定ファイルでそれらを指定できます。この方法は、監視プロセスの範囲を制限することでビルドパフォーマンスを向上させる大規模プロジェクトに特に有効です。
-
-以下は、設定ファイルでカスタムコンテンツ拡張子を定義する例です：
-
-```typescript fileName="intlayer.config.ts" codeFormat="typescript"
-import type { IntlayerConfig } from "intlayer";
-
-const config: IntlayerConfig = {
-  content: {
-    fileExtensions: [".my_content.ts", ".my_content.tsx"], // あなたのカスタム拡張子
-  },
-};
-
-export default config;
-```
-
-```javascript fileName="intlayer.config.mjs" codeFormat="esm"
-/** @type {import('intlayer').IntlayerConfig} */
-const config = {
-  content: {
-    fileExtensions: [".my_content.cjs", ".my_content.cjx"], // あなたのカスタム拡張子
-  },
-};
-
-export default config;
-```
-
-```javascript fileName="intlayer.config.cjs" codeFormat="commonjs"
-/** @type {import('intlayer').IntlayerConfig} */
-const config = {
-  content: {
-    fileExtensions: [".my_content.mjs", ".my_content.mjx"], // あなたのカスタム拡張子
-  },
-};
-
-module.exports = config;
-```
-
-この例では、設定ファイルで2つのカスタム拡張子 `.my_content.ts` と `.my_content.tsx` が指定されています。Intlayerはこれらの拡張子を持つファイルのみを監視して辞書を構築します。
-
-### カスタム拡張子の利点
-
-- **ビルドパフォーマンス**: 監視対象のファイル範囲を絞ることで、大規模プロジェクトにおけるビルドパフォーマンスが大幅に向上します。
-- **競合回避**: カスタム拡張子は、プロジェクト内の他のJavaScriptやTypeScriptファイルとの競合を防ぐのに役立ちます。
-- **整理整頓**: カスタム拡張子を使用することで、プロジェクトのニーズに応じてコンテンツ宣言ファイルを整理することができます。
-
-### カスタム拡張子のガイドライン
-
-コンテンツファイルの拡張子をカスタマイズする際は、以下のガイドラインを守ってください。
-
-- **一意性**: 競合を避けるために、プロジェクト内で一意の拡張子を選択してください。
-- **一貫した命名**: コードの可読性と保守性を高めるために、一貫した命名規則を使用してください。
-- **一般的な拡張子の回避**: 他のモジュールやライブラリとの競合を防ぐために、`.ts`や`.js`などの一般的な拡張子の使用は避けてください。
-
-## 結論
-
-- **競合回避**: カスタム拡張子は、プロジェクト内の他のJavaScriptやTypeScriptファイルとの競合を防ぐのに役立ちます。
-- **整理整頓**: カスタム拡張子を使用することで、プロジェクトのニーズに応じてコンテンツ宣言ファイルを整理できます。
-
-### カスタム拡張子のガイドライン
-
-コンテンツファイルの拡張子をカスタマイズする際は、以下のガイドラインを守ってください：
-
-- **一意性**: プロジェクト内で一意の拡張子を選び、競合を避けること。
-- **一貫した命名**: コードの可読性とメンテナンス性を高めるために、一貫した命名規則を使用すること。
-- **一般的な拡張子の回避**: `.ts` や `.js` のような一般的な拡張子は、他のモジュールやライブラリとの競合を避けるために使用しないこと。
-
-## 結論
-
-Intlayerでコンテンツファイルの拡張子をカスタマイズすることは、大規模アプリケーションのパフォーマンス最適化や競合回避に役立つ重要な機能です。本ドキュメントで示したガイドラインに従うことで、コンテンツ宣言を効果的に管理し、プロジェクトの他の部分とのスムーズな統合を実現できます。
-
-## ドキュメント履歴
-
-- 5.5.10 - 2025-06-29: 履歴初期化