Vertaal Docusaurus-documentatie naar een andere taal, met MDX en code onaangeroerd
Zip je docs-map, upload hem en ontvang dezelfde bestanden vertaald terug, direct klaar om in i18n/<locale>/docusaurus-plugin-content-docs/current te plaatsen. Importregels, Tabs en andere componenten, admonition-markers, codeblokken en links blijven zoals ze zijn; titels, sidebar-labels, beschrijvingen en de lopende tekst worden vertaald. Het eerste deel is gratis zonder account; tot 1,000,000 tekens tekst kost $5, eenmalig betaald.
- import- en exportregels en regels met JSX-componenten blijven exact behouden
- Admonition-markers (:::note, :::tip) behouden; de tekst ertussen wordt vertaald
- Frontmatter: title, description en sidebar_label vertaald; id, slug en sidebar_position behouden
- Kopankers zoals {#install} behouden, zodat links blijven werken
- Dezelfde mappaden terug als .zip; afbeeldingen ongewijzigd meegenomen
Docusaurus i18n zonder knippen en plakken
Docusaurus verwacht een vertaalde kopie van elk document in de locale-map, met exact dezelfde bestandsnamen. Dat met de hand doen, of bestand voor bestand in een chatbot, is traag en bij MDX zijn fouten fataal: een vertaalde import-naam of een gewijzigde prop laat de build crashen. Deze tool vertaalt alleen wat de lezer ziet en neemt al het andere letterlijk over uit je bestanden.
Inline code, linkdoelen, afbeeldingspaden en MDX-{expressions} worden vóór de vertaling vervangen door tijdelijke markers en achteraf teruggeplaatst, zodat het model ze nooit te zien krijgt. Regels met uitsluitend JSX, zoals <Tabs> of <TabItem value="mac">, worden overgeslagen. Codeblokken worden volledig overgeslagen, inclusief commentaren.
Na het downloaden
- Pak de .zip uit en kopieer de inhoud van de map docs-<locale> naar i18n/<locale>/docusaurus-plugin-content-docs/current
- Voer docusaurus write-translations uit voor themalabels en namen van zijbalkcategorieën, die in JSON staan
- Start de site met --locale <locale> en loop er even doorheen
- Pas eventuele alinea's aan die in het waarschuwingenbestand vermeld staan
Niet inbegrepen
Zijbalkcategorielabels, navigatiebalk- en footerteksten staan in JSON-bestanden die worden gegenereerd door write-translations; vertaal die met de tool voor lokalisatiebestanden. Blogposts werken op dezelfde manier als documentatie: zip de blogmap en upload deze als een tweede opdracht, of samen met docs in één .zip.
Hoe de tool werkt, wat het kost en hoe we met je bestanden omgaan, staat op de pagina Markdown-documentatie vertalen; de prijzen van alle tools staan op de pagina prijzen.
Laatst bijgewerkt op
Vragen en antwoorden
Slaagt de build nog steeds?
Imports, componenten, props, code en linkdoelen worden rechtstreeks uit je bestanden overgenomen — precies waar MDX-builds normaal gesproken op stuklopen. Voer de build na het kopiëren eenmalig uit en controleer het waarschuwingenbestand.
Worden admonitions vertaald?
De regels met :::note en ::: blijven exact zoals ze zijn; de tekst ertussen wordt vertaald.
Hoeveel past er in één opdracht?
Tot 1,000,000 tekens tekst, ongeveer 300 pagina's, voor $5. Code en frontmatter-sleutels tellen niet mee.
Kan ik eerst een paar bestanden proberen?
Ja. Het eerste deel wordt gratis vertaald en direct getoond; een opdracht tot 40 alinea's is volledig gratis.