# General Translation Integrations: Quickstart
URL: https://generaltranslation.com/it/docs/integrations/mintlify/quickstart.mdx
---
title: Quickstart
description: Quickstart per tradurre un sito di documentazione Mintlify con General Translation.
related:
  links:
    - /docs/integrations/mintlify/guides/translating-content
    - /docs/integrations/mintlify/guides/managing-translations
    - /docs/integrations/mintlify/guides/using-translated-content
    - /docs/integrations/mintlify/guides/configuring-mintlify

---

Usa l'integrazione Mintlify per tradurre automaticamente la tua documentazione Mintlify in tutte le lingue che ti servono.

L'integrazione si basa su [Locadex](/docs/platform/locadex/quickstart), un AI Agent. Colleghi il repository GitHub che contiene la documentazione Mintlify, scegli le lingue e Locadex apre una pull request che aggiunge il routing di internazionalizzazione (i18n) e i contenuti tradotti. Non c'è alcun pacchetto da installare né alcun file di configurazione da scrivere a mano.

## Prima di iniziare [#before-start]

Ti servono:

* Un [Progetto](/docs/platform/dashboard/get-started).
* Un repository GitHub che contenga un progetto Mintlify valido: un `docs.json` il cui `$schema` punti a Mintlify (`mintlify.com/docs.json`), senza alcun `mint.json` legacy.
* Il permesso di installare una GitHub App su quel repository.

## Quickstart [#quickstart]

La configurazione richiede solo cinque minuti. Locadex si occupa della configurazione per te: devi solo scegliere il repository e le lingue.

### 1. Collega GitHub

Nella dashboard di General Translation, apri **Progetto > Integrazioni > Catalogo** e collega GitHub. Autorizza la GitHub App di General Translation per il repository che contiene la documentazione Mintlify.

### 2. Crea un'automazione

Apri **Progetto > Automations** e scegli **Generate translations and push**. Seleziona il repository collegato, la directory che contiene `docs.json` e **Mintlify** come framework. Verifica il branch di destinazione e il trigger, quindi fai clic su **Create automation**.

*Se la tua documentazione si trova in una sottodirectory di un monorepo, imposta la directory di destinazione su quel percorso. Vedi [Usare Locadex in un monorepo](/docs/platform/locadex/guides/using-in-monorepos).*

### 3. Esegui il setup

Apri l'automazione e fai clic su **Esegui il setup**. Imposta la **locale di origine** e le **lingue di destinazione**, quindi conferma. Vedi [Locales](/docs/integrations/mintlify/reference/locales).

### 4. Rivedi e fai il merge della pull request

Locadex esegue il setup e poi apre una pull request nel tuo repository. Potrebbero volerci alcuni minuti. La PR aggiunge la configurazione di General Translation, riorganizza la navigazione di `docs.json` per più lingue e include i file Markdown e MDX tradotti. Rivedi le modifiche e fai il merge per pubblicare la documentazione tradotta.

### 5. Mantieni aggiornate le traduzioni

Dopo il merge della PR di setup iniziale, Locadex segue il trigger configurato per l'automazione. Per impostazione predefinita, le nuove automazioni di traduzione vengono eseguite quando una pull request viene modificata. Per tradurre le modifiche dopo che raggiungono il branch di destinazione, imposta **Run when** su **A commit is pushed**. Vedi [Gestione delle traduzioni](/docs/integrations/mintlify/guides/managing-translations).
## Next steps

- /docs/integrations/mintlify/guides/translating-content
- /docs/integrations/mintlify/guides/managing-translations
- /docs/integrations/mintlify/guides/using-translated-content
- /docs/integrations/mintlify/guides/configuring-mintlify