# General Translation Integrations: Configurare Mintlify
URL: https://generaltranslation.com/it/docs/integrations/mintlify/guides/configuring-mintlify.mdx
---

title: Configurare Mintlify
description: "Come collegare un repository di documentazione Mintlify a General Translation: questa guida spiega come scegliere le lingue e configurare l'esecuzione delle traduzioni."
related:
  links:
    - /docs/integrations/mintlify/guides/translating-content
    - /docs/integrations/mintlify/guides/managing-translations
    - /docs/integrations/mintlify/guides/using-translated-content

---

# Configurare Mintlify

Collega a General Translation il repository GitHub che contiene la documentazione di Mintlify, quindi scegli le lingue e il modo in cui devono essere eseguite le traduzioni. Il [Quickstart](/docs/integrations/mintlify/quickstart) mostra la procedura più rapida; questa guida illustra più nel dettaglio le opzioni di configurazione.

L'integrazione si basa su [Locadex](/docs/platform/locadex/quickstart), quindi si configura da **Locadex > Agent** nel Dashboard, non da un pacchetto o da un file di configurazione da modificare manualmente.

## Prima di iniziare [#before-start]

* Un [progetto](/docs/platform/dashboard/get-started) General Translation con un piano che include la funzionalità `locadex_workflows`.
* Un repository GitHub con un progetto Mintlify valido. Locadex verifica che il repository contenga un file `docs.json` il cui `$schema` punti a Mintlify. Rifiuta i progetti che usano ancora il vecchio `mint.json` (prima esegui la migrazione a `docs.json`) o che sembrano un'app Next.js.

## Connetti e collega il tuo repository [#connect]

1. Nella Dashboard, apri il tuo progetto e vai a **Locadex > Agent**.
2. Fai clic su **Connect GitHub** e autorizza la General Translation GitHub App sui repository a cui vuoi consentire l'accesso a Locadex.
3. Seleziona il repository che contiene la documentazione Mintlify. Ogni progetto è collegato a un solo repository.

## Imposta la directory radice dell'app [#app-directory]

Se il file `docs.json` si trova nella radice del repository, lascia vuota la directory radice dell'app oppure impostala su `.`. Se la documentazione si trova in una sottodirectory (ad esempio in un monorepo), imposta la directory radice dell'app su quel percorso, così Locadex opererà sulla cartella corretta. Vedi [Monorepos](/docs/platform/locadex/guides/using-in-monorepos).

## Scegli le lingue [#languages]

Imposta l'**impostazione regionale predefinita** (la lingua in cui è scritta la documentazione) e le **lingue di destinazione** in cui tradurre.

Mintlify supporta un insieme fisso di codici lingua e General Translation associa a essi le locales che scegli. Possono essere usate solo le locales che corrispondono a una lingua supportata da Mintlify. Vedi [Locales](/docs/integrations/mintlify/reference/locales).

Per cambiare lingua in seguito, vedi [Gestione delle traduzioni](/docs/integrations/mintlify/guides/managing-translations).

## Nascondi l'impostazione regionale predefinita [#hide-default]

Usa l'interruttore **Nascondi l'impostazione regionale predefinita nei percorsi URL** per controllare come viene servita la tua lingua sorgente:

* **Attivo** (predefinito): le pagine dell'impostazione regionale predefinita restano nei percorsi esistenti (senza prefisso di impostazione regionale) e solo le lingue tradotte ricevono un prefisso di impostazione regionale.
* **Disattivo**: ogni lingua, inclusa quella predefinita, viene servita con il proprio prefisso di impostazione regionale.

Questa scelta cambia il modo in cui Locadex ristruttura i file e la navigazione di `docs.json`. Consulta il [riferimento della configurazione](/docs/integrations/mintlify/reference/config) per vedere esattamente cosa produce ciascuna modalità.

## Configura l'esecuzione delle traduzioni [#triggers]

Locadex apre pull request per ogni modifica che apporta. Per i repository di documentazione, si attiva sui nuovi commit del branch predefinito e può eseguire automaticamente il merge delle pull request di traduzione una volta superati i controlli, così la documentazione resta tradotta senza passaggi manuali. Puoi rivedere queste impostazioni e modificare il trigger o il comportamento di auto-merge in qualsiasi momento — vedi [Auto-merge](/docs/platform/locadex/guides/auto-merging-prs).
## Next steps

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