@intlayer/docs 5.5.10 → 5.5.11

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

@@ -0,0 +1,53 @@
+---
+createdAt: 2025-04-18
+updatedAt: 2025-06-29
+title: Documentazione del pacchetto | svelte-intlayer
+description: Scopri come utilizzare il pacchetto svelte-intlayer
+keywords:
+  - Intlayer
+  - svelte-intlayer
+  - Internazionalizzazione
+  - Documentazione
+  - JavaScript
+  - Svelte
+slugs:
+  - doc
+  - packages
+  - svelte-intlayer
+---
+
+# svelte-intlayer: pacchetto NPM per internazionalizzare (i18n) un'applicazione Solid
+
+**Intlayer** è una suite di pacchetti progettata specificamente per sviluppatori JavaScript. È compatibile con framework come Solid, Solid e Express.js.
+
+**Il pacchetto `svelte-intlayer`** ti permette di internazionalizzare la tua applicazione Solid. Fornisce provider di contesto e hook per l'internazionalizzazione in Solid.
+
+## Perché internazionalizzare la tua applicazione Solid?
+
+Internazionalizzare la tua applicazione Solid è 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 provenienti da 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 definizioni dei tuoi contenuti 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 svelte-intlayer
+```
+
+```bash packageManager="yarn"
+yarn add svelte-intlayer
+```
+
+```bash packageManager="pnpm"
+pnpm add svelte-intlayer
+```
+
+## Cronologia della Documentazione
+
+- 5.5.10 - 2025-06-29: Inizio cronologia

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

@@ -0,0 +1,76 @@
+---
+createdAt: 2024-08-11
+updatedAt: 2025-06-29
+title: Documentazione del pacchetto | vite-intlayer
+description: Scopri come utilizzare il pacchetto vite-intlayer
+keywords:
+  - Intlayer
+  - vite-intlayer
+  - Internazionalizzazione
+  - Documentazione
+  - Next.js
+  - JavaScript
+  - React
+slugs:
+  - doc
+  - packages
+  - vite-intlayer
+---
+
+# vite-intlayer: pacchetto NPM per internazionalizzare (i18n) un'applicazione Vite
+
+**Intlayer** è una suite di pacchetti progettata specificamente per sviluppatori JavaScript. È compatibile con framework come React, React e Express.js.
+
+**Il pacchetto `vite-intlayer`** ti permette di internazionalizzare la tua applicazione Vite. Include il plugin Vite per impostare la configurazione tramite variabili d'ambiente nel [bundler Vite](https://vitejs.dev/guide/why.html#why-bundle-for-production). Fornisce inoltre un middleware per rilevare la lingua preferita dall'utente e reindirizzare l'utente all'URL appropriato come specificato nella [configurazione](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/configuration.md).
+
+## Perché internazionalizzare la tua applicazione Vite?
+
+Internazionalizzare la tua applicazione Vite è 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 provenienti da diversi contesti linguistici.
+
+## Configurazione
+
+Il pacchetto `vite-intlayer` funziona perfettamente con il [`pacchetto react-intlayer`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/packages/react-intlayer/index.md) e il [`pacchetto intlayer`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/packages/intlayer/index.md). Dai un'occhiata alla documentazione pertinente per maggiori informazioni.
+
+## Installazione
+
+Installa il pacchetto necessario utilizzando il tuo gestore di pacchetti preferito:
+
+```bash packageManager="npm"
+npm install vite-intlayer
+```
+
+```bash packageManager="yarn"
+yarn add vite-intlayer
+```
+
+```bash packageManager="pnpm"
+pnpm add vite-intlayer
+```
+
+## Esempio di utilizzo
+
+Ecco un esempio di come includere i plugin nella tua configurazione di vite.
+
+```typescript fileName="vite.config.ts"
+import { defineConfig } from "vite";
+import { intlayerPlugin, intLayerMiddlewarePlugin } from "vite-intlayer";
+
+// https://vitejs.dev/config/
+export default defineConfig({
+  plugins: [intlayerPlugin(), intLayerMiddlewarePlugin()],
+});
+```
+
+> Il plugin Vite `intlayerPlugin()` viene utilizzato per integrare Intlayer con Vite. Garantisce la creazione dei file di dichiarazione dei contenuti e li monitora in modalità sviluppo. Definisce le variabili d'ambiente di Intlayer all'interno dell'applicazione Vite. Inoltre, fornisce alias per ottimizzare le prestazioni.
+
+> Il plugin `intLayerMiddlewarePlugin()` aggiunge il routing lato server alla tua applicazione. Questo plugin rileverà automaticamente la locale corrente in base all'URL e imposterà il cookie della locale appropriata. Se non viene specificata alcuna locale, il plugin determinerà la locale più appropriata in base alle preferenze linguistiche del browser dell'utente. Se non viene rilevata alcuna locale, reindirizzerà alla locale predefinita.
+
+## Padroneggiare l'internazionalizzazione della tua applicazione Vite
+
+Intlayer offre molte funzionalità per aiutarti a internazionalizzare la tua applicazione Vite.
+
+**Per saperne di più su queste funzionalità, consulta la guida [Internazionalizzazione React (i18n) con Intlayer e Vite e React](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/intlayer_with_vite+react.md) per applicazioni Vite e React.**
+
+## Cronologia del documento
+
+- 5.5.10 - 2025-06-29: Inizio cronologia

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

@@ -0,0 +1,53 @@
+---
+createdAt: 2025-04-18
+updatedAt: 2025-06-29
+title: Documentazione del Pacchetto | vue-intlayer
+description: Scopri come utilizzare il pacchetto vue-intlayer
+keywords:
+  - Intlayer
+  - vue-intlayer
+  - Internazionalizzazione
+  - Documentazione
+  - JavaScript
+  - Vue
+slugs:
+  - doc
+  - packages
+  - vue-intlayer
+---
+
+# vue-intlayer: Pacchetto NPM per internazionalizzare (i18n) un'applicazione Vue
+
+**Intlayer** è una suite di pacchetti progettata specificamente per sviluppatori JavaScript. È compatibile con framework come Vue, Vue ed Express.js.
+
+**Il pacchetto `vue-intlayer`** ti permette di internazionalizzare la tua applicazione Vue. Fornisce provider di contesto e hook per l'internazionalizzazione in Vue.
+
+## Perché internazionalizzare la tua applicazione Vue?
+
+Internazionalizzare la tua applicazione Vue è 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 diverse origini linguistiche.
+
+## 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 definizioni dei tuoi contenuti 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 vue-intlayer
+```
+
+```bash packageManager="yarn"
+yarn add vue-intlayer
+```
+
+```bash packageManager="pnpm"
+pnpm add vue-intlayer
+```
+
+## Cronologia della Documentazione
+
+- 5.5.10 - 2025-06-29: Inizio cronologia

