Übersetzung

Docsbook veröffentlicht Ihre Dokumentation in fünfzehn Sprachcodes. Sie müssen keine Übersetzungsdateien schreiben, speichern oder pflegen: Sie aktivieren einfach eine Sprache, und Docsbook übersetzt die Seiten direkt aus dem Markdown in Ihrem Repository, veröffentlicht jede Sprache unter einem eigenen URL-Pfad und übersetzt eine Seite erneut, wenn ein Commit sie ändert.

Maschinell übersetzte Dokumentation ist in der Regel ein Risiko – verstümmelte Codebezeichner, Terminologie, die zwischen den Seiten driftet, Übersetzungen, die unbemerkt veralten, wenn sich die Quelle weiterentwickelt, und URLs für Sprachvarianten, die Ihre Sichtbarkeit in der Suche beeinträchtigen, anstatt sie zu erweitern. Im restlichen Abschnitt geht es darum, wie die Pipeline von Docsbook mit jedem dieser Punkte konkret umgeht und wo dies weiterhin nicht der Fall ist.

Was Ihnen das Öffnen einer Sprache bringt#

Drei konkrete Dinge, die Sie alle selbst überprüfen können.

Ein eigener Satz von URLs, auf die eine Suchanfrage in dieser Sprache überhaupt passen kann. Jede Sprache ist ein eigener URL-Pfad, der als statisches HTML gerendert, in Ihrer Sitemap aufgeführt und mit einem eigenen hreflang-Eintrag versehen wird. Eine ausschließlich englische Seite kann unabhängig von ihrer Platzierung nicht zu einer spanischen Suchanfrage passen; eine spanische Seite schon. Googles eigene Empfehlung lautet, dass übersetzte Seiten der Weg sind, für diese Zielgruppe infrage zu kommen – und kein Problem mit doppelten Inhalten darstellen – und Docsbook den hreflang-Cluster pro Seite statt pro Website erstellt, sodass der veröffentlichte Cluster von Google akzeptiert wird. Der Mechanismus und die Art und Weise, wie er bei nachlässiger Umsetzung scheitert, werden unter Übersetzungsqualität und SEO beschrieben.

Eine Website-Suche, die in der Sprache der Leserin oder des Lesers funktioniert. Wenn eine Seite übersetzt wird, wird der übersetzte Text unter dem entsprechenden Sprachcode für die Volltextsuche indexiert, nicht nur das englische Original. Leserinnen und Leser, die auf Deutsch suchen, finden deutsche Seiten.

Dokumentation, aus der ein Assistent in dieser Sprache zitieren kann. Dasselbe statische HTML, das ein Crawler liest, ruft auch ein KI-Assistent ab. Die Übersetzung erweitert die GEO-Abdeckung auf die von Ihnen geöffneten Sprachen, weil nun eine Seite in dieser Sprache zum Zitieren vorhanden ist.

Was es kostet#

Aufwand. Das Aktivieren einer Sprache besteht aus dem Setzen eines Kontrollkästchens und einem Bestätigungsdialog. Es gibt keinen Exportschritt, keine .po-Dateien, keine Schlüssel und kein Anbieter-Konto. Das nachträgliche Korrigieren eines bestimmten Satzes erfolgt im Übersetzungsbereich oder über einen upload_translation-Aufruf — siehe den Korrekturablauf.

Kosten. Das Übersetzen belastet das KI-Guthaben Ihres Projekts; die Auslieferung einer bereits übersetzten Seite an einen Leser verursacht keine Kosten. Eine Seite wird anhand eines Inhalts-Hashes in Abschnitte aufgeteilt, sodass beim Bearbeiten eines Absatzes dieser Abschnitt erneut übersetzt wird und der Rest aus dem Cache wiederverwendet wird. Docsbook nennt die Kosten des Durchlaufs, bevor Sie ihn bestätigen, und beendet ihn, statt das Guthaben zu überschreiten, wenn es aufgebraucht ist. Die automatische Übersetzung und die Tools für den Übersetzungsworkflow sind Bestandteil des kostenpflichtigen Tarifs — siehe Preise.

Aufmerksamkeit. Dies sind die Kosten, die die meisten Teams unterschätzen. Die maschinelle Übersetzung technischer Prosa ist gut genug zur Veröffentlichung, aber nicht gut genug, um sie ungeprüft zu lassen: Terminologieabweichungen und überübersetzte Fachbegriffe sind die dokumentierten Fehlerquellen, und Googles Spam-Richtlinien betrachten ungeprüfte maschinelle Übersetzung als Risiko für Ihre Website, nicht als neutralen Vorgang. Übersetzungsqualität und SEO erläutert, was Docsbook misst, was nicht und was Sie überprüfen sollten.

In diesem Abschnitt#

Einschränkungen und offene Fragen#

• Fünfzehn Sprachcodes, und nur diese. en, es, fr, de, pt, it, ru, zh, ja, ko, ar, hi, tr, pl, nl. Einer davon ist die Quellsprache Ihres Projekts und wird niemals als Übersetzungsziel verwendet – ein englischsprachiges Projekt hat also vierzehn Zielsprachen. Regionale Varianten (pt-BR gegenüber pt-PT, zh-Hans gegenüber zh-Hant) sind keine separaten Optionen.
• Docsbook veröffentlicht keine Bewertung der Übersetzungsqualität. Für Ihre Seiten gibt es weder einen BLEU- oder COMET-Wert noch eine Bewertung durch Menschen, und diese Dokumentation erhebt keinen Anspruch darauf. Das Produkt misst Abdeckung und Aktualität – wie viele Seiten in jeder Sprache vorhanden sind und wie viele aus der aktuellen Version der Quelle übersetzt wurden. Betrachten Sie „die Übersetzung ist gut“ als Ihr eigenes Urteil, das Sie anhand der Informationen unter Übersetzungsqualität und SEO fällen.
• Automatische Übersetzung ist eine kostenpflichtige Funktion, ebenso wie die zugehörige Sprachkonfiguration. Ein kostenloses Projekt sieht die Einstellungen und erhält beim Verbinden eine automatische Erkennung seiner Quellsprache, kann jedoch weder die aktivierten Sprachen oder die Quellsprache ändern noch den Übersetzungsmodus festlegen oder einen Übersetzungslauf starten. Siehe Preise.
• Die Pipeline übersetzt Markdown-Seiten aus Ihrem Repository. Sie ist kein Lokalisierungssystem für UI-Strings und übersetzt nicht die Feldbeschreibungen einer OpenAPI-Spezifikation.

Verwandte Themen#

• SEO — was Docsbook auf jeder Seite für Suchmaschinen ausgibt, unabhängig davon, ob sie übersetzt wurde oder nicht
• GEO — von einem KI-Assistenten zitiert werden, statt gerankt zu werden
• Bericht zu Besucher-Ländern — aus welchen Regionen Besucher kommen, für die du bisher noch keine Übersetzung anbietest
• Inhalt & Einrichtung — wie Seiten überhaupt in Docsbook gelangen