Locadex per Next.js App Router

Automatizza la traduzione della tua app Next.js

Tradurre la tua app Next.js in francese 🇫🇷, spagnolo 🇪🇸, giapponese 🇯🇵 o in qualsiasi altra lingua è complesso e richiede tempo.

Locadex è un agente AI progettato per gestire il 100% del lavoro di internazionalizzazione (i18n) al posto tuo. L’installazione richiede 5 minuti.

Schermata di installazione di Locadex

Locadex:

  • Configura il tuo progetto per utilizzare la libreria i18n gt-next
  • Modifica i componenti React e le stringhe per supportare contenuti multilingue
  • Traduce la tua app in tutte le lingue di cui hai bisogno
  • Continua a internazionalizzare e tradurre man mano che pubblichi nuovi contenuti

Procedura di configurazione

Passaggio 1: Accedi al Dashboard di General Translation

Vai al Dashboard e accedi al tuo account.

Passaggio 2: Connetti GitHub

  1. Vai alla sezione Integrazione GitHub nella tua dashboard
  2. Fai clic su "Connetti GitHub" per collegare il tuo account GitHub
  3. Verrai reindirizzato su GitHub per autorizzare la connessione

Passaggio 3: Installa l’app GitHub

  1. Dopo aver collegato GitHub, verrai reindirizzato per installare l’app GitHub di Locadex
  2. Scegli a quali repository concedere l’accesso a Locadex:
    • Installa su tutti i repository, oppure
    • Seleziona repository specifici
  3. Fai clic su “Install” per completare l’installazione dell’app GitHub

Passaggio 4: Collega il repository al progetto

  1. Torna alla dashboard di GT e seleziona il repository che vuoi internazionalizzare
  2. In questo modo colleghi il repo alle impostazioni di traduzione e alle lingue di destinazione
  3. A un progetto può essere collegato un solo repository, ma puoi creare più progetti, ciascuno con un repository diverso

Passaggio 5: Configura le impostazioni

Nella schermata di configurazione, configura:

  • Lingue di destinazione: Scegli in quali lingue/locali tradurre

Schermata di installazione di Locadex

Fase 6: Completa l’installazione

  1. Rivedi le impostazioni di configurazione
  2. Fai clic su “Install” per attivare Locadex per il tuo repository
  3. Verrai reindirizzato a una pagina di riepilogo che mostra il tuo repository GitHub collegato

Cosa succede ora

Configurazione iniziale

Una volta completata l’installazione:

  1. Creazione immediata della PR: Locadex creerà una pull request sul branch principale
  2. Configurazione completa: Questa PR esegue il comando di setup completo di Locadex che:
    • Installa le librerie GT
    • Configura il progetto per l’internazionalizzazione
    • Configura l’infrastruttura di traduzione
  3. Revisione e merge: Rivedi la PR ed esegui il merge per completare la configurazione i18n

Internazionalizzazione continua

Dopo che la configurazione iniziale è stata integrata:

  1. Locadex monitora il branch principale o quello specificato in cerca di pull request
  2. Quando invii nuovo codice con contenuti traducibili, attendi che Locadex aggiunga il proprio commit alla PR
  3. Una volta che Locadex ha effettuato il commit sulla PR, puoi effettuare il merge in sicurezza — il nuovo codice è internazionalizzato
  4. La tua app resta tradotta senza interventi manuali

Monitoraggio del repository

Pannello di connessione GitHub di Locadex

Pannello di configurazione di Locadex

Stato della dashboard

Nella dashboard puoi monitorare:

  • Stato del repository: Indicatore di monitoraggio attivo
  • Configurazione: Impostazioni correnti e lingue di destinazione

Integrazione con GitHub

  • Controlli di stato: Locadex aggiunge aggiornamenti di stato alle pull request
  • Esecuzioni di verifica: GitHub mostra lo stato di elaborazione di Locadex

Risoluzione dei problemi

Problemi comuni

Locadex non crea PR

  • Verifica che l’app GitHub abbia accesso al repository
  • Controlla che i commit includano contenuti traducibili

Modifiche di configurazione necessarie

  • Aggiorna le impostazioni del branch nella dashboard di GT
  • Le modifiche verranno applicate ai nuovi commit dopo l’aggiornamento

Framework supportati

Attualmente, Locadex supporta solo le app Next.js con l’App Router.

Come valuti questa guida?

Locadex per Next.js App Router