Referenz:BlueSpiceTranslationTransfer: Unterschied zwischen den Versionen

Version vom 23. Juni 2026, 07:09 Uhr

Übersicht
Beschreibung:	Ermöglicht das Übersetzen und Übertragen von Seiten zwischen Wiki-Instanzen
Status:	stable	Lizenz:	GPL-3.0-only
Entwickler:	HalloWelt	Distribution:	BlueSpice
Kategorie:	Administration	Edition:	BlueSpice farm 5.0+
Benutzer-Hilfeseite ansehen

Funktion

BlueSpiceTranslationTransfer (BSTT) ermöglicht es Nutzern eines Wikis, ihre übersetzten Artikel an ein anderes Wiki zu senden.

DeepL API-Schlüssel erforderlich Diese Funktion benötigt einen gültigen DeepL API-Schlüssel. Dieser wird nicht von BlueSpice bereitgestellt.

Voraussetzungen

Quellwiki: Die Wikiseiten werden aus diesem Wiki übersetzt. Nur ein Quellwiki ist möglich.
Zielwiki: Die übersetzte Wikiseite wird im Zielwiki erstellt. Mehrere Zielwikis sind möglich (standardmäßig in einer Wikifarm).
DeepL API-Schlüssel (dieser wird in der Konfigurationsverwaltung des Quellwikis angegeben)
Die Erweiterungen BlueSpiceTranslationTransfer, ContentTransfer und MergeArticles (optional) sind in allen Wikis (Quell- und Zielwikis) am Übersetzungsworkflow beteiligt.
Bot-Benutzer im Zielwiki zum Erstellen der Seiten (erstellt über Spezial:BotPasswords) (in BlueSpice farm bereits vorkonfiguriert)
Internetverbindung für das Quellwiki
Verbindung zwischen den Wikis (in BlueSpice farm bereits vorkonfiguriert)
Gemeinsam genutzte Tabelle bs_translationtransfer_translations (kann in der Stammdatei LocalSettings.php oder in einer der settings.d-Dateien angegeben werden, z. B. settings.d/050-BlueSpiceTranslationTransfer

Technische Information[Bearbeiten | Quelltext bearbeiten]

Voraussetzungen[Bearbeiten | Quelltext bearbeiten]

MediaWiki: 1.43.0

BlueSpiceFoundation: 5.0.0
BlueSpiceVisualEditorConnector: *
ContentTransfer: *
MergeArticles: *
OOJSPlus: 3.0.0
VisualEditor: *

Integriert in[Bearbeiten | Quelltext bearbeiten]

BlueSpiceDiscovery

BlueSpiceTranslationTransfer

VisualEditor

Spezialseiten[Bearbeiten | Quelltext bearbeiten]

TranslationDictionary
TranslationGlossary
TranslationOverview

Konfiguration[Bearbeiten | Quelltext bearbeiten]

Name	Wert
DeeplTranslateConversionConfig	array ( 'translatePageTitle' => false, 'addDisplayTitleToContent' => true, 'translateNamespaces' => true, 'namespaceMap' => array ( ), 'translateMagicWords' => true, )
TranslateTransferFilesToDraft	true
TranslateTransferLeadingLanguage	false
TranslateTransferNamespaces	array ( )
TranslateTransferTargetNamespaceMapping	array ( )
TranslateTransferTargets	array ( )

API Modules[Bearbeiten | Quelltext bearbeiten]

bs-translation-transfer-convert
bs-translation-transfer-foreign-page-tasks
bs-translation-transfer-tasks

Hooks[Bearbeiten | Quelltext bearbeiten]

Composer-Anforderungen

all-packages	mwstake/mediawiki-component-commonuserinterface mwstake/mediawiki-component-deepl-translator mwstake/mediawiki-component-commonwebapis

Zertifikate[Bearbeiten | Quelltext bearbeiten]

Wenn selbstsignierte Zertifikate verwendet werden (und keine ausgehenden Verbindungen erlaubt sind), muss

$GLOBALS['wgWikiFarmConfig_internalServer'] = 'http://wiki-web:9090';

in data/bluespice/pre-init-settings.php konfiguriert werden.

Zusätzliche Konfigurationsmöglichkeiten[Bearbeiten | Quelltext bearbeiten]


Name	Wert
bsgTranslateTransferUsePipeline	Wenn diese Option aktiviert ist, wird die neue, platzhalterbasierte Übersetzungspipeline anstelle der bisherigen Methode `ignore_tags` verwendet. Standardmäßig ist diese Option aktiviert. Die bisherige Pipeline ist veraltet und wird zukünftig entfernt. Setzen Sie die Option auf `false`, um die neue Pipeline vorübergehend zu deaktivieren, falls Probleme auftreten.
bsgTranslateTransferTemplateArgs	Dies ist ein Verzeichnis von Vorlagenargumenten, die übersetzt werden sollen. Die Schlüssel sind die Vorlagennamen, die Werte sind Zuordnungen (Maps) von Argumentnamen zu Übersetzungsmethoden („text“ für eine reguläre DeepL-Übersetzung, „title“ für die Übersetzung von Wiki-Seitentiteln mittels TitleDictionary). Zuvor waren diese Vorlagen und die zu übersetzenden Argumente fest im Code hinterlegt (hardcodiert). Nun erfolgt die Konfiguration über eine Variable.

PDF-Ausschluss - Start

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

PDF-Ausschluss - Ende

@@ Zeile 37: / Zeile 37: @@
 |bsgTranslateTransferUsePipeline
 |
-# When '''true''', use the new placeholder-based translation pipeline instead of the legacy <code>ignore_tags</code> approach. '''By default: true'''. As the legacy pipeline is deprecated and will eventually be removed.
+# Wenn diese Option aktiviert ist, wird die neue, platzhalterbasierte Übersetzungspipeline anstelle der bisherigen Methode <code>ignore_tags</code> verwendet. Standardmäßig ist diese Option aktiviert. Die bisherige Pipeline ist veraltet und wird zukünftig entfernt.
-# Set to '''false''' to temporarily disable the new pipeline if you encounter issues.
+# Setzen Sie die Option auf  <code>false</code>, um die neue Pipeline vorübergehend zu deaktivieren, falls Probleme auftreten.
 |-
 |bsgTranslateTransferTemplateArgs
 |
-# Registry of template arguments that should be translated. Keys are template names, values are maps of argument name to translation method ('text' for regular DeepL translation, 'title' for wiki page title translation via TitleDictionary).
+# Dies ist ein Verzeichnis von Vorlagenargumenten, die übersetzt werden sollen. Die Schlüssel sind die Vorlagennamen, die Werte sind Zuordnungen (Maps) von Argumentnamen zu Übersetzungsmethoden („text“ für eine reguläre DeepL-Übersetzung, „title“ für die Übersetzung von Wiki-Seitentiteln mittels TitleDictionary).
-# Previously these templates and their arguments which should be translated - were hardcoded. Now it is exposed via config variable.
+# Zuvor waren diese Vorlagen und die zu übersetzenden Argumente fest im Code hinterlegt (hardcodiert). Nun erfolgt die Konfiguration über eine Variable.
-# '''For Eventim''' we would need to add that [3] to <code>post-init-settings.php</code> after deployment, to add needed for them templates to the registry.
 |}