Documentazione di Intlayer

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 integrarsi facilmente nel tuo codice. Utilizzando TypeScript, Intlayer rende il tuo sviluppo più solido ed efficiente.

Intlayer fornisce 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 doversi preoccupare del codice.

Esempio di utilizzo

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

import { t, type Dictionary } from "intlayer";

const componentContent = {
  key: "component-key",
  content: {
    myTranslatedContent: t({
      en: "Hello World",
      es: "Hola Mundo",
      fr: "Bonjour le monde",
    }),
  },
} satisfies Dictionary;

export default componentContent;

import type { FC } from "react";
import { useIntlayer } from "react-intlayer";

export const MyComponent: FC = () => {
  const { myTranslatedContent } = useIntlayer("component-key");

  return <span>{myTranslatedContent}</span>;
};

Funzionalità Principali

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

• Supporto per l'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 i plugin per editor progettati per Intlayer. Consulta la Guida all'Editor Visivo.
• Flessibilità di Configurazione: Personalizza la tua configurazione con ampie 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 codice per mantenere tutto coerente e facilmente gestibile.

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

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

• Enumerazione
  Gestisci facilmente insiemi di dati ripetuti o fissi in diverse lingue.

• Condizione
  Impara a usare la logica condizionale in Intlayer per creare contenuti dinamici.

• Inserimento
  Scopri come inserire valori in una stringa usando segnaposto di inserimento.

• Recupero Funzioni
  Scopri come recuperare dinamicamente contenuti con logiche personalizzate per adattarsi al flusso di lavoro del tuo progetto.

• Markdown
  Impara a usare Markdown in Intlayer per creare contenuti ricchi.

• Incorporamento File
  Scopri come incorporare file esterni in Intlayer per usarli nell’editor di contenuti.

• Annidamento
  Comprendi come annidare contenuti in Intlayer per creare strutture complesse.

Ambienti e Integrazioni

Abbiamo progettato Intlayer con la 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 React Native e Expo
• Intlayer con Lynx e React
• Intlayer con Express

Ogni guida all'integrazione include le migliori pratiche per utilizzare le funzionalità di Intlayer, come il rendering lato server, il routing dinamico o il rendering lato client, così da poter mantenere un'applicazione veloce, ottimizzata per i motori di ricerca (SEO) 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 issue nel nostro repository GitHub.

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