Handbuch:Erweiterung/BlueSpiceTranslationTransfer

DeepL API-Schlüssel erforderlich

Diese Funktion benötigt einen gültigen DeepL API-Schlüssel. Dieser wird nicht von BlueSpice bereitgestellt. Der Schlüssel wird in der Konfigurationsverwaltung des Quellwikis angegeben.

Quell- und Zielwikis bestimmen

Der Übersetzungsmechanismus erfordert ein Quellwiki und ein oder mehrere Zielwikis.

Die Inhaltssprache des Stammwikis bestimmt, welche Wiki-Instanz in der Farm als Quellwiki für Übersetzungen dient. Das Stammwiki ist das Wiki, über welches über die Seite Spezial:FarmManager die anderen Instanzen generiert werden.

Wenn beispielsweise das Stammwiki als deutsches Wiki (mit der Inhaltssprache DE) installiert ist, muss im Wiki zusätzlich eine Instanz mit dem Namen DE vorhanden sein. Diese DE-Instanz funktioniert nun als Quellwiki für Übersetzungen. Von dort aus können Übersetzungen von Wikiseiten in andere Sprachwikis generiert werden.

Die Werkzeugleiste der Wikiseiten zeigt somit automatisch einen Übersetzungslink, auch wenn kein DeepL API-Schlüssel eingetragen wurde. Es muss entweder der Schlüssel angegeben werden oder die Erweiterung BlueSpiceTranslationTransfer in der Farm deaktiviert werden, falls kein API-Schlüssel existiert.

Anlegen der Zielwikis

Sprachwikis werden immer mit ihrem zweistelligen ISO 639-1 Sprachkürzel angelegt (zum Beispiel EN für die englischsprachige Instanz, FR für die französische). Bei der Übersetzung können alle Wikis angelegt werden, die vom DeepL Übersetzungsdienst unterstützt werden.

Dies bedeutet auch, dass eine Wiki-Instanz mit dem Namen IT automatisch als Sprachwiki erkannt wird. Für die IT-Abteilung muss dann entsprechend eine Instanz erstellt werden, die nicht dem Sprachkürzel für Italienisch entspricht (z.B. IT-Wiki).

Benötigt eine Wiki-Farm ein anderes Setup, muss die Serverkonfiguration entsprechend von einem Server-Administrator angepasst werden (nur bei On-Premise-Installationen möglich).

Übersetzung einer Seite

Nach der Erstellung der benötigten Wiki-Instanzen können Seiten aus dem Quellwiki übersetzt und in einer anderen Sprach-Wiki-Instanz angelegt werden.

Um eine Seite zu übersetzen:

1. Klicken Sie auf der Quellseite auf den Übersetzen-Link in der Werkzeugleiste. Es öffnet sich ein Dialog.
2. Wählen Sie die gewünschte Zielsprache aus.
3. Klicken Sie Übersetzen, um die Übersetzung zu starten.
4. Überprüfen Sie den vorgeschlagenen Seitennamen im Zielwiki und ändern Sie ihn, falls nötig. Dieses Dialogfeld erscheint nur bei der Erstübersetzung der Seite.
5. Klicken Sie erneut Übersetzen, um den Seitennamen zu speichern. Die Übersetzung wird angezeigt.
6. Klicken Sie Speichern, um die übersetzte Seite im Zielwiki zu speichern. Sie können nun direkt zur Seite im Zielwiki wechseln, eine Übersetzung in eine weitere Sprache (falls konfiguriert) vornehmen oder das Dialogfenster ohne weitere Handlung schließen.

• 
  Übersetzung Schaltfläche
• 
  Sprachauswahl Dialog
• 
  Seitentitel anpassen
• 
  Seitenübersetzung Anzeige und Bestätigung
• 
  Verknüpfung zwischen den Sprachversionen

Seiteninhalt zusammenführen

Wenn eine Seite bereits übersetzt wurde, überschreiben nachfolgende Übersetzungen die vorherige Seite.

