Intlayer

--- createdAt: 2024-12-24 updatedAt: 2025-11-01 title: Come automatizzare le traduzioni JSON di i18next usando Intlayer description: Automatizza le tue traduzioni JSON con Intlayer e i18next per una migliore internazionalizzazione nelle applicazioni JavaScript. keywords: - Intlayer - i18next - Internazionalizzazione - i18n - Localizzazione - Traduzione - React - Next.js - JavaScript - TypeScript - Migrazione - Integrazione slugs: - blog - intlayer-with-i18next youtubeVideo: https://www.youtube.com/watch?v=MpGMxniDHNg history: - version: 7.0.6 date: 2025-11-01 changes: Aggiunto plugin loadJSON - version: 7.0.0 date: 2025-10-29 changes: Cambiato in plugin syncJSON --- # Come automatizzare le traduzioni JSON di i18next usando Intlayer <iframe title="Come automatizzare le traduzioni JSON di i18next usando 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/MpGMxniDHNg?autoplay=0&amp;origin=http://intlayer.org&amp;controls=0&amp;rel=1"/> ## Cos'è Intlayer? **Intlayer** è una libreria di internazionalizzazione innovativa e open-source progettata per superare le limitazioni delle soluzioni i18n tradizionali. Offre un approccio moderno alla gestione dei contenuti nelle applicazioni JavaScript. Consulta un confronto concreto con i18next nel nostro post sul blog [next-i18next vs. next-intl vs. Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/blog/it/next-i18next_vs_next-intl_vs_intlayer.md). ## Perché combinare Intlayer con i18next? Sebbene Intlayer offra una soluzione i18n autonoma eccellente (vedi la nostra [guida all'integrazione con Next.js](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/intlayer_with_nextjs_16.md)), potresti volerlo combinare con i18next per diversi motivi: 1. **Codice esistente**: Hai un'implementazione i18next consolidata e desideri migrare gradualmente alla migliore esperienza sviluppatore offerta da Intlayer. 2. **Requisiti legacy**: Il tuo progetto richiede la compatibilità con plugin o flussi di lavoro i18next esistenti. 3. **Familiarità del team**: Il tuo team è abituato a i18next ma desidera una migliore gestione dei contenuti. 4. **Utilizzo delle funzionalità di Intlayer**: Vuoi utilizzare funzionalità di Intlayer come la dichiarazione dei contenuti, la gestione delle chiavi di traduzione, lo stato delle traduzioni e altro ancora. **Per questo, Intlayer può essere implementato come un adattatore per i18next per aiutarti ad automatizzare le traduzioni JSON tramite CLI o pipeline CI/CD, testare le tue traduzioni e molto altro.** Questa guida ti mostra come sfruttare il sistema superiore di dichiarazione dei contenuti di Intlayer mantenendo la compatibilità con i18next. ## Indice <TOC/> ## Guida passo-passo per configurare Intlayer con i18next ### Passo 1: Installa le dipendenze Installa i pacchetti necessari: ```bash packageManager="npm" npm install intlayer @intlayer/sync-json-plugin ``` ```bash packageManager="pnpm" pnpm add intlayer @intlayer/sync-json-plugin ``` ```bash packageManager="yarn" yarn add intlayer @intlayer/sync-json-plugin ``` ```bash packageManager="bun" bun add intlayer @intlayer/sync-json-plugin ``` **Descrizione dei pacchetti:** - **intlayer**: Libreria core per la gestione dell'internazionalizzazione, dichiarazione dei contenuti e build - **@intlayer/sync-json-plugin**: Plugin per esportare le dichiarazioni di contenuto di Intlayer in un formato JSON compatibile con i18next ### Passo 2: Implementa il plugin Intlayer per avvolgere il JSON Crea un file di configurazione Intlayer per definire le tue localizzazioni supportate: **Se vuoi anche esportare dizionari JSON per i18next**, aggiungi il plugin `syncJSON`: ```typescript fileName="intlayer.config.ts" import { Locales, type IntlayerConfig } from "intlayer"; import { syncJSON } from "@intlayer/sync-json-plugin"; const config: IntlayerConfig = { internationalization: { locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH], defaultLocale: Locales.ENGLISH, }, plugins: [ syncJSON({ format: "i18next", source: ({ key, locale }) => `./locales/${locale}/${key}.json`, }), ], }; export default config; ``` Il plugin `syncJSON` avvolgerà automaticamente il JSON. Leggerà e scriverà i file JSON senza modificare l'architettura del contenuto. Se vuoi far coesistere quel JSON con i file di dichiarazione del contenuto di Intlayer (file `.content`), Intlayer procederà in questo modo: 1. caricherà sia i file JSON che i file di dichiarazione del contenuto e li trasformerà in un dizionario Intlayer. 2. se ci sono conflitti tra i file JSON e i file di dichiarazione del contenuto, Intlayer procederà alla fusione di tutti quei dizionari. A seconda della priorità dei plugin e di quella del file di dichiarazione del contenuto (tutti configurabili). Se vengono apportate modifiche utilizzando la CLI per tradurre il JSON, o utilizzando il CMS, Intlayer aggiornerà il file JSON con le nuove traduzioni. Per maggiori dettagli sul plugin `syncJSON`, si prega di fare riferimento alla [documentazione del plugin syncJSON](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/plugins/sync-json.md). ### (Opzionale) Passo 3: Implementare traduzioni JSON per componente Per impostazione predefinita, Intlayer caricherà, unirà e sincronizzerà sia i file JSON che i file di dichiarazione del contenuto. Vedi [la documentazione sulla dichiarazione del contenuto](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/dictionary/content_file.md) per maggiori dettagli. Ma se preferisci, utilizzando un plugin Intlayer, puoi anche implementare una gestione per componente del JSON localizzato ovunque nel tuo codice. Per questo, puoi usare il plugin `loadJSON`. ```ts fileName="intlayer.config.ts" import { Locales, type IntlayerConfig } from "intlayer"; import { loadJSON, syncJSON } from "@intlayer/sync-json-plugin"; const config: IntlayerConfig = { internationalization: { locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH], defaultLocale: Locales.ENGLISH, }, // Mantieni i tuoi file JSON attuali sincronizzati con i dizionari Intlayer plugins: [ /** * Caricherà tutti i file JSON nella cartella src che corrispondono al pattern {key}.i18n.json */ loadJSON({ source: ({ key }) => `./src/**/${key}.i18n.json`, locale: Locales.ENGLISH, priority: 1, // Garantisce che questi file JSON abbiano la precedenza sui file in `./locales/en/${key}.json` }), /** * Caricherà e scriverà l'output e le traduzioni nei file JSON nella directory delle localizzazioni */ syncJSON({ format: "i18next", source: ({ key, locale }) => `./locales/${locale}/${key}.json`, priority: 0, }), ], }; export default config; ``` Questo caricherà tutti i file JSON nella directory `src` che corrispondono al modello `{key}.i18n.json` e li caricherà come dizionari Intlayer. --- ## Configurazione Git Si consiglia di ignorare i file generati automaticamente da Intlayer: ```plaintext fileName=".gitignore" # Ignora i file generati da Intlayer .intlayer ``` Questi file possono essere rigenerati durante il processo di build e non devono essere inseriti nel controllo di versione. ### Estensione VS Code Per migliorare l'esperienza dello sviluppatore, installa l'**Estensione ufficiale Intlayer per VS Code**: [Installa dal Marketplace di VS Code](https://marketplace.visualstudio.com/items?itemName=intlayer.intlayer-vs-code-extension)