Skip to main content

​
Prerequisiti

Quetzal può essere utilizzato per fornire traduzioni per progetti React che utilizzano il framework Lingui

​
Installazione di Quetzal

Installa
npm install --save @quetzallabs/i18n-core

​
Configurazione

Dopo l’installazione del pacchetto, è necessaria una configurazione aggiuntiva.
1

Esegui script di configurazione

Esegui npx quetzal-setup nella directory in cui hai installato il pacchetto Quetzal
2

Imposta Chiave API

Imposta la variabile d’ambiente QUETZAL_API_KEY con la tua Chiave API Quetzal. La tua Chiave API si trova nella tua dashboard del progetto
3

Aggiorna quetzal.config.json

Lo script di configurazione dovrebbe averlo creato per te. Aggiorna paths in modo che punti alle directory con il codice che intendi localizzare. Aggiorna parser a lingui-parser
Esempio quetzal.config.json
{
  "paths": ["src/**/*.{js,tsx}"],
  "parser": "lingui-parser"
}
4

Verifica lingui.config

Assicurati che la configurazione di Lingui definisca correttamenteEsempio lingui.config:
/** @type {import('@lingui/conf').LinguiConfig} */
module.exports = { 
  "locales": [
      "it-IT",
      "es-419"
  ],
  "sourceLocale": "it-IT",
  "catalogs": [
    {
      "path": "<rootDir>/locales/{locale}/messages",
      "include": [
        "src"
      ]
    }
  ],
  "format": "po"
};

​
E hai finito!

La configurazione dovrebbe essere completata, e puoi iniziare a tradurre la tua app.

​
Verifica la Tua Installazione

Esegui npx quetzal-process-translations per testare la tua installazione. Process Translations Output Se il tuo output è simile a quello sopra, allora Quetzal è stato installato correttamente e la tua app inizierà a supportare altre lingue! In caso di errori, si spera che il problema sia chiaro e risolvibile. In caso contrario, contattaci e possiamo far funzionare la tua installazione. Quetzal è progettato per integrarsi perfettamente nel tuo processo di build. Quindi, questo script dovrebbe essere eseguito almeno ogni volta che viene effettuata una build, ma potrebbe essere eseguito con la frequenza desiderata. Lo script di configurazione dovrebbe aver aggiunto npx quetzal-process-translations allo script pre-build nel package.json del tuo progetto, ma questo può essere modificato.