Traduci la tua documentazione Mintlify

Creato su misura per Mintlify. Collega il tuo repo e ogni pagina sarà disponibile in tutte le lingue in pochi minuti

Inizia ora
General Translation

Quickstart

Translate a Mintlify documentation site with General Translation.

The integration is powered by Locadex, an AI agent: connect the GitHub repository that holds your docs, choose your languages, and Locadex opens a pull request with internationalization (i18n) routing and translated content. There is nothing to install and no config to write by hand.

Before you start

You need:

  • A project.
  • A GitHub repository containing a valid Mintlify project: a docs.json whose $schema points at Mintlify (mintlify.com/docs.json), with no legacy mint.json.
  • Permission to install a GitHub App on that repository.

Merge della pull request completatoes, fr, ja

Traduci la tua documentazione in pochi passaggi

Bastano tre passaggi e pochi minuti, senza codice da modificare né configurazioni da scrivere a mano

  1. Connetti il tuo repo

    Collega il nostro Locadex Agent al repo GitHub che ospita la tua documentazione Mintlify.

  2. Scegli le lingue

    Scegli il locale di origine e le lingue di destinazione.

  3. Esegui il merge della PR

    Locadex si occupa di tutta la configurazione e apre una PR con le pagine tradotte, la navigazione multilingue e il routing per l'internazionalizzazione (i18n). Esegui il merge e la tua documentazione tradotta sarà online.

Come posso tradurre un sito di documentazione Mintlify?

Trascrizione

In Hamburg, your Mintlify docs open in English, and the site offers no German. The navigation in docs.json lists one set of English pages and no languages. General Translation lets you choose languages, and Locadex opens a translation pull request. Authorize the General Translation app on GitHub, and choose your docs repository in the Dashboard. Create an automation from the Generate translations and push template for Mintlify, then run its setup with your languages. Locadex's pull request adds a navigation entry per language and the translated pages. The merged site's menu switches the docs to Spanish, Japanese and German.

Scelto dalle migliori aziende al mondo

General Translation sviluppa l'intero stack di localizzazione, offrendo un'esperienza fluida sia agli sviluppatori sia agli utenti

  • 11+ locales tra dashboard, landing page e iOS

  • 14+ locales tra web e documentazione

  • 47+ locales tra piattaforma e documentazione

  • 2+ locales tra web, iOS e Android

  • 7+ locales tra web e GTM

  • Librerie i18n open-source
  • Traduzione sensibile al contesto
  • Piattaforma di revisione collaborativa
  • Integrazioni per i contenuti
  • Locadex Agent

Traduzioni di livello madrelingua basate sul contesto completo

Traduzioni della massima qualità, basate sulla comprensione del tuo prodotto e verificate consultando l'intero sito di documentazione

Contesto a ogni livello

Le traduzioni rispettano il tuo tono di voce e le tue regole di stile e tengono conto del contesto e della logica del tuo prodotto.

Coerenza in ogni pagina

Ogni pagina viene revisionata, confrontata con il testo sorgente e controllata per garantirne la coerenza con le altre pagine.

Rivedi e modifica insieme al tuo team

Puoi modificare ogni riga nella Dashboard, con le lingue affiancate, la cronologia e i commenti.

Traduzione continua a ogni aggiornamento

Ogni volta che aggiorni la documentazione, Locadex traduce le modifiche e apre una pull request per te. Ti basta rivederla e fare il merge

  1. Invia una modifica alla documentazione
  2. Locadex traduce le parti modificate
  3. Si apre una pull request
  4. Rivedi e fai il merge
  5. Online in tutte le lingue

Collega e localizza la tua intera suite di prodotti

General Translation riunisce codice, contenuti, traduzioni e revisione in un'unica piattaforma

Domande frequenti

Tradurre la mia documentazione equivale a localizzarla?

Non proprio. La traduzione trasferisce i tuoi contenuti da una lingua all'altra. La localizzazione è un concetto più ampio che comprende la traduzione del software e l'adattamento dell'intero prodotto a ciascuna impostazione regionale. Include l'internazionalizzazione (i18n), che prepara il tuo sito a supportare più impostazioni regionali, gestendo routing, navigazione, date, valute, plurali e altre convenzioni.

General Translation si occupa della configurazione e della manutenzione continua sia della localizzazione sia della traduzione.

