# 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

---

# Quickstart

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), l'AI Agent di General Translation. 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) General Translation con un piano che includa la funzionalità `locadex_workflows`.
* 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.

*Nota: se la funzionalità* `locadex_workflows` *non è inclusa nel tuo piano, la Dashboard mostra un prompt di upgrade invece della configurazione di Locadex, quindi non puoi collegare un 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 il tuo progetto e vai a **Locadex > Agent**. Fai clic su **Connect GitHub** e autorizza la connessione. Segui la procedura per installare la GitHub App di General Translation sui repository a cui vuoi che Locadex abbia accesso (tutti i repository o solo una selezione specifica).

### 2. Collega il tuo repository

Nella Dashboard, seleziona il repository che contiene la tua documentazione Mintlify. Ogni progetto è collegato a un solo repository; crea altri progetti per altri repository.

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

### 3. Scegli le lingue

Imposta la **default locale** (la lingua in cui è scritta la tua documentazione) e le **lingue di destinazione** in cui tradurre. Facoltativamente, attiva o disattiva **Nascondi la default locale nei percorsi URL** per controllare se la tua lingua sorgente viene pubblicata senza un prefisso di impostazione regionale. Vedi [Locales](/docs/integrations/mintlify/reference/locales).

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

Locadex esegue il workflow di 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 configurazione iniziale, Locadex monitora il branch predefinito. Quando esegui il push di contenuti nuovi o modificati, traduce automaticamente gli aggiornamenti. 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