@intlayer/docs 5.5.10 → 5.5.12

package/docs/it/packages/@intlayer/core/index.md

@@ -0,0 +1,49 @@
+---
+createdAt: 2025-02-07
+updatedAt: 2025-06-29
+title: @intlayer/core - Funzioni Core per l'i18n di Intlayer
+description: Pacchetto NPM contenente funzioni core per Intlayer, incluse funzioni di traduzione, funzioni di dizionario e funzioni di utilità per l'internazionalizzazione.
+keywords:
+  - intlayer
+  - core
+  - traduzione
+  - dizionario
+  - utilità
+  - i18n
+  - JavaScript
+  - NPM
+slugs:
+  - doc
+  - package
+  - @intlayer_core
+---
+
+# @intlayer/core: Pacchetto NPM contenente le funzioni core di Intlayer
+
+**Intlayer** è una suite di pacchetti progettata specificamente per sviluppatori JavaScript. È compatibile con framework come React, React e Express.js.
+
+**Il pacchetto `@intlayer/core`** è un pacchetto NPM che include le funzioni core di Intlayer condivise da più pacchetti. Include in particolare:
+
+- Funzioni di traduzione
+- Funzioni di dizionario
+- Funzioni di utilità
+
+## Installazione
+
+Installa il pacchetto necessario utilizzando il tuo gestore di pacchetti preferito:
+
+```bash packageManager="npm"
+npm install @intlayer/core
+```
+
+```bash packageManager="pnpm"
+pnpm add @intlayer/core
+```
+
+```bash packageManager="yarn"
+yarn add @intlayer/core
+```
+
+## Cronologia della documentazione
+
+- 5.5.10 - 2025-06-29: Storia iniziale

package/docs/it/packages/@intlayer/design-system/index.md