Es ist jedoch in der Serverkonfiguration einstellbar, ob bereits übersetzte Seiten zunächst in einem Entwurf-Namensraum landen und manuell geprüft und freigegeben werden müssen.

Sofern dies konfiguriert ist, ist die entsprechende Dokumentation auf der Handbuch-Seite der Erweiterung MergeArticles verfügbar.

Übersetzte Elemente

Folgende Elemente werden für die Übersetzung berücksichtigt:

• Seiteninhalt
• Seitentitel (Anpassung des Titels ist bei der Erstübersetzung möglich)
• Kategorien
  • Die auf einer Seiten angegeben Kategorien werden bei der Erstübersetzung der Seite übersetzt, sofern die Kategorien nicht bereits über eine andere Wiki-Seite übersetzt wurden.
  • Existiert eine Kategorie aus dem Quellwiki durch eine frühere Übersetzung der Seite oder durch eine Übersetzung über eine andere Seite bereits im Zielwiki, wird sie von einer erneuten Übersetzung ausgeschlossen. Dies verhindert, dass die Kategorie vom Übersetzungs-Service mit einer neuen abweichenden Übersetzung ersetzt kann.
• Interne Links
  • Ein Link zu einer Wiki-Seite verlinkt auf die Ursprungsseite im Quellwiki, falls sie nicht ins im Zielwiki existiert.
  • Beispiel: Wenn die deutsche Seite A auf die deutsche Seite B verlinkt, wird die englische Übersetzungsseite A auf die englische Übersetzungsseite B verlinkt.
• Eingebundene Dateien werden ins Zielwiki übertragen:
  • Der Dateiname wird beibehalten
  • Die Beschreibung und der Alternativtext von eingebetteten Dateien werden übersetzt
• Magische Wörter werden in ihre kanonische Bezeichnung (EN) übersetzt
• Transkludierte Seiten werden auch ohne Übersetzung übertragen
• Codeblöcke selbst werden nicht übersetzt; Kommentare in Code-Blöcken werden übersetzt.
• Einschränkung: Wenn eine Seite zu groß ist, kann die DeepL API sie nicht übersetzen. Die beste Möglichkeit ist, die Seite in kleinere Unterseiten aufzuteilen.

Nicht-übersetzte oder übertragene Elemente

Folgende Elemente werden für die Übersetzung nichtg berücksichtigt:

• Vorlageninhalte: Vorlagen werden bei der Übersetzung in das Zielwiki übertragen, eine Übersetzung der Parameterwerte findet jedoch nicht statt.
• Formulare für Vorlagen (Page Forms): Formulare müssen manuell in die Zielwikis übertragen werden und dort der jeweiligen Sprache angepasst werden.
• Dateianhänge: Dateien werden nicht ins Zielwiki übertragen, wenn sie nur als Anhänge über das <attachments>-Tag auf einer Seite angezeigt werden.

Dateien von der Übersetzung ausschließen

Auf der Quellseite kann ein Tag eingefügt werden, um alle eingebunden Dateien für eine bestimmte Seite vom Übersetzungsprozess auszuschließen.

Auf diese Weise werden die im Zielsystem vorgenommenen Änderungen an Dateien bei der nächsten Übersetzung nicht überschrieben.

Schritte, um Dateien von der Übersetzung ausschließen:

1. Fügen Sie das Tag __BS_NO_AUTOMATIC_DOCUMENT_TRANSLATION__ im Quelltext der zu übersetzenden Seite ein.
2. Übersetzen Sie die Seite in die Zielsprache. In der Vorschau werden die Dateien des Quellwikis noch angezeigt. Sie werden allerdings nicht mit übertragen.
3. Überprüfen Sie die Zielseite. Der Dateilink wurde mit dem Originalnamen im Quelltext beibehalten. Die Datei selbst wurde nicht übertragen . Die Datei auf der Seite als “gewünschte Datei” (Redlink) angezeigt. So ist ersichtlich, dass Dateien fehlen und gegebenenfalls ersetzt werden müssen.

Nicht-übertragene Datei

