# 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 della documentazione di Mintlify a General Translation e configurare le lingue e i trigger delle traduzioni.
related:
  links:
    - /docs/integrations/mintlify/guides/translating-content
    - /docs/integrations/mintlify/guides/managing-translations
    - /docs/integrations/mintlify/guides/using-translated-content

---

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 il repository e l'automazione associati si configurano da **Progetto > Integrations** e **Progetto > Automations** nel Dashboard.

## Prima di iniziare [#before-start]

* Un [progetto](/docs/platform/dashboard/get-started) General Translation.
* 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 **Progetto > Integrations > Catalog**.
2. Collega GitHub e autorizza la GitHub App di General Translation per il repository che contiene la documentazione Mintlify.
3. Apri **Progetto > Automations** e scegli **Generate translations and push**.
4. Seleziona il repository, la directory di destinazione e il framework **Mintlify**.

## Imposta la directory di destinazione [#target-directory]

Se il tuo `docs.json` si trova nella radice del repository, imposta **Directory di destinazione** su `.`. Se invece la documentazione si trova in una sottodirectory, ad esempio in un monorepo, imposta **Directory di destinazione** su quel percorso, in modo che Locadex operi nella cartella corretta. Vedi [Usare Locadex in un monorepo](/docs/platform/locadex/guides/using-in-monorepos).

## Scegli le lingue [#languages]

Imposta l'**impostazione regionale sorgente** (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).

## Scegli il layout URL per l'impostazione regionale predefinita [#default-locale-url]

Il setup avviato da **Progetto > Automations** crea un layout con prefisso dell'impostazione regionale per ogni lingua, inclusa l'impostazione regionale sorgente. Ad esempio, le pagine sorgente in inglese vengono pubblicate sotto `/en/...`.

I progetti esistenti configurati per nascondere l'impostazione regionale sorgente continuano a pubblicare le pagine sorgente nei percorsi originali. Questo comportamento viene registrato nel file `gt.config.json` generato; consulta il [riferimento della configurazione](/docs/integrations/mintlify/reference/config#options).

Questo layout cambia il modo in cui Locadex ristruttura i file e la navigazione di `docs.json`. Esamina la pull request di setup prima di eseguire il merge.

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

Locadex apre o aggiorna pull request con le modifiche che apporta. Riutilizza una PR aperta per lo stesso branch dell'automazione e ne apre una nuova dopo che la PR precedente è stata sottoposta a merge o chiusa.

Le nuove automazioni di traduzione usano per impostazione predefinita **Le modifiche a una pull request**, con **Auto-merge** disattivato. Scegli **Viene eseguito il push di un commit** per tradurre le modifiche dopo che raggiungono il branch di destinazione e attiva **Auto-merge** quando controlli obbligatori affidabili possono proteggere il branch. Vedi [Merge automatico delle PR di Locadex](/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