Localizza la tua documentazione Markdown

Traduci ogni file Markdown della tua documentazione in pochi minuti con General Translation

Inizia ora

content/docs/en-US/platform/locadex/quickstart.md

  1. ---
  2. title: Quickstart
  3. description: Use Locadex, the AI agent which connects your codebase, translations, and content sources. It’s the fastest way to run General Translation's full-stack localization.
  4. ---
  5. Locadex is the General Translation AI agent which connects your codebase, translations, and content sources.
  6. After setup, Locadex can configure your project and automatically translate it into the languages you choose.
  7. Locadex currently supports **Next.js**, **Mintlify**, **Fern**, and **Docusaurus** projects, along with React applications built with Vite, Gatsby, Redwood, React Router, TanStack Start, Bazel, esbuild, Rollup, Rolldown, or webpack.
  8. ## How Locadex works [#locadex-works]
  9. Locadex works inside your GitHub repository and automatically opens or updates PRs with generated changes. Three automation templates keep your localization up to date:
  10. - **Generate code** wraps source code with the right internationalization (i18n) library calls, such as `t()` and the `T` component.
  11. - **Generate translations and push** translates source content into every target language and updates translation files.
  12. - **Keep locales in sync** updates project files when languages are added or removed.

npx gt translatees, fr, ja

Localizza la tua documentazione in qualsiasi lingua, in pochi passaggi

Traduzioni pronte per la produzione per l'intero sito di documentazione in pochi minuti

  1. Avvia la configurazione guidata

    Esegui npx gt init nel repo della tua documentazione, scegli Markdown come formato dei file e seleziona le lingue di destinazione.

  2. Indica i file da tradurre

    La procedura guidata aggiunge a gt.config.json un pattern glob per i file .md, con una cartella [locale] per ogni lingua. Non occorre modificare il codice.

  3. Traduci e distribuisci

    Esegui npx gt translate: la CLI crea una copia tradotta di ogni file, mantenendo intatte la sintassi e la formattazione Markdown. Includi i file tradotti in un commit e pubblicali insieme al sito della documentazione.

Come posso mantenere aggiornate le traduzioni a ogni distribuzione?

Trascrizione

In Montreal, your French page shows the line you added this week in English. Your build script runs next build alone, so the line was never translated. General Translation keeps translations current when your CI runs npx gt translate before the build. Create an API key for CI with the file, context and translation queue permissions. Store it and your project ID as secrets in your CI provider. Add npx gt translate to your build script, before the build command. Run that build on every push to main, for example with a GitHub Actions workflow. Each build then ships current translations in Spanish, Japanese and French.

Scelto dalle migliori aziende al mondo

General Translation sviluppa uno stack completo per la localizzazione, per un'esperienza di sviluppo senza ostacoli

  • 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.

Localizzazione continua a ogni aggiornamento

Esegui npx gt translate prima della build della documentazione: ogni esecuzione traduce solo ciò che è cambiato, così a ogni distribuzione la documentazione è disponibile in tutte le lingue

  1. Invia una modifica alla documentazione
  2. La build esegue la CLInpx gt translate
  3. Vengono tradotte solo le parti modificate
  4. Distribuito 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

Qual è la differenza tra traduzione, internazionalizzazione e localizzazione?

La traduzione converte i contenuti da una lingua a un'altra. L'internazionalizzazione (i18n) prepara il sito a supportare più impostazioni regionali, gestendo routing, navigazione, date e plurali. La localizzazione (l10n) è il processo complessivo di adattamento del prodotto a ogni impostazione regionale, dai testi alla formattazione. Per la documentazione Markdown, l'internazionalizzazione consiste nell'organizzare i contenuti in una cartella per ogni impostazione regionale supportata dal sito; la traduzione consiste nel tradurre ciascun file in ogni lingua. General Translation gestisce l'intero flusso di lavoro di localizzazione in modo continuo.

Cerchi informazioni specifiche sulla traduzione? Consulta Traduzione Markdown.

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 integrato nel tuo repo insieme alla build. 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.

Quanto tempo richiede la configurazione?

Bastano pochi minuti, non serve una migrazione. Esegui npx gt init, scegli le lingue ed esegui npx gt translate; 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 oltre 120 impostazioni regionali supportate da General Translation, comprese varianti regionali come pt-BR e zh-Hant e lingue con scrittura da destra a sinistra come l'arabo e l'ebraico. Elencale in gt.config.json e aggiungine altre quando vuoi. Consulta le impostazioni regionali supportate.

Le traduzioni rimarranno aggiornate man mano che la documentazione cambia?

Sì, in modo continuo. Esegui npx gt translate nella pipeline CI prima della build della documentazione. Traduce solo i contenuti il cui testo sorgente è cambiato e conserva le tue modifiche locali, così ogni modifica viene rilasciata in tutte le lingue contemporaneamente.

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à la formattazione Markdown?

No. La CLI mantiene intatte la sintassi e la formattazione Markdown in ogni file tradotto e gli ID espliciti dei titoli, come {#id}, restano associati ai rispettivi titoli.

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.

Rendi la tua documentazione Markdown accessibile a un pubblico globale

Inizia gratis, senza tariffe mensili