# General Translation Platform: guida rapida
URL: https://generaltranslation.com/it/docs/platform/core/quickstart.mdx
---

title: guida rapida
description: Scopri cosa fa la libreria Core `generaltranslation`, quando usarla e come tradurre la tua prima stringa.
related:
  links:
    - /docs/platform/core/guides/translating-strings
    - /docs/platform/core/guides/translating-files
    - /docs/platform/core/guides/locale-codes

---

La libreria `generaltranslation` è la libreria i18n Core di General Translation per la traduzione, la formattazione e le utilità relative alle impostazioni regionali.

La maggior parte delle applicazioni basate su framework dovrebbe iniziare con [gt-react o gt-next](/docs/react/overview). Usa `generaltranslation` direttamente quando vuoi un controllo più capillare, un workflow personalizzato o utilità di traduzione al di fuori di un'integrazione con un framework.

## Cosa fa `generaltranslation` [#what-it-does]

`generaltranslation` ti dà accesso diretto a:

* **Traduzione delle stringhe** per tradurre stringhe o contenuti strutturati dal codice.
* **Traduzione di file** per caricare file sorgente, mettere in coda i processi di traduzione, controllarne lo stato e scaricare l'output tradotto.
* **Utilità per le impostazioni regionali** per convalidare, confrontare, risolvere e visualizzare i codici locale.
* **Utilità di formattazione** per numeri, date, messaggi, elenchi e tempo relativo in base all'impostazione regionale.

## Quando usare `generaltranslation` [#when-to-use]

Usa `generaltranslation` quando devi:

* Tradurre contenuti da uno script, un servizio backend, un worker o una fase di build personalizzata.
* Caricare e scaricare file di traduzione senza usare la CLI.
* Creare automazioni di traduzione personalizzate basate su file, job, branch o tag del Project.
* Formattare numeri, date, messaggi o nomi delle impostazioni regionali al di fuori di React o Next.js.
* Condividere il comportamento di GT tra pacchetti che non usano lo stesso framework frontend.

## Guida rapida [#quickstart]

Installa `generaltranslation`, crea un'istanza di [GT](/docs/platform/core/reference/gt-class/constructor) con il tuo ID progetto e la tua chiave API e traduci la tua prima stringa.

### 1. Installa `generaltranslation`

<Tabs items={['npm', 'yarn', 'bun', 'pnpm']}>
  <Tab value="npm">
    ```bash
    npm install generaltranslation
    ```
  </Tab>

  <Tab value="yarn">
    ```bash
    yarn add generaltranslation
    ```
  </Tab>

  <Tab value="bun">
    ```bash
    bun add generaltranslation
    ```
  </Tab>

  <Tab value="pnpm">
    ```bash
    pnpm add generaltranslation
    ```
  </Tab>
</Tabs>

### 2. Ottieni una chiave API

Crea un `GT_PROJECT_ID` e una `GT_API_KEY` nella Dashboard. Apri la pagina [API Keys](https://dash.generaltranslation.com/api-keys), fai clic su **Create API Key**, inserisci un nome e conferma.

```bash
GT_PROJECT_ID=your-project-id
GT_API_KEY=your-api-key
```

General Translation offre limiti di richieste gratuiti molto elevati per i Project personali, gli sviluppatori indipendenti e la community.

### 3. Inizializza la classe GT

Inizializza la classe [GT](/docs/platform/core/reference/gt-class/constructor) e passa in modo sicuro `GT_PROJECT_ID` e `GT_API_KEY`.

```typescript title="src/index.ts"
import { GT } from 'generaltranslation';

const gt = new GT({
  projectId: 'your-project-id',
  apiKey: 'your-api-key',
});
```

Puoi configurare le impostazioni regionali predefinite nell&#39;istanza [GT](/docs/platform/core/reference/gt-class/constructor). Usa le impostazioni regionali predefinite quando la maggior parte delle chiamate utilizza la stessa impostazione regionale di origine o di destinazione.

```typescript title="src/index.ts"
const gt = new GT({
  projectId: 'your-project-id',
  apiKey: 'your-api-key',
  sourceLocale: 'en',
  targetLocale: 'es',
});
```

Vedi [classe GT](/docs/platform/core/reference/gt-class/constructor) per tutte le opzioni del costruttore.

### 4. Traduci la tua prima stringa

Chiama il metodo [translate](/docs/platform/core/reference/gt-class-methods/translation/translate) per tradurre la tua prima stringa. Passa la stringa che vuoi tradurre e l&#39;impostazione regionale di destinazione.

```typescript title="src/index.ts"
const result = await gt.translate('Hello, world!', 'es');

if (result.success) {
  console.log(result.translation); // "¡Hola, mundo!"
} else {
  console.error(`Translation failed: ${result.error}`);
}
```

I metodi di traduzione richiedono una chiave API e un ID progetto. Le funzioni di formattazione e le utilità relative alle impostazioni regionali possono essere utilizzate senza accesso all&#39;API di traduzione.
## Next steps

- /docs/platform/core/guides/translating-strings
- /docs/platform/core/guides/translating-files
- /docs/platform/core/guides/locale-codes