AI-Übersetzung
Aktiviere gewünschte Sprachen: Jamdesk übersetzt deine Dokumentation nach jedem Build und committet die Seiten in dein eigenes GitHub-Repository.
Jamdesk kann deine Dokumentation für dich übersetzen. Wähle die gewünschten Sprachen in den Projekteinstellungen aus. Nach jedem Build übersetzt Jamdesk deine englischen Seiten und committet die Ergebnisse in dein eigenes GitHub-Repository, und zwar in Verzeichnisse mit Sprachpräfix. Die Übersetzungen gehören dir: Sie liegen in deinem Repository und deiner Git-Historie und können wie jede andere Datei bearbeitet werden.
Die Screenshots zeigen die Benutzeroberfläche auf Englisch.
Diese Seite richtet sich an alle, die ihre Dokumentation in mehr als einer Sprache verfügbar machen möchten, ohne einen Übersetzungsdienstleister oder ein eigenes Skript auszuführen. Informationen zur Navigation pro Locale und zur Sprachumschaltung findest du unter Mehrsprachige Unterstützung. Diese Konfiguration gilt unabhängig davon, ob die Übersetzungen von Jamdesk, deinen eigenen Übersetzern oder einem anderen Tool erstellt werden.
Voraussetzungen
- Ein verbundenes GitHub-Repository für das Projekt. Übersetzte Seiten werden in dein Repository zurückcommittet. Daher kann ein Projekt, das über die CLI oder ein Tarball bereitgestellt wird, diese Funktion nicht nutzen.
- Schreibzugriff für die Jamdesk GitHub App, damit sie diesen Commit erstellen kann. Wenn der Zugriff fehlt, weist das Fenster Translations darauf hin und enthält einen Link, über den ein GitHub-Administrator den Zugriff gewähren kann. Dieser Schritt ist nur einmal pro GitHub-Konto erforderlich.
Automatische Übersetzung ist in jedem Plan enthalten, auch in Testzeiträumen. Es gibt keine Kosten pro Wort und keine Credits zu kaufen.
Aktivieren
Öffne dein Projekt im Jamdesk Dashboard, öffne Settings und scrolle zu Translations.
Aktiviere Translate my documentation und wähle die gewünschten Sprachen aus. Jede Sprache wird mit ihrem Eigennamen und daneben mit dem englischen Namen aufgeführt.
Die Übersetzung läuft, nachdem ein Build abgeschlossen ist. Beim ersten Durchlauf wird jede Seite übersetzt und die übersetzten Dateien werden in dein Repository committet. Dort kannst du sie wie jeden anderen Commit überprüfen.
Einschränkungen
Es gelten zwei Einschränkungen, jeweils pro Projekt:
| Limit | Wert |
|---|---|
| Sprachen pro Projekt | Bis zu 5 |
| Pro Monat übersetzte Seiten | 10.000 |
Da nach dem ersten Durchlauf nur geänderte Seiten erneut übersetzt werden, verwendet eine eingerichtete Website nur einen kleinen Teil des monatlichen Kontingents.
Nur Geändertes
Beim ersten Durchlauf wird alles übersetzt. Danach übersetzt Jamdesk nur die Seiten erneut, deren englische Quelle tatsächlich geändert wurde. Wenn du also einen Tippfehler auf einer Seite korrigierst, kostet das eine Seite und nicht deine gesamte Website.
Übersetzungen, die Jamdesk nicht ändert
Zwei Arten von Übersetzungen gelten als von dir verfasst, und Jamdesk ersetzt keine davon selbstständig:
- Bereits vorhandene Übersetzungen. Wenn dein Repository bereits übersetzte Seiten enthält, sobald du die Funktion aktivierst, übernimmt Jamdesk diese, anstatt sie zu überschreiben. Deine eigene Arbeit oder von einem Dienstleister erstellte Übersetzungen bleiben exakt erhalten.
- Von dir bearbeitete Übersetzungen. Wenn du eine übersetzte Seite manuell änderst, erkennt Jamdesk dies, sodass deine Formulierung bei jedem späteren Durchlauf erhalten bleibt.
Beide Fälle werden auf dieselbe Weise erfasst und führen zu einer dauerhaften Sperre: Diese Seiten werden nie wieder automatisch übersetzt, auch nicht, wenn sich ihre englische Quelle ändert. Wenn sich der englische Inhalt ändert, erscheinen sie im Fenster Translations unter Edited by hand.
Für jede dort aufgeführte Seite gibt es eine Schaltfläche Replace with AI translation. Damit übergibst du die Seite wieder an die KI. Deine Version wird verworfen und die Seite bei deinem nächsten Build erneut übersetzt. Beim Klicken ändert sich also noch nichts. Diese Schaltfläche ist die einzige Möglichkeit, die Sperre aufzuheben.
Deshalb gilt „Nur Geändertes“ nicht für diese Seiten. Eine von Jamdesk übersetzte Seite wird aktualisiert, sobald sich ihre englische Quelle ändert. Eine von dir verfasste oder bearbeitete Seite wartet dagegen darauf, dass du dies anforderst.
Sprache deaktivieren
Wenn du die Auswahl einer Sprache aufhebst, übersetzt Jamdesk nicht mehr in diese Sprache. Es wird nichts gelöscht: Bereits committete Seiten bleiben unverändert in deinem Repository erhalten.