@@ -0,0 +1,45 @@
+---
+createdAt: 2025-02-07
+updatedAt: 2025-06-29
+title: @intlayer/design-system - Componenti UI per Intlayer
+description: Pacchetto NPM contenente componenti del design system ed elementi UI per costruire interfacce utente coerenti con l'internazionalizzazione Intlayer.
+keywords:
+  - intlayer
+  - design system
+  - componenti UI
+  - interfaccia
+  - i18n
+  - JavaScript
+  - NPM
+  - styling
+slugs:
+  - doc
+  - package
+  - @intlayer_design-system
+---
+
+# @intlayer/design-system: Pacchetto NPM contenente la libreria UI di Intlayer
+
+**Intlayer** è una suite di pacchetti progettata specificamente per sviluppatori JavaScript. È compatibile con framework come React, React e Express.js.
+
+Il pacchetto **`@intlayer/design-system`** è un pacchetto NPM che include il design system di Intlayer. Questo pacchetto è utilizzato in particolare dall'[editor Intlayer](https://github.com/aymericzip/intlayer/tree/main/docs/it/packages/intlayer-editor/index.md), nel [Sito Web](https://intlayer.org) e nell'[Editor Visivo / CMS](https://intlayer.org/dashboard).
+
+## Installazione
+
+Installa il pacchetto necessario utilizzando il tuo gestore di pacchetti preferito:
+
+```bash packageManager="npm"
+npm install @intlayer/design-system
+```
+
+```bash packageManager="pnpm"
+pnpm add @intlayer/design-system
+```
+
+```bash packageManager="yarn"
+yarn add @intlayer/design-system
+```
+
+## Cronologia della documentazione
+
+- 5.5.10 - 2025-06-29: Inizio cronologia

package/docs/it/packages/@intlayer/dictionary-entry/index.md

@@ -0,0 +1,45 @@
+---
+createdAt: 2025-02-07
+updatedAt: 2025-06-29
+title: @intlayer/dictionary-entry - Gestione del Dizionario per Intlayer
+description: Pacchetto NPM per la gestione delle voci del dizionario in Intlayer, che fornisce utility per creare, aggiornare e organizzare dizionari di traduzione.
+keywords:
+  - intlayer
+  - dizionario
+  - voci
+  - gestione
+  - traduzione
+  - i18n
+  - JavaScript
+  - NPM
+slugs:
+  - doc
+  - package
+  - @intlayer_dictionary-entry
+---
+
+# @intlayer/dictionary-entry: Pacchetto NPM per recuperare i dizionari di Intlayer
+
+**Intlayer** è una suite di pacchetti progettata specificamente per sviluppatori JavaScript. È compatibile con framework come React, React e Express.js.
+
+Il pacchetto **`@intlayer/dictionary-entry`** è un pacchetto NPM che restituisce solo il percorso di ingresso dei dizionari intlayer. Poiché la ricerca nel filesystem è impossibile dal browser, utilizzare bundler come Webpack o Rollup per recuperare il percorso di ingresso dei dizionari non è possibile. Questo pacchetto è pensato per essere aliasato.
+
+## Installazione
+
+Installa il pacchetto necessario utilizzando il tuo gestore di pacchetti preferito:
+
+```bash packageManager="npm"
+npm install @intlayer/dictionary-entry
+```
+
+```bash packageManager="pnpm"
+pnpm add @intlayer/dictionary-entry
+```
+
+```bash packageManager="yarn"
+yarn add @intlayer/dictionary-entry
+```
+
+## Cronologia della documentazione
+
+- 5.5.10 - 2025-06-29: Inizializzazione della cronologia

package/docs/it/packages/@intlayer/editor/index.md

@@ -0,0 +1,45 @@
+---
+createdAt: 2025-02-07
+updatedAt: 2025-06-29
+title: @intlayer/editor - Pacchetto Interfaccia Editor Intlayer
+description: Pacchetto NPM che fornisce utility per interfacciare le applicazioni con l'editor Intlayer e manipolare dizionari in tutti i framework JavaScript.
+keywords:
+  - intlayer
+  - editor
+  - dizionario
+  - interfaccia
+  - NPM
+  - JavaScript
+  - utility
+  - multipiattaforma
+slugs:
+  - doc
+  - package
+  - @intlayer_editor
+---
+
+# @intlayer/editor: Pacchetto NPM che fornisce utility per interfacciare l'applicazione con l'editor Intlayer e manipolare dizionari
+
+**Intlayer** è una suite di pacchetti progettata specificamente per sviluppatori JavaScript. È compatibile con framework come React, Next.js e Express.js.
+
+Il pacchetto **`intlayer-editor`** fornisce utility per interfacciare l'applicazione con l'editor Intlayer. Include l'API per interagire con l'editor e utility per manipolare i dizionari. Questo pacchetto è multipiattaforma.
+
+## Installazione
+
+Installa il pacchetto necessario utilizzando il tuo gestore di pacchetti preferito:
+
+```bash
+npm install @intlayer/editor
+```
+
+```bash
+yarn add @intlayer/editor
+```
+
+```bash
+pnpm add @intlayer/editor
+```
+
+## Cronologia della documentazione
+
+- 5.5.10 - 2025-06-29: Storia iniziale

package/docs/it/packages/@intlayer/editor-react/index.md

@@ -0,0 +1,45 @@
+---
+createdAt: 2025-02-07
+updatedAt: 2025-06-29
+title: @intlayer/editor-react - Componenti React per Intlayer Editor
+description: Pacchetto NPM che fornisce componenti e hook React per integrare l'editor visuale Intlayer nelle applicazioni React per l'internazionalizzazione.
+keywords:
+  - intlayer
+  - editor
+  - React
+  - componenti
+  - hook
+  - i18n
+  - JavaScript
+  - NPM
+slugs:
+  - doc
+  - package
+  - @intlayer_editor-react
+---
+
+# @intlayer/editor-react: Pacchetto NPM che fornisce Stati, Contesti, Hook e Componenti React per interagire con l'editor Intlayer
+
+**Intlayer** è una suite di pacchetti progettata specificamente per sviluppatori JavaScript. È compatibile con framework come React, Next.js e Express.js.
+
+Il pacchetto **`@intlayer/editor-react`** fornisce stati, contesti, hook e componenti per interagire con l'editor Intlayer in un'applicazione React.
+
+## Installazione
+
+Installa il pacchetto necessario utilizzando il tuo gestore di pacchetti preferito:
+
+```bash
+npm install @intlayer/editor-react
+```
+
+```bash
+yarn add @intlayer/editor-react
+```
+
+```bash
+pnpm add @intlayer/editor-react
+```
+
+## Cronologia della documentazione
+
+- 5.5.10 - 2025-06-29: Storia iniziale

package/docs/it/packages/@intlayer/webpack/index.md

@@ -0,0 +1,59 @@
+---
+createdAt: 2025-02-07
+updatedAt: 2025-06-29
+title: @intlayer/webpack - Plugin Webpack per Intlayer i18n
+description: Pacchetto NPM che fornisce configurazione e plugin Webpack per un'integrazione fluida dell'internazionalizzazione Intlayer con applicazioni basate su Webpack.
+keywords:
+  - intlayer
+  - webpack
+  - plugin
+  - configurazione
+  - i18n
+  - JavaScript
+  - NPM
+  - bundler
+slugs:
+  - doc
+  - package
+  - @intlayer_webpack
+---
+
+# @intlayer/webpack: Pacchetto NPM per utilizzare il Plugin Webpack di Intlayer nella tua applicazione
+
+**Intlayer** è una suite di pacchetti progettata specificamente per sviluppatori JavaScript. È compatibile con framework come React, React e Express.js.
+
+Il pacchetto **`@intlayer/webpack`** viene utilizzato per fornire una configurazione Webpack che facilita l'uso di un'applicazione basata su Webpack con Intlayer. Il pacchetto fornisce anche un plugin da aggiungere a un'applicazione Webpack esistente.
+
+## Utilizzo
+
+```ts
+import { IntlayerPlugin } from "@intlayer/webpack";
+
+export default {
+  plugins: [
+    new IntlayerPlugin({
+      // Opzioni
+    }),
+  ],
+};
+```
+
+## Installazione
+
+Installa il pacchetto necessario utilizzando il tuo gestore di pacchetti preferito:
+
+```bash packageManager="npm"
+npm install @intlayer/webpack
+```
+
+```bash packageManager="pnpm"
+pnpm add @intlayer/webpack
+```
+
+```bash packageManager="yarn"
+yarn add @intlayer/webpack
+```
+
+## Cronologia della documentazione
+
+- 5.5.10 - 2025-06-29: Storia iniziale

package/docs/it/packages/angular-intlayer/index.md

@@ -0,0 +1,53 @@
+---
+createdAt: 2025-04-18
+updatedAt: 2025-06-29
+title: Documentazione del pacchetto | angular-intlayer
+description: Scopri come utilizzare il pacchetto angular-intlayer
+keywords:
+  - Intlayer
+  - angular-intlayer
+  - Internazionalizzazione
+  - Documentazione
+  - JavaScript
+  - Angular
+slugs:
+  - doc
+  - packages
+  - angular-intlayer
+---
+
+# angular-intlayer: Pacchetto NPM per internazionalizzare (i18n) un'applicazione Angular
+
+**Intlayer** è una suite di pacchetti progettata specificamente per sviluppatori JavaScript. È compatibile con framework come Angular, Angular e Express.js.
+
+**Il pacchetto `angular-intlayer`** ti permette di internazionalizzare la tua applicazione Angular. Fornisce provider di contesto e hook per l'internazionalizzazione in Angular.
+
+## Perché internazionalizzare la tua applicazione Angular?
+
+Internazionalizzare la tua applicazione Angular è essenziale per servire efficacemente un pubblico globale. Permette alla tua applicazione di fornire contenuti e messaggi nella lingua preferita di ogni utente. Questa capacità migliora l'esperienza utente e amplia la portata della tua applicazione rendendola più accessibile e rilevante per persone di diversi contesti linguistici.
+
+## Perché integrare Intlayer?
+
+- **Gestione dei contenuti basata su JavaScript**: Sfrutta la flessibilità di JavaScript per definire e gestire i tuoi contenuti in modo efficiente.
+- **Ambiente Type-Safe**: Sfrutta TypeScript per garantire che tutte le tue definizioni di contenuto siano precise e prive di errori.
+- **File di Contenuto Integrati**: Mantieni le tue traduzioni vicine ai rispettivi componenti, migliorando la manutenibilità e la chiarezza.
+
+## Installazione
+
+Installa il pacchetto necessario utilizzando il tuo gestore di pacchetti preferito:
+
+```bash packageManager="npm"
+npm install angular-intlayer
+```
+
+```bash packageManager="yarn"
+yarn add angular-intlayer
+```
+
+```bash packageManager="pnpm"
+pnpm add angular-intlayer
+```
+
+## Cronologia Documentazione
+
+- 5.5.10 - 2025-06-29: Storia iniziale

package/docs/it/packages/express-intlayer/index.md

@@ -0,0 +1,228 @@
+---
+createdAt: 2024-08-11
+updatedAt: 2025-06-29
+title: Documentazione del pacchetto | express-intlayer
+description: Scopri come usare il pacchetto express-intlayer
+keywords:
+  - Intlayer
+  - express-intlayer
+  - Internazionalizzazione
+  - Documentazione
+  - Next.js
+  - JavaScript
+  - React
+slugs:
+  - doc
+  - packages
+  - express-intlayer
+---
+
+# express-intlayer: Pacchetto JavaScript per internazionalizzare (i18n) un'applicazione Express.js
+
+**Intlayer** è una suite di pacchetti progettata specificamente per sviluppatori JavaScript. È compatibile con framework come React, Next.js e Express.js.
+
+**Il pacchetto `express-intlayer`** ti permette di internazionalizzare la tua applicazione Express.js. Fornisce un middleware per rilevare la lingua preferita dall'utente e restituisce il dizionario appropriato per l'utente.
+
+## Perché internazionalizzare il tuo backend?
+
+Internazionalizzare il backend è essenziale per servire efficacemente un pubblico globale. Permette alla tua applicazione di fornire contenuti e messaggi nella lingua preferita di ogni utente. Questa capacità migliora l'esperienza utente e amplia la portata della tua applicazione rendendola più accessibile e rilevante per persone di diversi background linguistici.
+
+### Casi d'uso pratici
+
+- **Visualizzare gli errori del backend nella lingua dell'utente**: Quando si verifica un errore, mostrare i messaggi nella lingua madre dell'utente migliora la comprensione e riduce la frustrazione. Questo è particolarmente utile per messaggi di errore dinamici che potrebbero essere mostrati in componenti front-end come toast o modali.
+
+- **Recuperare contenuti multilingue**: Per le applicazioni che estraggono contenuti da un database, l'internazionalizzazione garantisce che tu possa fornire questi contenuti in più lingue. Questo è fondamentale per piattaforme come siti di e-commerce o sistemi di gestione dei contenuti che devono mostrare descrizioni di prodotti, articoli e altri contenuti nella lingua preferita dall'utente.
+
+- **Invio di email multilingue**: Che si tratti di email transazionali, campagne di marketing o notifiche, inviare email nella lingua del destinatario può aumentare significativamente l'engagement e l'efficacia.
+
+- **Notifiche push multilingue**: Per le applicazioni mobili, inviare notifiche push nella lingua preferita dall'utente può migliorare l'interazione e la fidelizzazione. Questo tocco personale può rendere le notifiche più rilevanti e incisive.
+
+- **Altre comunicazioni**: Qualsiasi forma di comunicazione dal backend, come messaggi SMS, avvisi di sistema o aggiornamenti dell'interfaccia utente, beneficia dell'essere nella lingua dell'utente, garantendo chiarezza e migliorando l'esperienza complessiva dell'utente.
+
+Internazionalizzando il backend, la tua applicazione non solo rispetta le differenze culturali, ma si allinea anche meglio alle esigenze del mercato globale, rendendolo un passaggio chiave per scalare i tuoi servizi a livello mondiale.
+
+## Perché integrare Intlayer?
+
+- **Ambiente Type-Safe**: Sfrutta TypeScript per garantire che tutte le definizioni dei tuoi contenuti siano precise e prive di errori.
+
+## Installazione
+
+Installa il pacchetto necessario utilizzando il tuo gestore di pacchetti preferito:
+
+```bash
+npm install express-intlayer
+```
+
+```bash
+yarn add express-intlayer
+```
+
+```bash
+pnpm add express-intlayer
+```
+
+### Configurare Intlayer
+
+Intlayer fornisce un file di configurazione per impostare il tuo progetto. Posiziona questo file nella radice del tuo progetto.
+
+```typescript fileName="intlayer.config.ts" codeFormat="typescript"
+import { Locales, type IntlayerConfig } from "intlayer";
+
+const config: IntlayerConfig = {
+  internationalization: {
+    locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],
+    defaultLocale: Locales.ENGLISH,
+  },
+};
+
+export default config;
+```
+
+```javascript fileName="intlayer.config.mjs" codeFormat="esm"
+import { Locales } from "intlayer";
+
+/** @type {import('intlayer').IntlayerConfig} */
+const config = {
+  internationalization: {
+    locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],
+    defaultLocale: Locales.ENGLISH,
+  },
+};
+
+export default config;
+```
+
+```javascript fileName="intlayer.config.cjs" codeFormat="commonjs"
+const { Locales } = require("intlayer");
+
+/** @type {import('intlayer').IntlayerConfig} */
+const config = {
+  internationalization: {
+    locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],
+    defaultLocale: Locales.ENGLISH,
+  },
+};
+
+module.exports = config;
+```
+
+> Per un elenco completo dei parametri disponibili, fare riferimento alla [documentazione della configurazione](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/configuration.md).
+
+## Esempio di utilizzo
+
+Configura la tua applicazione Express per utilizzare `express-intlayer`:
+
+```typescript fileName="src/index.ts" codeFormat="typescript"
+import express, { type Express } from "express";
+import { intlayer, t } from "express-intlayer";
+
+const app: Express = express();
+
+// Carica il gestore delle richieste di internazionalizzazione
+app.use(intlayer());
+
+// Rotte
+app.get("/", (_req, res) => {
+  res.send(
+    t({
+      en: "Example of returned content in English",
+      fr: "Esempio di contenuto restituito in francese",
+      "es-ES": "Esempio di contenuto restituito in spagnolo (Spagna)",
+      "es-MX": "Esempio di contenuto restituito in spagnolo (Messico)",
+    })
+  );
+});
+
+// Avvia il server
+app.listen(3000, () => console.log(`In ascolto sulla porta 3000`));
+```
+
+```javascript fileName="src/index.mjs" codeFormat="esm"
+import express from "express";
+import { intlayer, t } from "express-intlayer";
+
+const app = express();
+
+// Carica il gestore delle richieste di internazionalizzazione
+app.use(intlayer());
+
+// Rotte
+app.get("/", (_req, res) => {
+  res.send(
+    t({
+      en: "Example of returned content in English",
+      fr: "Esempio di contenuto restituito in francese",
+      "es-MX": "Esempio di contenuto restituito in spagnolo (Messico)",
+      "es-ES": "Esempio di contenuto restituito in spagnolo (Spagna)",
+    })
+  );
+});
+
+// Avvia il server
+app.listen(3000, () => console.log(`In ascolto sulla porta 3000`));
+app.listen(3000, () => console.log(`In ascolto sulla porta 3000`));
+```
+
+### Compatibilità
+
+`express-intlayer` è completamente compatibile con:
+
+- [`react-intlayer`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/packages/react-intlayer/index.md) per applicazioni React
+- [`next-intlayer`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/packages/next-intlayer/index.md) per applicazioni Next.js
+- [`vite-intlayer`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/packages/vite-intlayer/index.md) per applicazioni Vite
+
+Funziona inoltre perfettamente con qualsiasi soluzione di internazionalizzazione in diversi ambienti, inclusi browser e richieste API. Puoi personalizzare il middleware per rilevare la locale tramite header o cookie:
+
+```typescript fileName="intlayer.config.ts" codeFormat="typescript"
+import { Locales, type IntlayerConfig } from "intlayer";
+
+const config: IntlayerConfig = {
+  // ... Altre opzioni di configurazione
+  middleware: {
+    headerName: "my-locale-header", // nome dell'intestazione personalizzata per la localizzazione
+    cookieName: "my-locale-cookie", // nome del cookie personalizzato per la localizzazione
+  },
+};
+
+export default config;
+```
+
+```javascript fileName="intlayer.config.mjs" codeFormat="esm"
+import { Locales } from "intlayer";
+
+/** @type {import('intlayer').IntlayerConfig} */
+const config = {
+  // ... Altre opzioni di configurazione
+  middleware: {
+    headerName: "my-locale-header", // nome dell'intestazione personalizzata per la localizzazione
+    cookieName: "my-locale-cookie", // nome del cookie personalizzato per la localizzazione
+  },
+};
+
+export default config;
+```
+
+```javascript fileName="intlayer.config.cjs" codeFormat="commonjs"
+const { Locales } = require("intlayer");
+
+/** @type {import('intlayer').IntlayerConfig} */
+const config = {
+  // ... Altre opzioni di configurazione
+  middleware: {
+    headerName: "my-locale-header",
+    cookieName: "my-locale-cookie",
+  },
+};
+
+module.exports = config;
+```
+
+Per impostazione predefinita, `express-intlayer` interpreterà l'intestazione `Accept-Language` per determinare la lingua preferita del client.
+
+## Funzioni fornite dal pacchetto `express-intlayer`
+
+- [`t()`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/packages/express-intlayer/t.md)
+
+## Cronologia della documentazione
+
+- 5.5.10 - 2025-06-29: Cronologia iniziale