package/docs/it/per_locale_file.md

@@ -0,0 +1,325 @@
+---
+createdAt: 2025-04-18
+updatedAt: 2025-06-29
+title: Dichiarazione di Contenuto `Per-Locale` in Intlayer
+description: Scopri come dichiarare contenuti per locale in Intlayer. Segui la documentazione per comprendere i diversi formati e casi d'uso.
+keywords:
+  - Internazionalizzazione
+  - Documentazione
+  - Intlayer
+  - Per-Locale
+  - TypeScript
+  - JavaScript
+slugs:
+  - doc
+  - concept
+  - per-locale-file
+---
+
+# Dichiarazione di Contenuto `Per-Locale` in Intlayer
+
+Intlayer supporta due modi per dichiarare contenuti multilingue:
+
+- Un singolo file con tutte le traduzioni
+- Un file per ogni locale (formato per-locale)
+
+Questa flessibilità consente:
+
+- Migrazione semplice da altri strumenti i18n
+- Supporto per flussi di lavoro di traduzione automatizzata
+- Organizzazione chiara delle traduzioni in file separati e specifici per locale
+
+## Singolo File con Traduzioni Multiple
+
+Questo formato è ideale per:
+
+- Iterazioni rapide nel codice.
+- Integrazione senza soluzione di continuità con il CMS.
+
+Questo è l'approccio consigliato per la maggior parte dei casi d'uso. Centralizza le traduzioni, rendendo facile iterare e integrare con il CMS.
+
+```tsx fileName="hello-world.content.ts" contentDeclarationFormat="typescript"
+import { t, type Dictionary } from "intlayer";
+
+const helloWorldContent = {
+  key: "hello-world",
+  content: {
+    multilingualContent: t({
+      en: "Title of my component",
+      es: "Título de mi componente",
+    }),
+  },
+} satisfies Dictionary;
+
+export default helloWorldContent;
+```
+
+```js fileName="hello-world.content.mjs" contentDeclarationFormat="esm"
+import { t } from "intlayer";
+
+/** @type {import('intlayer').Dictionary} */
+// Contenuto per "hello-world" con traduzioni multiple
+const helloWorldContent = {
+  key: "hello-world",
+  content: {
+    multilingualContent: t({
+      en: "Title of my component",
+      es: "Título de mi componente",
+    }),
+  },
+};
+
+export default helloWorldContent;
+```
+
+```js fileName="hello-world.content.cjs" contentDeclarationFormat="json"
+const { t } = require("intlayer");
+
+/** @type {import('intlayer').Dictionary} */
+// Contenuto per "hello-world" con traduzioni multiple
+const helloWorldContent = {
+  key: "hello-world",
+  content: {
+    multilingualContent: t({
+      en: "Title of my component",
+      es: "Título de mi componente",
+    }),
+  },
+};
+
+module.exports = helloWorldContent;
+```
+
+```json fileName="hello-world.content.ts" contentDeclarationFormat="json"
+{
+  "$schema": "https://intlayer.org/schema.json",
+  "key": "hello-world",
+  "content": {
+    "multilingualContent": {
+      "nodeType": "translation",
+      "translation": {
+        "en": "Title of my component",
+        "es": "Título de mi componente"
+      }
+    }
+  }
+}
+```
+
+> Consigliato: questo formato è il migliore quando si utilizza l'editor visuale di Intlayer o si gestiscono le traduzioni direttamente nel codice.
+
+## Formato per Locale
+
+Questo formato è utile quando:
+
+- Vuoi versionare o sovrascrivere le traduzioni in modo indipendente.
+- Stai integrando flussi di lavoro di traduzione automatica o umana.
+
+Puoi anche suddividere le traduzioni in file di locale individuali specificando il campo locale:
+
+```tsx fileName="hello-world.en.content.ts" contentDeclarationFormat="typescript"
+import { t, Locales, type Dictionary } from "intlayer";
+
+const helloWorldContent = {
+  key: "hello-world",
+  locale: Locales.ENGLISH, // Importante
+  content: { multilingualContent: "Titolo del mio componente" },
+} satisfies Dictionary;
+
+export default helloWorldContent;
+```
+
+```tsx fileName="hello-world.es.content.ts" contentDeclarationFormat="typescript"
+import { t, Locales, type Dictionary } from "intlayer";
+
+const helloWorldContent = {
+  key: "hello-world",
+  locale: Locales.SPANISH, // Importante
+  content: { multilingualContent: "Título de mi componente" },
+} satisfies Dictionary;
+
+export default helloWorldContent;
+```
+
+```js fileName="hello-world.en.content.mjs" contentDeclarationFormat="esm"
+import { t, Locales } from "intlayer";
+
+/** @type {import('intlayer').Dictionary} */
+// Dizionario contenuti per "hello-world" in inglese
+const helloWorldContent = {
+  key: "hello-world",
+  locale: Locales.ENGLISH, // Importante
+  content: { multilingualContent: "Titolo del mio componente" },
+};
+
+export default helloWorldContent;
+```
+
+```tsx fileName="hello-world.es.content.mjs" contentDeclarationFormat="esm"
+import { t, Locales } from "intlayer";
+
+/** @type {import('intlayer').Dictionary} */
+// Dizionario contenuti per "hello-world" in spagnolo
+const helloWorldContent = {
+  key: "hello-world",
+  locale: Locales.SPANISH, // Importante
+  content: { multilingualContent: "Título de mi componente" },
+};
+
+export default helloWorldContent;
+```
+
+```js fileName="hello-world.en.content.cjs" contentDeclarationFormat="commonjs"
+const { t, Locales } = require("intlayer");
+
+/** @type {import('intlayer').Dictionary} */
+const helloWorldContent = {
+  key: "hello-world",
+  locale: Locales.ENGLISH, // Importante
+  content: {
+    multilingualContent: "Titolo del mio componente",
+  },
+};
+
+module.exports = helloWorldContent;
+```
+
+```tsx fileName="hello-world.es.content.cjs" contentDeclarationFormat="commonjs"
+const { t, Locales } = require("intlayer");
+
+/** @type {import('intlayer').Dictionary} */
+const helloWorldContent = {
+  key: "hello-world",
+  locale: Locales.SPANISH, // Importante
+  content: {
+    multilingualContent: "Título de mi componente",
+  },
+};
+
+module.exports = helloWorldContent;
+```
+
+```json5 fileName="hello-world.en.content.json" contentDeclarationFormat="json"
+{
+  "$schema": "https://intlayer.org/schema.json",
+  "key": "hello-world",
+  "locale": "en", // Importante
+  "content": {
+    "multilingualContent": "Titolo del mio componente",
+  },
+}
+```
+
+```json5 fileName="hello-world.es.content.json" contentDeclarationFormat="json"
+{
+  "$schema": "https://intlayer.org/schema.json",
+  "key": "hello-world",
+  "locale": "es", // Importante
+  "content": {
+    "multilingualContent": "Título de mi componente",
+  },
+}
+```
+
+> Importante: Assicurati che il campo locale sia definito. Indica a Intlayer quale lingua rappresenta il file.
+
+> Nota: In entrambi i casi, il file di dichiarazione del contenuto deve seguire il modello di denominazione `*.content.{ts,tsx,js,jsx,mjs,cjs,json}` per essere riconosciuto da Intlayer. Il suffisso `.[locale]` è opzionale ed è usato solo come convenzione di denominazione.
+
+## Mescolare Formati
+
+Puoi combinare entrambi gli approcci di dichiarazione per la stessa chiave di contenuto. Per esempio:
+
+- Dichiara il tuo contenuto base staticamente in un file come index.content.ts.
+- Aggiungi o sovrascrivi traduzioni specifiche in file separati come index.fr.content.ts o index.content.json.
+
+Questa configurazione è particolarmente utile quando:
+
+- Vuoi definire la struttura iniziale del contenuto nel codice.
+- Hai intenzione di arricchire o completare le traduzioni successivamente utilizzando il CMS o strumenti automatizzati.
+
+```bash codeFormat="typescript"
+.
+└── Components
+    └── MyComponent
+        ├── index.content.ts
+        ├── index.content.json
+        └── index.ts
+```
+
+### Esempio
+
+Ecco un file di dichiarazione di contenuto multilingue:
+
+```tsx fileName="Components/MyComponent/index.content.ts"
+import { t, type Dictionary } from "intlayer";
+
+const helloWorldContent = {
+  key: "hello-world",
+  locale: Locales.ENGLISH,
+  content: {
+    multilingualContent: "Titolo del mio componente",
+    projectName: "Il mio progetto",
+  },
+} satisfies Dictionary;
+
+export default helloWorldContent;
+```
+
+```json fileName="Components/MyComponent/index.content.json"
+{
+  "$schema": "https://intlayer.org/schema.json",
+  "key": "hello-world",
+  "content": {
+    "multilingualContent": {
+      "nodeType": "translation",
+      "translation": {
+        "fr": "Titre de mon composant",
+        "es": "Título de mi componente"
+      }
+    }
+  }
+}
+```
+
+Intlayer unisce automaticamente i file multilingue e per locale.
+
+```tsx fileName="Components/MyComponent/index.ts"
+import { getIntlayer, Locales } from "intlayer";
+
+const intlayer = getIntlayer("hello-world"); // La lingua predefinita è INGLESE, quindi restituirà il contenuto in INGLESE
+
+console.log(JSON.stringify(intlayer, null, 2));
+// Risultato:
+// {
+//  "multilingualContent": "Titolo del mio componente",
+//  "projectName": "Il mio progetto"
+// }
+
+const intlayer = getIntlayer("hello-world", Locales.SPANISH);
+
+console.log(JSON.stringify(intlayer, null, 2));
+// Risultato:
+// {
+//  "multilingualContent": "Título de mi componente",
+//  "projectName": "Il mio progetto"
+// }
+
+const intlayer = getIntlayer("hello-world", Locales.FRENCH);
+
+console.log(JSON.stringify(intlayer, null, 2));
+// Risultato:
+// {
+//  "multilingualContent": "Titre de mon composant",
+//  "projectName": "Il mio progetto"
+// }
+```
+
+### Generazione Automatica delle Traduzioni
+
+### Generazione Automatica delle Traduzioni
+
+Usa il [intlayer CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/intlayer_cli.md) per compilare automaticamente le traduzioni mancanti basandoti sui servizi che preferisci.
+
+## Cronologia del Documento
+
+- 5.5.10 - 2025-06-29: Inizio cronologia