Traduci la documentazione Docusaurus in un'altra lingua, senza toccare MDX e codice
Comprimi la cartella docs in uno zip, caricala e ricevi gli stessi file tradotti, pronti da inserire in i18n/<locale>/docusaurus-plugin-content-docs/current. Righe di import, Tabs e altri componenti, marcatori di admonition, blocchi di codice e link rimangono invariati; titoli, etichette della barra laterale, descrizioni e testo discorsivo vengono tradotti. La prima parte è gratis senza registrazione; fino a 1,000,000 caratteri di testo a $5, pagamento una tantum.
- Righe di import ed export e componenti JSX copiati esattamente come scritti
- Marcatori di admonition (:::note, :::tip) mantenuti; il testo all'interno viene tradotto
- Front matter: title, description e sidebar_label tradotti; id, slug e sidebar_position mantenuti
- Ancore dei titoli come {#install} mantenute, così i link continuano a funzionare
- Stessa struttura delle cartelle restituita in un .zip; immagini copiate senza modifiche
L'i18n di Docusaurus senza copia e incolla
Docusaurus richiede una copia tradotta di ogni documento nella cartella della lingua, mantenendo gli stessi nomi di file. Farlo a mano o file per file con un chatbot è lento, e con MDX gli errori costano caro: un nome di import tradotto o una prop modificata mandano in errore la build. Questo strumento traduce solo le parti visibili ai lettori e copia tutto il resto direttamente dai tuoi file.
Codice inline, destinazioni dei link, percorsi delle immagini ed {espressioni} MDX vengono sostituiti da segnaposto prima della traduzione e ripristinati subito dopo, così il modello non li vede nemmeno. Le righe composte solo da JSX, come <Tabs> o <TabItem value="mac">, vengono ignorate. I blocchi di codice vengono saltati del tutto, inclusi i relativi commenti.
Dopo il download
- Estrai il file zip e copia il contenuto della cartella docs-<locale> in i18n/<locale>/docusaurus-plugin-content-docs/current
- Esegui docusaurus write-translations per le etichette del tema e i nomi delle categorie della barra laterale, che si trovano nei file JSON
- Avvia il sito con --locale <locale> e naviga tra le pagine per verificare
- Correggi gli eventuali paragrafi segnalati nel file dei warning, se presente
Cosa non è incluso
Le etichette delle categorie della barra laterale e i testi di navbar e footer si trovano nei file JSON generati da write-translations: puoi tradurli con lo strumento Traduci file di localizzazione. Gli articoli del blog funzionano come la documentazione: comprimi la cartella blog in un file zip e caricala come secondo lavoro, oppure insieme a docs in un unico file .zip.
Come funziona lo strumento, quanto costa e come vengono gestiti i tuoi file lo trovi nella pagina Traduci documentazione Markdown; i prezzi di ogni strumento sono nella pagina prezzi.
Ultimo aggiornamento:
Domande e risposte
La build andrà a buon fine?
Import, componenti, prop, codice e destinazioni dei link vengono copiati direttamente dai tuoi file, che è dove di solito le build MDX falliscono. Esegui la build una volta terminata la copia e controlla il file dei warning.
Le admonition vengono tradotte?
Le righe con :::note e ::: restano esattamente come sono; il testo al loro interno viene tradotto.
Quanto può contenere un singolo lavoro?
Fino a 1,000,000 caratteri di testo, circa 300 pagine, per $5. Il codice e le chiavi del front matter non vengono conteggiati.
Posso provare prima con qualche file?
Sì. La prima parte viene tradotta gratis e mostrata sullo schermo; un lavoro fino a 40 paragrafi è gratis per intero.