​Hinweis: Falls die Datei schon auf EN Wiki existiert, wird die Datei weitehin als richtig angezeigt.

Übersetzungsübersicht

Eine Übersicht über alle Übersetzungen ist unter Spezial:TranslationsOverview im Quellwiki verfügbar.

Übersetzungsübersicht

Titelverzeichnis

Der Wörterbuch mit allen Seitentiteln und Verknüpfungen kann unter Spezial:TranslationDictionary im Quellwiki verwaltet werden.

Wenn der Titel einer Zielseite nach der ersten Übersetzung angepasst oder gelöscht werden soll, kann das auf dieser Spezialseite erfolgen.

Übersetzungs-Wörterbuch

Wenn eine Quellseite umbenannt wird, werden die Titel automatisch neu übersetzt und die Titelübersetzungen werden in der Datenbank und im Wiki aktualisiert.

Die verschiedenen Übersetzungsversionen werden weiterhin korrekt verlinkt. Die auf der Quellseite gewählte Weiterleitung wird auch auf den entsprechenden Zielseiten eingerichtet.

Übersetzungsglossar

Auf der Seite Spezial:Übersetzungsglossar können Glossareinträge für die Übersetzung gepflegt werden. Dies stellt sicher, dass bestimmte Begriffe aus der Quellsprache immer mit einem bestimmtem Begriff aus der Zielsprache übersetzt werden. Dies gilt sowohl für den Seitentitel als auch für den Seiteninhalt.

Das Wiki-Glossar wird bei der Übersetzung in das DeepL-Glossar übertragen und verwendet.

Übersetzungs-Glossar

Nicht alle Übersetzungssprachen unterstützen die Glossarfunktion (siehe DeepL Dokumentation).

Ad-hoc Übersetzung

In einer Wiki-Instanz mit konfiguriertem DeepL API-Schlüssel wird Benutzern, deren Sprache in der Benutzereinstellung eine andere ist als die Inhaltssprache des Wikis, ein Link zur sogenannten Ad-hoc Übersetzung angezeigt. Diese Übersetzung ist nur solange gültig, bis die Seite neu geladen wird.

Weiterführende Links

• Handbuch:Erweiterung/ContentTransfer
• Handbuch:Erweiterung/MergeArticles
• Handbuch:Erweiterung/AdhocTranslation

Technische Referenz: BlueSpiceTranslationTransfer

PDF-Ausschluss - Start

---

Feedback zur Dokumentation ist im Community-Forum möglich.

PDF-Ausschluss - Ende

Im Wiki abgetrennter Bereich, dessen Inhalte über spezielle Berechtigungen gelesen und bearbeitet werden können. Einen Namensraum erkennt man an einem Präfix vor dem Artikeltitel.

Kategorien helfen, Seiten im Wiki zur organisieren. Jede Kategorie ist im gesamten Wiki verfügbar.

Ein "Magisches Word" ist eine Art Zeichenkette. Das Wiki verbindet diese mit einem Ausgabewert oder einer Funktion, etwa Zeitangaben, Webseiten-Informationen oder Seitennamen.

Tag: XML-Tags, welche beliebig parametrisiert werden können und eine vom Programmierer gewünschte Ausgabe produzieren. Fügt man beispielsweise das <bs:bookshelf>-Tag ein, dann erhält der Artikel die Kapitelnavigation des PDF-Buches, in dem der Artikel verlinkt ist.

Ein Link zu einer Wikiseite, die nicht existiert. Durch Anklicken des Links kann die Seite erstellt werden.

Eine Weiterleitung hilft, Duplikate und inhaltlichen Wildwuchs zu vermeiden. Weiterleitungen werden z.B. für Seiten eingerichtet, deren Inhalte veraltet sind, die nicht mehr gebraucht werden oder mit den Inhalten anderer Seiten übereinstimmen. Sie verweisen in der Regel auf die aktuellste Beschreibung eines Themas und vermeiden unnötige Arbeit im Fall von Ab-kürzungen, Synonymen, Plural/Singular-Duplikaten, Umbenennungen oder Verschiebungen.