Referenz:BlueSpiceTranslationTransfer: Unterschied zwischen den Versionen

Version vom 23. Juni 2026, 07:07 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	When true, use the new placeholder-based translation pipeline instead of the legacy `ignore_tags` approach. By default: true. As the legacy pipeline is deprecated and will eventually be removed. Set to false to temporarily disable the new pipeline if you encounter issues.
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). Previously these templates and their arguments which should be translated - were hardcoded. Now it is exposed via config variable. For Eventim we would need to add that [3] to `post-init-settings.php` after deployment, to add needed for them templates to the registry.

PDF-Ausschluss - Start

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

PDF-Ausschluss - Ende

@@ Zeile 14: / Zeile 14: @@
 * 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 [[Referenz:BueSpiceWikiFarm{|Wikifarm]]).
+* Zielwiki: Die übersetzte Wikiseite wird im Zielwiki erstellt. Mehrere Zielwikis sind möglich (standardmäßig in einer [[Referenz:BueSpiceWikiFarm|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.
@@ Zeile 29: / Zeile 29: @@
 </syntaxhighlight>
 in <code>data/bluespice/pre-init-settings.php</code> konfiguriert werden.
+==Zusätzliche Konfigurationsmöglichkeiten==
+{| class="wikitable"
+|+
+!Name
+!Wert
+|-
+|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.
+# Set to '''false''' to temporarily disable the new pipeline if you encounter issues.
+|-
+|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).
+# Previously these templates and their arguments which should be translated - were hardcoded. Now it is exposed via config 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.
+|}