---
title: Traduci un sito MkDocs con l'IA | Smartcat
description: Traduci il tuo sito MkDocs con l'AI ed effettua la revisione nel contesto. Esegui l'installazione tramite l'override del tema per il blocco head.
canonical: https://it.smartcat.com/integrations/mkdocs/
language: it
updated: 2026-11-16
---

# Traduci un sito MkDocs con l'IA | Smartcat

## Traduci il tuo sito MkDocs con l'AI

Aggiungi lo snippet del sito web di Smartcat al tuo progetto MkDocs una sola volta, distribuiscilo tramite la tua normale pipeline ed esegui la revisione delle traduzioni in Smartcat prima di pubblicare una lingua.

- [Inizia la prova gratuita](https://smartcat.com/sign-up)

- [Prenota una demo](https://www.smartcat.com/book-a-demo/?mkdocs)

## Come aggiungi Smartcat a MkDocs

Crea un Smartcat progetto di sito web dal tuo URL MkDocs pubblicato e scegli le lingue di destinazione.

Installa lo snippet generato di Smartcat tramite l'override del tema per il blocco head (extra_javascript carica solo gli asset).

Distribuisci la modifica e apri il sito pubblicato per confermare che lo snippet sia presente.

Rivedi le traduzioni nell'editor visivo di Smartcat e pubblica le lingue pronte.

## Traduci un sito MkDocs senza fare editing dell'HTML generato

Mantieni l'integrazione nella tua configurazione di partenza di MkDocs. extra_javascript carica gli asset JavaScript, mentre potrebbe essere necessario un override del tema quando l'installazione fornita richiede markup nell'head. Con Material per MkDocs, usa l'estensione del modello che dispone di supporto invece di modificare il pacchetto del tema installato.

Ricostruisci ed esegui il deployment, poi effettua una revisione di una guida con navigazione, avvisi ed esempi di codice. Un avviso tradotto dovrebbe preservare la sua gravità e un esempio di comando dovrebbe rimanere eseguibile. La traduzione del sito web non produce una seconda serie di sorgenti di partenza Markdown.

## Cosa cambia per i visitatori e cosa rimane in MkDocs

La traduzione di siti web apporta modifiche all'esperienza di lettura pubblicata. Non crea file di partenza tradotti, cataloghi di messaggi o build delle impostazioni locali nel tuo repository MkDocs.

## Revisione prima che una lingua vada online

La traduzione automatica ti offre una prima bozza veloce. Nell'editor visuale di Smartcat vedi ogni stringa tradotta sulla pagina, accorci i titoli troppo lunghi sui dispositivi mobili e mantieni la coerenza di nomi di prodotti e brand grazie a un glossario. Assegna un responsabile della revisione quando una pagina necessita di approvazione e pubblica solo le lingue che sono pronte.

## Domande frequenti

### Posso incollare i tag script HTML in extra_javascript?

extra_javascript è una configurazione delle risorse, non un campo intestazione HTML a testo libero. Segui la sua struttura che ha supporto e usa una sostituzione del tema quando è richiesto il markup effettivo.

### Posso eseguire l'editing delle traduzioni prima della pubblicazione?

Sì. Perfeziona e conferma il testo nell'editor visivo di Smartcat, poi pubblica le lingue pronte.

### Cosa succede quando aggiungi una nuova pagina in MkDocs?

Il nuovo testo segue la modalità di traduzione selezionata per il progetto Smartcat. Scegli le traduzioni con Revisione della traduzione quando ogni nuova pagina richiede l'approvazione; le modalità automatiche possono tradurre il testo appena rilevato. Nessuna delle due modalità apporta modifiche ai tuoi contenuti di partenza in MkDocs.

Pubblica il tuo sito MkDocs in più lingue

Installa lo snippet una sola volta, esamina le traduzioni nel contesto e pubblica le lingue di cui il tuo pubblico ha bisogno. Vedi tutte le [integrazioni per siti web](https://www.smartcat.com/integrations/category/website-translation/) o scopri come funziona il [traduttore per siti web](https://www.smartcat.com/website-translator/).

- [Inizia la prova gratuita](https://smartcat.com/sign-up)
