Utilizzo

npx gtx-cli init

Usa questo comando per avviare la procedura guidata di configurazione di GT.

Questo comando equivale a eseguire setup e poi configure.

La procedura guidata:

1. Installerà le dipendenze necessarie per il progetto.
2. (Se Next.js) Aggiungerà la funzione withGTConfig al file next.config.js e configurerà il componente GTProvider.
3. Creerà un file gt.config.json nella directory radice del progetto.
4. Genererà una chiave API e un ID progetto per il tuo progetto.

Dipendenze

Il comando init installerà le seguenti dipendenze per il tuo progetto:

• gt-react o gt-next (se il progetto è basato su React)
• gtx-cli come dipendenza di sviluppo (se non è già installata)

Progetti basati su React

Se il tuo progetto è basato su React, la procedura guidata ti aiuterà a configurarlo per usare gt-react o gt-next.

Se utilizzi già un’altra libreria i18n, potresti dover configurare il progetto manualmente.

Consulta la documentazione di React o la documentazione di Next.js per ulteriori informazioni.

Poiché la procedura guidata è attualmente sperimentale, è possibile che non funzioni con tutti i progetti basati su React. In questi casi, potrebbe essere necessario configurare il progetto manualmente.

Se riscontri problemi, faccelo sapere su GitHub.

Questa parte della procedura guidata può anche essere eseguita separatamente tramite npx gtx-cli setup.

gt.config.json

Il comando init ti aiuta a configurare le impostazioni di GT per il tuo progetto.

Crea un file gt.config.json nella root del progetto.

Il file contiene le seguenti impostazioni:

• defaultLocale: La locale predefinita del progetto.
• locales: Un array di locale supportate per il progetto.
• files: Un oggetto che contiene informazioni sui contenuti da tradurre.

Per informazioni più specifiche sul file gt.config.json, consulta la documentazione di configurazione.

Questa parte della procedura guidata può anche essere eseguita separatamente tramite npx gtx-cli configure.

Credenziali

La procedura guidata ti aiuterà a generare una chiave API e un ID progetto per il tuo progetto (se non sono già configurati).

Tieni presente che la chiave API e l’ID progetto non sono necessari per usare gt-react o gt-next.

La procedura guidata aggiungerà la chiave API e l’ID progetto al file .env.local. Se questo file non esiste, la procedura guidata lo creerà e lo aggiungerà al file .gitignore.

Questa sezione della procedura guidata può anche essere eseguita separatamente tramite npx gtx-cli auth.