Pose una domanda e ottieni un riassunto del documento facendo riferimento a questa pagina e al provider AI di tua scelta
Integrando il server MCP Intlayer al tuo assistente AI, puoi recuperare tutti i documenti direttamente da ChatGPT, DeepSeek, Cursor, VSCode, ecc.
Vedi la documentazione del server MCPIl contenuto di questa pagina è stato tradotto con un'IA.
Vedi l'ultima versione del contenuto originale in ingleseSe hai un’idea per migliorare questa documentazione, non esitare a contribuire inviando una pull request su GitHub.
Collegamento GitHub alla documentazioneCopia il Markdown del documento nella porta-documenti
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.
Copiare il codice nella clipboard
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;
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:
Copiare il codice nella clipboard
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;
Copiare il codice nella clipboard
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;
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.
Copiare il codice nella clipboard
.└── Components └── MyComponent ├── index.content.ts ├── index.content.json └── index.ts
Esempio
Ecco un file di dichiarazione di contenuto multilingue:
Copiare il codice nella clipboard
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;
Copiare il codice nella clipboard
{ "$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.
Copiare il codice nella clipboard
import { getIntlayer, Locales } from "intlayer";const intlayer = getIntlayer("hello-world"); // La lingua predefinita è INGLESE, quindi restituirà il contenuto in INGLESEconsole.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 per compilare automaticamente le traduzioni mancanti basandoti sui servizi che preferisci.
Cronologia del Documento
- 5.5.10 - 2025-06-29: Inizio cronologia