Docusaurus-Dokumentation übersetzen – MDX und Code bleiben unberührt
Packen Sie Ihren Docs-Ordner als ZIP-Datei, laden Sie ihn hoch und erhalten Sie die übersetzten Dateien mit identischer Struktur zurück – bereit zum Einfügen in i18n/<locale>/docusaurus-plugin-content-docs/current. Import-Zeilen, Tabs und andere Komponenten, Admonition-Tags, Code-Blöcke und Links bleiben exakt erhalten; Titel, Sidebar-Labels, Beschreibungen und Fließtext werden übersetzt. Der erste Teil ist kostenlos und ohne Registrierung; bis zu 1,000,000 Zeichen kosten $5 als Einmalzahlung.
- import- und export-Zeilen sowie JSX-Komponenten bleiben zeichengenau erhalten
- Admonition-Markierungen (:::note, :::tip) bleiben erhalten; der Text darin wird übersetzt
- Frontmatter: title, description und sidebar_label übersetzt; id, slug, sidebar_position unverändert
- Überschriften-Anker wie {#install} bleiben erhalten, damit alle Links funktionieren
- Gleiche Ordnerstruktur als .zip zurück; Bilder werden unverändert übernommen
Docusaurus-i18n ohne lästiges Copy-Paste
Docusaurus erwartet eine Kopie jedes Dokuments im Sprachordner – übersetzt und mit identischen Dateinamen. Das von Hand oder Datei für Datei im KI-Chatbot zu erledigen, dauert ewig, und bei MDX sind Fehler teuer: Ein übersetzter Import-Name oder eine veränderte Prop lässt den Build fehlschlagen. Dieses Tool übersetzt nur den für Leser sichtbaren Text und übernimmt alles andere unverändert aus Ihren Dateien.
Inline-Code, Linkziele, Bildpfade und MDX-{expressions} werden vor der Übersetzung durch Platzhalter ersetzt und danach wieder eingefügt – das Modell sieht sie gar nicht erst. Zeilen, die reines JSX enthalten wie <Tabs> oder <TabItem value="mac">, werden übersprungen. Codeblöcke werden samt Kommentaren komplett ignoriert.
Nach dem Download
- Entpacken Sie das ZIP-Archiv und kopieren Sie den Inhalt des Ordners docs-<locale> nach i18n/<locale>/docusaurus-plugin-content-docs/current.
- Führen Sie docusaurus write-translations für Theme-Texte und Seitenleisten-Kategorien aus, die in JSON-Dateien liegen.
- Starten Sie die Website mit --locale <locale> und prüfen Sie die Seiten.
- Korrigieren Sie eventuelle Absätze, die in der Warnungsdatei aufgeführt sind.
Nicht enthalten
Seitenleisten-Beschriftungen sowie Texte für Navigationsleiste und Footer liegen in JSON-Dateien, die von write-translations erzeugt werden; übersetzen Sie diese mit dem Tool für Lokalisierungsdateien. Blogbeiträge funktionieren genauso wie Docs: Zippen Sie den Ordner blog und laden Sie ihn als zweiten Auftrag hoch – oder zusammen mit docs in einer gemeinsamen .zip-Datei.
Wie das Tool funktioniert, was es kostet und wie mit Ihren Dateien umgegangen wird, steht auf der Seite Markdown-Dokumentation übersetzen; die Preise für alle Tools finden Sie auf der Seite Preise.
Zuletzt aktualisiert:
Fragen und Antworten
Läuft der Build danach noch durch?
Imports, Komponenten, Props, Code und Linkziele werden exakt aus Ihren Dateien übernommen – genau daran scheitern MDX-Builds sonst meistens. Führen Sie nach dem Kopieren einmal den Build aus und prüfen Sie die Warnungsdatei.
Werden Admonitions übersetzt?
Die Zeilen mit :::note und ::: bleiben unverändert erhalten; der Text dazwischen wird übersetzt.
Wie viel passt in einen Auftrag?
Bis zu 1,000,000 Zeichen Text, etwa 300 Seiten, für $5. Code und Front-Matter-Schlüssel zählen nicht mit.
Kann ich zuerst ein paar Dateien testen?
Ja. Der erste Teil wird kostenlos übersetzt und am Bildschirm angezeigt; ein Auftrag mit bis zu 40 Absätzen ist komplett kostenlos.