Per la configurazione completa della localizzazione, consulta Localizzazione di Mintlify.

Non posso semplicemente tradurre la mia documentazione con un'API di IA?

Per un intervento una tantum, sì. Ma per pubblicare ogni settimana documentazione affidabile in ogni lingua, serve un sistema che non si limiti al solo modello.

Le tue pagine non sono solo testo. I componenti MDX, le importazioni e i blocchi di codice devono rimanere esattamente come sono stati scritti, il frontmatter deve conservare le proprie chiavi e gli ID dei titoli come {#configure-client} devono restare associati ai rispettivi titoli, per non rendere inutilizzabili i collegamenti diretti.

La tua documentazione è un sito, non una pagina. Serve una versione della navigazione per ogni lingua, i codici locali devono essere tra quelli accettati dalla tua piattaforma e «workspace» deve essere tradotto nello stesso modo a pagina 1 e a pagina 400 (e nella tua app, per la quale supportiamo anche la localizzazione).

La tua documentazione cambia ogni settimana. Ogni aggiornamento dovrebbe tradurre solo ciò che è cambiato, conservare le modifiche manuali dei revisori ed essere proposto come pull request sul branch giusto. Aggiungere una lingua in un secondo momento non dovrebbe compromettere quelle già presenti.

I membri del team hanno bisogno di controllo e visibilità: devono poter vedere ogni riga affiancata al testo sorgente e avere accesso a cronologia, commenti, ruoli e regole sul tono per ogni lingua.

General Translation gestisce tutto questo end-to-end. Gestiamo migliaia di PR di localizzazione per i nostri clienti, che possono così concentrarsi sullo sviluppo di un prodotto amato in tutto il mondo.

I nostri traduttori e revisori possono modificare le traduzioni?

Sì. Nella pagina Traduzioni, i revisori confrontano i testi nelle diverse lingue affiancati, modificano qualsiasi riga inline e aggiungono etichette, note e commenti. Non ci sono limiti al numero di utenti, quindi può partecipare tutto il team.

Quanto tempo richiede la configurazione?

Bastano pochi minuti, non serve una migrazione. Collega il tuo repository, scegli le lingue ed esegui il merge della pull request aperta da General Translation; da quel momento, la traduzione procede su larga scala (Ramp ha tradotto 40.000 chiavi, per un totale di milioni di parole, in pochi minuti). Puoi anche affidare la configurazione al tuo agente di programmazione con il pulsante Configurazione per agenti.

Quali lingue sono supportate?

Tutte le lingue supportate da Mintlify, tra cui spagnolo, francese, tedesco, giapponese, coreano, cinese (semplificato e tradizionale), portoghese (anche brasiliano), arabo, ebraico e hindi. General Translation associa le impostazioni regionali che scegli ai codici lingua di Mintlify; per le varianti regionali viene usata la lingua di base, a meno che Mintlify non le supporti direttamente. Consulta l’elenco completo.

Le traduzioni rimarranno aggiornate man mano che la documentazione cambia?

Sì, in modo continuo. Il nostro Locadex Agent si attiva in base ai trigger che scegli: pull request, commit o avvio manuale. Traduce solo ciò che è cambiato, anziché l'intero sito, e invia le traduzioni tramite una pull request, così ogni rilascio è disponibile in tutte le lingue insieme alla modifica che lo ha introdotto.

Le traduzioni rispecchieranno il nostro tono di voce e la nostra terminologia?

General Translation ti consente di impostare Prompt Personalizzati in base al tuo tono e stile e un Glossario che definisce i nomi dei prodotti e la terminologia chiave. Il contesto viene applicato in modo coerente a tutte le tue traduzioni: app, sito web, documentazione, presentazioni e file di progettazione.

La traduzione comprometterà i miei componenti MDX?

No. La traduzione mantiene la sintassi MDX e la struttura dei componenti, traducendo i contenuti leggibili da persone. Per i siti Mintlify vengono tradotti anche i titoli e le descrizioni nel frontmatter.

Quanto costa?

Fatturazione a consumo senza costi per utente né abbonamenti. Nessun costo di piattaforma con il piano Starter, che include progetti, utenti e lingue illimitati e una quota gratuita per iniziare. Consulta la pagina dei prezzi per tutte le tariffe.

Traduci la tua documentazione Mintlify per un pubblico globale

Inizia gratis, senza tariffe mensili