Intlayer Documentazione

Benvenuto nella documentazione ufficiale di Intlayer! Qui troverai tutto ciò di cui hai bisogno per integrare, configurare e padroneggiare Intlayer per tutte le tue esigenze di internazionalizzazione (i18n), che tu stia lavorando con Next.js, React, Vite, Express o un altro ambiente JavaScript.

Introduzione

Cos'è Intlayer?

Intlayer è una libreria di internazionalizzazione progettata specificamente per gli sviluppatori JavaScript. Permette la dichiarazione dei tuoi contenuti ovunque nel tuo codice. Converte la dichiarazione di contenuti multilingue in dizionari strutturati per integrarli facilmente nel tuo codice. Utilizzando TypeScript, Intlayer rende il tuo sviluppo più solido ed efficiente.

Intlayer offre anche un editor visivo opzionale che ti consente di modificare e gestire facilmente i tuoi contenuti. Questo editor è particolarmente utile per gli sviluppatori che preferiscono un'interfaccia visiva per la gestione dei contenuti o per i team che generano contenuti senza preoccuparsi del codice.

Esempio di utilizzo

.└── Components    └── MyComponent        ├── index.content.ts        └── index.tsx

import { t, type Dictionary } from "intlayer";// Dichiarazione del contenuto del componenteconst componentContent = {  key: "component-key",  content: {    myTranslatedContent: t({      en: "Hello World",      fr: "Bonjour le monde",      es: "Hola Mundo",    }),  },} satisfies Dictionary;export default componentContent;

import type { FC } from "react";import { useIntlayer } from "react-intlayer";// Componente React che utilizza Intlayerexport const MyComponent: FC = () => {  const { myTranslatedContent } = useIntlayer("component-key");  return <span>{myTranslatedContent}</span>;};

Caratteristiche Principali

Intlayer offre una varietà di funzionalità progettate per soddisfare le esigenze dello sviluppo web moderno. Di seguito le caratteristiche principali, con link alla documentazione dettagliata per ciascuna:

• Supporto all'Internazionalizzazione: Migliora la portata globale della tua applicazione con il supporto integrato per l'internazionalizzazione.
• Editor Visivo: Migliora il tuo flusso di lavoro di sviluppo con plugin per editor progettati per Intlayer. Consulta la Guida all'Editor Visivo.
• Flessibilità di Configurazione: Personalizza la tua configurazione con opzioni dettagliate nella Guida alla Configurazione.
• Strumenti CLI Avanzati: Gestisci i tuoi progetti in modo efficiente utilizzando l'interfaccia a riga di comando di Intlayer. Esplora le funzionalità nella Documentazione degli Strumenti CLI.

Concetti Fondamentali

Dizionario

Organizza i tuoi contenuti multilingue vicino al tuo codice per mantenere tutto coerente e facile da gestire.

• Inizia
  Scopri le basi per dichiarare i tuoi contenuti in Intlayer.

• Traduzione
  Comprendi come le traduzioni vengono generate, archiviate e utilizzate nella tua applicazione.

• Enumerazione
  Gestisci facilmente set di dati ripetuti o fissi in varie lingue.

• Recupero Funzioni
  Scopri come recuperare dinamicamente i contenuti con logica personalizzata per adattarsi al flusso di lavoro del tuo progetto.

Ambienti e Integrazioni

Abbiamo progettato Intlayer con flessibilità in mente, offrendo un'integrazione senza soluzione di continuità con i framework e gli strumenti di build più popolari:

• Intlayer con Next.js 15
• Intlayer con Next.js 14 (App Router)
• Intlayer con Next.js Page Router
• Intlayer con React CRA
• Intlayer con Vite + React
• Intlayer con Express

Ogni guida all'integrazione include le migliori pratiche per utilizzare le funzionalità di Intlayer—come il server-side rendering, il routing dinamico o il client-side rendering—così puoi mantenere un'applicazione veloce, SEO-friendly e altamente scalabile.

Contributi e Feedback

Valorizziamo il potere dell'open-source e dello sviluppo guidato dalla comunità. Se desideri proporre miglioramenti, aggiungere una nuova guida o correggere eventuali problemi nella nostra documentazione, sentiti libero di inviare una Pull Request o aprire un problema sul nostro repository GitHub.

Pronto a tradurre la tua applicazione in modo più veloce ed efficiente? Esplora la nostra documentazione per iniziare a utilizzare Intlayer oggi stesso. Vivi un approccio robusto e semplificato all'internazionalizzazione che mantiene i tuoi contenuti organizzati e il tuo team più produttivo.

Buona traduzione!