BlueSpice Helpdesk - Benutzerbeiträge [de]

Handbuch:Erweiterung/Forms

2026-07-03T09:36:55Z

Margit.link-rodrigue:

{{Textbox|boxtype=note|header=Kompatibilität:|text=Die Anweisungen auf dieser Seite gelten für '''BlueSpice 5.1.8+'''. In den Versionen 5.1.x bis 5.1.7 war es nicht möglich, den Seitennamen dynamisch aus Variablen von Formularfeldern zu generieren. Befolgen Sie für diese Versionen die [[/5.1.1|Anweisungen für 5.1.1]].|icon=yes}}

Die '''Forms'''-Erweiterung ermöglicht es, eine Wikiseite oder einen Benutzerdialog als Formular zu gestalten. Sie wird außerdem in Verbindung mit der Erweiterung [[Handbuch:Erweiterung/Workflows|Workflows]] verwendet, um Eingabeformulare für Workflow-Daten bereitzustellen.

==Einführung==
Um beispielsweise eine Checkliste als Formular zu erstellen, sind folgende Schritte erforderlich:
#'''Erstellen der Checklisten-Formulardefinition'''
#'''Erstellen von Checklisteninstanzen direkt über die Formulardefinitionsseite'''

[[Datei:checklist-event-screenshot.png|alt=Beispiel einer Veranstaltungs-Checkliste|center|thumb|550x550px|Beispiel einer Veranstaltungs-Checkliste]]

==Ein Checklistenformular erstellen==
Im folgenden Beispiel werden die ersten Felder für eine Veranstaltung erstellt, bei der hygienerelevante Informationen im Zusammenhang mit Lebensmitteln dokumentiert werden müssen.
#'''Erstellen''' Sie die Seite ''EventChecklisteHygiene.form''.
[[Datei:Extension Forms create form.png|center|thumb|400x400px|alt=Dialog zum Erstellen einer Seite|Neue Formularseite erstellen]]
Dadurch wird der Formulareditor geöffnet.
[[Datei:Extension Forms form editor.png|alt=Elemente des Formulareditors|center|thumb|700x700px|Formulareditor]]
#'''Fügen''' Sie einen Formularabschnitt '''hinzu''':
##'''Wählen''' Sie das Element ''Abschnittsüberschrift'' unter ''Formularelement> Anderes'' '''aus''' (siehe Markierung 1 und 2 im Screenshot) und ziehen Sie es bei gedrückter linker Maustaste in den interaktiven Formulareditor.
##'''Klicken''' Sie irgendwo in die Zeile ''Abschnittsüberschrift''. Der Feldinspektor wird geöffnet.
##'''Geben''' Sie den Namen '''ein'''''.'' Dieser wird als Feld-ID in der Datenbank gespeichert und sollte daher keine Sonderzeichen enthalten.
##Geben Sie en ''Titel'' für die Abschnittsüberschrift '''ein'''. Dieser wird als sichtbare Beschriftung angezeigt.
[[Datei:Extension Forms add section header.png|alt=Inspektor für das Element Section label|center|thumb|700x700px|Erste Abschnittsüberschrift hinzufügen]]
#'''Erstellen''' Sie die Formularfelder für den Abschnitt ''Event''. Im folgenden Beispiel wird ein Textfeld hinzugefügt.
##'''Ziehen''' Sie das Element ''Text'' aus ''Form Elements > Inputs'' unter die Abschnittsüberschrift.
##'''Klicken''' Sie irgendwo '''in''' die Zeile des Textfelds. Der Feldinspektor wird geöffnet.
##'''Geben''' Sie den ''Namen'' '''ein'''. Dieser dient als Datenbank-ID für das Feld und sollte daher keine Sonderzeichen enthalten.
##'''Geben''' Sie das ''Label'' '''ein'''. Dieses wird als sichtbare Feldbeschriftung angezeigt.
##'''Fügen''' Sie weitere Formularelemente '''hinzu'''.
#'''Klicken''' Sie '''auf''' ''Speichern''. Das Formular steht nun als ''EventChecklisteHygiene.form'' zur Verfügung.
[[Datei:Checklist-view.png|alt=Gespeichertes Formular|center|thumb|650x650px|Gespeichertes Formular]]
==Weitere Formularelemente hinzufügen==
Nun können weitere Felder hinzugefügt werden:
[[Handbuch:Erweiterung/Forms/Formularelemente|Übersicht aller Formularelemente, die Formularen hinzugefügt werden können.]]

== Definieren des Zielseitennamens ==
Wenn der Name der Forminstanz nicht über das offene Eingabefeld erfolgen soll, so kann die Namenslogik auch über einen Einbezug von Formularfeldern erfolgen.

'''Um einen Zielseitennamen zu definieren:'''

# '''Klicken''' Sie '''auf''' das Zahnrad neben der Speichern-Schaltfläche. Das öffnet die Formulareigenschaften.
# '''Klicken''' Sie '''auf''' Ziel.
# '''Wählen''' Sie als Zieltyp ''JSON in einer Wikiseite.''
# '''Geben''' Sie den gewünschten Seitennamen '''ein'''. Folgende Syntax erstellt die Formularinstanzen im Namensraum <code>Event</code> mit dem Startdatum (Feld <code>start-date</code> muss existieren) als Wurzelseite und mit dem Eventnamen (Feld <code>event-name</code> muss existieren): <code>Event/<nowiki>{{start-date}}</nowiki>-<nowiki>{{event-name}}</nowiki></code>
# '''Klicken''' Sie ''Fertig''.

In diesem Fall wird auf der Formulardefinitionsseite kein Eingabefeld angezeigt, sondern das Formular direkt geladen.

==Eine Checklisteninstanz erstellen==
Um eine Checkliste aus dem Formular zu erstellen:
# Einen Veranstaltungsnamen '''eingeben'''
# Die Formularfelder '''ausfüllen'''
# Auf ''Abschicken'' '''klicken'''
Die Checkliste wird nun im Wiki gespeichert und kann anschließend weiter bearbeitet werden.
==Alternatives Ziel: E-Mail==
Anstatt beim Speichern des Formulars eine Wikiseite zu erstellen, können die Formulardaten an ein E-Mail-Konto gesendet werden.
('''Hinweis:''' Der E-Mail-Empfänger muss durch einen Serveradministrator auf dem Server konfiguriert werden, damit er in Formularen verfügbar ist.)
[[Datei:E-mail image.png|alt=E-Mail-Ziel|center|thumb|650x650px|E-Mail-Ziel]]
*'''Zieltyp:''' Email
*'''Empfänger:''' Mögliche Empfänger müssen aus Sicherheitsgründen auf dem Server konfiguriert worden sein. Beispiel:<syntaxhighlight lang="php">
$wgFormsTargetEMailRecipients = [
'Marketing' => "marketing@example.com",
'Administration' => 'WikiSysop'
];
</syntaxhighlight>
*'''Betreff:''' Vorhandene Formularfelder können hier als Variablen verwendet werden. Der jeweilige Wert wird aus dem Formular übernommen.
*'''Inhalt:''' Wie beim Betreff können auch hier vorhandene Formularfelder als Variablen verwendet werden. Der jeweilige Wert wird aus dem Formular übernommen.
[[mediawikiwiki:Help:Magic_words#Localisation|Lokalisierungsnachrichten]] können in Kombination mit Formularfeldern ebenfalls als Betreff oder E-Mail-Inhalt verwendet werden:
<syntaxhighlight lang="wikitext" line="1">
{{int:Mailsubject| {{{name}}}|{{{surname}}} }}
</syntaxhighlight>
==Alternatives Ziel: Vorlage==
Anstatt eine Standard-Wikiseite zu erstellen oder die Formulardaten per E-Mail zu versenden, kann eine [[Handbuch:Vorlagen|Vorlage]] als Ziel für ein Formular verwendet werden. <br>
In diesem Fall werden die übermittelten Formulardaten genutzt, um auf Basis einer vorhandenen Vorlagen-Struktur eine neue Wikiseite zu erstellen. Die Formularwerte werden dabei in die Platzhalter der Vorlage eingefügt.
*'''Voraussetzungen:''' Bevor ein Vorlagen-Ziel verwendet werden kann, muss bereits eine entsprechende Vorlagen-Seite im Wiki vorhanden sein. Die Vorlage dient als strukturelle Grundlage für die generierte Seite. Formularfelder werden den in der Vorlage definierten Platzhaltern zugeordnet.
[[Datei:Template Target.png|alt=Auswahl von Vorlage als Formularziel|center|thumb|550x550px|Template-Ziel]]
*'''Zieltyp:''' Vorlage
*'''Predefined title:''' Optionaler Standardtitel für die neu erstellte Seite oder zur Vorgabe eines Seitenpfads (z. B. um alle generierten Seiten als Unterseiten einer bestimmten Seite zu erstellen)
*'''Zu verwendende Vorlage:''' Name des vorhandenen Templates, das für die Seitenerstellung verwendet wird
Es wird empfohlen, für Formular und Template identische oder eindeutig zusammengehörige Bezeichnungen zu verwenden. Dies erleichtert die Wartung und macht Konfigurationsabhängigkeiten leichter nachvollziehbar.
Diese Zielart wird typischerweise verwendet, um standardisierte und lesbare Wikiseiten zu erzeugen. JSON-basierte Ziele werden dagegen häufiger für die strukturierte Weiterverarbeitung von Daten eingesetzt.
==Styling anpassen==
===Common.css===
Um einzelne Elemente im Formular zu gestalten, kann im Optionsdialog der Reiter ''Styling'' verwendet werden. Dort lässt sich ein CSS-Klassenname eintragen. Das eigentliche Styling wird anschließend auf der Seite ''MediaWiki:Common.css'' definiert (Administratorrechte erforderlich).
So wird die Abschnittsüberschrift gestaltet:
#Den Reiter ''Styling'' im Optionsmenü des Feldes ''Event heading'' '''öffnen'''
#Eine neue CSS-Klasse '''hinzufügen''' und einen Selektornamen im Feld ''CSS Classes'' eintragen, z. B. ''frm-sectionhd'' [[Datei:forms-css-class-de.png|alt=CSS-Klasse hinzufügen|center|thumb|650x650px|CSS-Klasse hinzufügen]]
#Die folgenden Stildefinitionen auf der Seite ''MediaWiki:Common.css'' '''einfügen''':<syntaxhighlight lang="css">
.frm-sectionhd {
border-bottom: 1px solid #a6a6a7;
background:#f1f3f9;
padding:6px;
margin:30px 0;
}
</syntaxhighlight>[[Datei:forms-css-class-view-de.png|alt=Abschnittsüberschrift mit individuellem Styling|center|thumb|650x650px|Abschnittsüberschrift mit individuellem Styling]] <br>
Falls keine Berechtigung zum Anzeigen oder Bearbeiten dieser Seite besteht, können Stilinformationen auch direkt über Inline-Styling für einzelne Formularelemente hinterlegt werden.
===Inline-Styling===
Ohne Zugriff auf ''MediaWiki:Common.css'' können Stilinformationen direkt im Formular eingetragen werden. Bei häufig wiederkehrenden Stildefinitionen ist dies jedoch weniger effizient als die Verwendung von CSS-Klassen in ''MediaWiki:Common.css''. <br>Im folgenden Beispiel wird das zuvor verwendete Styling der Abschnittsüberschrift direkt als Inline-Styling angewendet. Dazu erneut das Optionsmenü des Formularelements ''ech-event'' öffnen. Anschließend den folgenden Eintrag im Feld ''Styling'' hinterlegen und die Änderung speichern:
<syntaxhighlight lang="css">
border-bottom: 1px solid #a6a6a7; background:#f1f3f9; padding:6px;margin:30px 0;
</syntaxhighlight>
[[Datei:forms-css-inlinestyling-en.png|alt=Inline-Styling eines Formularelements|center|thumb|650x650px|Inline-Styling eines Formularelements]]

{{translation}}

Handbuch:Erweiterung/Forms

2026-07-01T10:02:11Z

Margit.link-rodrigue:

{{Textbox|boxtype=note|header=Kompatibilität:|text=Die Anweisungen auf dieser Seite gelten für '''BlueSpice 5.1.8+'''. In den Versionen 5.1.x bis 5.1.7 war es nicht möglich, den Seitennamen dynamisch aus Variablen von Formularfeldern zu generieren. Befolgen Sie für diese Versionen die [[/5.1.1|Anweisungen für 5.1.1]].|icon=yes}}

Die '''Forms'''-Erweiterung ermöglicht es, eine Wikiseite oder einen Benutzerdialog als Formular zu gestalten. Sie wird außerdem in Verbindung mit der Erweiterung [[Handbuch:Erweiterung/Workflows|Workflows]] verwendet, um Eingabeformulare für Workflow-Daten bereitzustellen.

==Einführung==
Um beispielsweise eine Checkliste als Formular zu erstellen, sind folgende Schritte erforderlich:
#'''Erstellen der Checklisten-Formulardefinition'''
#'''Erstellen von Checklisteninstanzen direkt über die Formulardefinitionsseite'''

[[Datei:checklist-event-screenshot.png|alt=Beispiel einer Veranstaltungs-Checkliste|center|thumb|550x550px|Beispiel einer Veranstaltungs-Checkliste]]

==Ein Checklistenformular erstellen==
Im folgenden Beispiel werden die ersten Felder für eine Veranstaltung erstellt, bei der hygienerelevante Informationen im Zusammenhang mit Lebensmitteln dokumentiert werden müssen.
#'''Erstellen''' Sie die Seite ''EventChecklisteHygiene.form''.
[[Datei:Extension Forms create form.png|center|thumb|400x400px|alt=Dialog zum Erstellen einer Seite|Neue Formularseite erstellen]]
Dadurch wird der Formulareditor geöffnet.
[[Datei:Extension Forms form editor.png|alt=Elemente des Formulareditors|center|thumb|700x700px|Formulareditor]]
#'''Fügen''' Sie einen Formularabschnitt '''hinzu''':
##'''Wählen''' Sie das Element ''Abschnittsüberschrift'' unter ''Formularelement> Anderes'' '''aus''' (siehe Markierung 1 und 2 im Screenshot) und ziehen Sie es bei gedrückter linker Maustaste in den interaktiven Formulareditor.
##'''Klicken''' Sie irgendwo in die Zeile ''Abschnittsüberschrift''. Der Feldinspektor wird geöffnet.
##'''Geben''' Sie den Namen '''ein'''''.'' Dieser wird als Feld-ID in der Datenbank gespeichert und sollte daher keine Sonderzeichen enthalten.
##Geben Sie en ''Titel'' für die Abschnittsüberschrift '''ein'''. Dieser wird als sichtbare Beschriftung angezeigt.
[[Datei:Extension Forms add section header.png|alt=Inspektor für das Element Section label|center|thumb|700x700px|Erste Abschnittsüberschrift hinzufügen]]
#'''Erstellen''' Sie die Formularfelder für den Abschnitt ''Event''. Im folgenden Beispiel wird ein Textfeld hinzugefügt.
##'''Ziehen''' Sie das Element ''Text'' aus ''Form Elements > Inputs'' unter die Abschnittsüberschrift.
##'''Klicken''' Sie irgendwo '''in''' die Zeile des Textfelds. Der Feldinspektor wird geöffnet.
##'''Geben''' Sie den ''Namen'' '''ein'''. Dieser dient als Datenbank-ID für das Feld und sollte daher keine Sonderzeichen enthalten.
##'''Geben''' Sie das ''Label'' '''ein'''. Dieses wird als sichtbare Feldbeschriftung angezeigt.
##'''Fügen''' Sie weitere Formularelemente '''hinzu'''.
#'''Klicken''' Sie '''auf''' ''Speichern''. Das Formular steht nun als ''EventChecklisteHygiene.form'' zur Verfügung.
[[Datei:Checklist-view.png|alt=Gespeichertes Formular|center|thumb|650x650px|Gespeichertes Formular]]
==Weitere Formularelemente hinzufügen==
Nun können weitere Felder hinzugefügt werden:
[[Handbuch:Erweiterung/Forms/Formularelemente|Übersicht aller Formularelemente, die Formularen hinzugefügt werden können.]]

== Definieren des Zielseitennamens ==
Wenn der Name der Forminstanz nicht über das offene Eingabefeld erfolgen soll, so kann die Namenslogik auch über einen Einbezug von Formularfeldern erfolgen.

'''Um einen Zielseitennamen zu definieren:'''

# '''Klicken''' Sie '''auf''' das Zahnrad neben der Speichern-Schaltfläche. Das öffnet die Formulareigenschaften.
# '''Klicken''' Sie '''auf''' Ziel.
# '''Wählen''' Sie als Zieltyp ''JSON in einer Wikiseite.''
# '''Geben''' Sie den gewünschten Seitennamen '''ein'''. Folgende Syntax erstellt die Formularinstanzen im Namensraum <code>Event</code> mit dem Startdatum (Feld <code>start-date</code> muss existieren) als Wurzelseite und mit dem Eventnamen (Feld <code>event-name</code> muss existieren).
# '''Klicken''' Sie ''Fertig''.

In diesem Fall wird auf der Formulardefinitionsseite kein Eingabefeld angezeigt, sondern das Formular direkt geladen.

==Eine Checklisteninstanz erstellen==
Um eine Checkliste aus dem Formular zu erstellen:
# Einen Veranstaltungsnamen '''eingeben'''
# Die Formularfelder '''ausfüllen'''
# Auf ''Abschicken'' '''klicken'''
Die Checkliste wird nun im Wiki gespeichert und kann anschließend weiter bearbeitet werden.
==Alternatives Ziel: E-Mail==
Anstatt beim Speichern des Formulars eine Wikiseite zu erstellen, können die Formulardaten an ein E-Mail-Konto gesendet werden.
('''Hinweis:''' Der E-Mail-Empfänger muss durch einen Serveradministrator auf dem Server konfiguriert werden, damit er in Formularen verfügbar ist.)
[[Datei:E-mail image.png|alt=E-Mail-Ziel|center|thumb|650x650px|E-Mail-Ziel]]
*'''Zieltyp:''' Email
*'''Empfänger:''' Mögliche Empfänger müssen aus Sicherheitsgründen auf dem Server konfiguriert worden sein. Beispiel:<syntaxhighlight lang="php">
$wgFormsTargetEMailRecipients = [
'Marketing' => "marketing@example.com",
'Administration' => 'WikiSysop'
];
</syntaxhighlight>
*'''Betreff:''' Vorhandene Formularfelder können hier als Variablen verwendet werden. Der jeweilige Wert wird aus dem Formular übernommen.
*'''Inhalt:''' Wie beim Betreff können auch hier vorhandene Formularfelder als Variablen verwendet werden. Der jeweilige Wert wird aus dem Formular übernommen.
[[mediawikiwiki:Help:Magic_words#Localisation|Lokalisierungsnachrichten]] können in Kombination mit Formularfeldern ebenfalls als Betreff oder E-Mail-Inhalt verwendet werden:
<syntaxhighlight lang="wikitext" line="1">
{{int:Mailsubject| {{{name}}}|{{{surname}}} }}
</syntaxhighlight>
==Alternatives Ziel: Vorlage==
Anstatt eine Standard-Wikiseite zu erstellen oder die Formulardaten per E-Mail zu versenden, kann eine [[Handbuch:Vorlagen|Vorlage]] als Ziel für ein Formular verwendet werden. <br>
In diesem Fall werden die übermittelten Formulardaten genutzt, um auf Basis einer vorhandenen Vorlagen-Struktur eine neue Wikiseite zu erstellen. Die Formularwerte werden dabei in die Platzhalter der Vorlage eingefügt.
*'''Voraussetzungen:''' Bevor ein Vorlagen-Ziel verwendet werden kann, muss bereits eine entsprechende Vorlagen-Seite im Wiki vorhanden sein. Die Vorlage dient als strukturelle Grundlage für die generierte Seite. Formularfelder werden den in der Vorlage definierten Platzhaltern zugeordnet.
[[Datei:Template Target.png|alt=Auswahl von Vorlage als Formularziel|center|thumb|550x550px|Template-Ziel]]
*'''Zieltyp:''' Vorlage
*'''Predefined title:''' Optionaler Standardtitel für die neu erstellte Seite oder zur Vorgabe eines Seitenpfads (z. B. um alle generierten Seiten als Unterseiten einer bestimmten Seite zu erstellen)
*'''Zu verwendende Vorlage:''' Name des vorhandenen Templates, das für die Seitenerstellung verwendet wird
Es wird empfohlen, für Formular und Template identische oder eindeutig zusammengehörige Bezeichnungen zu verwenden. Dies erleichtert die Wartung und macht Konfigurationsabhängigkeiten leichter nachvollziehbar.
Diese Zielart wird typischerweise verwendet, um standardisierte und lesbare Wikiseiten zu erzeugen. JSON-basierte Ziele werden dagegen häufiger für die strukturierte Weiterverarbeitung von Daten eingesetzt.
==Styling anpassen==
===Common.css===
Um einzelne Elemente im Formular zu gestalten, kann im Optionsdialog der Reiter ''Styling'' verwendet werden. Dort lässt sich ein CSS-Klassenname eintragen. Das eigentliche Styling wird anschließend auf der Seite ''MediaWiki:Common.css'' definiert (Administratorrechte erforderlich).
So wird die Abschnittsüberschrift gestaltet:
#Den Reiter ''Styling'' im Optionsmenü des Feldes ''Event heading'' '''öffnen'''
#Eine neue CSS-Klasse '''hinzufügen''' und einen Selektornamen im Feld ''CSS Classes'' eintragen, z. B. ''frm-sectionhd'' [[Datei:forms-css-class-de.png|alt=CSS-Klasse hinzufügen|center|thumb|650x650px|CSS-Klasse hinzufügen]]
#Die folgenden Stildefinitionen auf der Seite ''MediaWiki:Common.css'' '''einfügen''':<syntaxhighlight lang="css">
.frm-sectionhd {
border-bottom: 1px solid #a6a6a7;
background:#f1f3f9;
padding:6px;
margin:30px 0;
}
</syntaxhighlight>[[Datei:forms-css-class-view-de.png|alt=Abschnittsüberschrift mit individuellem Styling|center|thumb|650x650px|Abschnittsüberschrift mit individuellem Styling]] <br>
Falls keine Berechtigung zum Anzeigen oder Bearbeiten dieser Seite besteht, können Stilinformationen auch direkt über Inline-Styling für einzelne Formularelemente hinterlegt werden.
===Inline-Styling===
Ohne Zugriff auf ''MediaWiki:Common.css'' können Stilinformationen direkt im Formular eingetragen werden. Bei häufig wiederkehrenden Stildefinitionen ist dies jedoch weniger effizient als die Verwendung von CSS-Klassen in ''MediaWiki:Common.css''. <br>Im folgenden Beispiel wird das zuvor verwendete Styling der Abschnittsüberschrift direkt als Inline-Styling angewendet. Dazu erneut das Optionsmenü des Formularelements ''ech-event'' öffnen. Anschließend den folgenden Eintrag im Feld ''Styling'' hinterlegen und die Änderung speichern:
<syntaxhighlight lang="css">
border-bottom: 1px solid #a6a6a7; background:#f1f3f9; padding:6px;margin:30px 0;
</syntaxhighlight>
[[Datei:forms-css-inlinestyling-en.png|alt=Inline-Styling eines Formularelements|center|thumb|650x650px|Inline-Styling eines Formularelements]]

Handbuch:Erweiterung/Forms

2026-07-01T09:39:43Z

Margit.link-rodrigue:

{{Textbox|boxtype=note|header=Kompatibilität:|text=Die Anweisungen auf dieser Seite gelten für '''BlueSpice 5.1.8+'''. In den Versionen 5.1.x bis 5.1.7 war es nicht möglich, den Seitennamen dynamisch aus Variablen von Formularfeldern zu generieren. Befolgen Sie für diese Versionen die [[/5.1.1|Anweisungen für 5.1.1]].|icon=yes}}

Die '''Forms'''-Erweiterung ermöglicht es, eine Wikiseite oder einen Benutzerdialog als Formular zu gestalten. Sie wird außerdem in Verbindung mit der Erweiterung [[Handbuch:Erweiterung/Workflows|Workflows]] verwendet, um Eingabeformulare für Workflow-Daten bereitzustellen.

==Einführung==
Um beispielsweise eine Checkliste als Formular zu erstellen, sind folgende Schritte erforderlich:
#'''Erstellen der Checklisten-Formulardefinition'''
#'''Erstellen von Checklisteninstanzen direkt über die Formulardefinitionsseite'''

[[Datei:checklist-event-screenshot.png|alt=Beispiel einer Veranstaltungs-Checkliste|center|thumb|550x550px|Beispiel einer Veranstaltungs-Checkliste]]

==Ein Checklistenformular erstellen==
Im folgenden Beispiel werden die ersten Felder für eine Veranstaltung erstellt, bei der hygienerelevante Informationen im Zusammenhang mit Lebensmitteln dokumentiert werden müssen.
#'''Erstellen''' Sie die Seite ''EventChecklisteHygiene.form''.
[[Datei:Extension Forms create form.png|center|thumb|400x400px|alt=Dialog zum Erstellen einer Seite|Neue Formularseite erstellen]]
Dadurch wird der Formulareditor geöffnet.
[[Datei:Extension Forms form editor.png|alt=Elemente des Formulareditors|center|thumb|700x700px|Formulareditor]]
#'''Fügen''' Sie einen Formularabschnitt '''hinzu''':
##Das Element ''Abschnittsüberschrift'' unter ''Formularelement> Anderes'' '''auswählen''' (siehe Markierung 1 und 2 im Screenshot) und bei gedrückter linker Maustaste in den interaktiven Formulareditor ziehen.
##Irgendwo in die Zeile ''Abschnittsüberschrfit'' '''klicken'''. Der Feldinspektor wird geöffnet.
##Den ''Name'' '''eingeben'''. Dieser wird als Feld-ID in der Datenbank gespeichert und sollte daher keine Sonderzeichen enthalten.
##Den ''Title'' für die Abschnittsüberschrift '''eingeben'''. Dieser wird als sichtbare Beschriftung angezeigt.
[[Datei:Extension Forms add section header.png|alt=Inspektor für das Element Section label|center|thumb|700x700px|Erste Abschnittsüberschrift hinzufügen]]
#'''Erstellen''' der Formularfelder für den Abschnitt ''Event''. Im folgenden Beispiel wird ein Textfeld hinzugefügt.
##Das Element ''Text'' aus ''Form Elements > Inputs'' unter die Abschnittsüberschrift '''ziehen'''.
##Irgendwo in die Zeile des Textfelds '''klicken'''. Der Feldinspektor wird geöffnet.
##Den ''Name'' '''eingeben'''. Dieser dient als Datenbank-ID für das Feld und sollte daher keine Sonderzeichen enthalten.
##Das ''Label'' '''eingeben''. Dieses wird als sichtbare Feldbeschriftung angezeigt.
##Weitere Formularelemente '''hinzufügen'''.
#Auf ''Speichern'' '''klicken''. Das Formular steht nun als ''EventChecklisteHygiene.form'' zur Verfügung.
[[Datei:Checklist-view.png|alt=Gespeichertes Formular|center|thumb|650x650px|Gespeichertes Formular]]
==Weitere Formularelemente hinzufügen==
Nun können weitere Felder hinzugefügt werden:
[[Handbuch:Erweiterung/Forms/Formularelemente|Übersicht aller Formularelemente, die Formularen hinzugefügt werden können.]]
==Eine Checklisteninstanz erstellen==
Um eine Checkliste aus dem Formular zu erstellen:
# Einen Veranstaltungsnamen '''eingeben'''
# Die Formularfelder '''ausfüllen'''
# Auf ''Abschicken'' '''klicken'''
Die Checkliste wird nun im Wiki gespeichert und kann anschließend weiter bearbeitet werden.
==Alternatives Ziel: E-Mail==
Anstatt beim Speichern des Formulars eine Wikiseite zu erstellen, können die Formulardaten an ein E-Mail-Konto gesendet werden.
('''Hinweis:''' Der E-Mail-Empfänger muss durch einen Serveradministrator auf dem Server konfiguriert werden, damit er in Formularen verfügbar ist.)
[[Datei:E-mail image.png|alt=E-Mail-Ziel|center|thumb|650x650px|E-Mail-Ziel]]
*'''Zieltyp:''' Email
*'''Empfänger:''' Mögliche Empfänger müssen aus Sicherheitsgründen auf dem Server konfiguriert worden sein. Beispiel:<syntaxhighlight lang="php">
$wgFormsTargetEMailRecipients = [
'Marketing' => "marketing@example.com",
'Administration' => 'WikiSysop'
];
</syntaxhighlight>
*'''Betreff:''' Vorhandene Formularfelder können hier als Variablen verwendet werden. Der jeweilige Wert wird aus dem Formular übernommen.
*'''Inhalt:''' Wie beim Betreff können auch hier vorhandene Formularfelder als Variablen verwendet werden. Der jeweilige Wert wird aus dem Formular übernommen.
[[mediawikiwiki:Help:Magic_words#Localisation|Lokalisierungsnachrichten]] können in Kombination mit Formularfeldern ebenfalls als Betreff oder E-Mail-Inhalt verwendet werden:
<syntaxhighlight lang="wikitext" line="1">
{{int:Mailsubject| {{{name}}}|{{{surname}}} }}
</syntaxhighlight>
==Alternatives Ziel: Vorlage==
Anstatt eine Standard-Wikiseite zu erstellen oder die Formulardaten per E-Mail zu versenden, kann eine [[Handbuch:Vorlagen|Vorlage]] als Ziel für ein Formular verwendet werden. <br>
In diesem Fall werden die übermittelten Formulardaten genutzt, um auf Basis einer vorhandenen Vorlagen-Struktur eine neue Wikiseite zu erstellen. Die Formularwerte werden dabei in die Platzhalter der Vorlage eingefügt.
*'''Voraussetzungen:''' Bevor ein Vorlagen-Ziel verwendet werden kann, muss bereits eine entsprechende Vorlagen-Seite im Wiki vorhanden sein. Die Vorlage dient als strukturelle Grundlage für die generierte Seite. Formularfelder werden den in der Vorlage definierten Platzhaltern zugeordnet.
[[Datei:Template Target.png|alt=Auswahl von Vorlage als Formularziel|center|thumb|550x550px|Template-Ziel]]
*'''Zieltyp:''' Vorlage
*'''Predefined title:''' Optionaler Standardtitel für die neu erstellte Seite oder zur Vorgabe eines Seitenpfads (z. B. um alle generierten Seiten als Unterseiten einer bestimmten Seite zu erstellen)
*'''Zu verwendende Vorlage:''' Name des vorhandenen Templates, das für die Seitenerstellung verwendet wird
Es wird empfohlen, für Formular und Template identische oder eindeutig zusammengehörige Bezeichnungen zu verwenden. Dies erleichtert die Wartung und macht Konfigurationsabhängigkeiten leichter nachvollziehbar.
Diese Zielart wird typischerweise verwendet, um standardisierte und lesbare Wikiseiten zu erzeugen. JSON-basierte Ziele werden dagegen häufiger für die strukturierte Weiterverarbeitung von Daten eingesetzt.
==Styling anpassen==
===Common.css===
Um einzelne Elemente im Formular zu gestalten, kann im Optionsdialog der Reiter ''Styling'' verwendet werden. Dort lässt sich ein CSS-Klassenname eintragen. Das eigentliche Styling wird anschließend auf der Seite ''MediaWiki:Common.css'' definiert (Administratorrechte erforderlich).
So wird die Abschnittsüberschrift gestaltet:
#Den Reiter ''Styling'' im Optionsmenü des Feldes ''Event heading'' '''öffnen'''
#Eine neue CSS-Klasse '''hinzufügen''' und einen Selektornamen im Feld ''CSS Classes'' eintragen, z. B. ''frm-sectionhd'' [[Datei:forms-css-class-de.png|alt=CSS-Klasse hinzufügen|center|thumb|650x650px|CSS-Klasse hinzufügen]]
#Die folgenden Stildefinitionen auf der Seite ''MediaWiki:Common.css'' '''einfügen''':<syntaxhighlight lang="css">
.frm-sectionhd {
border-bottom: 1px solid #a6a6a7;
background:#f1f3f9;
padding:6px;
margin:30px 0;
}
</syntaxhighlight>[[Datei:forms-css-class-view-de.png|alt=Abschnittsüberschrift mit individuellem Styling|center|thumb|650x650px|Abschnittsüberschrift mit individuellem Styling]] <br>
Falls keine Berechtigung zum Anzeigen oder Bearbeiten dieser Seite besteht, können Stilinformationen auch direkt über Inline-Styling für einzelne Formularelemente hinterlegt werden.
===Inline-Styling===
Ohne Zugriff auf ''MediaWiki:Common.css'' können Stilinformationen direkt im Formular eingetragen werden. Bei häufig wiederkehrenden Stildefinitionen ist dies jedoch weniger effizient als die Verwendung von CSS-Klassen in ''MediaWiki:Common.css''. <br>Im folgenden Beispiel wird das zuvor verwendete Styling der Abschnittsüberschrift direkt als Inline-Styling angewendet. Dazu erneut das Optionsmenü des Formularelements ''ech-event'' öffnen. Anschließend den folgenden Eintrag im Feld ''Styling'' hinterlegen und die Änderung speichern:
<syntaxhighlight lang="css">
border-bottom: 1px solid #a6a6a7; background:#f1f3f9; padding:6px;margin:30px 0;
</syntaxhighlight>
[[Datei:forms-css-inlinestyling-en.png|alt=Inline-Styling eines Formularelements|center|thumb|650x650px|Inline-Styling eines Formularelements]]

Seitenentwurf:Handbuch:Erweiterung/PDFCreator/Schriftart ändern

2026-07-01T08:58:37Z

Margit.link-rodrigue:

=== Schriftdatei hochladen ===
Wenn Sie eine lizenzierte Schriftart oder eine Open-Source-Schriftart (wie z. B. eine Google Font) für Ihren PDF-Export verwenden möchten, können Sie diese über den Standard-Datei-Upload in das Wiki hochladen und in der Definition Ihrer PDF-Vorlage verwenden. {{Bsvs|bsvFrom=5.3}}

=== URL der Schriftart abrufen ===
Kopieren Sie nach dem Hochladen der Schriftartdatei deren Adresse in die Zwischenablage, indem Sie beispielsweise mit der rechten Maustaste auf den Dateinamen klicken und „Link-Adresse kopieren“ (oder ähnlich) wählen.
[[Datei:Erweiterung PDFCreator Schriftart ändern.png|alternativtext=Offenes Kontextmenü zum Kopieren des Dateilinks|zentriert|mini|300x300px|Schriftart ändern]]

=== PDF-Vorlage aktualisieren ===
Öffnen Sie den Reiter ''Styles'' Ihrer PDF-Vorlage (zum Beispiel auf der Seite ''MediaWiki:PDFCreator/StandardPDF''). Fügen Sie die erforderliche ''@font-face-Regel'' am Anfang des Reiters hinzu. Für die Beispielschriftart ''Neuton-Regular.ttf'' fügen Sie den Pfad wie folgt hinzu: :<syntaxhighlight lang="css">@font-face {
font-family: 'Neuton-Regular';
src: url('https://my.wiki.com/w/nsfr_img_auth.php/w/3/3f/Neuton-Regular.ttf') format('truetype');
font-weight: normal;
font-style: normal;
}

body.mediawiki {
font-family: 'Neuton-Regular', sans-serif;
}</syntaxhighlight>Alternativ kann als URL-Pfad auch die relative URL der Datei im Wiki verwendet werden:<syntaxhighlight lang="css">src: url('/w/nsfr_img_auth.php/w/3/3f/Neuton-Regular.ttf') format('truetype');</syntaxhighlight>Nach dem Speichern der PDF-Vorlage können Sie eine Seite unter Verwendung der angepassten PDF-Vorlage drucken.

Für detailliertere Anpassungen der Schriftart muss die Anwendung über zusätzliche CSS-Regeln (ergänzend zu der für <code>body.mediawiki</code> deklarierten Regel) oder durch das Ersetzen dieser Regel durch spezifischere Regeln erfolgen (CSS-Kenntnisse erforderlich). {{Textbox|boxtype=note|header=Benutzerdefinierte Schriftart für das Wiki selbst:|text=Wenn Sie die benutzerdefinierte Schriftart (oder eine andere) auch im Wiki selbst verwenden möchten, müssen Sie dieselbe @-Regel im Bereich „Free CSS“ des Skin-Editors [[Special:FlexiSkin|Flexiskin]] hinzufügen.|icon=yes}}

Seitenentwurf:Handbuch:Erweiterung/PDFCreator/Schriftart ändern

2026-07-01T08:51:30Z

Margit.link-rodrigue: Die Seite wurde neu angelegt: „=== Schriftdatei hochladen === Wenn Sie eine lizenzierte Schriftart oder eine Open-Source-Schriftart (wie z. B. eine Google Font) für Ihren PDF-Export verwenden möchten, können Sie diese über den Standard-Datei-Upload in das Wiki hochladen und in der Definition Ihrer PDF-Vorlage verwenden. {{Bsvs|bsvFrom=5.3}} === URL der Schriftart abrufen === Kopieren Sie nach dem Hochladen der Schriftartdatei deren Adresse in die Zwischenablage, indem Sie beispiel…“

=== Schriftdatei hochladen ===
Wenn Sie eine lizenzierte Schriftart oder eine Open-Source-Schriftart (wie z. B. eine Google Font) für Ihren PDF-Export verwenden möchten, können Sie diese über den Standard-Datei-Upload in das Wiki hochladen und in der Definition Ihrer PDF-Vorlage verwenden. {{Bsvs|bsvFrom=5.3}}

=== URL der Schriftart abrufen ===
Kopieren Sie nach dem Hochladen der Schriftartdatei deren Adresse in die Zwischenablage, indem Sie beispielsweise mit der rechten Maustaste auf den Dateinamen klicken und „Link-Adresse kopieren“ (oder ähnlich) wählen.
[[Datei:Erweiterung PDFCreator Schriftart ändern.png|alternativtext=Offenes Kontextmenü zum Kopieren des Dateilinks|zentriert|mini|300x300px|Schriftart ändern]]

=== PDF-Vorlage aktualisieren ===
Öffnen Sie den Reiter ''Styles'' Ihrer PDF-Vorlage (zum Beispiel auf der Seite ''MediaWiki:PDFCreator/StandardPDF''). Fügen Sie die erforderliche ''@font-face-Regel'' am Anfang des Reiters hinzu. Für die Beispielschriftart ''Neuton-Regular.ttf'' fügen Sie den Pfad wie folgt hinzu: :<syntaxhighlight lang="css">@font-face {
font-family: 'Neuton-Regular';
src: url('https://my.wiki.com/w/nsfr_img_auth.php/w/3/3f/Neuton-Regular.ttf') format('truetype');
font-weight: normal;
font-style: normal;
}

body.mediawiki {
font-family: 'Neuton-Regular', sans-serif;
}</syntaxhighlight>Alternativ kann als URL-Pfad auch die relative URL der Datei im Wiki verwendet werden:<syntaxhighlight lang="css">src: url('/w/nsfr_img_auth.php/w/3/3f/Neuton-Regular.ttf') format('truetype');</syntaxhighlight>Nach dem Speichern der PDF-Vorlage können Sie eine Seite unter Verwendung der angepassten PDF-Vorlage drucken. {{Textbox|boxtype=note|header=Benutzerdefinierte Schriftart für das Wiki selbst:|text=Wenn Sie die benutzerdefinierte Schriftart (oder eine andere) auch im Wiki selbst verwenden möchten, müssen Sie dieselbe @-Regel im Bereich „Free CSS“ des Skin-Editors [[Special:FlexiSkin|Flexiskin]] hinzufügen.|icon=yes}}

Datei:Erweiterung PDFCreator Schriftart ändern.png

2026-07-01T08:49:47Z

Margit.link-rodrigue: Margit.link-rodrigue lud eine neue Version von Datei:Erweiterung PDFCreator Schriftart ändern.png hoch

Datei:Erweiterung PDFCreator Schriftart ändern.png

2026-07-01T08:48:08Z

Margit.link-rodrigue:

Referenz:BlueSpicePageAssignments

2026-06-29T15:13:06Z

Margit.link-rodrigue:

{{BSExtensionInfo
|status=stable
|developer=HalloWelt
|type=BlueSpice
|edition=BlueSpice free, BlueSpice pro, BlueSpice farm, BlueSpice cloud
|compatible=BlueSpice
|category=Qualitätssicherung
|features=Mit '''PageAssignments''' können Seiten einzelnen Benutzern oder Benutzergruppen zugewiesen werden. Benutzer werden über ihre Zuweisungen oder deren Entfernung per E-Mail oder über interne Benachrichtigungen informiert.

*Einer Seite werden verantwortliche Benutzer zugewiesen.
*Einer Seite können mehrere individuelle Benutzer und Gruppen zugewiesen werden.
*Zugewiesene Benutzer können die Verantwortung auf einen anderen Benutzer übertragen.
*Auf der Spezialseite im Wiki ''Spezial:Zuweisungen'' sehen Benutzer ihre zugewiesenen Seiten.
*Auf der Seite ''Spezial:Zuweisungsverwaltung'' sehen und verwalten Benutzer mit ''admin-, maintenanceadmin-'' oder ''reviewer''-Rechten die Zuweisungen im Wiki.
*Die zugewiesenen Benutzer können über eine angepasste Konfiguration direkt im Titelbereich der Seite angezeigt werden:


$GLOBALS['bsgPageAssignmentsPageHeaderLimit'] = 25;

===Alle Benutzer zuweisen (mit der Option, einzelne Benutzer auszuschließen)===
Um die Gruppe ''everyone'' bereitzustellen, fügen Sie diese unter PageAssignmentsActivatedTypes in der Datei ''<bluespice-Installationpfad>/extensions/BlueSpicePageAssignments/extension.json'' hinzu:<syntaxhighlight lang="json">
"PageAssignmentsActivatedTypes": {
"value": [
"user",
"group",
"everyone"
]
},
</syntaxhighlight>Dies macht die Gruppe ''Jeder'' im Auswahlmenü im Zuweisungsformular verfügbar. Einzelne Benutzer können hiervon ausgeschlossen werden, wenn die Seite ''MediaWiki:PageAssignments-everyone-blacklist'' erstellt wird. Benutzer könnend dieser "Blacklist" unter Verwendung von Zeilenumbrüchen hinzugefügt werden.
<br />
{{Textbox|boxtype=warning|header=Konflikt zwischen Berechtigungen und expliziten Bearbeitungsrechten in einem Namensraum|text=Wenn ein Administrator explizite Bearbeitungsrechte für einen Namensraum setzt, wird die Berechtigung <code>pageassignable</code> nur der explizit zugewiesenen Bearbeitergruppe erteilt. Das bedeutet, dass Gruppen mit anderen Rollen – wie etwa „Leser“ – die Berechtigung <code>pageassignable</code> verlieren. Dies liegt daran, dass die Berechtigung standardmäßig mehreren Rollen zugewiesen ist (siehe Berechtigungstabelle unten).

Die Folge ist: Auch wenn es so aussieht, als wären bestimmte Benutzer einer Seite zugewiesen, sind sie es faktisch nicht und erhalten somit auch keine Lesebestätigungen. Stattdessen erhalten die Gruppen mit dem exklusiven Namensraumrecht (z. B. die Bearbeiterrolle im Namensraum) die Lesebestätigungen.

Um diesen Konflikt zu vermeiden, nehmen Sie in der Datei <code>/data/bluespice/pre-init-settings.php</code> folgende Einstellung vor:
<syntaxhighlight lang="php">
$bsgPermissionConfig[ 'pageassignable' ] = [
'roles' => [
"reader"
]
];
</syntaxhighlight>
|icon=no}}
|license=GPL v3 only
}}

Referenz:BlueSpicePageAssignments

2026-06-29T15:11:26Z

Margit.link-rodrigue:

Referenz:BlueSpiceReadConfirmation

2026-06-29T15:10:42Z

Margit.link-rodrigue:

{{BSExtensionInfo
|status=stable
|developer=HalloWelt
|type=BlueSpice
|edition=BlueSpice pro, BlueSpice farm, BlueSpice cloud
|compatible=BlueSpice
|category=Qualitätssicherung
|features='''ReadConfirmation''' fragt nach einer Bestätigung, dass eine Seite von zugewiesenen Benutzern gelesen wurde.

<span title="">Wenn die Funktion für einen Namespace aktiviert ist, sehen zugewiesene Benutzer ein Kontrollkästchen oben auf der Seite.</span> <span title="" class="">Durch Klicken auf das Kontrollkästchen bestätigen sie, dass sie die Seite gelesen haben.</span>

Lesebsestätigungen können für jeden Namensraum einzeln in der [[Referenz:BlueSpiceNamespaceManager|Namensraumverwaltung]] aktiviert oder deaktiviert werden.

=== Seitenfreigabe und Lesebestätigung ===
Wenn in einem Namensraum gleichzeitig die Funktion [[Referenz:ContentStabilization|Freigabe]] aktiviert ist, so wird die Lesebestätigung ausgelöst, wenn ein neuer Entwurf existiert. Dies kann über Serverkonfiguration geändert werden, sodass die Lesebestätigung erforderlich wird, nachdem der Seitenentwurf freigegeben wurde:
<syntaxhighlight lang="text">
$GLOBALS['bsgReadConfirmationMechanism'] = "\\MediaWiki\\Extension\\ContentStabilization\\Integration\\ReadConfirmation\\PageApproved::factory";
</syntaxhighlight>

{{Textbox|boxtype=warning|header=Berechtigungskonflikte können sich auf Lesebestätigungen auswirken:|text=Wenn für einen Namensraum in der Rechteverwaltung explizit verrechtet wurde, kann dies zu Konflikten mit Seitenzuweisungen und daher auch mit Lesebestätigungen führen. Sollte bei einigen Benutzern keine Lesebestätigungsbox erscheinen, ist möglicherweise eine [[Referenz:BlueSpicePageAssignments|benutzerdefinierte Konfiguration]] erforderlich.|icon=no}}
|license=GPL v3 only
}}

Referenz:BlueSpiceReadConfirmation

2026-06-29T15:10:30Z

Margit.link-rodrigue:

{{BSExtensionInfo
|status=stable
|developer=HalloWelt
|type=BlueSpice
|edition=BlueSpice pro, BlueSpice farm, BlueSpice cloud
|compatible=BlueSpice
|category=Qualitätssicherung
|features='''ReadConfirmation''' fragt nach einer Bestätigung, dass eine Seite von zugewiesenen Benutzern gelesen wurde.

<span title="">Wenn die Funktion für einen Namespace aktiviert ist, sehen zugewiesene Benutzer ein Kontrollkästchen oben auf der Seite.</span> <span title="" class="">Durch Klicken auf das Kontrollkästchen bestätigen sie, dass sie die Seite gelesen haben.</span>

Lesebsestätigungen können für jeden Namensraum einzeln in der [[Referenz:BlueSpiceNamespaceManager|Namensraumverwaltung]] aktiviert oder deaktiviert werden.

=== Seitenfreigabe und Lesebestätigung ===
Wenn in einem Namensraum gleichzeitig die Funktion [[Referenz:ContentStabilization|Freigabe]] aktiviert ist, so wird die Lesebestätigung ausgelöst, wenn ein neuer Entwurf existiert. Dies kann über Serverkonfiguration geändert werden, sodass die Lesebestätigung erforderlich wird, nachdem der Seitenentwurf freigegeben wurde:
<syntaxhighlight lang="text">
$GLOBALS['bsgReadConfirmationMechanism'] = "\\MediaWiki\\Extension\\ContentStabilization\\Integration\\ReadConfirmation\\PageApproved::factory";
</syntaxhighlight>

{{Textbox|boxtype=warning|header=Berechtigungskonflikte können sich auf Lesebestätigungen auswirken:|text=Wenn für einen Namensraum in der Rechteverwaltung explizit verrechtet wurde, kann dies zu Konflikten mit Seitenzuweisungen und daher auch mit Lesebestätigungen führen. Sollte bei einigen Benutzern keine Lesebestätigungsbox erscheinen, ist möglicherweise eine [[Reference:BlueSpicePageAssignments|benutzerdefinierte Konfiguration]] erforderlich.|icon=no}}
|license=GPL v3 only
}}

Referenz:BlueSpiceReadConfirmation

2026-06-29T08:36:18Z

Margit.link-rodrigue:

MediaWiki:Common.css

2026-06-26T13:32:58Z

Margit.link-rodrigue:

/* Das folgende CSS wird für alle Benutzeroberflächen geladen. */
/*Sidebar subpagetree */
/*stabilize gutter*/
#sb-pri {
scrollbar-gutter: stable;
scrollbar-width: auto!important
}

/*top-align expand chevron*/
#sb-pri .oojsplus-data-tree-items .oojs-ui-data-tree-item .oojsplus-data-tree-expander {
vertical-align: top;
}

/*avoid hover-wiggle in some resolutions*/
#sb-pri ul.tree-node-list > li > div,
#sb-pri ul.tree-node-list > li > ul.tree-node-list {
margin-left: 0px!important;
border-left: 5px solid transparent;
box-sizing: border-box!important;
}
#sb-pri ul.tree-node-list > li > div:hover {
margin-left: 0px!important;
border-left: 5px solid var(--sidebar-primary-marker--hover);
box-sizing: border-box!important;
}

/*make room for plus-icon*/
#sb-pri ul.tree-node-list a:not(.new),
#sb-pri ul.tree-node-list a:not(.new):visited,
#sb-pri ul.tree-node-list a:not(.new):hover {
margin-right: 0!important;
}
#sb-pri ul.mws-tree .mws-tree-item a.mws-tree-item-label,
#sb-pri .oojsplus-data-navigation-tree span.oojsplus-data-tree-label {
padding-right: 8px
}

/*Entry links

#sb-pri .list-group-item a {
margin-left: 0px!important;
border-left: 5px solid transparent;
box-sizing: border-box!important;
}*/

/*Custom formatting for centering footer links*/

#footer ul {
position: relative;
}

li.edit-footerlinks-link {
position: absolute;
top: 2.2em;}

/*Custom formatting for EmbedVideo overlay on dark background image*/
.embedvideo-thumbnail {
position: absolute;
z-index: 1;
top:-10px
}
.embedvideo-overlay {
display: block;
position: absolute;
top: 0;
}
.embedvideo-overlay a {
color:white!important;
font-size:1.1em!important;
}
.embedvideo-loader__title {
white-space: normal;
text-align:center;
padding-top:20px
}
.embedvideo-loader__footer > div {
background-color: rgba(226, 0, 0, .8);
}
.embedvideo-privacyNotice {
height:110%
}
.embedvideo-privacyNotice__continue {
border: none;
padding: 2px 5px;
border-radius:5px;
outline: inherit;
background-color: #36c;
color:white ;
}
.embedvideo-privacyNotice__dismiss {
border: none;
padding: 2px 5px;
border-radius:5px;
background-color:white;
}
.embedvideo-loader__fakeButton {
margin-top:30px;
}

/*WCAG 1.4.3 discernable links*/
.mw-body-content a:not([class*='oo-ui-']),
[class^='mw-content-'] a:not([class*='oo-ui-']) {
text-decoration: underline dotted;
text-underline-offset: 4px;
text-decoration-thickness: 1px;
text-decoration-color: grey
}

/*MW overrides */
.wikitable {
background-color: #fff
}

.wikitable tr th {
background-color: #f1f3f9
}

figure[typeof~='mw:File/Thumb'].mw-halign-center,
figure[typeof~='mw:File/Frame'].mw-halign-center {
margin: 2em auto;
}

.mw-body-content li {
margin-bottom: 0.6em;
}

/*Main Page banner */
#mpbanner {
margin-top: -55px;
}

h1#mpbanner-byline {
font-size: 1.8em;
color: #3e5389;
line-height: 1em;
padding-top: 20px;
}

#mpbanner-title {
font-size: 3.4rem;
color: #4b80eb;
line-height: 1.2em;
font-weight: 900;
letter-spacing: 1px;
display: block
}

#mpbsv {
color: #4666cd
}

/*Main Page general */
.mpbs5 .section-featured h2 {
font-size: 1.2em;
margin: 0 0 1em 0;
border-bottom: none;
color: #555
}

#startpage.mpbs5 .sectionflexcontainer>div h2 {
padding: 20px 15px 5px 15px
}

/*Softwarekatalog*/
table.casablanca.swc tbody tr,
table.casablanca.swc th {
color: #333
}

table.casablanca.swc thead tr,
table.casablanca tbody th.swc {
background: #e9e9ee
}

a.pdfcreator-export {
background: #efefef;
padding: 10px;
border-radius: 6px;
float: right;
font-weight: bold;
}

a.pdfcreator-export:before {
font-family: 'bootstrap-icons';
content: '\F1B9';
vertical-align: -0.3em;
padding-right: 0.5em;
}

/* Hide PDF Exclude Tags*/
.hf-nsheader .pdfcreator-excludestart,
.hf-nsheader .pdfcreator-excludeend,
.hf-nsfooter .pdfcreator-excludestart,
.hf-nsfooter .pdfcreator-excludeend {
display: none;
}

/*Quiz */
/*Quiz*/
.quiz .question {
margin-bottom: 3em;
}

.questionText {
font-weight: 700;
margin-bottom: 1.2em;
}

.question .header {
background: #fff0e1;
padding: 1px 6px;
}

span.questionText {
display: block;
}

.question td {
background: #f6f6f6;
border-bottom: 2px solid #fff;
padding: 8px 6px 6px;
}

.question th {
background: #f6f6f6;
border-bottom: 2px solid #fff;
padding: 8px 6px 6px;
}

.quiz table {
width: 100%;
}

.quizQuestions .question .sign {
width: 26px;
}

.quiz table.settings {
margin-left: 30px !important;
}

.mw-content-ltr .quiz .question .border {
border-width: 0 0 0 12px !important;
}

.quiz .margin.right {
background-color: #8ed27d !important;
}

.quiz .margin.NA {
background-color: #337ecc !important;
}

.quiz .margin.wrong {
background-color: #ff5c64 !important;
}

.quiz .question .border.right {
border-color: #8ed27d !important;
}

.quiz .question .border.NA {
border-color: #337ecc !important;
}

.quiz .question .border.wrong {
border-color: #ff5c64 !important;
}

.quiz .question .check.right {
outline: 3px solid #8ed27d !important;
}

.quiz .question .check.NA {
outline: 3px solid #337ecc !important;
}

.quiz .question .check.wrong {
outline: 3px solid #ff5c64 !important;
}

.quizForm input[value="Submit"] {
background: #36c;
border: none;
color: #FFF;
margin-right: 10px;
margin-left: 30px;
padding: 6px 12px;
}

.quizForm input:hover[value="Submit"] {
background: #2551aa;
}

.quizForm input[value="Reset"] {
background: #a4a4a4;
border: none;
color: #FFF;
margin-right: 10px;
padding: 6px 12px;
}

.quizForm input:hover[value="Reset"] {
background: #858585;
}

.quiz .correction {
background-color: #ffe4c9;
display: block;
font-weight: 700;
margin: 10px 0 30px 28px;
padding: 20px;
}

/** Template downloads **/
.cards {
display: flex;
flex-wrap: wrap;
justify-content: space-between;
gap: 20px
}

.cards>div {
margin-left: 5px;
margin-right: 5px;
flex-basis: 290px;
margin-bottom: 50px;
border-top: 1px solid #f0f0f0;
box-shadow: 0 1px 3px rgba(0, 0, 0, .12), 0 1px 2px rgba(0, 0, 0, .24);
transition: all .3s cubic-bezier(.25, .8, .25, 1);
cursor: pointer;
text-align: center
}

.cards>div:hover {
box-shadow: 0 6px 8px rgba(0, 0, 0, .10), 0 10px 10px rgba(0, 0, 0, .10);
}

.cards a.image img {
max-width: 600px
}

.cards .screenshot {
width: 300px;
height: 200px;
overflow: hidden;
border-top: 14px solid #eee;
border-bottom: 14px solid #eee
}

#content #bodyContent .cards h2 {
margin: 10px;
padding: 0;
font-size: 1.1rem;
font-color: #444;
border: none;
text-align: center
}

.cards h2 .mw-editsection {
display: none
}

.cards .text {
font-size: 0.85rem;
padding: 20px 10px;
text-align: center;
font-weight: bold;
}

#mw-content-text text a:not(.new),
[class^="mw-content-"] .text a:not(.new),
#mw-content-text .text a:link:not(.new),
[class^="mw-content-"] .text a:link:not(.new),
#mw-content-text .text a:not(.new):visited,
[class^="mw-content-"] .text a:not(.new):visited,
#mw-content-text .text a:link:not(.new):visited,
[class^="mw-content-"] .text a:link:not(.new):visited {
color: #444;
}

.cards .emptycard,
.cards>div.emptycard:hover {
border: 0;
box-shadow: none;
}

@media only screen and (max-width: 768px) {
.cards>div {
flex-basis: 98%;
}

.cards .screenshot {
width: auto;
text-align: center
}

}

.getButton {
display: inline-block;
background-color: #4CAF50;
border: none;
color: white;
padding: 8px 20px;
text-align: center;
text-decoration: none;
font-size: 16px;
margin: 0 0 10px 0;
-webkit-transition-duration: 0.4s;
transition-duration: 0.4s;
border-radius: 8px;
}

#mw-content-text .getButton a {
color: #ffffff !important;
}

.getButton:hover {
box-shadow: 0 12px 16px 0 rgba(0, 0, 0, 0.24), 0 17px 50px 0 rgba(0, 0, 0, 0.19);
color: 'f5f5f5';
}

.getButton:active {
position: relative;
top: 1px;
}

.getButton a:before {
font-family: 'fontawesome';
content: '\f019 ';
font-size: 1.3em;
vertical-align: middle;
margin-right: 10px;
}

.cart a:before {
font-family: 'fontawesome';
content: '\f217 ';
}

.downloadarea {
text-align: center;
display: inline-block;
float: right;
margin: 0 0 20px 40px;
padding: 10px;
background: #efefef;
background: linear-gradient(270deg, rgb(240, 240, 240) 0%, rgb(224, 224, 224) 52%, rgb(240, 240, 240) 100%);
}

.downloadarea p {
margin: 0
}

@media only screen and (max-width: 768px) {
.cards>div {
flex-basis: 98%;
}
}

.oo-ui-panelLayout-framed {
border: 0;
}

.oo-ui-tabSelectWidget-framed {
border-bottom: 1px solid #d3d5da;
}

/*404 system message badaccess-groups*/
#system404-error {
text-align: center;
}

#system404-error div.floatnone a.image img {
padding: 0;
margin: 0;
}

#system404-error hr {
margin-top: 0px;
margin-bottom: 2rem;
border: 0;
max-width: 600px;
border-top: 3px dotted #ddd;
}

/*Quick Search */
#bs-extendedsearch-box .bs-extendedsearch-autocomplete-popup {
overflow-y: scroll;
max-height: 750px
}

.bs-extendedsearch-autocomplete-popup .bs-extendedsearch-autocomplete-popup-item {
background: #f1f3f9;
margin: 0 10px 6px 0;
border-radius: 4px;
}

#bs-extendedsearch-box .bs-extendedsearch-autocomplete-popup .bs-extendedsearch-autocomplete-popup-primary .bs-extendedsearch-autocomplete-popup-primary-item:hover {
background: #fff
}

.oo-ui-icon-articleRedirect {
background-size: 80%
}

.bs-extendedsearch-autocomplete-popup-item-header-redirect a {
width: 85% !important;
font-size: 0.9em
}

/* Styles for section cards */
.sectionflex {
display: flex;
flex-wrap: wrap;
justify-content: space-between;
gap: 20px
}

.sectionflex.col1>div {
flex-basis: 100%;
padding: 10px 20px;
}

.sectionflex.col2>div {
flex-basis: 48%;
padding: 10px 20px;
}

.sectionflex.col3>div {
flex-basis: 32%;
padding: 10px 20px;
}

.sectionflex.col4>div {
flex-basis: 23%;
padding: 10px 20px;
}

.sectionflex>div.empty {
border: none;
background: none
}

#mw-content-text .sectionflex>div h2 {
margin: 0 0 1em 0;
font-size: 1.3em
}

#mw-content-text .sectionflex>div h3 {
margin: 0 0 1em;
font-size: 1.2em
}

.sectionflex.frame>div {
border: 1px solid #e7e7e7
}

.sectionflex.background>div {
background: #f1f3f9
}

.sectionflex .ve-ce-branchNode-slug,
.sectionflex span.mw-editsection {
display: none
}

.sectionflex.linked a {
display: block
}

.sectionflex.centered>div {
text-align: center;
}

/*All topics */
/*Themen*/
.sectionflex.themenhd div [class*=" bi-"]::before {
font-size: 1.6em;
vertical-align: middle;
padding: 6px;
border-radius: 50%;
}

.sectionflex.themenhd div [class*=" bi-"]::before {
font-size: 2em;
vertical-align: middle;
background-color: #f1f3f9;
padding: 10px;
}

.sectionflex.themenhd.background div [class*=" bi-"]::before {
font-size: 2em;
vertical-align: middle;
background-color: #fff;
padding: 10px;
}

.themenhd div a {
display: block
}

.themenhd div:hover {
background: rgb(233, 233, 238, 0.5)
}

/* bootstrap icons in blue and big */
.bi-big,
.fa-big {
font-size: 2rem;
color: #2b80ea
}

ul.smw-format.ul-format.alltopics-col {
column-count: 3;
}

@media (max-width: 767px) {

.sectionflex.col2>div,
.sectionflex.col3>div {
flex-basis: 100%;
margin-top: 2em
}
}

/*Referenz Seiten */
.extension-infobox {
width: 25em;
font-size: 90%;
background-color: #f1f3f9;
color: black;
margin-bottom: 0.5em;
margin-left: 1em;
padding: 0.2em;
float: right;
clear: right;
text-align: left;
}

.extension-infobox-header {
text-align: center;
background-color: #2e6096;
padding: 8px;
color: #ffffff;
}

.extension-infobox-headertext {
font-size: larger;
color: #FFFFFF;
}

.extension-infobox-description {
font-weight: normal !important;
text-align: left;
background-color: #f1f3f9;
padding: 20px 10px 20px 10px !important;
}

.extension-infobox-first-row {
vertical-align: top;
padding: 20px 10px 0 10px;
}

.extension-infobox-row {
vertical-align: top;
padding: 0 10px;
}

.extension-infobox-last-row {
vertical-align: top;
padding: 0 10px 20px 10px;
}

.extension-infobox-helppage {
font-weight: normal;
text-align: center;
vertical-align: top;
padding-left: 10px;
padding-top: 10px;
padding-bottom: 10px;
background-color: #eeeeee;
}

.extension-infobox.fullwidth {
width: 100%;
float: none;
font-size: 1em;
margin-left: 0;
}

.extension-infobox.fullwidth th {
text-align: right;
}

.extension-infobox-header,
.extension-infobox-helppage {
text-align: center !important;
font-size: 1.1em
}

.extension-infobox.fullwidth th,
.extension-infobox.fullwidth td {
padding: 8px;
width: 100px;
border: 1px solid #ffffff;
}

.extension-infobox.fullwidth td {
width: 300px;
}

.extension-infobox-helppage {
background-color: #eaecf0;
}

.flexbox {
display: flex;
flex-direction: row;
flex-wrap: wrap;
justify-content: flex-start;
align-items: stretch;
align-content: stretch;
}

#content #bodyContent #importdata h3 {
margin: 1em 0 1.4em;
}

#importdata .flexbox {
justify-content: space-between;
margin-top: 2em;
}

#mw-content-text #importdata .flexbox h3,
[class^="mw-content-"] #importdata .flexbox h3 {
background: #d8d8d9;
margin: 0 0 12px 0;
padding: 8px;
font-size: 1em !important;
font-weight: bold
}

#importdata .mw li {
margin-left: 0;
list-style-type: none;
padding-left: 30px;
background: no-repeat left 1px top 3px / 18px url('/w/nsfr_img_auth.php/c/c6/MediaWiki-2020-small-icon.svg');
}

#importdata .bs li {
margin-left: 0;
list-style-type: none;
padding-left: 30px;
background: no-repeat left 2px top 4px / 15px url('/w/nsfr_img_auth.php/c/c4/Bluespice_Icon.svg');
}

#importdata .flexbox div {
background: #f1f3f9;
text-align: left;
margin: 0;
flex-basis: 33%;
padding: 0
}

#importdata table.wikitable>tr>th,
#importdata table.wikitable>*>tr>th,
table.wikitable.reference>tr>th,
.importdata .wikitable.reference>*>tr>th {
background-color: #eaecf0;
text-align: left;
padding: 8px;
border: 1px solid #ffffff
}

#importdata table.wikitable>tr>td,
#importdata table.wikitable>*>tr>td,
#importdata table.wikitable.reference>tr>td,
#importdata table.wikitable.reference>*>tr>td {
padding: 8px;
border: 1px solid #ffffff;
}

#importdata div .inner {
padding: 8px 12px
}

#importdata .bs p {
font-size: 0.9rem;
margin-left: 2.1em;
display: list-item;
}

.smwtable-clean {
width: auto;
max-width: 100%;
margin-bottom: 20px;
background-color: transparent;
border-spacing: 0px;
}

.smwtable-clean tr>th {
padding: 8px !important;
line-height: 1.42857143;
vertical-align: top;
border-top: 1px solid #dddddd;
border-collapse: collapse;
border-spacing: 0;
text-align: center;
vertical-align: middle;
}

.smwtable-clean tr>td {
padding: 8px !important;
line-height: 1.42857143;
vertical-align: top;
border-top: 1px solid #dddddd;
border-collapse: collapse;
border-spacing: 0;
}

.smwtable-clean tbody>tr:nth-child(even) {
background-color: #f5f5f5;
}

/*Stile für die Unterseitennavigation über Erweiterung HeaderFooter */
.hf-navbox {
background: #f2f3f9;
padding: 1em;
margin-bottom: 2em
}

.hf-subpages .subpagelist ul {
margin-top: 1em;
margin-bottom: 1em;
column-count: 3
}

#mw-content-text .hf-subpages .subpagelist li {
margin-top: 0
}

.hf-subpages .default {
display: none;
line-height: 0;
overflow: hidden
}

/*avoid empty space if there are no subpages*/
.wcagnote {
border: 1px solid #e9bb06;
padding: 2px 6px;
border-radius: 6px;
background: #fffdeb;
}

/* See ERM45154 */
html {
filter: none !important;
color-scheme: light !important;
}

/*Lingo tooltip */
.qtip {
font-size: 0.9em;
}

MediaWiki:Common.css

2026-06-26T13:14:29Z

Margit.link-rodrigue:

/* Das folgende CSS wird für alle Benutzeroberflächen geladen. */
/*Sidebar subpagetree */

/*Entry links

#sb-pri .list-group-item a {
margin-left: 0px!important;
border-left: 5px solid transparent;
box-sizing: border-box!important;
}*/

/*Custom formatting for centering footer links*/

#footer ul {
position: relative;
}

li.edit-footerlinks-link {
position: absolute;
top: 2.2em;}

/*Custom formatting for EmbedVideo overlay on dark background image*/
.embedvideo-thumbnail {
position: absolute;
z-index: 1;
top:-10px
}
.embedvideo-overlay {
display: block;
position: absolute;
top: 0;
}
.embedvideo-overlay a {
color:white!important;
font-size:1.1em!important;
}
.embedvideo-loader__title {
white-space: normal;
text-align:center;
padding-top:20px
}
.embedvideo-loader__footer > div {
background-color: rgba(226, 0, 0, .8);
}
.embedvideo-privacyNotice {
height:110%
}
.embedvideo-privacyNotice__continue {
border: none;
padding: 2px 5px;
border-radius:5px;
outline: inherit;
background-color: #36c;
color:white ;
}
.embedvideo-privacyNotice__dismiss {
border: none;
padding: 2px 5px;
border-radius:5px;
background-color:white;
}
.embedvideo-loader__fakeButton {
margin-top:30px;
}

/*WCAG 1.4.3 discernable links*/
.mw-body-content a:not([class*='oo-ui-']),
[class^='mw-content-'] a:not([class*='oo-ui-']) {
text-decoration: underline dotted;
text-underline-offset: 4px;
text-decoration-thickness: 1px;
text-decoration-color: grey
}

/*MW overrides */
.wikitable {
background-color: #fff
}

.wikitable tr th {
background-color: #f1f3f9
}

figure[typeof~='mw:File/Thumb'].mw-halign-center,
figure[typeof~='mw:File/Frame'].mw-halign-center {
margin: 2em auto;
}

.mw-body-content li {
margin-bottom: 0.6em;
}

/*Main Page banner */
#mpbanner {
margin-top: -55px;
}

h1#mpbanner-byline {
font-size: 1.8em;
color: #3e5389;
line-height: 1em;
padding-top: 20px;
}

#mpbanner-title {
font-size: 3.4rem;
color: #4b80eb;
line-height: 1.2em;
font-weight: 900;
letter-spacing: 1px;
display: block
}

#mpbsv {
color: #4666cd
}

/*Main Page general */
.mpbs5 .section-featured h2 {
font-size: 1.2em;
margin: 0 0 1em 0;
border-bottom: none;
color: #555
}

#startpage.mpbs5 .sectionflexcontainer>div h2 {
padding: 20px 15px 5px 15px
}

/*Softwarekatalog*/
table.casablanca.swc tbody tr,
table.casablanca.swc th {
color: #333
}

table.casablanca.swc thead tr,
table.casablanca tbody th.swc {
background: #e9e9ee
}

a.pdfcreator-export {
background: #efefef;
padding: 10px;
border-radius: 6px;
float: right;
font-weight: bold;
}

a.pdfcreator-export:before {
font-family: 'bootstrap-icons';
content: '\F1B9';
vertical-align: -0.3em;
padding-right: 0.5em;
}

/* Hide PDF Exclude Tags*/
.hf-nsheader .pdfcreator-excludestart,
.hf-nsheader .pdfcreator-excludeend,
.hf-nsfooter .pdfcreator-excludestart,
.hf-nsfooter .pdfcreator-excludeend {
display: none;
}

/*Quiz */
/*Quiz*/
.quiz .question {
margin-bottom: 3em;
}

.questionText {
font-weight: 700;
margin-bottom: 1.2em;
}

.question .header {
background: #fff0e1;
padding: 1px 6px;
}

span.questionText {
display: block;
}

.question td {
background: #f6f6f6;
border-bottom: 2px solid #fff;
padding: 8px 6px 6px;
}

.question th {
background: #f6f6f6;
border-bottom: 2px solid #fff;
padding: 8px 6px 6px;
}

.quiz table {
width: 100%;
}

.quizQuestions .question .sign {
width: 26px;
}

.quiz table.settings {
margin-left: 30px !important;
}

.mw-content-ltr .quiz .question .border {
border-width: 0 0 0 12px !important;
}

.quiz .margin.right {
background-color: #8ed27d !important;
}

.quiz .margin.NA {
background-color: #337ecc !important;
}

.quiz .margin.wrong {
background-color: #ff5c64 !important;
}

.quiz .question .border.right {
border-color: #8ed27d !important;
}

.quiz .question .border.NA {
border-color: #337ecc !important;
}

.quiz .question .border.wrong {
border-color: #ff5c64 !important;
}

.quiz .question .check.right {
outline: 3px solid #8ed27d !important;
}

.quiz .question .check.NA {
outline: 3px solid #337ecc !important;
}

.quiz .question .check.wrong {
outline: 3px solid #ff5c64 !important;
}

.quizForm input[value="Submit"] {
background: #36c;
border: none;
color: #FFF;
margin-right: 10px;
margin-left: 30px;
padding: 6px 12px;
}

.quizForm input:hover[value="Submit"] {
background: #2551aa;
}

.quizForm input[value="Reset"] {
background: #a4a4a4;
border: none;
color: #FFF;
margin-right: 10px;
padding: 6px 12px;
}

.quizForm input:hover[value="Reset"] {
background: #858585;
}

.quiz .correction {
background-color: #ffe4c9;
display: block;
font-weight: 700;
margin: 10px 0 30px 28px;
padding: 20px;
}

/** Template downloads **/
.cards {
display: flex;
flex-wrap: wrap;
justify-content: space-between;
gap: 20px
}

.cards>div {
margin-left: 5px;
margin-right: 5px;
flex-basis: 290px;
margin-bottom: 50px;
border-top: 1px solid #f0f0f0;
box-shadow: 0 1px 3px rgba(0, 0, 0, .12), 0 1px 2px rgba(0, 0, 0, .24);
transition: all .3s cubic-bezier(.25, .8, .25, 1);
cursor: pointer;
text-align: center
}

.cards>div:hover {
box-shadow: 0 6px 8px rgba(0, 0, 0, .10), 0 10px 10px rgba(0, 0, 0, .10);
}

.cards a.image img {
max-width: 600px
}

.cards .screenshot {
width: 300px;
height: 200px;
overflow: hidden;
border-top: 14px solid #eee;
border-bottom: 14px solid #eee
}

#content #bodyContent .cards h2 {
margin: 10px;
padding: 0;
font-size: 1.1rem;
font-color: #444;
border: none;
text-align: center
}

.cards h2 .mw-editsection {
display: none
}

.cards .text {
font-size: 0.85rem;
padding: 20px 10px;
text-align: center;
font-weight: bold;
}

#mw-content-text text a:not(.new),
[class^="mw-content-"] .text a:not(.new),
#mw-content-text .text a:link:not(.new),
[class^="mw-content-"] .text a:link:not(.new),
#mw-content-text .text a:not(.new):visited,
[class^="mw-content-"] .text a:not(.new):visited,
#mw-content-text .text a:link:not(.new):visited,
[class^="mw-content-"] .text a:link:not(.new):visited {
color: #444;
}

.cards .emptycard,
.cards>div.emptycard:hover {
border: 0;
box-shadow: none;
}

@media only screen and (max-width: 768px) {
.cards>div {
flex-basis: 98%;
}

.cards .screenshot {
width: auto;
text-align: center
}

}

.getButton {
display: inline-block;
background-color: #4CAF50;
border: none;
color: white;
padding: 8px 20px;
text-align: center;
text-decoration: none;
font-size: 16px;
margin: 0 0 10px 0;
-webkit-transition-duration: 0.4s;
transition-duration: 0.4s;
border-radius: 8px;
}

#mw-content-text .getButton a {
color: #ffffff !important;
}

.getButton:hover {
box-shadow: 0 12px 16px 0 rgba(0, 0, 0, 0.24), 0 17px 50px 0 rgba(0, 0, 0, 0.19);
color: 'f5f5f5';
}

.getButton:active {
position: relative;
top: 1px;
}

.getButton a:before {
font-family: 'fontawesome';
content: '\f019 ';
font-size: 1.3em;
vertical-align: middle;
margin-right: 10px;
}

.cart a:before {
font-family: 'fontawesome';
content: '\f217 ';
}

.downloadarea {
text-align: center;
display: inline-block;
float: right;
margin: 0 0 20px 40px;
padding: 10px;
background: #efefef;
background: linear-gradient(270deg, rgb(240, 240, 240) 0%, rgb(224, 224, 224) 52%, rgb(240, 240, 240) 100%);
}

.downloadarea p {
margin: 0
}

@media only screen and (max-width: 768px) {
.cards>div {
flex-basis: 98%;
}
}

.oo-ui-panelLayout-framed {
border: 0;
}

.oo-ui-tabSelectWidget-framed {
border-bottom: 1px solid #d3d5da;
}

/*404 system message badaccess-groups*/
#system404-error {
text-align: center;
}

#system404-error div.floatnone a.image img {
padding: 0;
margin: 0;
}

#system404-error hr {
margin-top: 0px;
margin-bottom: 2rem;
border: 0;
max-width: 600px;
border-top: 3px dotted #ddd;
}

/*Quick Search */
#bs-extendedsearch-box .bs-extendedsearch-autocomplete-popup {
overflow-y: scroll;
max-height: 750px
}

.bs-extendedsearch-autocomplete-popup .bs-extendedsearch-autocomplete-popup-item {
background: #f1f3f9;
margin: 0 10px 6px 0;
border-radius: 4px;
}

#bs-extendedsearch-box .bs-extendedsearch-autocomplete-popup .bs-extendedsearch-autocomplete-popup-primary .bs-extendedsearch-autocomplete-popup-primary-item:hover {
background: #fff
}

.oo-ui-icon-articleRedirect {
background-size: 80%
}

.bs-extendedsearch-autocomplete-popup-item-header-redirect a {
width: 85% !important;
font-size: 0.9em
}

/* Styles for section cards */
.sectionflex {
display: flex;
flex-wrap: wrap;
justify-content: space-between;
gap: 20px
}

.sectionflex.col1>div {
flex-basis: 100%;
padding: 10px 20px;
}

.sectionflex.col2>div {
flex-basis: 48%;
padding: 10px 20px;
}

.sectionflex.col3>div {
flex-basis: 32%;
padding: 10px 20px;
}

.sectionflex.col4>div {
flex-basis: 23%;
padding: 10px 20px;
}

.sectionflex>div.empty {
border: none;
background: none
}

#mw-content-text .sectionflex>div h2 {
margin: 0 0 1em 0;
font-size: 1.3em
}

#mw-content-text .sectionflex>div h3 {
margin: 0 0 1em;
font-size: 1.2em
}

.sectionflex.frame>div {
border: 1px solid #e7e7e7
}

.sectionflex.background>div {
background: #f1f3f9
}

.sectionflex .ve-ce-branchNode-slug,
.sectionflex span.mw-editsection {
display: none
}

.sectionflex.linked a {
display: block
}

.sectionflex.centered>div {
text-align: center;
}

/*All topics */
/*Themen*/
.sectionflex.themenhd div [class*=" bi-"]::before {
font-size: 1.6em;
vertical-align: middle;
padding: 6px;
border-radius: 50%;
}

.sectionflex.themenhd div [class*=" bi-"]::before {
font-size: 2em;
vertical-align: middle;
background-color: #f1f3f9;
padding: 10px;
}

.sectionflex.themenhd.background div [class*=" bi-"]::before {
font-size: 2em;
vertical-align: middle;
background-color: #fff;
padding: 10px;
}

.themenhd div a {
display: block
}

.themenhd div:hover {
background: rgb(233, 233, 238, 0.5)
}

/* bootstrap icons in blue and big */
.bi-big,
.fa-big {
font-size: 2rem;
color: #2b80ea
}

ul.smw-format.ul-format.alltopics-col {
column-count: 3;
}

@media (max-width: 767px) {

.sectionflex.col2>div,
.sectionflex.col3>div {
flex-basis: 100%;
margin-top: 2em
}
}

/*Referenz Seiten */
.extension-infobox {
width: 25em;
font-size: 90%;
background-color: #f1f3f9;
color: black;
margin-bottom: 0.5em;
margin-left: 1em;
padding: 0.2em;
float: right;
clear: right;
text-align: left;
}

.extension-infobox-header {
text-align: center;
background-color: #2e6096;
padding: 8px;
color: #ffffff;
}

.extension-infobox-headertext {
font-size: larger;
color: #FFFFFF;
}

.extension-infobox-description {
font-weight: normal !important;
text-align: left;
background-color: #f1f3f9;
padding: 20px 10px 20px 10px !important;
}

.extension-infobox-first-row {
vertical-align: top;
padding: 20px 10px 0 10px;
}

.extension-infobox-row {
vertical-align: top;
padding: 0 10px;
}

.extension-infobox-last-row {
vertical-align: top;
padding: 0 10px 20px 10px;
}

.extension-infobox-helppage {
font-weight: normal;
text-align: center;
vertical-align: top;
padding-left: 10px;
padding-top: 10px;
padding-bottom: 10px;
background-color: #eeeeee;
}

.extension-infobox.fullwidth {
width: 100%;
float: none;
font-size: 1em;
margin-left: 0;
}

.extension-infobox.fullwidth th {
text-align: right;
}

.extension-infobox-header,
.extension-infobox-helppage {
text-align: center !important;
font-size: 1.1em
}

.extension-infobox.fullwidth th,
.extension-infobox.fullwidth td {
padding: 8px;
width: 100px;
border: 1px solid #ffffff;
}

.extension-infobox.fullwidth td {
width: 300px;
}

.extension-infobox-helppage {
background-color: #eaecf0;
}

.flexbox {
display: flex;
flex-direction: row;
flex-wrap: wrap;
justify-content: flex-start;
align-items: stretch;
align-content: stretch;
}

#content #bodyContent #importdata h3 {
margin: 1em 0 1.4em;
}

#importdata .flexbox {
justify-content: space-between;
margin-top: 2em;
}

#mw-content-text #importdata .flexbox h3,
[class^="mw-content-"] #importdata .flexbox h3 {
background: #d8d8d9;
margin: 0 0 12px 0;
padding: 8px;
font-size: 1em !important;
font-weight: bold
}

#importdata .mw li {
margin-left: 0;
list-style-type: none;
padding-left: 30px;
background: no-repeat left 1px top 3px / 18px url('/w/nsfr_img_auth.php/c/c6/MediaWiki-2020-small-icon.svg');
}

#importdata .bs li {
margin-left: 0;
list-style-type: none;
padding-left: 30px;
background: no-repeat left 2px top 4px / 15px url('/w/nsfr_img_auth.php/c/c4/Bluespice_Icon.svg');
}

#importdata .flexbox div {
background: #f1f3f9;
text-align: left;
margin: 0;
flex-basis: 33%;
padding: 0
}

#importdata table.wikitable>tr>th,
#importdata table.wikitable>*>tr>th,
table.wikitable.reference>tr>th,
.importdata .wikitable.reference>*>tr>th {
background-color: #eaecf0;
text-align: left;
padding: 8px;
border: 1px solid #ffffff
}

#importdata table.wikitable>tr>td,
#importdata table.wikitable>*>tr>td,
#importdata table.wikitable.reference>tr>td,
#importdata table.wikitable.reference>*>tr>td {
padding: 8px;
border: 1px solid #ffffff;
}

#importdata div .inner {
padding: 8px 12px
}

#importdata .bs p {
font-size: 0.9rem;
margin-left: 2.1em;
display: list-item;
}

.smwtable-clean {
width: auto;
max-width: 100%;
margin-bottom: 20px;
background-color: transparent;
border-spacing: 0px;
}

.smwtable-clean tr>th {
padding: 8px !important;
line-height: 1.42857143;
vertical-align: top;
border-top: 1px solid #dddddd;
border-collapse: collapse;
border-spacing: 0;
text-align: center;
vertical-align: middle;
}

.smwtable-clean tr>td {
padding: 8px !important;
line-height: 1.42857143;
vertical-align: top;
border-top: 1px solid #dddddd;
border-collapse: collapse;
border-spacing: 0;
}

.smwtable-clean tbody>tr:nth-child(even) {
background-color: #f5f5f5;
}

/*Stile für die Unterseitennavigation über Erweiterung HeaderFooter */
.hf-navbox {
background: #f2f3f9;
padding: 1em;
margin-bottom: 2em
}

.hf-subpages .subpagelist ul {
margin-top: 1em;
margin-bottom: 1em;
column-count: 3
}

#mw-content-text .hf-subpages .subpagelist li {
margin-top: 0
}

.hf-subpages .default {
display: none;
line-height: 0;
overflow: hidden
}

/*avoid empty space if there are no subpages*/
.wcagnote {
border: 1px solid #e9bb06;
padding: 2px 6px;
border-radius: 6px;
background: #fffdeb;
}

/* See ERM45154 */
html {
filter: none !important;
color-scheme: light !important;
}

/*Lingo tooltip */
.qtip {
font-size: 0.9em;
}

MediaWiki:Common.css

2026-06-26T13:13:39Z

Margit.link-rodrigue:

/* Das folgende CSS wird für alle Benutzeroberflächen geladen. */
/*Sidebar subpagetree */

/*stabilize gutter*/
#sb-pri {
scrollbar-gutter: stable;
scrollbar-width: auto!important
}

/*top-align expand chevron*/
#sb-pri .oojsplus-data-tree-items .oojs-ui-data-tree-item .oojsplus-data-tree-expander {
vertical-align: top;
}

/*avoid hover-wiggle in some resolutions*/
#sb-pri ul.tree-node-list > li > div,
#sb-pri ul.tree-node-list > li > ul.tree-node-list {
margin-left: 0px!important;
border-left: 5px solid transparent;
box-sizing: border-box!important;
}

/*make room for plus-icon*/
#sb-pri ul.tree-node-list a:not(.new),
#sb-pri ul.tree-node-list a:not(.new):visited,
#sb-pri ul.tree-node-list a:not(.new):hover {
margin-right: 0!important;
}
#sb-pri ul.mws-tree .mws-tree-item a.mws-tree-item-label,
#sb-pri .oojsplus-data-navigation-tree span.oojsplus-data-tree-label {
padding-right: 8px
}

/*Entry links

#sb-pri .list-group-item a {
margin-left: 0px!important;
border-left: 5px solid transparent;
box-sizing: border-box!important;
}*/

/*Custom formatting for centering footer links*/

#footer ul {
position: relative;
}

li.edit-footerlinks-link {
position: absolute;
top: 2.2em;}

/*Custom formatting for EmbedVideo overlay on dark background image*/
.embedvideo-thumbnail {
position: absolute;
z-index: 1;
top:-10px
}
.embedvideo-overlay {
display: block;
position: absolute;
top: 0;
}
.embedvideo-overlay a {
color:white!important;
font-size:1.1em!important;
}
.embedvideo-loader__title {
white-space: normal;
text-align:center;
padding-top:20px
}
.embedvideo-loader__footer > div {
background-color: rgba(226, 0, 0, .8);
}
.embedvideo-privacyNotice {
height:110%
}
.embedvideo-privacyNotice__continue {
border: none;
padding: 2px 5px;
border-radius:5px;
outline: inherit;
background-color: #36c;
color:white ;
}
.embedvideo-privacyNotice__dismiss {
border: none;
padding: 2px 5px;
border-radius:5px;
background-color:white;
}
.embedvideo-loader__fakeButton {
margin-top:30px;
}

/*WCAG 1.4.3 discernable links*/
.mw-body-content a:not([class*='oo-ui-']),
[class^='mw-content-'] a:not([class*='oo-ui-']) {
text-decoration: underline dotted;
text-underline-offset: 4px;
text-decoration-thickness: 1px;
text-decoration-color: grey
}

/*MW overrides */
.wikitable {
background-color: #fff
}

.wikitable tr th {
background-color: #f1f3f9
}

figure[typeof~='mw:File/Thumb'].mw-halign-center,
figure[typeof~='mw:File/Frame'].mw-halign-center {
margin: 2em auto;
}

.mw-body-content li {
margin-bottom: 0.6em;
}

/*Main Page banner */
#mpbanner {
margin-top: -55px;
}

h1#mpbanner-byline {
font-size: 1.8em;
color: #3e5389;
line-height: 1em;
padding-top: 20px;
}

#mpbanner-title {
font-size: 3.4rem;
color: #4b80eb;
line-height: 1.2em;
font-weight: 900;
letter-spacing: 1px;
display: block
}

#mpbsv {
color: #4666cd
}

/*Main Page general */
.mpbs5 .section-featured h2 {
font-size: 1.2em;
margin: 0 0 1em 0;
border-bottom: none;
color: #555
}

#startpage.mpbs5 .sectionflexcontainer>div h2 {
padding: 20px 15px 5px 15px
}

/*Softwarekatalog*/
table.casablanca.swc tbody tr,
table.casablanca.swc th {
color: #333
}

table.casablanca.swc thead tr,
table.casablanca tbody th.swc {
background: #e9e9ee
}

a.pdfcreator-export {
background: #efefef;
padding: 10px;
border-radius: 6px;
float: right;
font-weight: bold;
}

a.pdfcreator-export:before {
font-family: 'bootstrap-icons';
content: '\F1B9';
vertical-align: -0.3em;
padding-right: 0.5em;
}

/* Hide PDF Exclude Tags*/
.hf-nsheader .pdfcreator-excludestart,
.hf-nsheader .pdfcreator-excludeend,
.hf-nsfooter .pdfcreator-excludestart,
.hf-nsfooter .pdfcreator-excludeend {
display: none;
}

/*Quiz */
/*Quiz*/
.quiz .question {
margin-bottom: 3em;
}

.questionText {
font-weight: 700;
margin-bottom: 1.2em;
}

.question .header {
background: #fff0e1;
padding: 1px 6px;
}

span.questionText {
display: block;
}

.question td {
background: #f6f6f6;
border-bottom: 2px solid #fff;
padding: 8px 6px 6px;
}

.question th {
background: #f6f6f6;
border-bottom: 2px solid #fff;
padding: 8px 6px 6px;
}

.quiz table {
width: 100%;
}

.quizQuestions .question .sign {
width: 26px;
}

.quiz table.settings {
margin-left: 30px !important;
}

.mw-content-ltr .quiz .question .border {
border-width: 0 0 0 12px !important;
}

.quiz .margin.right {
background-color: #8ed27d !important;
}

.quiz .margin.NA {
background-color: #337ecc !important;
}

.quiz .margin.wrong {
background-color: #ff5c64 !important;
}

.quiz .question .border.right {
border-color: #8ed27d !important;
}

.quiz .question .border.NA {
border-color: #337ecc !important;
}

.quiz .question .border.wrong {
border-color: #ff5c64 !important;
}

.quiz .question .check.right {
outline: 3px solid #8ed27d !important;
}

.quiz .question .check.NA {
outline: 3px solid #337ecc !important;
}

.quiz .question .check.wrong {
outline: 3px solid #ff5c64 !important;
}

.quizForm input[value="Submit"] {
background: #36c;
border: none;
color: #FFF;
margin-right: 10px;
margin-left: 30px;
padding: 6px 12px;
}

.quizForm input:hover[value="Submit"] {
background: #2551aa;
}

.quizForm input[value="Reset"] {
background: #a4a4a4;
border: none;
color: #FFF;
margin-right: 10px;
padding: 6px 12px;
}

.quizForm input:hover[value="Reset"] {
background: #858585;
}

.quiz .correction {
background-color: #ffe4c9;
display: block;
font-weight: 700;
margin: 10px 0 30px 28px;
padding: 20px;
}

/** Template downloads **/
.cards {
display: flex;
flex-wrap: wrap;
justify-content: space-between;
gap: 20px
}

.cards>div {
margin-left: 5px;
margin-right: 5px;
flex-basis: 290px;
margin-bottom: 50px;
border-top: 1px solid #f0f0f0;
box-shadow: 0 1px 3px rgba(0, 0, 0, .12), 0 1px 2px rgba(0, 0, 0, .24);
transition: all .3s cubic-bezier(.25, .8, .25, 1);
cursor: pointer;
text-align: center
}

.cards>div:hover {
box-shadow: 0 6px 8px rgba(0, 0, 0, .10), 0 10px 10px rgba(0, 0, 0, .10);
}

.cards a.image img {
max-width: 600px
}

.cards .screenshot {
width: 300px;
height: 200px;
overflow: hidden;
border-top: 14px solid #eee;
border-bottom: 14px solid #eee
}

#content #bodyContent .cards h2 {
margin: 10px;
padding: 0;
font-size: 1.1rem;
font-color: #444;
border: none;
text-align: center
}

.cards h2 .mw-editsection {
display: none
}

.cards .text {
font-size: 0.85rem;
padding: 20px 10px;
text-align: center;
font-weight: bold;
}

#mw-content-text text a:not(.new),
[class^="mw-content-"] .text a:not(.new),
#mw-content-text .text a:link:not(.new),
[class^="mw-content-"] .text a:link:not(.new),
#mw-content-text .text a:not(.new):visited,
[class^="mw-content-"] .text a:not(.new):visited,
#mw-content-text .text a:link:not(.new):visited,
[class^="mw-content-"] .text a:link:not(.new):visited {
color: #444;
}

.cards .emptycard,
.cards>div.emptycard:hover {
border: 0;
box-shadow: none;
}

@media only screen and (max-width: 768px) {
.cards>div {
flex-basis: 98%;
}

.cards .screenshot {
width: auto;
text-align: center
}

}

.getButton {
display: inline-block;
background-color: #4CAF50;
border: none;
color: white;
padding: 8px 20px;
text-align: center;
text-decoration: none;
font-size: 16px;
margin: 0 0 10px 0;
-webkit-transition-duration: 0.4s;
transition-duration: 0.4s;
border-radius: 8px;
}

#mw-content-text .getButton a {
color: #ffffff !important;
}

.getButton:hover {
box-shadow: 0 12px 16px 0 rgba(0, 0, 0, 0.24), 0 17px 50px 0 rgba(0, 0, 0, 0.19);
color: 'f5f5f5';
}

.getButton:active {
position: relative;
top: 1px;
}

.getButton a:before {
font-family: 'fontawesome';
content: '\f019 ';
font-size: 1.3em;
vertical-align: middle;
margin-right: 10px;
}

.cart a:before {
font-family: 'fontawesome';
content: '\f217 ';
}

.downloadarea {
text-align: center;
display: inline-block;
float: right;
margin: 0 0 20px 40px;
padding: 10px;
background: #efefef;
background: linear-gradient(270deg, rgb(240, 240, 240) 0%, rgb(224, 224, 224) 52%, rgb(240, 240, 240) 100%);
}

.downloadarea p {
margin: 0
}

@media only screen and (max-width: 768px) {
.cards>div {
flex-basis: 98%;
}
}

.oo-ui-panelLayout-framed {
border: 0;
}

.oo-ui-tabSelectWidget-framed {
border-bottom: 1px solid #d3d5da;
}

/*404 system message badaccess-groups*/
#system404-error {
text-align: center;
}

#system404-error div.floatnone a.image img {
padding: 0;
margin: 0;
}

#system404-error hr {
margin-top: 0px;
margin-bottom: 2rem;
border: 0;
max-width: 600px;
border-top: 3px dotted #ddd;
}

/*Quick Search */
#bs-extendedsearch-box .bs-extendedsearch-autocomplete-popup {
overflow-y: scroll;
max-height: 750px
}

.bs-extendedsearch-autocomplete-popup .bs-extendedsearch-autocomplete-popup-item {
background: #f1f3f9;
margin: 0 10px 6px 0;
border-radius: 4px;
}

#bs-extendedsearch-box .bs-extendedsearch-autocomplete-popup .bs-extendedsearch-autocomplete-popup-primary .bs-extendedsearch-autocomplete-popup-primary-item:hover {
background: #fff
}

.oo-ui-icon-articleRedirect {
background-size: 80%
}

.bs-extendedsearch-autocomplete-popup-item-header-redirect a {
width: 85% !important;
font-size: 0.9em
}

/* Styles for section cards */
.sectionflex {
display: flex;
flex-wrap: wrap;
justify-content: space-between;
gap: 20px
}

.sectionflex.col1>div {
flex-basis: 100%;
padding: 10px 20px;
}

.sectionflex.col2>div {
flex-basis: 48%;
padding: 10px 20px;
}

.sectionflex.col3>div {
flex-basis: 32%;
padding: 10px 20px;
}

.sectionflex.col4>div {
flex-basis: 23%;
padding: 10px 20px;
}

.sectionflex>div.empty {
border: none;
background: none
}

#mw-content-text .sectionflex>div h2 {
margin: 0 0 1em 0;
font-size: 1.3em
}

#mw-content-text .sectionflex>div h3 {
margin: 0 0 1em;
font-size: 1.2em
}

.sectionflex.frame>div {
border: 1px solid #e7e7e7
}

.sectionflex.background>div {
background: #f1f3f9
}

.sectionflex .ve-ce-branchNode-slug,
.sectionflex span.mw-editsection {
display: none
}

.sectionflex.linked a {
display: block
}

.sectionflex.centered>div {
text-align: center;
}

/*All topics */
/*Themen*/
.sectionflex.themenhd div [class*=" bi-"]::before {
font-size: 1.6em;
vertical-align: middle;
padding: 6px;
border-radius: 50%;
}

.sectionflex.themenhd div [class*=" bi-"]::before {
font-size: 2em;
vertical-align: middle;
background-color: #f1f3f9;
padding: 10px;
}

.sectionflex.themenhd.background div [class*=" bi-"]::before {
font-size: 2em;
vertical-align: middle;
background-color: #fff;
padding: 10px;
}

.themenhd div a {
display: block
}

.themenhd div:hover {
background: rgb(233, 233, 238, 0.5)
}

/* bootstrap icons in blue and big */
.bi-big,
.fa-big {
font-size: 2rem;
color: #2b80ea
}

ul.smw-format.ul-format.alltopics-col {
column-count: 3;
}

@media (max-width: 767px) {

.sectionflex.col2>div,
.sectionflex.col3>div {
flex-basis: 100%;
margin-top: 2em
}
}

/*Referenz Seiten */
.extension-infobox {
width: 25em;
font-size: 90%;
background-color: #f1f3f9;
color: black;
margin-bottom: 0.5em;
margin-left: 1em;
padding: 0.2em;
float: right;
clear: right;
text-align: left;
}

.extension-infobox-header {
text-align: center;
background-color: #2e6096;
padding: 8px;
color: #ffffff;
}

.extension-infobox-headertext {
font-size: larger;
color: #FFFFFF;
}

.extension-infobox-description {
font-weight: normal !important;
text-align: left;
background-color: #f1f3f9;
padding: 20px 10px 20px 10px !important;
}

.extension-infobox-first-row {
vertical-align: top;
padding: 20px 10px 0 10px;
}

.extension-infobox-row {
vertical-align: top;
padding: 0 10px;
}

.extension-infobox-last-row {
vertical-align: top;
padding: 0 10px 20px 10px;
}

.extension-infobox-helppage {
font-weight: normal;
text-align: center;
vertical-align: top;
padding-left: 10px;
padding-top: 10px;
padding-bottom: 10px;
background-color: #eeeeee;
}

.extension-infobox.fullwidth {
width: 100%;
float: none;
font-size: 1em;
margin-left: 0;
}

.extension-infobox.fullwidth th {
text-align: right;
}

.extension-infobox-header,
.extension-infobox-helppage {
text-align: center !important;
font-size: 1.1em
}

.extension-infobox.fullwidth th,
.extension-infobox.fullwidth td {
padding: 8px;
width: 100px;
border: 1px solid #ffffff;
}

.extension-infobox.fullwidth td {
width: 300px;
}

.extension-infobox-helppage {
background-color: #eaecf0;
}

.flexbox {
display: flex;
flex-direction: row;
flex-wrap: wrap;
justify-content: flex-start;
align-items: stretch;
align-content: stretch;
}

#content #bodyContent #importdata h3 {
margin: 1em 0 1.4em;
}

#importdata .flexbox {
justify-content: space-between;
margin-top: 2em;
}

#mw-content-text #importdata .flexbox h3,
[class^="mw-content-"] #importdata .flexbox h3 {
background: #d8d8d9;
margin: 0 0 12px 0;
padding: 8px;
font-size: 1em !important;
font-weight: bold
}

#importdata .mw li {
margin-left: 0;
list-style-type: none;
padding-left: 30px;
background: no-repeat left 1px top 3px / 18px url('/w/nsfr_img_auth.php/c/c6/MediaWiki-2020-small-icon.svg');
}

#importdata .bs li {
margin-left: 0;
list-style-type: none;
padding-left: 30px;
background: no-repeat left 2px top 4px / 15px url('/w/nsfr_img_auth.php/c/c4/Bluespice_Icon.svg');
}

#importdata .flexbox div {
background: #f1f3f9;
text-align: left;
margin: 0;
flex-basis: 33%;
padding: 0
}

#importdata table.wikitable>tr>th,
#importdata table.wikitable>*>tr>th,
table.wikitable.reference>tr>th,
.importdata .wikitable.reference>*>tr>th {
background-color: #eaecf0;
text-align: left;
padding: 8px;
border: 1px solid #ffffff
}

#importdata table.wikitable>tr>td,
#importdata table.wikitable>*>tr>td,
#importdata table.wikitable.reference>tr>td,
#importdata table.wikitable.reference>*>tr>td {
padding: 8px;
border: 1px solid #ffffff;
}

#importdata div .inner {
padding: 8px 12px
}

#importdata .bs p {
font-size: 0.9rem;
margin-left: 2.1em;
display: list-item;
}

.smwtable-clean {
width: auto;
max-width: 100%;
margin-bottom: 20px;
background-color: transparent;
border-spacing: 0px;
}

.smwtable-clean tr>th {
padding: 8px !important;
line-height: 1.42857143;
vertical-align: top;
border-top: 1px solid #dddddd;
border-collapse: collapse;
border-spacing: 0;
text-align: center;
vertical-align: middle;
}

.smwtable-clean tr>td {
padding: 8px !important;
line-height: 1.42857143;
vertical-align: top;
border-top: 1px solid #dddddd;
border-collapse: collapse;
border-spacing: 0;
}

.smwtable-clean tbody>tr:nth-child(even) {
background-color: #f5f5f5;
}

/*Stile für die Unterseitennavigation über Erweiterung HeaderFooter */
.hf-navbox {
background: #f2f3f9;
padding: 1em;
margin-bottom: 2em
}

.hf-subpages .subpagelist ul {
margin-top: 1em;
margin-bottom: 1em;
column-count: 3
}

#mw-content-text .hf-subpages .subpagelist li {
margin-top: 0
}

.hf-subpages .default {
display: none;
line-height: 0;
overflow: hidden
}

/*avoid empty space if there are no subpages*/
.wcagnote {
border: 1px solid #e9bb06;
padding: 2px 6px;
border-radius: 6px;
background: #fffdeb;
}

/* See ERM45154 */
html {
filter: none !important;
color-scheme: light !important;
}

/*Lingo tooltip */
.qtip {
font-size: 0.9em;
}

Setup:Release Notes

2026-06-24T15:44:59Z

Margit.link-rodrigue:

{{#vardefine:latestpatch|{{#ask: [[-Has subobject::Setup:Release_Notes]]|?Releasepatch|mainlabel=-|format=plainlist|headers=hide|limit=1|searchlabel=|sort=Releasedate|order=desc}}}}
{{Hinweisbox|boxtype=neutral|icon=|Note text=
<span class="bi bi-download"></span> [https://bluespice.com/de/download/ Aktuelle Version herunterladen]<hr />Support:
'''BlueSpice free:''' [https://community.bluespice.com/ community.bluespice.com]
*'''Subskriptionskunden:''' Zur Aktualisierung erstellen Sie bitte ein Ticket mit dem Titel ''Update auf aktuelle BlueSpice Version'' im [https://support.hallowelt.com/login Ticket-System].
|bgcolor=}}
{{Hinweisbox|boxtype=Hinweis|icon=|Note text=Support für BlueSpice 4.x endet am 15. Juli 2026.|bgcolor=}}
{{TOClimit|limit=1|notitle=1|nonum=1|inline=1}}
==5.2.5==
{{#subobject:Release=5|Releasedate=24.06.2026|Releasepatch=5.2.5}}Release-Datum: 24.06.2026
=== BlueSpice Free ===
==== Notable changes ====
*'''EnhancedStandardUIs - Due to the limited display of the version history, not all versions can be compared with one another''' (ERM45987)
:All grids within BlueSpice have been improved and now allow for the display of <code>25</code>, <code>50</code> and <code>100</code> rows. With this improvement, it is now also possible to compare newer versions with older ones.
* '''EnhancedStandardUIs - The latest revision cannot be hidden, but the option to do so is still displayed''' (ERM46644)
: To improve the user experience when it comes to hiding revisions, the icon for hiding the latest revision is now hidden, as this is not technically possible.

==== Bugfixes ====
* '''BlueSpiceBookshelf - Failed to create book pages in parallel using the <code>Add to book</code> action''' (ERM48241)
: If multiple users are editing a book at the same time and adding pages simultaneously using the <code>Add to book</code> action, this now works.
* '''BlueSpiceDiscovery - The language switcher references itself''' (ERM45696)
: The language switcher is working properly again and is displayed automatically as soon as a subpage with a language code is found.
* '''BlueSpiceExtendedSearch - Section links breaks in certain search results''' (ERM47958)
: The section links in the Search center are now displayed correctly again.
*'''BlueSpiceFoundation - Remove DB-schema check on runtime for improving performance''' (ERM47979)
:As part of a performance review,improvements were made to the <code>Extension:BlueSpiceFoundation</code> to enhance performance.
* '''BlueSpiceInsertCategory - Category cannot be set on a file description page''' (ERM47462)
: It is again possible to assign categories on a file description page.
* '''BlueSpicePageAccess - Cache <code>bs-page-access</code> page property for improving performance''' (ERM47582)
: As part of a performance review, improvements were made to the <code>Extension:BlueSpicePageAccess</code> to enhance performance.
* '''BlueSpicePageFormsConnector - Content in a form cannot be edited if a certain text format is used''' (ERM47218)
: If <code>{{{field|content|input type=textarea|editor=visualeditor}}}</code> is used as the text format for a form, it is now possible once again to edit the content properly.
* '''BlueSpiceSaferEdit - BlueSpiceSaferEdit unnecessarily queries edit sessions on special pages which affects performance''' (ERM47485)
: As part of a performance review, improvements were made to the <code>Extension:BlueSpiceSaferEdit</code> to enhance performance.
*'''BlueSpiceSmartList - The ContentDroplet <code>Recent changes</code> displays an error as soon as <code>trim=0</code> is set''' (ERM45585)
:If the ContentDroplet <code>Recent changes</code> is inserted as a tag via the wiki editor with <code>trim = 0</code> is defined, it will still render correctly in view mode.
*'''BlueSpiceUserManager - Deactivating users from <code>Special:UserManager</code> takes 5–10 minutes to complete''' (ERM47927)
:If a user is deactivated via the user management system, this now takes effect immediately. The same applies if a deactivated user is reactivated.
*'''EnhancedStandardUIs - Optimize <code>watchlist state</code> integration in <code>MWStakeComponent Commonwebapis</code> for improving performance''' (ERM47988)
:As part of a performance review, improvements were made to the <code>Extension:EnhancedStandardUIs</code> to enhance performance.
* '''EnhancedUpload - Files used within the ContentDroplet <code>Attachments</code> are not displayed on the file description page''' (ERM46953)
: If files are added to a page within the Content Droplet <code>Attachments</code>, this is now also displayed on the file description page in the <code>File usage</code> section.
* '''EnhancedUpload - The file name param is overwritten by an empty string, which causes the upload to fail''' (ERM48162)
: File uploads are now working properly again.
* '''EnhancedUpload - When uploading a file from the clipboard, issues arise if the file contains a prefix with a colon''' (ERM47949)
: If a file is uploaded from the clipboard to the main namespace, the colon is sanitized so that the upload can proceed.
*'''Docker BlueSpice – The Docker container is missing the <code>EXIF</code> data, which is why portrait-oriented images are rotated incorrectly when uploaded''' (ERM48018)
:Portrait-oriented images are now uploaded correctly again, and the corresponding metadata is also displayed.
*'''MWStakeComponent Commonwebapis - The path to subpages does not expand when searching for a term on <code>Special:Pages</code>''' '(ERM47586)
:If a search term is entered on <code>Special:Pages</code> that matches a subpage, the path is now displayed expanded again.
*'''MWStakeComponent Commonwebapis - Wikis with base language de<code>-formal</code> display empty <code>Special:Pages</code> and <code>Special:File_list</code>''' (ERM48253)
:If <code>de-formal</code> is used as the base language for a wiki, results are now displayed correctly again on <code>Special:Pages</code> and <code>Special:File_list</code>.
* '''MWStakeComponent Datastore - Refactor data stores for improving performance''' (ERM47747)
: As part of the performance review, the datastores were refactored, resulting in enhanced performance.
*'''MWStakeComponent Utils - <code>bs:toplist</code> cannot handle special pages''' (ERM47914)
:The Toplist is now working properly again.
* '''OOJSPlus - The <code>TitleInputWidget</code> on <code>Special:PageTemplatesAdmin</code> does not accept the exact page title''' (ERM48152)
: The title inputfield now accepts the exact page title again when creating a new page template and correctly displays a result for it.

=== BlueSpice Pro ===

==== Noteable changes ====
* '''BlueSpiceExportTables - When exporting very large grids, the export process is not visible''' (ERM47770)
: When exporting very large grids, such as the <code>Wiki Explorer</code> or the <code>Workflow Overview</code>, the export progress is now visible via a progress bar.
* '''Workflows - Add information about which user started the workflow to the Workflows overview''' (ERM44148)
: As part of a feature request, a new column was added to the grid on the workflow overview page that shows which user started the workflow, making this information immediately apparent.

==== Bugfixes ====
* '''BlueSpiceBookshelf - The <code>Add to book</code> action overwrites the entire book context''' (ERM46316)
: The <code>Add to book</code> feature has been improved so that the book must now be explicitly selected first, preventing the book's contents from being overwritten.
* '''BlueSpiceBookshelf - Cache chapter pager for improving performance''' (ERM47984)
: As part of a performance review, improvements were made to the <code>Extension:BlueSpiceBookshelf</code> to enhance performance..
* '''BlueSpiceCategoryManager - The Category manager triggers a large number of API requests when renaming or deleting categories''' (ERM48429)
: Renaming or deleting categories that are associated with a very large number of pages now works properly again, as long as the user performing the action is in a group with the permission noratelimit.
* '''BlueSpiceFilterableTables - Content within filterable tables is truncated and the use of queries results in limited display of results''' (ERM45005)
: Text truncation within filterable tables is now prevented. Furthermore, this ticket also fixed an issue where queries within filterable tables were not working properly and the query results were not displayed correctly.
* '''BlueSpiceFilterableTables - If a table is filterable and sortable, not all links within a cell are displayed in view mode''' (ERM47082)
: If a filterable and sortable table is inserted on a page that contains more than one link in a single cell, all links are now displayed correctly in view mode.
* '''BlueSpiceFilterableTables - Glossary terms break cell content within a filterable table''' (ERM45625)
: If defined terms from the glossary are used within a filterable table, the remaining content is now also displayed correctly.
*'''BlueSpiceFilterableTables - Using queries in filterable tables results in limited display of results''' (ERM47970)
:Queries used within filterable tables now display all results correctly again. Furthermore, using links is working properly again.
*'''MWStakeComponent Wikitext - The workflow activity <code>SetTemplateParams</code> workflow activity does not work correctly in certain cases''' (ERM48044)
:The <code>SetTemplateParams</code> workflow activity is now working properly again.
*'''MWStakeComponent Wikitext - Workflow user roles fail to be set if they contain non-ASCII-characters''' (ERM48087)
:If user roles within a workflow contain non-ASCII characters, they are now set correctly again.
* '''NSFileRepo - Upload does not respect <code>wpDestFile</code>''' (ERM48242)
: If a new version of a file is uploaded with a different filename than the original, the new file will be correctly assigned and will not be uploaded separately.
*'''NSFileRepo - Align new <code>PageForms</code> upload dialog with Media dialog''' (ERM46059)
:The new upload dialog for <code>PageForms</code> has been adapted to match the standard media dialog to ensure consistency within the application and improve user-friendliness.
*'''NSFileRepo - The <code>delete</code> and <code>revert</code> links for old images are broken in the version history for the file description page''' (ERM46067)
:The delete and revert links are now correctly displayed on the version history of the file description page.
* '''Workflows - Cache and defer trigger evaluation for improving performance''' (ERM47983)
: As part of a performance review, improvements were made to the <code>Extension:Workflows</code> to enhance performance.

=== BlueSpice Farm ===

==== Noteable changes ====
* '''BlueSpiceTranslationTransfer - Improve the translation mechanism to reduce translation artifacts and implement the ability to configure translations for specific templates''' (ERM45815)
: The translation mechanism has been redesigned, which should improve translation quality and the number of “translation artifacts” should be significantly reduced. In addition, the ability to configure the translation of specific arguments for specific templates has been added. For more information, please refer to the Helpdesk.

==== Bugfixes ====

* '''BlueSpiceWikiFarm - Content transfer doesn't work for specific namespaces''' (ERM43866)
: It is now possible to transfer the contents of the namespaces <code>Blog</code>, <code>Forms</code> and <code>MediaWiki</code> to other farm instances.
* '''ContentTransfer - Cryptic error message when content cannot be transferred''' (ERM42421)
: Content transfer has been improved in terms of error messages displayed when a transfer fails; readable messages are now shown that indicate why the transfer didn't work.

==5.1.9 ==
{{#subobject:Release=5|Releasedate=24.06.2026|Releasepatch=5.1.9}}Release-Datum: 24.06.2026
=== BlueSpice Free ===
==== Notable changes ====
*'''EnhancedStandardUIs - Due to the limited display of the version history, not all versions can be compared with one another''' (ERM45987)
:All grids within BlueSpice have been improved and now allow for the display of <code>25</code>, <code>50</code> and <code>100</code> rows. With this improvement, it is now also possible to compare newer versions with older ones.
* '''EnhancedStandardUIs - The latest revision cannot be hidden, but the option to do so is still displayed''' (ERM46644)
: To improve the user experience when it comes to hiding revisions, the icon for hiding the latest revision is now hidden, as this is not technically possible.

==== Bugfixes ====
* '''BlueSpiceBookshelf - Failed to create book pages in parallel using the <code>Add to book</code> action''' (ERM48241)
: If multiple users are editing a book at the same time and adding pages simultaneously using the <code>Add to book</code> action, this now works.
* '''BlueSpiceDiscovery - The language switcher references itself''' (ERM45696)
: The language switcher is working properly again and is displayed automatically as soon as a subpage with a language code is found.
* '''BlueSpiceExtendedSearch - Section links breaks in certain search results''' (ERM47958)
: The section links in the Search center are now displayed correctly again.
*'''BlueSpiceFoundation - Remove DB-schema check on runtime for improving performance''' (ERM47979)
:As part of a performance review,improvements were made to the <code>Extension:BlueSpiceFoundation</code> to enhance performance.
* '''BlueSpiceInsertCategory - Category cannot be set on a file description page''' (ERM47462)
: It is again possible to assign categories on a file description page.
* '''BlueSpicePageAccess - Cache <code>bs-page-access</code> page property for improving performance''' (ERM47582)
: As part of a performance review, improvements were made to the <code>Extension:BlueSpicePageAccess</code> to enhance performance.
* '''BlueSpicePageFormsConnector - Content in a form cannot be edited if a certain text format is used''' (ERM47218)
: If <code>{{{field|content|input type=textarea|editor=visualeditor}}}</code> is used as the text format for a form, it is now possible once again to edit the content properly.
* '''BlueSpiceSaferEdit - BlueSpiceSaferEdit unnecessarily queries edit sessions on special pages which affects performance''' (ERM47485)
: As part of a performance review, improvements were made to the <code>Extension:BlueSpiceSaferEdit</code> to enhance performance.
*'''BlueSpiceSmartList - The ContentDroplet <code>Recent changes</code> displays an error as soon as <code>trim=0</code> is set''' (ERM45585)
:If the ContentDroplet <code>Recent changes</code> is inserted as a tag via the wiki editor with <code>trim = 0</code> is defined, it will still render correctly in view mode.
*'''BlueSpiceUserManager - Deactivating users from <code>Special:UserManager</code> takes 5–10 minutes to complete''' (ERM47927)
:If a user is deactivated via the user management system, this now takes effect immediately. The same applies if a deactivated user is reactivated.
*'''EnhancedStandardUIs - Optimize <code>watchlist state</code> integration in <code>MWStakeComponent Commonwebapis</code> for improving performance''' (ERM47988)
:As part of a performance review, improvements were made to the <code>Extension:EnhancedStandardUIs</code> to enhance performance.
* '''EnhancedUpload - Files used within the ContentDroplet <code>Attachments</code> are not displayed on the file description page''' (ERM46953)
: If files are added to a page within the Content Droplet <code>Attachments</code>, this is now also displayed on the file description page in the <code>File usage</code> section.
* '''EnhancedUpload - The file name param is overwritten by an empty string, which causes the upload to fail''' (ERM48162)
: File uploads are now working properly again.
* '''EnhancedUpload - When uploading a file from the clipboard, issues arise if the file contains a prefix with a colon''' (ERM47949)
: If a file is uploaded from the clipboard to the main namespace, the colon is sanitized so that the upload can proceed.
*'''Docker BlueSpice – The Docker container is missing the <code>EXIF</code> data, which is why portrait-oriented images are rotated incorrectly when uploaded''' (ERM48018)
:Portrait-oriented images are now uploaded correctly again, and the corresponding metadata is also displayed.
*'''MWStakeComponent Commonwebapis - The path to subpages does not expand when searching for a term on <code>Special:Pages</code>''' '(ERM47586)
:If a search term is entered on <code>Special:Pages</code> that matches a subpage, the path is now displayed expanded again.
*'''MWStakeComponent Commonwebapis - Wikis with base language de<code>-formal</code> display empty <code>Special:Pages</code> and <code>Special:File_list</code>''' (ERM48253)
:If <code>de-formal</code> is used as the base language for a wiki, results are now displayed correctly again on <code>Special:Pages</code> and <code>Special:File_list</code>.
* '''MWStakeComponent Datastore - Refactor data stores for improving performance''' (ERM47747)
: As part of the performance review, the datastores were refactored, resulting in enhanced performance.
*'''MWStakeComponent Utils - <code>bs:toplist</code> cannot handle special pages''' (ERM47914)
:The Toplist is now working properly again.
* '''OOJSPlus - The <code>TitleInputWidget</code> on <code>Special:PageTemplatesAdmin</code> does not accept the exact page title''' (ERM48152)
: The title inputfield now accepts the exact page title again when creating a new page template and correctly displays a result for it.

=== BlueSpice Pro ===

==== Noteable changes ====
* '''BlueSpiceExportTables - When exporting very large grids, the export process is not visible''' (ERM47770)
: When exporting very large grids, such as the <code>Wiki Explorer</code> or the <code>Workflow Overview</code>, the export progress is now visible via a progress bar.
* '''Workflows - Add information about which user started the workflow to the Workflows overview''' (ERM44148)
: As part of a feature request, a new column was added to the grid on the workflow overview page that shows which user started the workflow, making this information immediately apparent.

==== Bugfixes ====
* '''BlueSpiceBookshelf - The <code>Add to book</code> action overwrites the entire book context''' (ERM46316)
: The <code>Add to book</code> feature has been improved so that the book must now be explicitly selected first, preventing the book's contents from being overwritten.
* '''BlueSpiceBookshelf - Cache chapter pager for improving performance''' (ERM47984)
: As part of a performance review, improvements were made to the <code>Extension:BlueSpiceBookshelf</code> to enhance performance..
* '''BlueSpiceCategoryManager - The Category manager triggers a large number of API requests when renaming or deleting categories''' (ERM48429)
: Renaming or deleting categories that are associated with a very large number of pages now works properly again, as long as the user performing the action is in a group with the permission noratelimit.
* '''BlueSpiceFilterableTables - Content within filterable tables is truncated and the use of queries results in limited display of results''' (ERM45005)
: Text truncation within filterable tables is now prevented. Furthermore, this ticket also fixed an issue where queries within filterable tables were not working properly and the query results were not displayed correctly.
* '''BlueSpiceFilterableTables - If a table is filterable and sortable, not all links within a cell are displayed in view mode''' (ERM47082)
: If a filterable and sortable table is inserted on a page that contains more than one link in a single cell, all links are now displayed correctly in view mode.
* '''BlueSpiceFilterableTables - Glossary terms break cell content within a filterable table''' (ERM45625)
: If defined terms from the glossary are used within a filterable table, the remaining content is now also displayed correctly.
*'''BlueSpiceFilterableTables - Using queries in filterable tables results in limited display of results''' (ERM47970)
:Queries used within filterable tables now display all results correctly again. Furthermore, using links is working properly again.
*'''MWStakeComponent Wikitext - The workflow activity <code>SetTemplateParams</code> workflow activity does not work correctly in certain cases''' (ERM48044)
:The <code>SetTemplateParams</code> workflow activity is now working properly again.
*'''MWStakeComponent Wikitext - Workflow user roles fail to be set if they contain non-ASCII-characters''' (ERM48087)
:If user roles within a workflow contain non-ASCII characters, they are now set correctly again.
* '''NSFileRepo - Upload does not respect <code>wpDestFile</code>''' (ERM48242)
: If a new version of a file is uploaded with a different filename than the original, the new file will be correctly assigned and will not be uploaded separately.
*'''NSFileRepo - Align new <code>PageForms</code> upload dialog with Media dialog''' (ERM46059)
:The new upload dialog for <code>PageForms</code> has been adapted to match the standard media dialog to ensure consistency within the application and improve user-friendliness.
*'''NSFileRepo - The <code>delete</code> and <code>revert</code> links for old images are broken in the version history for the file description page''' (ERM46067)
:The delete and revert links are now correctly displayed on the version history of the file description page.
* '''Workflows - Cache and defer trigger evaluation for improving performance''' (ERM47983)
: As part of a performance review, improvements were made to the <code>Extension:Workflows</code> to enhance performance.

=== BlueSpice Farm ===

==== Noteable changes ====
* '''BlueSpiceTranslationTransfer - Improve the translation mechanism to reduce translation artifacts and implement the ability to configure translations for specific templates''' (ERM45815)
: The translation mechanism has been redesigned, which should improve translation quality and the number of “translation artifacts” should be significantly reduced. In addition, the ability to configure the translation of specific arguments for specific templates has been added. For more information, please refer to the Helpdesk.

==== Bugfixes ====

* '''BlueSpiceWikiFarm - Content transfer doesn't work for specific namespaces''' (ERM43866)
: It is now possible to transfer the contents of the namespaces <code>Blog</code>, <code>Forms</code> and <code>MediaWiki</code> to other farm instances.
* '''ContentTransfer - Cryptic error message when content cannot be transferred''' (ERM42421)
: Content transfer has been improved in terms of error messages displayed when a transfer fails; readable messages are now shown that indicate why the transfer didn't work.

==5.2.4 ==
{{#subobject:Release=5|Releasedate=26.05.2026|Releasepatch=5.2.4}}Release-Datum: 26.05.2026
=== BlueSpice Free ===
* '''BlueSpiceDiscovery - The enhanced MediaWiki sidebar does not properly respect the specified permissions''' (ERM47005)
: When using the enhanced MediaWiki sidebar, entries in the left navigation are now displayed correctly again based on a user's permissions or group membership.
* '''BlueSpiceDiscovery - The red dot is not displayed although a user is assigned a new task or workflow''' (ERM47044)
: The red dot will now appear correctly in the user menu again as soon as a task or workflow has been assigned.
* '''BlueSpiceExtendedSearch - ContentDroplet <code>Search in a book</code> doesn't display results''' (ERM46574)
: The Content Droplet <code>Search in a book</code> now displays results correctly again.
* '''BlueSpiceFoundation - Allow clientside caching of avatar image for improving performance''' (ERM47494)
: As part of a performance review, improvements were made to <code>Extension:UserProfile</code>, <code>Extension:BlueSpiceQrCode</code>, <code>Extension:BlueSpiceFoundation</code>, <code>Extension:BlueSpiceDiscovery</code> and <code>Extension:BlueSpiceAvatars</code> resulting in enhanced performance for BlueSpice.
*'''BlueSpice MediaWiki - Gallery does not display images from the custom namespace in slideshow mode''' (ERM44938)
:Images from custom namespaces are now displayed correctly in the gallery when using the slideshow.
*'''BlueSpicePermissionManager - No search results displayed for wiki pages in certain namespaces''' (ERM47896)
:If a user has reading permissions for a custom namespace, the search results will be displayed correctly in the Search center.
* '''BlueSpiceSmartList - If a category is set as a filter for the SmartList or Toplist, no results are displayed''' (ERM47042)
: Both the Smart List and the Top List now display correct results again when a category is selected as a filter.
* '''BlueSpiceSmartList - Optimize database queries for improving performance''' (ERM47492)
: As part of a performance review, improvements were made to the <code>Extension:BlueSpiceSmartList</code>, resulting in enhanced performance for BlueSpice.
* '''EnhancedUpload - Files used within the ContentDroplet <code>Attachments</code> are not displayed on the file description page''' (ERM46953)
: If files are added to a page within the Content Droplet <code>Attachments</code>, this is now also displayed on the file description page in the <code>File usage</code> section.
* '''EnhancedUpload - If an existing file is uploaded, this will result in the loss of the assigned categories and / or description''' (ERM47252)
: If an existing file is uploaded that already has categories assigned and / or a description added, the categories as well as description will not be overwritten during the upload unless new categories or a new description are specified.
*'''MWStakeComponent - Anonymous users and users in certain groups do not receive search results on <code>Special:SearchCenter</code>''' (ERM47794)
: Anonymous users with read permissions, as well as users in groups with read permissions, will now see search results displayed correctly again on <code>Special:SearchCenter</code>.
* '''MWStakeComponent - Optimize "display title" lookup for improving performance''' (ERM47495)
: As part of a performance review, improvements were made to <code>Extension:PreviewLinks</code>, <code>Extension:BlueSpiceBookshelf</code>, <code>Extension:BlueSpiceExtendedSearch</code>, <code>Extension:Workflows</code>, <code>Extension:BlueSpiceSmartList</code> and <code>Extension:SimpleBlogPage</code>, resulting in enhanced performance for BlueSpice.
* '''NotifyMe - Remove duplicate database queries for improving performance''' (ERM47486)
: As part of a performance review, improvements were made to the <code>Extension:NotifyMe</code>, resulting in enhanced performance for BlueSpice.
*'''NotifyMe - Images used in emails instead of logos are not embedded''' (ERM43936)
:When using custom images instead of logos in emails, they are now embedded correctly.
*'''UX BlueSpiceExtendedSearch - Improve inspector for Content Droplet <code>Search field</code> and fix issue with removing categories''' (ERM45081)
:In course of an UX review of BlueSpice, the inspector for the Content Droplet <code>Search field</code> has been improved. In addition it is now possible again to remove categories from the inspector.
*'''VisualEditorPlus - The inline inspector overlaps the dialog when linking a page''' (ERM47946)
:When editing a wiki page, the text to be linked is selected, and the inline inspector opens first so that additional formatting can be applied if needed. As soon as the user clicks the <code>Link</code> button in the visual editor's toolbar, the inline inspector is hidden so that it does not obscure the link dialog when creating a link.
=== BlueSpice Pro ===

* '''BlueSpiceBookshelf - When an old book revision is opened, the current revision is always displayed''' (ERM47270)
: If an old book revision is opened via the version history, it displays the correct version. In addition, a message appears indicating that you are editing an older version.
* '''BlueSpiceBookshelf - If a book is renamed via its metadata, this change is not displayed correctly in the book navigation''' (ERM47232)
: If a book is renamed in the metadata, this will be correctly reflected in the book navigation.
* '''CollabPads - Add proper DB indexes for improving performance''' (ERM47493)
: As part of a performance review, improvements were made to the <code>Extension:CollabPads</code>, resulting in enhanced performance for BlueSpice.
*'''ContentStabilization - Add proper DB indexes for improving performance''' (ERM47488)
:As part of a performance review, improvements were made to the <code>Extension:ContentStabilization</code>, resulting in enhanced performance for BlueSpice.
* '''ContentStabilization - <code>Special:PageAssignments</code> does not display any assigned pages''' (ERM47540)
: Pages assigned to a user are now displayed correctly again on <code>Special:PageAssignments</code>.
*'''ContentStabilization - Page with a draw.io diagram breaks after approval''' (ERM47666)
:If a page containing a draw.io diagram is approved, this will now work properly again.
*'''Forms - Re-add "form input value derived page titles" in <code>Extension:Forms</code>''' (ERM44368)
:The form editor now allows to specify target titles using a predefined title field and a mask for target titles. Although this form does not offer a specific target page, a banner appears indicating that a predefined target title exists, along with a display of the form.
*'''NSFileRepo - Uploading a duplicate to a custom namespace results in an incorrect link in the warning''' (ERM43056)
:If a duplicate file is uploaded again to a custom namespace, the warning now displays the correct file link.
* '''NSFileRepo - File list does not load with a specific permissions configuration''' (ERM47660)
: The file list is now displayed correctly again.
* '''NSFileRepo - File list does not load with a specific permissions configuration''' (ERM47660)
: The file list is now displayed correctly again.
* '''PageCheckout - Add proper DB indexes for improving performance''' (ERM47489)
: As part of a performance review, improvements were made to the <code>Extension:PageCheckout</code>, resulting in enhanced performance for BlueSpice.
* '''PageForms - Form editing is not available in the new version of <code>Extension:PageForms</code>''' (ERM47776)
: Form editing is now working properly again.
* '''VueJsPlus - Improve the indentation of the individual chapters in the book tree''' (ERM43297)
: When viewing the book structure in the book tree, the indentation of the individual chapters is now consistent and always at the same level.
* '''Workflows - Potential performance issue in <code>Extension:Workflows</code>''' (ERM44330)
: As part of a performance review, improvements were made to the <code>Extension:Workflows</code>, resulting in enhanced performance for BlueSpice.

==5.1.8 ==
{{#subobject:Release=5|Releasedate=26.05.2026|Releasepatch=5.1.8}}

Release-Datum: 26.05.2026
=== BlueSpice Free ===
* '''BlueSpiceDiscovery - The enhanced MediaWiki sidebar does not properly respect the specified permissions''' (ERM47005)
: When using the enhanced MediaWiki sidebar, entries in the left navigation are now displayed correctly again based on a user's permissions or group membership.
* '''BlueSpiceDiscovery - The red dot is not displayed although a user is assigned a new task or workflow''' (ERM47044)
: The red dot will now appear correctly in the user menu again as soon as a task or workflow has been assigned.
* '''BlueSpiceFoundation - Allow clientside caching of avatar image for improving performance''' (ERM47494)
: As part of a performance review, improvements were made to <code>Extension:UserProfile</code>, <code>Extension:BlueSpiceQrCode</code>, <code>Extension:BlueSpiceFoundation</code>, <code>Extension:BlueSpiceDiscovery</code> and <code>Extension:BlueSpiceAvatars</code> resulting in enhanced performance for BlueSpice.
*'''BlueSpice MediaWiki - Gallery does not display images from the custom namespace in slideshow mode''' (ERM44938)
:Images from custom namespaces are now displayed correctly in the gallery when using the slideshow.
*'''BlueSpicePermissionManager - No search results displayed for wiki pages in certain namespaces''' (ERM47896)
:If a user has reading permissions for a custom namespace, the search results will be displayed correctly in the Search center.
* '''BlueSpiceSmartList - Optimize database queries for improving performance''' (ERM47492)
: As part of a performance review, improvements were made to the <code>Extension:BlueSpiceSmartList</code>, resulting in enhanced performance for BlueSpice.
* '''EnhancedUpload - Files used within the ContentDroplet <code>Attachments</code> are not displayed on the file description page''' (ERM46953)
: If files are added to a page within the Content Droplet <code>Attachments</code>, this is now also displayed on the file description page in the <code>File usage</code> section.
* '''EnhancedUpload - If an existing file is uploaded, this will result in the loss of the assigned categories and / or description''' (ERM47252)
: If an existing file is uploaded that already has categories assigned and / or a description added, the categories as well as description will not be overwritten during the upload unless new categories or a new description are specified.
*'''MWStakeComponent - Anonymous users and users in certain groups do not receive search results on <code>Special:SearchCenter</code>''' (ERM47794)
: Anonymous users with read permissions, as well as users in groups with read permissions, will now see search results displayed correctly again on <code>Special:SearchCenter</code>.
* '''MWStakeComponent - Optimize "display title" lookup for improving performance''' (ERM47495)
: As part of a performance review, improvements were made to <code>Extension:PreviewLinks</code>, <code>Extension:BlueSpiceBookshelf</code>, <code>Extension:BlueSpiceExtendedSearch</code>, <code>Extension:Workflows</code>, <code>Extension:BlueSpiceSmartList</code> and <code>Extension:SimpleBlogPage</code>, resulting in enhanced performance for BlueSpice.
*'''NotifyMe - Images used in emails instead of logos are not embedded''' (ERM43936)
:When using custom images instead of logos in emails, they are now embedded correctly.
* '''NotifyMe - Remove duplicate database queries for improving performance''' (ERM47486)
: As part of a performance review, improvements were made to the <code>Extension:NotifyMe</code>, resulting in enhanced performance for BlueSpice.
*'''VisualEditorPlus - The inline inspector overlaps the dialog when linking a page''' (ERM47946)
:When editing a wiki page, the text to be linked is selected, and the inline inspector opens first so that additional formatting can be applied if needed. As soon as the user clicks the <code>Link</code> button in the visual editor's toolbar, the inline inspector is hidden so that it does not obscure the link dialog when creating a link.
=== BlueSpice Pro ===
* '''BlueSpiceBookshelf - When an old book revision is opened, the current revision is always displayed''' (ERM47270)
: If an old book revision is opened via the version history, it displays the correct version. In addition, a message appears indicating that you are editing an older version.
* '''BlueSpiceBookshelf - If a book is renamed via its metadata, this change is not displayed correctly in the book navigation''' (ERM47232)
: If a book is renamed in the metadata, this will be correctly reflected in the book navigation.
* '''CollabPads - Add proper DB indexes for improving performance''' (ERM47493)
: As part of a performance review, improvements were made to the <code>Extension:CollabPads</code>, resulting in enhanced performance for BlueSpice.
*'''ContentStabilization - Add proper DB indexes for improving performance''' (ERM47488)
:As part of a performance review, improvements were made to the <code>Extension:ContentStabilization</code>, resulting in enhanced performance for BlueSpice.
*'''Forms - Re-add "form input value derived page titles" in <code>Extension:Forms</code>''' (ERM44368)
:The form editor now allows to specify target titles using a predefined title field and a mask for target titles. Although this form does not offer a specific target page, a banner appears indicating that a predefined target title exists, along with a display of the form.
*'''NSFileRepo - Uploading a duplicate to a custom namespace results in an incorrect link in the warning''' (ERM43056)
:If a duplicate file is uploaded again to a custom namespace, the warning now displays the correct file link.
* '''NSFileRepo - File list does not load with a specific permissions configuration''' (ERM47660)
: The file list is now displayed correctly again.
* '''PageCheckout - Add proper DB indexes for improving performance''' (ERM47489)
: As part of a performance review, improvements were made to the <code>Extension:PageCheckout</code>, resulting in enhanced performance for BlueSpice.
* '''PageForms - Form editing is not available in the new version of <code>Extension:PageForms</code>''' (ERM47776)
: Form editing is now working properly again.
* '''VueJsPlus - Improve the indentation of the individual chapters in the book tree''' (ERM43297)
: When viewing the book structure in the book tree, the indentation of the individual chapters is now consistent and always at the same level.
* '''Workflows - Potential performance issue in <code>Extension:Workflows</code>''' (ERM44330)
: As part of a performance review, improvements were made to the <code>Extension:Workflows</code>, resulting in enhanced performance for BlueSpice.

==5.2.3 ==
{{#subobject:Release=5|Releasedate=16.04.2026|Releasepatch=5.2.3}}Release-Datum: 22.04.2026
=== BlueSpice Free ===

==== Noteable changes ====
* '''StandardDialogs - Moving a page caused a new page to be accidentally created due to automatic renaming''' (ERM46880)
: The behavior when moving a page has been improved by removing the placeholder <code>(2)</code>. The dialog box already prevents duplicate page names. Pages can now be moved more easily.
==== Bugfixes ====
* '''BlueSpiceDiscovery - Missing styling for page categories when displayed in title area''' (ERM45213)
: If the configuration specifies that categories should be displayed in the header section of a page, they will now be displayed with the correct styling again.
* '''BlueSpiceDiscovery - Mobile view of mega menus contains too much whitespace''' (ERM46894)
: The mobile view of the mega menus has been improved in regard to whitespace.
* '''BlueSpiceDiscovery - Add more space between sticky header and header bar''' (ERM46977)
: The spacing between the sticky header and the header bar has been improved.
* '''BlueSpiceNamespaceManager - Content namespace setting cannot be disabled for namespace <code>Blog</code>''' (ERM43028)
: It is now possible again to edit the Content namespace setting for the <code>Blog</code> namespace.
* '''BlueSpiceNamespaceManager - Read confirmation gets enabled automatically in all custom namespaces''' (ERM46966)
: If the settings for read confirmation are edited in a custom namespace, this no longer affects other custom namespaces.
*'''BlueSpiceNamespaceManager - It's not possible to unset alias''' (ERM44800)
:If an alias is set in the Namespace manager, it can also be unset.
*'''BlueSpicePageTemplates - Search for templates does not display the expected results''' (ERM43772)
:Searching for templates (with or without a prefix) on <code>Special:PageTemplatesAdmin</code> works again and displays results as expected.
* '''BlueSpiceSaferEdit - A banner about a collaborative editing session is displayed to users without editing permissions''' (ERM39261)
: If a collaborative editing session is taking place on a page, a banner displaying this information will only appear if a user has permission to edit that page.
*'''BlueSpiceUserManager - It's not possible to filter by groups on <code>Special:UserManager</code>''' (ERM46520)
:Filtering by groups in the user manager is now possible again.
* '''FlexiSkin - Whitelisting the logo and favicon does not work''' (ERM46324)
: Whitelisting the logo and favicon set via FlexiSkin works, so they are displayed to unauthenticated users.
*'''MWStake Component Commonwebapis - Files that a user is not permitted to read are masked but still appear in the file list''' (ERM46692)
:If a user does not have permission to view a file, it will no longer appear in the file list.
*'''MWStake Component Commonwebapis - It is not possible to filter the file list by namespace''' (ERM47144)
:It is now possible again to filter the file list by namespace, as requested.
*'''MWStake Component Inputprocessor – Unhandled null return value when a tag uses the <code>CategoryListValue</code> attribute''' (ERM46843)
:If a tag with the <code>CategoryListValue</code> attribute is used, an error message will be displayed if it is used incorrectly.
* '''OOJSPlus - Subpage tree ignores displaytitle set''' (ERM44476)
: If a subpage tree is used (the subpage tree from ConfigManager as well as the subpage tree within the Enhanced MediaWiki sidebar) and a displaytitle is set for a page, this title is now respected and displayed correctly in the left navigation.

=== BlueSpice Pro ===

==== Noteable changes ====
* '''BlueSpicePageAccess/PageForms/SemanticMediaWiki - Potential information disclosure via <code>Special:FormEdit</code> despite page access restrictions''' (ERM46929)
:Access checks on <code>Special:FormEdit</code>, <code>Special:Browse</code> and property pages have been improved to avoid potential information disclosure.
*'''Workflows - Introduce a tag that prevents a workflow from being executed using workflow triggers''' (ERM42643)
: A new tag has been introduced that prevents a workflow from bein executed automatically if a workflow trigger is set up. This tag is <code>__NOWORKFLOWEXECUTE__</code>, which can be inserted in the source editor. More information is available on the Helpdesk.

==== Bugfixes ====
* '''BlueSpiceBookshelf - Optimize <code>ApiBooksOverviewStore</code> to improve performance''' (ERM46612)
: The API <code>ApiBooksOverviewStore</code> has been improved to enhance performance.
* '''BlueSpiceBookshelf - Selected chapter is no longer highlighted in book navigation''' (ERM46677)
:If a book chapter is selected in the book navigation, it is visually highlighted again.
* '''BlueSpiceBookshelf - Selecting a book from <code>Special:Books</code> forwards to MenuEditor''' (ERM47231)
: When a book is selected in the book overview, the user is automatically forwarded to the first page of the book again.
* '''BlueSpiceInsertCategory - Enable categorization of non-wikitext pages''' (ERM44996)
: It is now possible to add categories to non-wikitext pages as well. This applies, for example, to pages in the <code>Book</code> as well as pages in the <code>MediaWiki</code> namespace.
* '''BlueSpiceReadConfirmation - Minor edit incorrectly triggers a read confirmation''' (ERM44689)
: If an edit is marked as a minor edit, it no longer triggers a read confirmation. Only major edits trigger a read confirmation for the specified users.
* '''BlueSpiceUEModuleTable2Excel - When using the checklist in a table, the selected values are not exported correctly''' (ERM46334)
: When the Content Droplet <code>Checklist</code> is used within a table, the selected values are now displayed correctly in the exported file.
*'''CognitiveProcessDesigner - Improve description page title validation''' (ERM45534)
:If the process name is too long or contains invalid characters, the creation of description pages will be skipped and a warning is displayed instead.
* '''DrawioEditor - Drawio editor fails to load certain SVGs''' (ERM46659)
: Loading SVGs in the Drawio editor is working properly again.
* '''CognitiveProcessDesigner - Catgories cannot be added to process pages''' (ERM42754)
: Categories can now be added to process pages.
* '''NSFileRepo - Misleading message from the browser stating that information will be lost when trying to save a form''' (ERM46654)
: If a form is edited and the changes are subsequently saved, the misleading browser hint about unsaved changes will no longer be displayed.
* '''SimpleBlogPage - The entrypoint <code>Blog</code> is displayed although although a user does not have the permission to read the namespace <code>Blogs</code>''' (ERM45623)
: The visibility of the <code>Blogs</code> entrypoint now depends on a user's read permissions. Similarly, the action to create a new blog post in the split button is now protected by permissions.

=== BlueSpice Farm ===
* '''BlueSpiceWikiFarm - ContentTransfer is not showing instances that are created from existing wiki''' (ERM43401)
: Cloned instances are now also displayed again in the selection of the receiving wiki on the page <code>Special:ContentTransfer</code>.
* '''BlueSpiceWikiFarm - Breadcrumb styling is broken when creating a new instance via <code>Special:Farm_management</code>''' (ERM45581)
: When creating a new instance via <code>Special:Farm_management</code>, the breadcrumb styling is now displayed correctly again.

==5.1.7 ==
{{#subobject:Release=5|Releasedate=16.04.2026|Releasepatch=5.1.7}}Release-Datum: 22.04.2026
=== BlueSpice Free ===

==== Noteable changes ====
* '''StandardDialogs - Moving a page caused a new page to be accidentally created due to automatic renaming''' (ERM46880)
: The behavior when moving a page has been improved by removing the placeholder <code>(2)</code>. The dialog box already prevents duplicate page names. Pages can now be moved more easily.
==== Bugfixes ====
* '''BlueSpiceDiscovery - Missing styling for page categories when displayed in title area''' (ERM45213)
: If the configuration specifies that categories should be displayed in the header section of a page, they will now be displayed with the correct styling again.
* '''BlueSpiceDiscovery - Mobile view of mega menus contains too much whitespace''' (ERM46894)
: The mobile view of the mega menus has been improved in regard to whitespace.
* '''BlueSpiceDiscovery - Add more space between sticky header and header bar''' (ERM46977)
: The spacing between the sticky header and the header bar has been improved.
* '''BlueSpiceNamespaceManager - Content namespace setting cannot be disabled for namespace <code>Blog</code>''' (ERM43028)
: It is now possible again to edit the Content namespace setting for the <code>Blog</code> namespace.
* '''BlueSpiceNamespaceManager - Read confirmation gets enabled automatically in all custom namespaces''' (ERM46966)
: If the settings for read confirmation are edited in a custom namespace, this no longer affects other custom namespaces.
*'''BlueSpicePageTemplates - Search for templates does not display the expected results''' (ERM43772)
:Searching for templates (with or without a prefix) on <code>Special:PageTemplatesAdmin</code> works again and displays results as expected.
* '''BlueSpiceSaferEdit - A banner about a collaborative editing session is displayed to users without editing permissions''' (ERM39261)
: If a collaborative editing session is taking place on a page, a banner displaying this information will only appear if a user has permission to edit that page.
* '''FlexiSkin - Whitelisting the logo and favicon does not work''' (ERM46324)
: Whitelisting the logo and favicon set via FlexiSkin works, so they are displayed to unauthenticated users.
*'''MWStake Component Commonwebapis - Files that a user is not permitted to read are masked but still appear in the file list''' (ERM46692)
:If a user does not have permission to view a file, it will no longer appear in the file list.
*'''MWStake Component Commonwebapis - It is not possible to filter the file list by namespace''' (ERM47144)
:It is now possible again to filter the file list by namespace, as requested.
*'''MWStake Component Inputprocessor – Unhandled null return value when a tag uses the <code>CategoryListValue</code> attribute''' (ERM46843)
:If a tag with the <code>CategoryListValue</code> attribute is used, an error message will be displayed if it is used incorrectly.
* '''OOJSPlus - Subpage tree ignores displaytitle set''' (ERM44476)
: If a subpage tree is used (the subpage tree from ConfigManager as well as the subpage tree within the Enhanced MediaWiki sidebar) and a displaytitle is set for a page, this title is now respected and displayed correctly in the left navigation.

=== BlueSpice Pro ===

==== Noteable changes ====
* '''BlueSpicePageAccess/PageForms/SemanticMediaWiki - Potential information disclosure via <code>Special:FormEdit</code> despite page access restrictions''' (ERM46929)
:Access checks on <code>Special:FormEdit</code>, <code>Special:Browse</code> and property pages have been improved to avoid potential information disclosure.
*'''Workflows - Introduce a tag that prevents a workflow from being executed using workflow triggers''' (ERM42643)
: A new tag has been introduced that prevents a workflow from running automatically if a workflow trigger is set up. This tag is <code>__NOWORKFLOWEXECUTE__</code>, which can be inserted in the source editor. More information is available on the Helpdesk.

==== Bugfixes ====
* '''BlueSpiceBookshelf - Optimize <code>ApiBooksOverviewStore</code> to improve performance''' (ERM46612)
: The API <code>ApiBooksOverviewStore</code> has been improved to enhance performance.
* '''BlueSpiceBookshelf - Selected chapter is no longer highlighted in book navigation''' (ERM46677)
:If a book chapter is selected in the book navigation, it is visually highlighted again.
* '''BlueSpiceBookshelf - Selecting a book from <code>Special:Books</code> forwards to MenuEditor''' (ERM47231)
: When a book is selected in the book overview, the user is automatically forwarded to the first page of the book again.
* '''BlueSpiceInsertCategory - Enable categorization of non-wikitext pages''' (ERM44996)
: It is now possible to add categories to non-wikitext pages as well. This applies, for example, to pages in the <code>Book</code> as well as pages in the <code>MediaWiki</code> namespace.
* '''BlueSpiceReadConfirmation - Minor edit incorrectly triggers a read confirmation''' (ERM44689)
: If an edit is marked as a minor edit, it no longer triggers a read confirmation. Only major edits trigger a read confirmation for the specified users.
* '''BlueSpiceUEModuleTable2Excel - When using the checklist in a table, the selected values are not exported correctly''' (ERM46334)
: When the Content Droplet <code>Checklist</code> is used within a table, the selected values are now displayed correctly in the exported file.
*'''CognitiveProcessDesigner - Improve description page title validation''' (ERM45534)
:If the process name is too long or contains invalid characters, the creation of description pages will be skipped and a warning is displayed instead.
* '''DrawioEditor - Drawio editor fails to load certain SVGs''' (ERM46659)
: Loading SVGs in the Drawio editor is working properly again.
* '''CognitiveProcessDesigner - Catgories cannot be added to process pages''' (ERM42754)
: Categories can now be added to process pages.
* '''NSFileRepo - Misleading message from the browser stating that information will be lost when trying to save a form''' (ERM46654)
: If a form is edited and the changes are subsequently saved, the misleading browser hint about unsaved changes will no longer be displayed.
* '''SimpleBlogPage - The entrypoint <code>Blog</code> is displayed although although a user does not have the permission to read the namespace <code>Blogs</code>''' (ERM45623)
: The visibility of the <code>Blogs</code> entrypoint now depends on a user's read permissions. Similarly, the action to create a new blog post in the split button is now protected by permissions.

=== BlueSpice Farm ===
* '''BlueSpiceWikiFarm - ContentTransfer is not showing instances that are created from existing wiki''' (ERM43401)
: Cloned instances are now also displayed again in the selection of the receiving wiki on the page <code>Special:ContentTransfer</code>.
* '''BlueSpiceWikiFarm - Breadcrumb styling is broken when creating a new instance via <code>Special:Farm_management</code>''' (ERM45581)
: When creating a new instance via <code>Special:Farm_management</code>, the breadcrumb styling is now displayed correctly again.

==5.2.2 ==
{{#subobject:Release=5|Releasedate=26.02.2026|Releasepatch=5.2.2}}Release-Datum: 26.02.2026

This release contains the security fix for [https://en.wiki.bluespice.com/wiki/Security:Security_Advisories/BSSA-2026-01 BSSA-2026-01 (CVE-2025-14847)].
=== BlueSpice Free ===
==== Noteable changes ====
*'''BlueSpiceDiscovery - The subpage tree of the MediaWiki Enhanced sidebar does not produce faithful output''' (ERM44804)
:The following changes have been made to improve the display quality of the subpage tree. The MediaWiki Enhanced sidebar continues to support statefulness. This means that elements expanded by the user are retained after the page is refreshed, making it easier to navigate the sidebar. For the context-sensitive subpage tree, on the other hand, the active path is used. This means that the page on which the user is currently located expands the navigation element in the primary sidebar. In addition, asynchronous reloading of the subpage tree has been implemented in the MediaWiki Enhanced sidebar, which results in faster loading times because not everything is rendered in HTML at the beginning. Only the necessary subpages are reloaded when needed. Furthermore, active markers have been introduced, which indicate in the interface which page the user is currently on. Loading indicators have also been introduced to show that the system is reloading the individual subpages for larger structures.
{{Textbox|boxtype=important|header=Effect on customizations|text=These changes mean that customizations for an active path in the [[Handbuch:Erweiterung/MenuEditor#Erweiterte_MediaWiki_Sidebar|MediaWiki Enhanced sidebar]] will no longer work as usual.|icon=yes}}
*'''BlueSpiceQrCode - Missing support for parser functions and magic words in the QR code inspector''' (ERM45452)
:The QR code now supports the use of parser functions and magic words again. A separate mode has been introduced in the inspector for this purpose, which is hidden behind the “Edit as wikitext” <code>[[]]</code> button. Clicking on it allows parser functions and magic words to be used, which are visually highlighted with the same font as wikitext.

==== Bugfixes ====
*''' BlueSpiceDistributionConnector - When linking PDF files, no preview is displayed in the exported file''' (ERM45232)
:If a PDF file is linked on a page that is then exported, the preview of the PDF file is now also displayed correctly in the exported file.
*'''BlueSpiceReaders - Pages with an ampersand in the page title cannot be accessed via <code>Display Readers</code>''' (ERM45231)
:Pages with an ampersand in the page title can now be accessed correctly when using the <code>display reader</code> function and are displayed accordingly.
*'''BlueSpicePagesVisited - Negative values allowed for number input widget''' (ERM45854)
:When using the inspector in visual editor for the Content Droplet <code>Pages visited</code>, negative values are no longer permitted for the count and maximum title length, ensuring proper display.
*'''BlueSpiceQrCode - PDF export fails if QR code is used on a page''' (ERM44071)
:When a QR code is used on a page, that page can be exported correctly, including the QR code display.
*'''BlueSpiceVisualEditorConnector - Magic word <code>TOC</code> disappears from being displayed in source code editor after a page has been edited again''' (ERM43554)
:If the table of contents has been explicitly set on a page, it remains in the source code editor as long as the number of headings is less than four. However, if the number of headings is greater than four, an implicit table of content is set.
*'''ContentStabilization - Missing translation and explanation for CS integration for Chatbot''' (ERM45913)
:The missing translation for the <code>ContentStabilization</code> integration of the chatbot extension in the configuration manager is now displayed correctly.
*'''FlexiSkin - Using extensive CSS in FlexiSkin causes storage failure because the request URI is too long''' (ERM46158)
:The storage request now uses the POST method, allowing extensive CSS to be applied and stored via FlexiSkin.
*'''PDFCreator - <code>DumpNamespaces.php</code> creates blank pages in <code>Main_namespace.pdf</code>''' (ERM44484)
:Using <code>PDFCreator/maintenance/DumpNamespaces.php</code> now works correctly and no longer produces blank pages.
*'''PDFCreator - Linked files are not clickable in the PDF export''' (ERM45195)
:Linking images and files now works correctly again in an exported file.
*'''PDFCreator - Exporting a page without a revision log interrupts the export process''' (ERM45516)
:Older revisions of a page can now be exported correctly again. The content is displayed according to user permissions and taking the revision into account.
*'''PDFCreator - Images with an ampersand in their file names are not displayed in the exported file''' (ERM45076)
:If an image is included on a page that has an ampersand in its file name, the image will also be displayed correctly in the PDF file when the page is exported.
*'''PDFCreator - If the file description page for an image contains <code>“”</code>, then the image is not visible in the export''' (ERM45639)
:If quotation marks are used for the file description page, the image will displayed correctly in the export.
*'''PDFCreator - If a cover page is configured in the PDF template, the table of contents is output twice in the PDF export''' (ERM46137)
:If a cover page is configured for a PDF template, the table of contents is now displayed correctly in the PDF export.
*''' PDFCreator - Linked pages with umlauts in the page title are not included in the PDF export''' (ERM46161)
:If pages with umlauts in their page titles are linked, these are now also included when the page, including linked pages, is exported.
*'''PDFCreator - Terms from the glossary are incorrectly displayed as links in an exported file''' (ERM43627)
:If terms from the glossary are used on a page that is exported, they are now displayed as text in the exported file.
*'''UX ContentDroplets - Improve layout of droplet inspectors''' (ERM43452)
:In course of an UX review of BlueSpice, the inspectors for various Content Droplets have been improved. To name just a few examples, these include the <code>Gallery</code>, <code>Search field</code>, <code>Content Filter</code>, <code>Process</code> and many more.
*'''UX EnhancedStandardUIs - Display loading indicator when expanding a subpage tree''' (ERM45811)
:As part of BlueSpice's UX review, a loading indicator was added for subpage trees so that there's visual feedback for users that subpages are loading, e. g. on <code>Special:Pages</code>.

=== BlueSpice Pro ===

==== Noteable changes ====
*'''Chatbot - Implement configuration for disabling AI summary in the Search center''' (ERM46364)
:In Configuration Manager on the tab <code>Skinning</code>, the AI summary feature, which is displayed on <code>Special:SearchCenter</code>, can now be enabled or disabled if desired. By default, the feature is enabled. In addition, an overview of the available chatbot credits has been implemented on <code>Special:Instance_Status</code>.
*'''ContentStabilization - User filter on <code>Special:Quality_management_overview</code> doesn't work correctly''' (ERM44803)
:To avoid any negative impact on performance, the user filter has been disabled on <code>Special:Quality_management_overview</code>.
*'''NSFileRepo - Fix permission checks of images''' (ERM45424)
:The permission checks for uploaded files and images have been fixed for NSFileRepo. Also see reference <code>CVE-2026-24732</code>.
==== Bugfixes ====
*'''BlueSpiceBookshelf - The export of a book chapter and subchapters is prevented by an ampersand in the page title''' (ERM45133)
:When using the ampersand in the page title, all book chapters, including their subchapters, are exported correctly.
*'''BlueSpiceBookshelf - Missing URL parameter <code>&book=</code> leads to invalid relevant title in book export''' (ERM46085)
:Regardless of the URL parameters set, the book title is now always displayed correctly on the cover page in the book export.
*'''BlueSpiceBookshelf - User is redirected to the wrong editing mode when switching from book menu editor to mode <code>Edit source</code>''' (ERM45355)
:The user is now redirected to the correct editing mode when switching from book menu editor (<code>action=edit</code>) to the <code>Edit source</code> mode of the book because the URL is now correctly appended with <code>action=editbooksource</code>.
*'''BlueSpiceExpiry - Expiry information is not displayed in page information dialog''' (ERM45533)
:If an expiry date is set for a page, this information is displayed in the page information dialog again.
*'''BlueSpiceFilterableTables - Content within filterable tables is truncated, and the use of queries results in limited display of results''' (ERM45005)
:Text truncation within filterable tables is now prevented. Furthermore, this ticket also fixed an issue where queries within filterable tables were not working properly and the query results were not displayed correctly.
*'''BlueSpiceReadConfirmation - Minor edit incorrectly triggers a read confirmation''' (ERM44689)
:If an edit is marked as a minor edit, it no longer triggers a read confirmation. Only major edits trigger a read confirmation for the specified users.
*'''CognitiveProcessDesigner - If the process diagram is too large, elements overlap on the page in the PDF export''' (ERM44986)
:For larger process diagrams, all elements are displayed neatly and clearly in the PDF export.
*'''CognitiveProcessDesigner - If a process is exported by using mode <code>Pages with linked pages</code>, the page order is mixed up''' (ERM45678)
:If a process is exported using the mode <code>Pages with linked pages</code>, the order of the pages is now exported topologically for better traceability.
*'''CognitiveProcessDesigner - Securing unsaved changes to a process in case of accidental closure of the browser tab''' (ERM45383)
:If changes are made to a process that have not yet been saved and the user accidentally tries to close the browser tab, a message will now be displayed indicating that there are unsaved changes. This ticket also fixed the issue where this message was incorrectly displayed by the browser tab.
*'''CollabPads - When using collaborative editing mode, no active editing is displayed in the browser tab''' (ERM45338)
:If a page is being edited in collaborative editing mode, the active editing is now displayed in the browser tab.
*'''ContentStabilization - Enabled approval causes problems with context, stabilization, and oldid query parameters during in exported file''' (ERM45274)
:When exporting a page that is located in a namespace where approval is enabled, the information is now displayed correctly in the PDF. This applies to the content of the page as well as the approval information below the page title.
*'''DrawioEditor - If shapes from the BPMN 2.0 library are used, they are displayed as black shapes in the exported file''' (ERM45109)
:If shapes from the BPMN 2.0 library are used, they are now displayed correctly in the exported file.
*'''NSFileRepo - If a namespace is renamed and files assigned to this namespace are also renamed, the file links break''' (ERM44451)
:If a namespace to which files are also assigned is renamed, it is now possible to revise the file links retrospectively so that they can be displayed again.
*'''SimpleBlogPage - Headings are displayed twice on <code>Special:ArticlesHome</code>''' (ERM44329)
:If headings are used for a blog entry, they are now displayed correctly again on <code>Special:ArticlesHome</code>.
*'''TableTools - The sticky table header is shifted when scrolling a table''' (ERM43132)
:When scrolling a table with a sticky header, it now remains at the top. Please note that the sticky table header is only supported up to a certain screen size (<code>width => 1400</code>), otherwise the responsive class applies.
*'''UX BlueSpiceBookshelf - Improve inspector for Content Droplet <code>Search in a book</code>''' (ERM45075)
:In course of an UX review of BlueSpice, the inspector for the Content Droplet <code>Search in a book</code> has been improved.

=== BlueSpice Farm ===
==== Noteable changes ====
*'''BlueSpiceTranslationTransfer - Allow certain words or phrases to be excluded from translation''' (ERM43565)
:It is now possible to exclude certein words, sentences or passages from translation. To do so, the <code>Insert</code> menu in the visual editor now includes the option <code>Exclude from translation</code>. This opens a small pop-up window where the user can insert the content that should be excluded from translation into another language instance. For further information please see our feature documentation.
==== Bugfixes ====
*'''Commonwebapis - When creating a new farm instance, system groups are displayed in the User manager''' (ERM45312)
:When creating a new farm instance, system groups are no longer displayed, as they belong to the group <code>Administrators</code> per default.

=== BlueSpice Cloud ===
*'''MWStakeComponent - Subpagetree of the Enhanced MediaWiki sidebar cannot be expanded''' (ERM46307)
:If a subpagetree is used in the Enhanced MediaWiki sidebar, the subchapters can now be expanded properly again.

==5.1.6 ==
{{#subobject:Release=5|Releasedate=26.02.2026|Releasepatch=5.1.6}}Release-Datum: 26.02.2026
This release contains the security fix for [https://en.wiki.bluespice.com/wiki/Security:Security_Advisories/BSSA-2026-01 BSSA-2026-01 (CVE-2025-14847)].

=== BlueSpice Free ===

==== Noteable changes ====

* '''BlueSpiceDiscovery - The subpage tree of the MediaWiki Enhanced sidebar does not produce faithful output''' (ERM44804)

: The following changes have been made to improve the display quality of the subpage tree. The MediaWiki Enhanced sidebar continues to support statefulness. This means that elements expanded by the user are retained after the page is refreshed, making it easier to navigate the sidebar. For the context-sensitive subpage tree, on the other hand, the active path is used. This means that the page on which the user is currently located expands the navigation element in the primary sidebar. In addition, asynchronous reloading of the subpage tree has been implemented in the MediaWiki Enhanced sidebar, which results in faster loading times because not everything is rendered in HTML at the beginning. Only the necessary subpages are reloaded when needed. Furthermore, active markers have been introduced, which indicate in the interface which page the user is currently on. Loading indicators have also been introduced to show that the system is reloading the individual subpages for larger structures. <u>Please note that these changes mean that customizations for an active path in the MediaWiki Enhanced sidebar will no longer work as usual.</u>

==== Bugfixes ====
* '''BlueSpiceDistributionConnector - When linking PDF files, no preview is displayed in the exported file''' (ERM45232)
: If a PDF file is linked on a page that is then exported, the preview of the PDF file is now also displayed correctly in the exported file.
* '''BlueSpiceQrCode - PDF export fails if QR code is used on a page''' (ERM44071)
: When a QR code is used on a page, that page can be exported correctly, including the QR code display.
* '''BlueSpiceReaders - Pages with an ampersand in the page title cannot be accessed via <code>Display Readers</code>''' (ERM45231)
: Pages with an ampersand in the page title can now be accessed correctly when using the <code>display reader</code> function and are displayed accordingly.
* '''BlueSpicePagesVisited - Negative values allowed for number input widget''' (ERM45854)
: When using the inspector in visual editor for the Content Droplet <code>Pages visited</code>, negative values are no longer permitted for the count and maximum title length, ensuring proper display.
* '''BlueSpiceVisualEditorConnector - Magic word <code>TOC</code> disappears from being displayed in source code editor after a page has been edited again''' (ERM43554)
: If the table of contents has been explicitly set on a page, it remains in the source code editor as long as the number of headings is less than four. However, if the number of headings is greater than four, an implicit table of content is set.
* '''FlexiSkin - Using extensive CSS in FlexiSkin causes storage failure because the request URI is too long''' (ERM46158)
: The storage request now uses the POST method, allowing extensive CSS to be applied and stored via FlexiSkin.
* '''PDFCreator - <code>DumpNamespaces.php</code> creates blank pages in <code>Main_namespace.pdf</code>''' (ERM44484)
: Using <code>PDFCreator/maintenance/DumpNamespaces.php</code> now works correctly and no longer produces blank pages.
* '''PDFCreator - Linked files are not clickable in the PDF export''' (ERM45195)
: Linking images and files now works correctly again in an exported file.
* '''PDFCreator - Exporting a page without a revision log interrupts the export process''' (ERM45516)
: Older revisions of a page can now be exported correctly again. The content is displayed according to user permissions and taking the revision into account.
* '''PDFCreator - Images with an ampersand in their file names are not displayed in the exported file''' (ERM45076)
: If an image is included on a page that has an ampersand in its file name, the image will also be displayed correctly in the PDF file when the page is exported.
* '''PDFCreator - If the file description page for an image contains <code>“”</code>, then the image is not visible in the export''' (ERM45639)
: If quotation marks are used for the file description page, the image will displayed correctly in the export.
* '''PDFCreator - If a cover page is configured in the PDF template, the table of contents is output twice in the PDF export''' (ERM46137)
: If a cover page is configured for a PDF template, the table of contents is now displayed correctly in the PDF export.
* '''PDFCreator - Linked pages with umlauts in the page title are not included in the PDF export''' (ERM46161)
: If pages with umlauts in their page titles are linked, these are now also included when the page, including linked pages, is exported.
* '''PDFCreator - Terms from the glossary are incorrectly displayed as links in an exported file''' (ERM43627)
: If terms from the glossary are used on a page that is exported, they are now displayed as text in the exported file.
* '''UX EnhancedStandardUIs - Display loading indicator when expanding a subpage tree''' (ERM45811)
: As part of BlueSpice's UX review, a loading indicator was added for subpage trees so that there's visual feedback for users that subpages are loading, e. g. on <code>Special:Pages</code>.

=== BlueSpice Pro ===

==== Noteable changes ====
*'''ContentStabilization - User filter on <code>Special:Quality_management_overview</code> doesn't work correctly''' (ERM44803)
:To avoid any negative impact on performance, the user filter has been disabled on <code>Special:Quality_management_overview</code>.
*'''NSFileRepo - Fix permission checks of images''' (ERM45424)
:The permission checks for uploaded files and images have been fixed for NSFileRepo. Also see reference <code>CVE-2026-24732</code>

==== Bugfixes ====

* '''BlueSpiceBookshelf - The export of a book chapter and subchapters is prevented by an ampersand in the page title''' (ERM45133)
: When using the ampersand in the page title, all book chapters, including their subchapters, are exported correctly.
* '''BlueSpiceBookshelf - Missing URL parameter <code>&book=</code> leads to invalid relevant title in book export''' (ERM46085)
: Regardless of the URL parameters set, the book title is now always displayed correctly on the cover page in the book export.
* '''BlueSpiceBookshelf - User is redirected to the wrong editing mode when switching from book menu editor to mode <code>Edit source</code>''' (ERM45355)
: The user is now redirected to the correct editing mode when switching from book menu editor (<code>action=edit</code>) to the <code>Edit source</code> mode of the book because the URL is now correctly appended with <code>action=editbooksource</code>.
* '''BlueSpiceExpiry - Expiry information is not displayed in page information dialog''' (ERM45533)
: If an expiry date is set for a page, this information is displayed in the page information dialog again.
* '''BlueSpiceFilterableTables - Content within filterable tables is truncated, and the use of queries results in limited display of results''' (ERM45005)
: Text truncation within filterable tables is now prevented. Furthermore, this ticket also fixed an issue where queries within filterable tables were not working properly and the query results were not displayed correctly.
* '''BlueSpiceReadConfirmation - Minor edit incorrectly triggers a read confirmation''' (ERM44689)
: If an edit is marked as a minor edit, it no longer triggers a read confirmation. Only major edits trigger a read confirmation for the specified users.
* '''CognitiveProcessDesigner - If the process diagram is too large, elements overlap on the page in the PDF export''' (ERM44986)
: For larger process diagrams, all elements are displayed neatly and clearly in the PDF export.
* '''CognitiveProcessDesigner - If a process is exported by using mode <code>Pages with linked pages</code>, the page order is mixed up''' (ERM45678)
: If a process is exported using the mode <code>Pages with linked pages</code>, the order of the pages is now exported topologically for better traceability.
* '''CognitiveProcessDesigner - Securing unsaved changes to a process in case of accidental closure of the browser tab''' (ERM45383)
: If changes are made to a process that have not yet been saved and the user accidentally tries to close the browser tab, a message will now be displayed indicating that there are unsaved changes. This ticket also fixed the issue where this message was incorrectly displayed by the browser tab.
* '''CollabPads - When using collaborative editing mode, no active editing is displayed in the browser tab''' (ERM45338)
: If a page is being edited in collaborative editing mode, the active editing is now displayed in the browser tab.
* '''ContentStabilization - Enabled approval causes problems with context, stabilization, and oldid query parameters during in exported file''' (ERM45274)
: When exporting a page that is located in a namespace where approval is enabled, the information is now displayed correctly in the PDF. This applies to the content of the page as well as the approval information below the page title.
* '''DrawioEditor - If shapes from the BPMN 2.0 library are used, they are displayed as black shapes in the exported file''' (ERM45109)
: If shapes from the BPMN 2.0 library are used, they are now displayed correctly in the exported file.
* '''NSFileRepo - If a namespace is renamed and files assigned to this namespace are also renamed, the file links break''' (ERM44451)
: If a namespace to which files are also assigned is renamed, it is now possible to revise the file links retrospectively so that they can be displayed again.
* '''SimpleBlogPage - Headings are displayed twice on <code>Special:ArticlesHome</code>''' (ERM44329)
: If headings are used for a blog entry, they are now displayed correctly again on <code>Special:ArticlesHome</code>.
* '''TableTools - The sticky table header is shifted when scrolling a table''' (ERM43132)
: When scrolling a table with a sticky header, it now remains at the top. Please note that the sticky table header is only supported up to a certain screen size (<code>width => 1400</code>), otherwise the responsive class applies.

=== BlueSpice Farm ===

==== Noteable changes ====
none

==== Bugfixes ====
* '''Commonwebapis - When creating a new farm instance, system groups are displayed in the User manager''' (ERM45312)
: When creating a new farm instance, system groups are no longer displayed, as they belong to the group <code>Administrators</code> per default.

==5.2.1==

{{#subobject:Release=5|Releasedate=22.01.2026|Releasepatch=5.2.1}}Release-Datum: 22.01.2026
=== BlueSpice Free ===
*'''BlueSpiceChecklist - When using the Content Droplet <code>Checklist</code>, the selected values are not saved''' (ERM45791)
:If the Content Droplet <code>Checklist</code> is used, the selected values are now saved and retained correctly.
*''' BlueSpiceChecklist - Content Droplet <code>Checklist</code> has line breaks after each checkbox''' (ERM45507)
:If the Content Droplet <code>Checklist</code> is used, the checkboxes are displayed as usual and without additional line break.
*'''BlueSpiceCountThings - Incorrect inspector is displayed when Content Droplet <code>Number of characters</code> is selected''' (ERM45058)
:If the Content Droplet <code>Number of characters</code> is selected, the correct inspector will now be displayed again. In addition, a display error in the help text has been corrected.
*'''BlueSpiceDiscovery – Breadcrumb action for <code>Special:EditWatchlist</code> is not displayed correctly''' (ERM44600)
:Depending on the respective action (edit or clear), the breadcrumb pill is now displayed correctly on <code>Special:EditWatchlist</code>.
*''' BlueSpiceDiscovery - Toolbar in the Namespace manager is too large, causing the hamburger icon to be hidden by the sidebar'''(ERM45425)
:The width of the Namespace manager toolbar has been adjusted correctly again so that no further actions are covered by the right sidebar.
*'''BlueSpiceDiscovery - No new task is displayed in the personal menu, even though a new workflow has been started''' (ERM45273)
:After a user has been assigned a task within a workflow, the indicator now reappears in the personal menu.
*'''BlueSpiceDiscovery - Underscores in namespaces are rendered in main navigation''' (ERM43166)
:When using the <code>namespace main page list</code> for the main navigation, the underscores for namespaces are no longer displayed.
*'''BlueSpiceDistributionConnector - If a GitHub link is added to a page via copy & paste, it is recognized as BitBucket''' (ERM45339)
:If a GitHub link is added to a page via copy & paste, it will now be recognized correctly again.
*'''BlueSpiceDistributionConnector – Inline search should be allowed in the insert link dialog''' (ERM42897)
:If a user wants to link to a page or file within a wiki page, the dialog now also supports inline search.
*'''BlueSpiceDistributionConnector - Create migration-process for for PluggableAuth plugins in WikiFarm''' (ERM44440)
:A PluggableAuth setting has been implemented for migrating new instances.
*'''BlueSpiceExtendedSearch - Border styling for autocomplete search is not displayed correctly''' (ERM45368)
:The styling of the autocomplete search border is now displayed correctly again.
*'''EnhancedUpload - Uploading a file with a category prevents the description to be added to the file page content''' (ERM44412)
:When uploading a file with a category and description, this is displayed correctly on the file description page. When uploading a new version of a file, these values are pre-filled in the upload dialog so that the user can decide whether to modify, delete or retain them.
*'''Migration UserProfile - No automatic conversion of custom fields config''' (ERM45420)
:The <code>BlueSpiceSocialProfile</code> extension in BlueSpice 4.x allowed custom fields to be created in the user profile. During migration to BlueSpice 5.x, the data for these was migrated but not made visible. This has now been fixed so that the existing data is also visible after succesful migration.
*'''NotifyMe - Update of process status in <code>notifications_event</code> table causes Word import to not work''' (ERM45803)
:The update of the process status in the <code>notifications_event</code> table has been removed because it no longer has any function.
*'''UX BlueSpiceCountThings - Improve inspector for Content Droplet <code>Number of files</code>''' (ERM45057)
:In course of an UX review of BlueSpice, the inspector for the Content Droplet <code>Number of files</code> has been improved.
*'''UX BlueSpiceDistributionConnector - Improve inspector for Content Droplet <code>Circled number</code>''' (ERM45073)
:In course of an UX review of BlueSpice, the inspector for the Content Droplet <code>Circled number</code> has been improved.
*'''UX BlueSpiceDistributionConnector - Improve inspector for Content Droplet <code>Categorytree</code>''' (ERM45077)
:In course of an UX review of BlueSpice, the inspector for the Content Droplet <code>Categorytree</code> has been improved.
*'''UX BlueSpiceDistributionConnector - Improve inspector for Content Droplet <code>Subpages</code>''' (ERM45083)
:In course of an UX review of BlueSpice, the inspector for the Content Droplet <code>Subpages</code> has been improved.
*'''UX BlueSpicePagesVisited - Improve inspector for Content Droplet <code>Visited pages</code> ''' (ERM45070)
:In course of an UX review of BlueSpice, the inspector for the Content Droplet <code>Visited pages</code> has been improved.
*'''UX EnhancedUpload - Improve inspector for Content Droplet <code>Attachments</code>''' (ERM44784)
:In course of an UX review of BlueSpice, the inspector for the Content Droplet <code>Attachments</code> has been improved.
*'''UX EnhancedStandardUIs - Category styling is different depending on number of categories displayed on <code>Special:File_list</code>''' (ERM45300)
:The styling of the categories on <code>Special:File_list</code> has been adjusted and now behaves consistently regardless of the number of categories displayed.
*'''UX OOJSPlus - Improve concept of date filter for grids''' (ERM45257)
:As part of BlueSpice's UX review, the concept of the date filter in grids was completely revised and an improved date picker including filter variations was introduced.
*'''UX OOJSPlus – Mark deletion actions in tables as destructive''' (ERM45397)
:As part of BlueSpice's UX review, the delete action in grids was changed to be destructive, so that it is consistent across the interface.
*'''UX OOJSPlus – <code>NumberInputWidget</code> on <code>Special:Preferences</code> should disable the button according to its limit''' (ERM43359)
:If a <code>NumberInputWidget</code> is used (such as for recent changes or the watchlist settings on <code>Special:Preferences</code>), it respects its limits and disables the save button once they are reached.
*'''UX BlueSpiceSmartList - Improve inspector for Content Droplet <code>New users</code>'''(ERM44794)
:In course of an UX review of BlueSpice, the inspector for the Content Droplet <code>New users</code> has been improved.
*'''UX BlueSpiceSmartList - Improve inspector for Content Droplet <code>Recent changes</code>''' (ERM45078)
:In course of an UX review of BlueSpice, the inspector for the Content Droplet <code>Recent changes</code> has been improved.
*''' UX BlueSpiceSmartList - Improve inspector for Content Droplet <code>Most visited pages</code>''' (ERM45079)
:In course of an UX review of BlueSpice, the inspector for the Content Droplet <code>Most visited pages</code> has been improved.
*'''UX BlueSpiceSmartList - Improve inspector for Content Droplet <code>Member list</code>''' (ERM45039)
:In course of an UX review of BlueSpice, the inspector for the Content Droplet <code>Member list</code> has been improved.
*'''UX BlueSpiceSmartList - Improve inspector for Content Droplet <code>New users</code>''' (ERM45080)
:In course of an UX review of BlueSpice, the inspector for the Content Droplet <code>New users</code> has been improved.
*'''UX BlueSpiceSmartList - Improve inspector for Content Droplet <code>Links to this page</code>''' (ERM45084)
:In course of an UX review of BlueSpice, the inspector for the Content Droplet <code>Links to this page</code> has been improved.
*'''UX StandardDialogs - The styling of the unordered list for the properties in the page information dialog is broken''' (ERM45587)
:The styling for the properties of a page in the page information dialog is now displayed correctly again.
*'''UX BlueSpiceWatchlist - Improve inspector for Content Droplet <code>Watchlist</code>''' (ERM45071)
:In course of an UX review of BlueSpice, the inspector for the Content Droplet <code>Watchlist</code> has been improved.
*'''UX BlueSpiceWhoIsOnline - Improve inspector for Content Droplet <code>List of users logged in</code>''' (ERM45038)
:In course of an UX review of BlueSpice, the inspector for the Content Droplet <code>List of users logged in</code> has been improved.
*'''WCAG 9.3.1.2 BlueSpiceDiscovery - Marking words and sections in other languages'''(ERM45347)
:In accordance with accessibility guidelines, foreign-language content in BlueSpice is now marked with a corresponding <code>lang</code> attribute.

=== BlueSpice Pro ===

==== Noteable changes ====
*'''PDFCreator - PDF templates need to be adjusted because <code>vertical-align:center</code> does not work''' (ERM45713)
:The default PDF templates have been modified so that <code>vertical-align:middle</code> is used. These changes only apply to new installations automatically. For existing systems, the parameter must be updated manually in order for it to work.

==== Bugfixes ====
*'''BlueSpiceBookshelf - If a user does not have permission to edit the <code>Book</code> namespace, the <code>Add to book</code> action should not be visible''' (ERM45726)
:If a user does not have permission to edit the <code>Book</code> namespace, the <code>Add to book</code> action will not be displayed for them. The same applies to the <code>New book</code> action in the <code>+</code> split button.
*'''BlueSpiceBookshelf - PDF template parameter <code>{{{book-title}}}</code> has no fallback''' (ERM44688)
:If a user exports a book for which the parameter <code><nowiki>{{{book-title}}}</nowiki></code> is not specified in the metadata, the parameter <code><nowiki>{{{title}}}</nowiki></code> is now used as a fallback and no empty cover page is generated.
*''' BlueSpiceFilterableTables - OOJS implementation does not respect the individually selected table width'''(ERM45532)
:If the user sets an individual table width for filterable tables, this is now also respected and displayed correctly.
*'''BlueSpice/ MediaWiki - Group permission <code>smw-schemaedit</code> is not part of BlueSpice roles''' (ERM44802)
:The group permission <code>smw-schemaedit</code> has been added to the BlueSpice role <code>Administrator</code> so that the namespace <code>smw/schema</code> can be edited.
*'''BlueSpiceSMWConnector - AsyncAsk tree and grid migration not complete''' (ERM45552)
:The missing features regarding the AsyncAsk tree and grid have been implemented.
*'''BlueSpiceWiki - An error is displayed when importing a <code>.vsdx</code> file for creating a new draw.io diagram''' (ERM44631)
:After updating the services it is now possible again to import a <code>.vsdx</code> file for creating a draw.io diagram.
*'''BlueSpiceWikiExplorer - Missing data in Wiki Explorer export''' (ERM43378)
:When exporting overview of the Wiki Explorer all columns selected by the user are now also displayed in the exported file.
*'''ChatIntegration - Checkboxes with <code>default = true</code> cannot be disabled''' (ERM45114)
:Checkboxes that are enabled by default can now be edited correctly and thus disabled. This applies to the chat service content droplets, where the <code>Show icon</code> setting now works correctly depending on the user's selection.
*'''CognitiveProcessDesigner - Include navigation concept from process description pages in PDF export''' (ERM40389)
:When creating a process with process description pages, a navigation concept can be seen in the wiki, which allows you to navigate through the process. These navigation points are now also displayed in the exported PDF file.
*'''CognitiveProcessDesigner - Eternal loading on <code>Special:OrphanedProcessDescriptionPages</code> when trying to filter for a process''' (ERM44988)
:When filtering for a process on <code>Special:OrphanedProcessDescriptionPages</code>, the grid is now loaded correctly again and displays the results correctly.
*'''CognitiveProcessDesigner - When exporting a process to <code>.pdf</code>, the approval is not respected''' (ERM44990)
:When a process is exported to <code>.pdf</code>, the correct approval information is displayed.
*'''ContentStabilization - Tag <code>documentstate</code> returns incorrect stabilization information''' (ERM45620)
:If the tag <code>documentstate</code> is used on a page, it now displays the correct stabilization information of a page.
*'''DrawioEditor - Lack of support for parser function results in missing draw.io diagram after updating to 5.2''' (ERM45041)
:Support for the parser function has been restored, so that draw.io diagrams are displayed correctly again.
*'''DrawioEditor - draw.io diagrams containing non-ASCII chars cannot be correctly loaded''' (ERM45793)
:If umlauts or special characters are used in draw.io diagrams, they are now loaded and displayed correctly.
*'''DrawioEditor – ImageMap support for draw.io <code>.svg</code> files''' (ERM34422)
:ImageMap has now been extended to support<code>.svg</code> format, which allows draw.io diagrams to be embedded via ImageMap.
*'''ImportOfficeFiles - If an imported file is assigned to a namespace, this is not taken into account for the included files''' (ERM45402)
:If a Word file is imported into the wiki and assigned to a namespace, this also applies to the included files.
*''' MWStakeComponent - Sticky toolbar shifted for forms''' (ERM43192)
:The sticky toolbar is now displayed correctly again.
*'''PDFCreator – Incorrect context displayed for introduction and appendix pages after export''' (ERM45110)
:The use of revision related parser functions works correctly. The revision ID is now parsed correctly on the cover page, in the header and footer, and in the appendix.
*'''PDFCreator - File export doesn't work''' (ERM45125)
:PDF export has been fixed with regard to file and media links. In addition, external links and approval information are now correctly recognized in PDF export.
*'''PreviewLinks - Preview is displayed in edit mode''' (ERM45250)
:When editing a page, hovering over links no longer displays a preview.
*'''PreviewLinks - Empty preview for external links is displayed''' (ERM45251)
:Previews are no longer displayed for external links.
*'''UX BlueSpiceCategoryManager - Improve the options displayed in the category manager''' (ERM45396)
:The selection options in the category manager have been improved. This includes adjusting the icons and colors to highlight their effects. In addition, the contrasts have been improved to ensure that they are sufficient for the accessibility of the application.
*'''UX ImportOfficeFiles - Cancel and back action should not be used on the same dialog page''' (ERM42200)
:In course of an UX review of BlueSpice, the dialog for importing a Word file was improved with regard to the actions.
*'''UX BlueSpiceSMWConnector - Improve inspector for Content Droplet <code>Data query</code>''' (ERM45072)
:In course of an UX review of BlueSpice, the inspector for the Content Droplet <code>Data query</code> has been improved.
*'''UX BlueSpiceSMWConnector - Improve inspector for Content Droplet <code>Decision overview</code>''' (ERM45074)
:In course of an UX review of BlueSpice, the inspector for the Content Droplet <code>Decision overview</code> has been improved.
*'''Workflows – Users and user groups can only be selected using the keyboard when editing a workflow trigger''' (ERM44656)
:It is possible to select a user or user group correctly by using the mouse.
*'''Workflows - No summary is included in the email for the group feedback workflow''' (ERM45488)
:The final email of the group feedback workflow now also contains a summary of the comments again.

=== BlueSpice Farm ===
*'''BlueSpiceWikiFarm - Interwiki links blocks farm instance names without wiki prefix''' (ERM45550)
:When internal links and interwiki links are used on a page, they are now recognized correctly again, so that users are redirected to a page in the instance they are currently in, or to a page in another wiki instance.
*'''BlueSpiceTranslationTransfer - Templates are overwritten in target wiki after executing translation workflow''' (ERM42772)
:If a page with an embedded template is transferred to another language instance via the translation workflow, the customized templates there are no longer overwritten to prevent loss of changes. The adjustments that need to be made in the source wiki template must then also be entered manually in the target wiki for this template. As part of this implementation, the dialog has also been improved so that it is clearly recognizable which pages have not been translated by the translation workflow.
*'''UX BlueSpiceTranslationTransfer - Improve labels for BlueSpiceTranslationTransfer in ConfigManager''' (ERM44630)
:The labels in the configuration manager that refer to the BlueSpiceTranslationTransfer extension have been adjusted so that they are now displayed consistently.

==5.1.5==
{{#subobject:|Release=5|Releasedate=22.01.2026|Releasepatch=5.1.5}}Release-Datum: 22.01.2026
=== BlueSpice Free ===
*''' BlueSpiceChecklist - Content Droplet <code>Checklist</code> has line breaks after each checkbox''' (ERM45507)
:If the Content Droplet <code>Checklist</code> is used, the checkboxes are displayed as usual and without additional line break.
*'''BlueSpiceCountThings - Incorrect inspector is displayed when Content Droplet <code>Number of characters</code> is selected''' (ERM45058)
:If the Content Droplet <code>Number of characters</code> is selected, the correct inspector will now be displayed again. In addition, a display error in the help text has been corrected.
*'''BlueSpiceDiscovery - Underscores in namespaces are rendered in main navigation''' (ERM43166)
:When using the <code>namespace main page list</code> for the main navigation, the underscores for namespaces are no longer displayed.
*'''BlueSpiceDiscovery – Breadcrumb action for <code>Special:EditWatchlist</code> is not displayed correctly''' (ERM44600)
:Depending on the respective action (edit or clear), the breadcrumb pill is now displayed correctly on <code>Special:EditWatchlist</code>.
*'''BlueSpiceDistributionConnector – Inline search should be allowed in the insert link dialog''' (ERM42897)
:If a user wants to link to a page or file within a wiki page, the dialog now also supports inline search.
*'''BlueSpiceDistributionConnector - Create migration-process for for PluggableAuth plugins in WikiFarm''' (ERM44440)
:A PluggableAuth setting has been implemented for migrating new instances.
*'''BlueSpiceExtendedSearch - Border styling for autocomplete search is not displayed correctly''' (ERM45368)
:The styling of the autocomplete search border is now displayed correctly again.
*'''EnhancedUpload - Uploading a file with a category prevents the description to be added to the file page content''' (ERM44412)
:When uploading a file with a category and description, this is displayed correctly on the file description page. When uploading a new version of a file, these values are pre-filled in the upload dialog so that the user can decide whether to modify, delete or retain them.
*'''Migration UserProfile - No automatic conversion of custom fields config''' (ERM45420)
:The <code>BlueSpiceSocialProfile</code> extension in BlueSpice 4.x allowed custom fields to be created in the user profile. During migration to BlueSpice 5.x, the data for these was migrated but not made visible. This has now been fixed so that the existing data is also visible after succesful migration.
*'''NotifyMe - Update of process status in <code>notifications_event</code> table causes Word import to not work''' (ERM45803)
:The update of the process status in the <code>notifications_event</code> table has been removed because it no longer has any function.
*'''UX EnhancedStandardUIs - Category styling is different depending on number of categories displayed on <code>Special:File_list</code>''' (ERM45300)
:The styling of the categories on <code>Special:File_list</code> has been adjusted and now behaves consistently regardless of the number of categories displayed.
*'''UX StandardDialogs - The styling of the unordered list for the properties in the page information dialog is broken''' (ERM45587)
:The styling for the properties of a page in the page information dialog is now displayed correctly again.
*'''UX OOJSPlus – Mark deletion actions in tables as destructive''' (ERM45397)
:As part of BlueSpice's UX review, the delete action in grids was changed to be destructive, so that it is consistent across the interface.

=== BlueSpice Pro ===

==== Noteable changes ====
*'''PDFCreator - PDF templates need to be adjusted because <code>vertical-align:center</code> does not work''' (ERM45713)
:The default PDF templates have been modified so that <code>vertical-align:middle</code> is used. These changes only apply to new installations automatically. For existing systems, the parameter must be updated manually in order for it to work.

==== Bugfixes ====
*'''BlueSpiceBookshelf - If a user does not have permission to edit the <code>Book</code> namespace, the <code>Add to book</code> action should not be visible''' (ERM45726)
:If a user does not have permission to edit the <code>Book</code> namespace, the <code>Add to book</code> action will not be displayed for them. The same applies to the <code>New book</code> action in the <code>+</code> split button.
*'''BlueSpiceBookshelf - PDF template parameter <code>{{{book-title}}}</code> has no fallback''' (ERM44688)
:If a user exports a book for which the parameter <code><nowiki>{{{book-title}}}</nowiki></code> is not specified in the metadata, the parameter <code><nowiki>{{{title}}}</nowiki></code> is now used as a fallback and no empty cover page is generated.
*''' BlueSpiceFilterableTables - OOJS implementation does not respect the individually selected table width'''(ERM45532)
:If the user sets an individual table width for filterable tables, this is now also respected and displayed correctly.
*'''BlueSpice/ MediaWiki - Group permission <code>smw-schemaedit</code> is not part of BlueSpice roles''' (ERM44802)
:The group permission <code>smw-schemaedit</code> has been added to the BlueSpice role <code>Administrator</code> so that the namespace <code>smw/schema</code> can be edited.
*'''BlueSpiceSMWConnector - AsyncAsk tree and grid migration not complete''' (ERM45552)
:The missing features regarding the AsyncAsk tree and grid have been implemented.
*'''BlueSpiceWiki - An error is displayed when importing a <code>.vsdx</code> file for creating a new draw.io diagram''' (ERM44631)
:After updating the services it is now possible again to import a <code>.vsdx</code> file for creating a draw.io diagram.
*'''BlueSpiceWikiExplorer - Missing data in WikiExplorer export''' (ERM43378)
:When exporting overview of the Wiki Explorer all columns selected by the user are now also displayed in the exported file.
*'''CognitiveProcessDesigner - Include navigation concept from process description pages in PDF export''' (ERM40389)
:When creating a process with process description pages, a navigation concept can be seen in the wiki, which allows you to navigate through the process. These navigation points are now also displayed in the exported PDF file.
*'''CognitiveProcessDesigner - Eternal loading on <code>Special:OrphanedProcessDescriptionPages</code> when trying to filter for a process''' (ERM44988)
:When filtering for a process on <code>Special:OrphanedProcessDescriptionPages</code>, the grid is now loaded correctly again and displays the results correctly.
*'''CognitiveProcessDesigner - When exporting a process to <code>.pdf</code>, the approval is not respected''' (ERM44990)
:When a process is exported to <code>.pdf</code>, the correct approval information is displayed.
*'''ContentStabilization - Tag <code>documentstate</code> returns incorrect stabilization information''' (ERM45620)
:If the tag <code>documentstate</code> is used on a page, it now displays the correct stabilization information of a page.
*'''DrawioEditor – ImageMap support for draw.io <code>.svg</code> files''' (ERM34422)
:ImageMap has now been extended to support<code>.svg</code> format, which allows draw.io diagrams to be embedded via ImageMap.
*'''DrawioEditor - draw.io diagrams containing non-ASCII chars cannot be correctly loaded''' (ERM45793)
:If umlauts or special characters are used in draw.io diagrams, they are now loaded and displayed correctly.
*'''ImportOfficeFiles - If an imported file is assigned to a namespace, this is not taken into account for the included files''' (ERM45402)
:If a Word file is imported into the wiki and assigned to a namespace, this also applies to the included files.
*''' MWStakeComponent - Sticky toolbar shifted for forms''' (ERM43192)
:The sticky toolbar is now displayed correctly again.
*'''PDFCreator – Incorrect context displayed for introduction and appendix pages after export''' (ERM45110)
:The use of revision related parser functions works correctly. The revision ID is now parsed correctly on the cover page, in the header and footer, and in the appendix.
*'''PDFCreator - File export doesn't work''' (ERM45125)
:PDF export has been fixed with regard to file and media links. In addition, external links and approval information are now correctly recognized in PDF export.
*'''UX BlueSpiceCategoryManager - Improve the options displayed in the category manager''' (ERM45396)
:The selection options in the category manager have been improved. This includes adjusting the icons and colors to highlight their effects. In addition, the contrasts have been improved to ensure that they are sufficient for the accessibility of the application.
*'''Workflows – Users and user groups can only be selected using the keyboard when editing a workflow trigger''' (ERM44656)
:It is possible to select a user or user group correctly by using the mouse.
*'''Workflows - No summary is included in the email for the group feedback workflow''' (ERM45488)
:The final email of the group feedback workflow now also contains a summary of the comments again.

=== BlueSpice Farm ===
*'''BlueSpiceWikiFarm - Interwiki links blocks farm instance names without wiki prefix''' (ERM45550)
:When internal links and interwiki links are used on a page, they are now recognized correctly again, so that users are redirected to a page in the instance they are currently in, or to a page in another wiki instance.
*'''BlueSpiceTranslationTransfer - Templates are overwritten in target wiki after executing translation workflow''' (ERM42772)
:If a page with an embedded template is transferred to another language instance via the translation workflow, the customized templates there are no longer overwritten to prevent loss of changes. The adjustments that need to be made in the source wiki template must then also be entered manually in the target wiki for this template. As part of this implementation, the dialog has also been improved so that it is clearly recognizable which pages have not been translated by the translation workflow.
*'''UX BlueSpiceTranslationTransfer - Improve labels for BlueSpiceTranslationTransfer in ConfigManager''' (ERM44630)
:The labels in the configuration manager that refer to the BlueSpiceTranslationTransfer extension have been adjusted so that they are now displayed consistently.

==5.1.4==
{{#subobject:|Release=5|Releasedate=09.12.2025|Releasepatch=5.1.4}}
==== BlueSpice Free ====
*'''BlueSpiceCustomMenu - Custom menu is truncated if no content is defined''' (ERM44585)
:The custom menu is now displayed correctly again, even if no entries have been defined yet.
*'''BlueSpiceDiscovery - Strange styling is applied to text in source edit mode''' (ERM40541)
:When using source edit mode to edit a page, the text is no longer formatted twice.
*'''BlueSpiceExtendedSearch - The autocomplete search does not support camel casing''' (ERM42811)
:Camel casing is now taken into account in the autocomplete search, so that the correct results are displayed.
*'''NotifyMe - Using a custom logo causes display errors''' (ERM43895)
:The display error in emails when using a custom logo is now fixed. It is possible to use a <code>.jpg</code> file as a logo again. In addition it is also possible to adjust the size of the logo via <code>MediaWiki:Wrapper.mail</code>, which is applied to the displayed logo in an email.
*'''UX BlueSpiceCustomMenu - Improve empty custom menu view''' (ERM43523)
:If the custom menu contained no entries, only a small hint was displayed. As part of the UX review, the menu was designed to be more appealing and was aligned with the design of other empty menus.
*'''UX ContentDroplets - Improve labels for visual editor inspectors''' (ERM45082)
:As part of a UX review, the labels of the visual editing inspectors were revised and improved.

==== BlueSpice Pro ====
*'''BlueSpiceBookshelf - If a file containing a space is used for a book cover image, the image will not be displayed in the PDF export''' (ERM39969)
:If a file containing spaces is used for the book cover image, it is now encoded correctly so that the cover image is also displayed correctly in the PDF.
*'''BlueSpiceBookshelf - Bookshelf image is not displayed if file is uploaded to custom namespace''' (ERM38527)
:If a bookshelf image is uploaded to a custom namespace, it will now be displayed again on <code>Special:Books</code>.
*'''BlueSpiceBookshelf - <code>Edit book</code> action is visible to users without the appropriate permission''' (ERM44450)
:The Edit book action is now only displayed if the user has the appropriate permission.
*'''BlueSpiceBookshelf - Bookshelf image is sometimes blurry''' (ERM42225)
:The size of the image used on Special:Books has been increased from <code>350px</code> in width. This means that the available space is now <code>325px</code>, which avoids blurry images.
*'''BlueSpiceBookshelf – Using an non-closing parenthesis as a heading breaks the syntax of a book''' (ERM43357)
:If a non-closing parenthesis is used as a heading in a book, it is no longer considered an operant and the book page is created as well as displayed correctly.
*'''BlueSpiceBookshelf - Book export action doesn't work if PDF template does not exist anymore''' (ERM43521)
:If a PDF template is deleted that was set for export via the metadata of a book, the template falls back to the configuration in ConfigManager.
*'''BlueSpiceCategoryManager - Category manager is displayed in global actions even user is not allowed to access it''' (ERM44029)
:If a user has editing permissions, the category manager is displayed in the global actions menu. If a user has read permissions only, the link to the category manager is not displayed because the user wouldn't be allowed to access it.
*'''BlueSpiceExpiry - Filtering on <code>Special:Expiry</code> leads to infinite loading''' (ERM43363)
:If a filter is applied on the <code>Special:Expiry</code> or <code>Special:Reminder</code> pages, the results will be displayed correctly again.
*'''BlueSpiceExpiry - Expired watermark missing when user language is neither EN nor DE''' (ERM44170)
:The watermark is now displayed correctly again. If a language other than EN or DE is selected, the watermark automatically falls back to the EN default.
*'''BlueSpiceExtendedStatistics - Number of page visits for different intervals do not match''' (ERM36739)
:If the query <code>Visits per page</code> is selected on the page <code>Special:AggregatedStatistic</code> and executed with different intervals (daily, weekly, etc.), the actual values displayed will now match again.
*'''BlueSpiceReadConfirmation -Indicator for read confirmation task should only be displayed if its enabled in a namespace'''(ERM44746)
:The task indicator only appears for a requested read confirmation if it is enabled a namespace.
*'''CognitiveProcessDesigner - Prefixed processes are not respected during migration''' (ERM44887)
:If a process is created in a custom namespace and thus receives a prefix, this is now taken into account and the processes are recreated correctly during migration.
*'''DrawioEditor - Export to PDF via draw.io Editor doesn't work''' (ERM44873)
:When using draw.io's internal PDF export, PDFs are now generated correctly again.
*'''MWStakeComponent - Filtering for users in the user manager only works with lowercase letters''' (ERM43906)
:When filtering for users in the user manager, results are now displayed regardless of upper or lower case.
*'''PDFCreator - Using Tabber to display tables with a tab switch causes PDF export to fail''' (ERM44099)
:If a table is embedded on a page using Tabber and contains a tab switch to navigate between tables, PDF export will now work properly again.
*'''PDFCreator - Blank pages in export before and after content''' (ERM44666)
:When exporting a page, no blank page is added before or after the content.
*'''PDFCreator - Oversized images lead to incorrect display in exported file''' (ERM44707)
:If an oversized image is inserted on a page, for example by adding only a link, the images are now automatically scaled so that the export is displayed correctly.
*'''PDFCreator - Thresholds of PDFCreator and the PDF backend can lead to broken exports''' (ERM45158)
:The thresholds of PDFCreator and the PDF backend have been adjusted so that PDF export works properly again. In addition, the parameters are now configurable so that they can be flexibly adjusted if needed.
*'''PDFCreator - Default table styles of PDFCreator have contradicting style definitions''' (ERM44934)
:The default table styles of the PDFCreator extension have been improved so that tables no longer become wider vertically.
*'''PDFCreator - Empty header image renders wrong text in header area of exported file''' (ERM45266)
:If <code>$headerData['headerImage']</code> is empty, the header area of the exported file will still be rendered and displayed correctly.
*'''PDFCreator - File links do not work properly, and media links are not embedded when exporting a page''' (ERM45119)
:If file and media links are used on a page that is exported, the corresponding links now work properly again in the export.
*''' PDFCreator - Umlauts and special characters in headings cause the table of contents to not be numbered in the export''' (ERM44750)
:If umlauts or special characters are used in the headings, the pages in the table of contents of the exported file are now numbered correctly again.
*'''PreToClip - <code>Using the Copy to clipboard</code> button creates protected spaces''' (ERM44290)
:When using the <code>Copy to clipboard</code> button, unwanted protected spaces are no longer included when pasting the content.
*'''Workflows - Checkbox status for minor revision not persistent''' (ERM43221)
:When creating a workflow using the ui editor and editing the form <code>Edit wiki page</code>, the status of the <code>Minor revision?</code> checkbox is now persisted again.

==== BlueSpice Farm ====
*'''BlueSpiceTranslationTransfer - Embedding a <code>Gallery</code> droplet on a page leads to translation of file names which results in a broken view''' (ERM44573)
:If a <code>Gallery</code> droplet is inserted on a page, the file names are no longer translated and the gallery is displayed correctly. However, the image captions of the individual files are still taken into account for translation and are displayed correctly after the transfer.
*'''BlueSpiceTranslationTransfer - Allow translation and transfer of categories for files and transclusions''' (ERM44652)
:Categories for related page resources are now translated as well as transferred when using BlueSpiceTranslationTransfer. For files the description page is translated in a regular way, if the file also exists on the target wiki. In addition the catgories for transclusions (including templates) are also respected during the translation process.
*'''ContentTransfer - Introduce numerical and alphabetical sorting for the dropdown menu of receiving wikis''' (ERM44732)
:On the page <code>Special:ContentTransfer</code>, numerical and alphabetical sorting has been introduced for the dropdown of the receiving wikis, making it easier and faster for users to navigate.

==5.2 (cloud)==
Minor Release (cloud only)

{{#subobject:|Release=5|Releasedate=18.11.2025|Releasepatch=5.2}}
{| class="wikitable" style="width: 100%;"
|+
! style="" class="" |'''Extension'''
! style="" class="" |'''Description'''
! style="" class="" |'''BlueSpice Version'''
|-
| style="" |ChatBot
| style="" |Provides a chatbot in the user interface
| style="" |BlueSpice Pro
|-
| style="" |ChatIntegration
| style="" |Enables the integration of various chat services into the wiki
| style="" |BlueSpice Pro
|-
| style="" |External Content
| style="" |Allows embedding external content, such as markdown files, in your wiki pages
| style="" |BlueSpice Pro
|-
| style="" |IssueTrackerLinks
| style="" |Enables linking of tickets in the content area
| style="" |BlueSpice Pro
|-
| style="" |PreviewLinks
| style="" |Enables a page preview on page links shown in a popup
| style="" |BlueSpice Pro
|-
| style="" |WikiRAG
| style="" |Augmentation layer for wiki-powered LLMs
| style="" |BlueSpice Pro
|}

====Extensions removed====
{| class="wikitable" style="width: 100%;"
|+
! style="" class="" |'''Extension'''
! style="vertical-align:middle;text-align:center;" class="" |'''Replaced by'''
|-
| style="" |Popups
| style="vertical-align:middle;text-align:left;" | PreviewLinks
|-
| style="" |TextExtracts
| style="vertical-align:middle;text-align:left;" | No specific replacement was needed as the extension was only required due to dependencies on extension Popups
|}

===Features===

==== AI applications in BlueSpice ====
{{Textbox|boxtype=important|header=Wichtiger Hinweis!|text=Um die Funktionen für KI-Anwendungen nutzen zu können, müssen Sie einen externen KI-Dienst konfigurieren, der nicht zur Standardinstallation von BlueSpice gehört. Weitere Informationen finden Sie auf der Seite [[Handbuch:KI-Anbindungen_Überblick|KI-Anbindungen Überblick]].|icon=yes}}
* '''ChatBot - Introduction of a chatbot user interface for interacting with the wiki''' (ERM43232, ERM44360)
: BlueSpice 5.2 introduces a chatbot user interface. The chatbot provides an interface for users to ask questions about content in the wiki and to receive answers. It is possible to copy the answer to the clipboard or directly save it as a subpage of the user in the <code>User</code> namespace. In addition the chatbot also displays the reference pages used for the answer. This allows users to gain deeper insights into the topic.
* '''ChatBot - Introduction of an AI summary in the Search center''' (ERM43232)
: In addition to the chatbot user interface a summary feature based on artificial intelligence has been implemented in the Search center with BlueSpice 5.2. This feature aims to assist users in quickly obtaining a concise summary for a search term. It is a common practice often offered by search engines and proves to be useful to get a quick overview, indicating the relevant sources.
*'''WikiRAG - RAG pipeline export''' (ERM43432)
: BlueSpice 5.2 introduces a standardized way to export contents of the wiki to a RAG pipeline. It will provide pre-optimized page contents, ACL information, meta data and more that can easily consumed by RAG systems. It seemlessly integrates with the new <code>bluespice/ai</code> service.

==== Chat integrations into BlueSpice ====
{{Textbox|boxtype=important|header=Wichtiger Hinweis!|text=Um die Funktionen für die Chat-Integration in BlueSpice nutzen zu können, müssen Sie das Chat-Tool zusätzlich konfigurieren. Weitere Informationen finden Sie unter [[Handbuch:Erweiterung/ChatIntegration]].|icon=yes}}

* '''ChatIntegration - Introduction of a bot user to submit search queries to the wiki via chat''' (ERM42133)
: BlueSpice 5.2 introduces another option to expand the search function in the wiki. By connecting the chat service to the wiki, users can ask a bot user questions based on the content of the wiki. The bot user answers these questions directly in the chat, including the display of reference pages, so that users can get a quick overview and explore the topic in more depth via the references in the wiki. The following chat tools can be used for this purpose: MS Teams, Slack and Rocket.Chat.

*'''ChatIntegration - Introduction of linking from the wiki to a dedicated chat service''' (ERM42132)
: BlueSpice 5.2 introduces the option of linking to a chat service in the wiki. Six new content droplets are provided for this purpose, relating to various chat providers. These include: MS Teams, Slack, Rocket.Chat, Zoom, Google Meet and Matrix. The URL for a chat channel can then be specified in the respective droplet. Afterwards it is displayed via an icon in the content area of the page and an individual label can be added if desired. In addition there's also the possibility to integrate the icon into the title area of a page. This allows users to enrich the content of a page by linking the corresponding meeting rooms, making them more quickly accessible to other users.

*'''ChatIntegration - Introduction of <code>Share via MS Teams</code> action''' (ERM42134)
: BlueSpice 5.2 now offers the option of distributing content even faster in the area of chat integration. For this purpose, the <code>Share via MS Teams</code> action has been introduced, which can be found in the Page tools under the <code>Share page</code> button. If the wiki is connected to MS Teams, information can be distributed to the specified recipients quickly and easily.

*'''ChatIntegration - Introduction of an extended notification system by adding the chat as an additional communication channel''' (ERM42135)
: BlueSpice 5.2 now also allows notifications to be received in chat, thereby expanding the existing notification system with an additional channel. Similar to the extended search functionality for content in the wiki from the chat, the introduced bot user can now also be used for receiving notifications. It is important to note that the set frequency is not applied to the chat, but that notifications can be received here in real-time.

==== Support IT documentation and issue tracker links in BlueSpice ====
*'''BlueSpiceProDistributionConnector - Integrate extension <code>ExternalContent</code> and introduce new Content Droplets for supporting IT documentation in the wiki''' (ERM42842, ERM42843)
: BlueSpice 5.2 comes with a newly included extension called <code>ExternalContent</code> and two new droplets, that allow better support and simplification of IT documentation in the wiki. With <code>ExternalContent</code> it is now possible to embed external content from Git reprositories, e.g. markdown files. In addition it is also possible to embed files from a BitBucket repository as well.
*'''IssueTrackerLinks - Introduction of new Content Droplets for adding issue tracker links to a wiki page''' (ERM42845)
: BlueSpice 5.2 introduces additional content droplets in the area of issue tracker links. Specifically these are issues from GitHub, GitLab, and Jira that can be added to a page using an URL and subsequently highlighted visually. This allows page content to be enriched and overviews of current issues to be more easily visible. The issue tracker links can be inserted not only via a droplet, but are also automatically detected when copied and pasted into edit mode with a specific URL pattern.

=== Improvements ===

==== Accessibility improvements ====
BlueSpice 5.2 aims to improve the accessibility of the application in order to provide optimal support for accessibility in reading mode. For this purpose, the application has been thoroughly reviewed and several areas have been optimized. The changes are briefly listed below:
:
*'''WCAG 9.1.1.1 EnhancedStandardUIs - Add expand label on <code>Special:Pages</code>''' (ERM42902)
:
* '''WCAG 9.1.1.1 OOJSPlus - Add expand label for trees in general''' (ERM42902)
:
* '''WCAG 9.1.3.1 BlueSpicePrivacy - Fix privacy section in preferences''' (ERM42837)
:
* '''WCAG 9.1.3.1 BlueSpicePrivacy - Fix radio input label''' (ERM43782)
:
* '''WCAG 9.1.3.1 NotifyMe - Add notification panel to enhanced preferences''' (ERM42837)
:
* '''WCAG 9.1.3.1 OOJSPlus - Add booklet special page''' (ERM42837)
:
* '''WCAG 9.1.3.1 OOJSPlus - Add generic group select widget and fix filter widget''' (ERM42965)
:
* '''WCAG 9.1.3.2 EnhancedStandardUIs - Fix WCAG tree and namespace selector on <code>Special:Pages</code>''' (ERM42904)
:
* '''WCAG 9.1.3.2 OOJSPlus - Improve tree by using nested lists for screenreader compatibility''' (ERM42901)
:
* '''WCAG 9.1.3.2 OOJSPlus - Remove empty ul in html''' (ERM44493)
:
* '''WCAG 9.1.4.4 BlueSpiceDiscovery - Fix font size unit''' (ERM44495)
:
* '''WCAG 9.1.4.4 BlueSpiceExtendedSearch - Fix extended search in navbar''' (ERM44495)
:
* '''WCAG 9.1.4.4 EnhancedStandardUIs - Improve preferences mobile view''' (ERM44495)
:
* '''WCAG 9.1.4.4 NotifyMe - Fix button on preferences in tab notification''' (ERM44495)
:
* '''WCAG 9.1.4.10 BlueSpiceDiscovery - Fix mobile headings and action fields''' (ERM44496)
:
* '''WCAG 9.1.4.10 NotifyMe - Fix mobile buttons and improve link icon''' (ERM44496)
:
* '''WCAG 9.1.4.10 NotifyMe - Fix mobile version of notification center''' (ERM43785)
:
* '''WCAG 9.1.4.11 BlueSpiceDiscovery - Fix contrast of border for autocomplete search''' (ERM43067)
:
* '''WCAG 9.1.4.11 BlueSpiceDiscovery - Fix OOJS input field border color''' (ERM43065)
:
* '''WCAG 9.1.4.11 BlueSpiceDiscovery - Fix border color for multiselect widget''' (ERM43065)
:
* '''WCAG 9.2.1.1 NotifyMe - Add <code>read all</code> button and remove link to <code>Special:Preferences</code>''' '''for eliminating the dropdown in tab header''' (ERM43457)
:
* '''WCAG 9.2.1.1 PreviewLinks - Replace extension <code>PopUps</code> by extension <code>PreviewLinks</code> for improved accessibility''' (ERM43458)
:
* '''WCAG 9.2.1.4 BlueSpiceExtendedSearch - Add user preference for search shortcut''' (ERM44048)
:
* '''WCAG 9.2.4.1 BlueSpicePrivacy - Improve cookie banner accessibility''' (ERM44497)
:
* '''WCAG 9.2.4.3 BlueSpiceDiscovery - Fix focus order for sidebar toggle buttons and content''' (ERM44498)
:
* '''WCAG 9.2.4.4 BlueSpicePagesVisited - Add aria label for pages visited links''' (ERM43464)
:
* '''WCAG 9.2.4.6 BlueSpiceDiscovery - Fix labeling of skin areas''' (ERM43797)
:
* '''WCAG 9.2.4.6''' '''EnhancedStandardUIs - Improve section headings and paginator labels''' (ERM44499)
:
* '''WCAG 9.2.4.6 NotifyMe - Improve pagination announcement on <code>Special:NotificationCenter</code>''' (ERM44499)
:
* '''WCAG 9.3.1.2 EnhancedStandardUIs - Add missing translations for words and sections''' (ERM42295)
:
* '''WCAG 9.4.1.2 BlueSpiceExtendedSearch - Fix issues with announcing table and also announce results with screenreader''' (ERM43799)
:
* '''WCAG 9.4.1.2 EnhancedStandardUIs - Improve mobile view and fix raw preference buttons''' (ERM44502)
:
* '''WCAG 9.4.1.2 EnhancedStandardUIs - Improve label issues and watch announcement''' (ERM44504)
:
* '''WCAG 9.4.1.2 OOJSPlus - Fix announcement selectable for only content cells which are notselectable''' (ERM43799)
:

===== Noteable changes =====
In the course of the accessibility review, some components had to be revised, either with a new interface or modified behavior.

Therefore, special attention should be paid to the following changes:

*'''WCAG 9.1.3.1 EnhancedStandardUIs - Implement enhanced <code>Special:Preferences</code>''' (ERM42837)
: To improve the accessibility of content in BlueSpice 5.2, the page <code>Special:Preferences</code>, which is used for user settings, has been revised and redesigned. It promises better accessibility via tab and screenreader. In addition, the settings displayed have been revised and arranged in a logical manner.

*'''WCAG 9.1.3.1 OOJSPlus - Remove and improve filters for grids''' (ERM43063)
: To improve the accessibility of content in BlueSpice 5.2, filters have been removed as part of the grids and an improved filter option has been implemented to avoid misleading text output via the screenreader. All other content is accessible and can be controlled using the keyboard.

*'''WCAG 9.2.1.1 PreviewLinks - Replace extension <code>PopUps</code> by extension <code>PreviewLinks</code> for improved accessibility''' (ERM43458)
:To improve the accessibility of content in BlueSpice 5.2, the <code>PreviewLinks</code> extension has been introduced as a replacement for the <code>PopUps</code> extension. The tooltips, which display a preview of the page, now allow increased accessibility of content for screenreaders.

*'''WCAG 9.4.1.2 BlueSpiceExtendedSearch - Fix issues with announcing table and also announce results with screenreader''' (ERM43799)
:To improve the accessibility of content in BlueSpice 5.2, the recently viewed results in the autocomplete search have been revised. Misleading text output by the screenreader is now avoided with the removal of the remove buttons. All other content is accessible and can be controlled via the keyboard.

==== Further improvements ====
* ''' DrawioEditor - Implement a full-screen editing mode for draw.io diagrams''' (ERM37816)
:In BlueSpice 5.2, it is now possible to edit draw.io diagrams in full-screen mode. This is particularly useful for very large diagrams, as it enables adjustments to be made easily and clearly. From now on there will be two editing modes for draw.io diagrams: page view and full-screen mode. These modes can be configured via the configuration manager so that the selected setting is used as the default across the wiki. In addition, it is also possible to select the editing mode by inserting the diagram droplet so that users can choose according to their preferences.

*'''CognitiveProcessDesigner - Implement the ability to import BPMN-based XML files and download existing processes as XML''' (ERM42773)
:BlueSpice 5.2 now offers the option of importing BPMN-based XML files into the wiki. This allows large and complex processes to be made available in the wiki immediately and supports their further processing within the wiki. It is also possible to download existing processes in the wiki as BPMN-based XML files so that they can be reused in other places.

*'''UX PDFCreator - Enhanced visibility for PDF template editing''' (ERM44869)
:To increase the visibility of the PDF template editing option, it has been added to the global actions mega menu. This makes it easier for users to access the PDF template editor.

*'''UX StandardDialogs - Improved consistency of dialogs in BlueSpice''' (ERM43047, ERM42551, ERM42202, ERM42275, ERM42197)
:As part of a UX review in BlueSpice 5.2 various dialogs were audited and improved in terms of consistency. This includes smoothening actions, labeling and more. Just to name a few places where dialogs have been improved: user manager, upload, workflow triggers, expiry, bookshelf and processes.

*'''UX OOJSPlus - Add more skeleton loaders to mark loading processes''' (ERM42277, ERM42415)
:As part of a UX review in BlueSpice 5.2, additional skeleton loaders were added to the application so that loading processes are more clearly visually distinguished. This applies, for example, to workflow triggers and the tasks overview.

*'''UX ContentDroplets - Improved layout of the Content Droplet inspectors''' (ERM43452)
:As part of a UX review in BlueSpice 5.2 the layout of various inspectors used for content droplets has already been improved. The aim is to make the inspectors clearer, give them more specific labels and provide meaningful help texts.

=== Changes and bugfixes ===

===Notable changes===

==== Free ====
*'''BlueSpiceDiscovery - Improve browser contrast settings''' (ERM44761)
:If a color setting is made via the browser, the contrasts are now automatically optimized and adapt the browser setting.
*'''BlueSpiceExtendedSearch - Correction suggestion not active for fuzzy search queries''' (ERM43405)
:The correction suggestion for a fuzzy search query is now possible again. However, a search reindex is necessary to restore functionality.

===Bugfixes===

==== BlueSpice Free ====
*'''BlueSpiceCustomMenu - Custom menu is truncated if no content is defined''' (ERM44585)
:The custom menu is now displayed correctly again, even if no entries have been defined yet.
*'''BlueSpiceDiscovery - Strange styling is applied to text in source edit mode''' (ERM40541)
:When using source edit mode to edit a page, the text is no longer formatted twice.
*'''UX BlueSpiceCustomMenu - Improve empty custom menu view''' (ERM43523)
:If the custom menu contained no entries, only a small hint was displayed. As part of the UX review, the menu was designed to be more appealing and was aligned with the design of other empty menus.

==== BlueSpice Pro ====
*'''BlueSpiceBookshelf - If a file containing a space is used for a book cover image, the image will not be displayed in the PDF export''' (ERM39969)
:If a file containing spaces is used for the book cover image, it is now encoded correctly so that the cover image is also displayed correctly in the PDF.
*'''BlueSpiceBookshelf - Bookshelf image is not displayed if file is uploaded to custom namespace''' (ERM38527)
:If a bookshelf image is uploaded to a custom namespace, it will now be displayed again on <code>Special:Books</code>.
*'''BlueSpiceBookshelf - <code>Edit book</code> action is visible to users without the appropriate permission''' (ERM44450)
:The Edit book action is now only displayed if the user has the appropriate permission.
*'''BlueSpiceBookshelf - Bookshelf image is sometimes blurry''' (ERM42225)
:The size of the image used on Special:Books has been increased from <code>350px</code> in width. This means that the available space is now <code>325px</code>, which avoids blurry images.
*'''BlueSpiceExpiry - Filtering on <code>Special:Expiry</code> leads to infinite loading''' (ERM43363)
:If a filter is applied on the <code>Special:Expiry</code> or <code>Special:Reminder</code> pages, the results will be displayed correctly again.
*'''BlueSpiceExpiry - Expired watermark missing when user language is neither EN nor DE''' (ERM44170)
:The watermark is now displayed correctly again. If a language other than EN or DE is selected, the watermark automatically falls back to the EN default.
*'''BlueSpiceExtendedStatistics - Number of page visits for different intervals do not match''' (ERM36739)
:If the query <code>Visits per page</code> is selected on the page <code>Special:AggregatedStatistic</code> and executed with different intervals (daily, weekly, etc.), the actual values displayed will now match again.
*'''BlueSpiceReadConfirmation -Indicator for read confirmation task should only be displayed if its enabled in a namespace'''(ERM44746)
:The task indicator only appears for a requested read confirmation if it is enabled a namespace.
*'''CognitiveProcessDesigner - Prefixed processes are not respected during migration''' (ERM44887)
:If a process is created in a custom namespace and thus receives a prefix, this is now taken into account and the processes are recreated correctly during migration.
*'''DrawioEditor - Export to PDF via draw.io Editor doesn't work''' (ERM44873)
:When using draw.io's internal PDF export, PDFs are now generated correctly again.
*'''MWStakeComponent - Filtering for users in the user manager only works with lowercase letters''' (ERM43906)
:When filtering for users in the user manager, results are now displayed regardless of upper or lower case.
*'''PDFCreator - Using Tabber to display tables with a tab switch causes PDF export to fail''' (ERM44099)
:If a table is embedded on a page using Tabber and contains a tab switch to navigate between tables, PDF export will now work properly again.
*'''PDFCreator - Blank pages in export before and after content''' (ERM44666)
:When exporting a page, no blank page is added before or after the content.
*'''PDFCreator - Oversized images lead to incorrect display in exported file''' (ERM44707)
:If an oversized image is inserted on a page, for example by adding only a link, the images are now automatically scaled so that the export is displayed correctly.
*'''Workflows - Checkbox status for minor revision not persistent''' (ERM43221)
:When creating a workflow using the ui editor and editing the form <code>Edit wiki page</code>, the status of the <code>Minor revision?</code> checkbox is now persisted again.

==== BlueSpice Farm ====
*'''BlueSpiceTranslationTransfer - Embedding a <code>Gallery</code> droplet on a page leads to translation of file names which results in a broken view''' (ERM44573)
:If a <code>Gallery</code> droplet is inserted on a page, the file names are no longer translated and the gallery is displayed correctly. However, the image captions of the individual files are still taken into account for translation and are displayed correctly after the transfer.
*'''ContentTransfer - Introduce numerical and alphabetical sorting for the dropdown menu of receiving wikis''' (ERM44732)
:On the page <code>Special:ContentTransfer</code>, numerical and alphabetical sorting has been introduced for the dropdown of the receiving wikis, making it easier and faster for users to navigate.
==5.1.3==

This release contains the security fix for [https://en.wiki.bluespice.com/wiki/Security:Security_Advisories/BSSA-2025-06 BSSA-2025-06].{{#subobject:|Release=5|Releasedate=27.10.2025|Releasepatch=5.1.3}}
=== BlueSpice Free ===

* '''BlueSpiceConfigManager - Configuration changes cannot be saved by using the search box because save button is disabled''' (ERM43178)
:If a configuration is to be changed in ConfigManager and the corresponding configuration is filtered using the search box, the tab on the left is automatically preselected so that the save button is active.
*'''BlueSpiceDiscovery - Ampersand in page title causes subpage names are not shown correctly''' (ERM44037)
:It is now possible to use an ampersand in the page title without causing display issues in the wiki.
* '''BlueSpiceDiscovery - Section links in the Search center do not work properly''' (ERM43182)
: Clicking on a section link in the Search center forwards the user to the corresponding page and automatically scrolls to the relevant section.
* '''BlueSpiceDiscovery - Style of multimedia viewer should be aligned to the Discovery skin''' (ERM44081)
: The style of the multimedia indicator has been aligned to the Discovery skin.
* '''BlueSpicePermissionManager - When a group is renamed, the permissions for the old group are retained''' (ERM43152)
: If a group is renamed in the permission manager, the permissions are transferred correctly. Also after a group is deleted, the corresponding permissions assigned to it are deleted properly.
*'''BlueSpicePrivacy - User settings for convenience cookies are not respected''' (ERM42363)
:If a user intentionally rejects convenience cookies, these cookies will no longer be set.
* '''EnhancedUpload - When using drag and drop for uploading an image which is a duplicate, an error message is shown''' (ERM43755)
: If a user attempts to add an image to a page using drag and drop and the image is a duplicate, a dialog will now appear. It informs the user that it is a duplicate file and asks whether they would like to use the original file instead.
*'''Lingo - BlueSpice LTS does not use the latest version of Lingo''' (ERM44438)
:The new release of BlueSpice includes the latest version of the extension Lingo, namely version <code>3.2.4</code>.
* '''NotifyMe - User name is displayed incorrectly in mail sent when user name contains a dot''' (ERM43879)
: When resetting the password of a user who has a dot in their username, the username is now displayed correctly in the email.
* '''PDFCreator - Mathematical formulas and PDFHandler images are not exported correctly''' (ERM41796)
: The display of mathematical formulas has been improved in PDF export. Furthermore, it is now possible again to export thumbnails that are integrated via PDFHandler.
* '''BlueSpiceUserManager - It's not possible to add new users as well as editing existing ones''' (ERM44481)
: Adding new users as well as editing existing users via Special:UserManager works again.
* '''UX BlueSpiceUserSidebar - Watchlist entry should be displayed in the default user menu, even if the user has not yet added any pages to the watchlist''' (ERM43373)
: In the user menu that is delivered as standard, the Watchlist entry is now always present, even if the user has not yet added any pages to their watchlist. Below the heading Watchlist, it is indicated that there are no entries yet. As soon as the user adds pages to the watchlist, these are displayed as usual as soon as changes are made by other users. If the Watchlist entry in the user menu is not desired, it can be easily removed via menu editing.
*'''VisualEditor - When a displaytitle is set, it's not visible in the page options after page has been reopened''' (ERM44042)
:Once a display title has been assigned via the page options, it will be visible in the visual editor when the page options dialog is reopened. If the display title is changed again, the display will adjust accordingly after the page is saved.
* '''VueJsPlus - It is no longer possible to expand and collapse chapters in the book tree''' (ERM43293)
: Expanding and collapsing chapters in the book tree now works correctly again.

=== BlueSpice Pro ===

==== Noteable changes ====
* '''AIEditingAssistant - It's not possible to define the AI model via the configuration manager''' (ERM43680)
: The corresponding AI model can now be specified via the configuration manager.

==== Bugfixes ====
* '''BlueSpiceCategoryManager - The query “Pages in categories” does not show any results''' (ERM43624)
: If the query type Pages in categories is selected on the page Special:AggregatedStatistics, it will now display results again.
* '''BlueSpiceFilterableTables - Date format is not displayed correctly in filterable tables if they are based on a template with a query''' (ERM43615)
: The date format is now displayed correctly in filterable tables, even if they are based on a template with a query.
*'''CognitiveProcessDesigner - Custom XML File cannot be used for creating new processes because the bpmn: prefix is missing'''(ERM44011)
:When using a custom <code>XML</code> file containing a <code>BPMN</code> definition of a process, it is now possible for creating new processes despite the missing <code>bpmn:</code> prefix.
*'''CognitiveProcessDesigner - Saving a process prevents the SVG being created and displays an error message''' (ERM44539)
:Saving a process while simultaneously creating an SVG file now works again.
* '''DrawioEditor - draw.io diagram not updated because of browser cache''' (ERM37845)
: Draw.io diagrams are now displayed correctly after saving and refreshing the page.
* '''PDFCreator - If there is an internal link to a page that is part of the PDF, turn it into a jump link.''' (ERM43643)
: If a book is created that contains a page link to a page that is also part of the book, the user is redirected to the corresponding chapter. If the page to which a page link within a book page points is not part of the book, the page is opened in the wiki. This behavior is also reflected in the book export, provided that links are allowed in the corresponding book template.
*'''PDFCreator - PDF export fails when a font style is appended inline after existing text''' (ERM43194)
:All 14 base fonts are now included in the <code>webservice-html2pdf</code> and loaded in the <code>.jar</code>. In addition the font styles <code>Monospace</code> and <code>Serif</code> are now supported when using them inline for existing text. Then the font styles are also displayed correctly in the exported file.
* '''PDFCreator - Width of figcaption is not limited to thumbnail width when exporting a page''' (ERM44153)
: The width of the caption when exporting a page is now adjusted to the thumbnail so that the export looks more appealing and avoids unsightly line breaks.
* '''PDFCreator - If a page name contains umlauts, it will be encoded incorrectly when exporting to PDF''' (ERM44431)
: The encoding when exporting pages with an umlaut in the page title has been improved so that umlauts are now displayed correctly in the downloaded file.
* '''SimpleTasks - Tasks do not generate semantic properties''' (ERM44300)
: When a task on a page is created, the semantic properties are now also created using a subobject, which can be viewed on the page properties page. This also enables the ContentDroplet Task report to work again properly, which displays the corresponding tasks in the wiki.
*'''SemanticResultFormats - SearchPanes do not work and cause a DBLanguageError''' (ERM42416)
:The issue has been fixed and using search panes is now possible again.
*'''SemanticResultFormats - Upgrade SemanticResultFormats to latest version''' (ERM43971)
:The latest version of SemanticResultFormats has been released and is used with the current release of BlueSpice.
*'''Workflows - Workflow triggers are executed multiple times''' (ERM42583)
:If a workflow trigger is defined, it will now only trigger once.
*'''Workflows - Cannot start a workflow on a <code>.formadata</code> page''' (ERM36518)
:It is now possible to start a workflow on a <code>.formdata</code> page.

=== BlueSpice Farm===
* '''BlueSpiceWikiFarm - ContentTransfer is not showing instances that are created from existing wiki''' (ERM43401)
: Cloned instances are now also displayed again in the selection of the receiving wiki on the page Special:ContentTransfer.
*'''UX BlueSpiceTranslationTransfer - Improve the view of configuration settings in ConfigManager''' (ERM43401)
:The configuration options for the BlueSpiceTranslationTransfer extension have been improved in the configuration manager. This includes a clearer visual presentation as well as unambiguous labels and help texts.

== 5.1.2 ==
Dieses Release enthält den Sicherheitsfix für [https://www.cve.org/CVERecord?id=CVE-2025-46703 CVE-2025-46703], [https://www.cve.org/CVERecord?id=CVE-2025-48007 CVE-2025-48007], [https://www.cve.org/CVERecord?id=CVE-2025-57880 CVE-2025-57880], [https://www.cve.org/CVERecord?id=CVE-2025-58114 CVE-2025-58114].

{{#subobject:|Release=5|Releasedate=18.09.2025|Releasepatch=5.1.2}}

*'''BlueSpice Docker - Wiki uses UTC as default timezone, but should use local timezone instead''' (ERM42851)
:It is now possible that timezone can be set via env variable. Docker images are updated accordingly.

=== BlueSpice Free ===
*'''Vulnerabilities in various extensions''' (ERM44091)
:Fix for the vulnerabilities from security advisory [https://en.wiki.bluespice.com/wiki/Security:Security_Advisories/BSSA-2025-05 BSSA-2025-05].
*'''BlueSpiceDiscovery - Sidebar is displayed on Special:PasswordReset and Special:UserLogout although anonymous users are not allowed to read the wiki due to permission concept''' (ERM43672)
:The sidebar is no longer visible on <code>Special:PasswordReset</code> as well as <code>Special:UserLogout</code> if anonymous users are not allowed to read the wiki.
*'''BlueSpiceDiscovery - EnhancedSidebarTree is not stateful''' (ERM42333)
:When using the enhanced MediaWiki sidebar, tabs that have been opened or closed in the navigation now retain their state.
*'''BlueSpiceDiscovery - Remove white space between label and input field in media dialog''' (ERM43927)
:The white space between the label and the input field in the media dialog (tab <code>General</code>) has been adjusted accordingly.
*'''BlueSpiceDiscovery - Right sidebar should be expanded by default''' (ERM43125)
:The right sidebar was hidden during the first login, which was not ideal for new users because they could not see the functionalities of the right sidebar at first glance. From now on, the right sidebar is displayed by default, unless the user decides to collapse it.
*'''BlueSpiceDiscovery - Add caching while using the enhanced MediaSiki sidebar to improve performance''' (ERM42889)
:Caching was introduced when using the enhanced MediaWiki sidebar so that the performance of the application can be improved.
*'''BlueSpiceDistributionConnector - When using the query <code>Page visits in relation</code>, only DivisionByZeroError is displayed''' (ERM43806)
:When using the query <code>Page visits in relation</code> on the page <code>Special:AggregatedStatistic</code> , a result is now displayed again.
*'''BlueSpiceExtendedSearch - Add BlueSpiceExtendedSearch to <code>/w/opensearch_desc.php</code>''' (ERM377723)
:It is possible to configure the search so that it can also be started in the wiki via the URL address bar.
* '''BlueSpiceExtendedSearch - When using the ContentDroplet <code>Search field</code> with restriction of sources, the search is executed in all available indexes'''
(ERM42563)
:If the droplet Search field with source restriction is inserted on a page, search results from the current instance are displayed.
*'''BlueSpiceExtendedSearch - The values defined in the input field <code>type</code> using the ContentDroplet <code>Search field</code> are not transferred''' (ERM43745)
:If the ContentDroplet <code>Search field</code> is used on a page and values are specified for the <code>type</code>, these are now correctly applied and displayed in the wiki text.
*'''BlueSpiceExtendedSearch - The creation date is more recent than the modification date in the Search center''' (ERM36533)
:If files are uploaded to the wiki and modified after a certain period of time, both the creation and modification dates are now displayed correctly.
*''' BlueSpicePagesVisited - User sidebar displays JSON code of a form''' (ERM37944)
:The user sidebar no longer displays JSON code under the visited pages tab, but only the page that the user has visited.
*''' BlueSpiceVisualEditorConnector - Although no changes have been made to a page and editing is canceled, a prompt appears asking whether editing should really be canceled''' (ERM41515)
:If no changes are added to a page, it is now possible to cancel edit mode without a confirmation prompt being displayed. The application behaves differently if a change has actually been made and unsaved changes could be lost - in this case, a confirmation prompt is displayed.
*'''BlueSpiceVisualEditorConnector - Once a cell border has been removed, it cannot be added again''' (ERM42795)
:Adding and removing cell borders now works correctly again.
*'''EnhancedStandardUIs - The page <code>Special:Pages</code> fails to load if a user only has permissions for the <code>Blog talk</code> namespace but not for the <code>Blog</code> namespace''' (ERM43159)
:The page <code>Special:Pages</code> will now load even if the user is only allowed to read the <code>Blog talk</code> namespace and not the <code>Blog</code> namespace.
*'''EnhancedStandardUIs - Loading indicator missing when switching to next page or changing namespace'''(ERM42833)
:If the paginator is used or the namespace is changed on the page <code>Special:Pages</code>, this is now indicated by a loading indicator.
*'''EnhancedStandardUIs - Infinite loading when searching for just one letter on the page <code>Special:Pages</code>''' (ERM42229)
:Searching for just one letter on the page <code>Special:Pages</code> no longer results in endless loading, but displays a result within a reasonable amount of time.
*'''EnhancedUpload - No comprehensible sorting after uploading files to ContentDroplet <code>Attachments</code> ''' (ERM43448)
:If the ContentDroplet <code>Attachments</code> is inserted on a page and files are added to it, the files are sorted according to the upload order. In addition, there is the option of temporarily sorting the files alphabetically in ascending or descending order.
*'''OOJSPlus - The number of entries displayed in the version history is incorrect''' (ERM43274)
:The number of entries in the version history is now displayed correctly again.
*'''OOJSPlu - If the quick access button to the last page of the version history is selected, the incorrect entry is displayed''' (ERM43277)
:If the user jumps to the last position in the version history using the quick access button, the correct entry is now displayed again.
*'''OOJSPlus - If a page is edited by an anonymous user, only the IP address is displayed in the version history instead of an avatar''' (ERM43754)
:If a page is edited by an anonymous user, the avatar for an unknown user is displayed in the version history as usual.This also applies to other locations in the wiki, such as the page information dialog, the notification center, and others.
*'''UserProfile - Distorted profile picture after upload''' (ERM43450)
:If an image is more rectangular in shape, it will no longer be stretched when displayed on the user profile.
*'''UX BlueSpiceAvatars - Align cancel action in profile image dialog''' (ERM43455)
:During a UX review, the cancel action in the profile picture editing dialog was adjusted to match the standard used in the application.
*'''UX BlueSpiceConfigManager - Configmanager toolbar labels must use messages instead of hardcoding labels''' (ERM43358)
:During a UX review, the labels in the configuration manager were audited and hard-coded labels were changed to messages so that they can be translated.

=== BlueSpice Pro ===
*'''Security Vulnerabilities Disclosure regarding Cognitive Process Designer''' (ERM43951)
:From now on, the svg file is validated before saved. If it is invalid or dangerous, the process will still be saved, but without storing the svg file.
*'''BlueSpiceBookshelf - Indents for subchapters are not displayed correctly in the book editor''' (ERM38516)
:The indentations for subchapters are now displayed correctly in the book editor. Furthermore, improvements have been made to the drag and drop mode in the book editor as part of this ticket.
*'''BlueSpiceBookshelf - Class <code>class="mw-headline-number hidden"</code> does not work''' (ERM42927)
:A hidden <code>mw-headline-number</code> has been introduced to headings, so that the <code>class="mw-headline-number hidden"</code> is displayed in the body.
*'''BlueSpiceBookshelf - Legacy bookshelf tag causes page break, so that there's a empty page before TOC displayed''' (ERM43439)
:The legacy Bookshelf tag has been removed so that unnecessary page breaks are no longer generated.
*'''BlueSpiceBookshelf - Button for expanding a chapter disappears when clicking on a subchapter''' (ERM43426)
:When opening a book chapter with subchapters, the button for expanding and collapsing the chapter now remains visible.
*'''BlueSpiceInsertCategory - Adding a category to a form page results in error''' (ERM37237)
:Categories can now be added to form pages.
*'''BlueSpiceExpiry - When a page expires, the date on the page <code>Special:Expiry</code> is not marked in red color''' (ERM43687)
:When a page becomes outdated, the expiration date is now displayed in red color on the page <code>Special:Expiry</code>.
*'''BlueSpiceExportTables - There are unnecessary empty rows in the statistics export''' (ERM43569)
:When statistics are exported on the page <code>Special:AggregatedStatistic</code>, the export no longer contains unnecessary and empty rows.
*'''BlueSpiceExtendedStatistics - Monthly evaluations are displayed negatively with regard to their values''' (ERM38330)
:The monthly evaluation of queries on <code>Special:AggregatedStatistic</code> is now displayed correctly.
*'''BlueSpiceExtendedStatistics - Add descriptions to the individual queries in the dropdown''' (ERM43625)
:For better clarity, descriptions have been added to the individual queries for the statistics in the selection dropdown.
*'''BlueSpiceExtendedStatistics - No total hits for the query <code>Number of search queries</code> displayed''' (ERM37900)
:The total number of hits for the query <code>Number of search queries</code> are displayed again.
*'''BlueSpiceRating - Recommendations can only be used if ratings are enabled in the NamespaceManager''' (ERM43179)
:Recommendations now work again regardless of whether rating is enabled in a namespace or not.
*'''BlueSpiceReminder - Special:Preferences doesn't display dropdown for namespace selection''' (ERM43029)
:Namespaces for reminders can now be selected again in the user preferences.
*'''CognitiveProcessDesigner - Swim lane label updates are not reflected in page paths''' (ERM42740)
:The swim lane labels and general activities are now displayed correctly in the page paths. In addition, the renaming mechanism has been improved so that it is no longer necessary to click outside the shape in order to save the change.
*'''CognitiveProcessDesigner - Process diagram cannot be saved due to use of an unescaped character''' (ERM43493)
:If a process diagram is created with an apostrophe, it can now be saved correctly.
*'''CognitiveProcessDesigner - If process ns is exclusive for a group, option for creating a new process should not be displayed''' (ERM43942)
:If editing the process namespace is restricted for a specific group via permissions, the <code>Create new process</code> action will no longer be displayed on the page <code>Special:ProcessOverview</code>.
*'''ContentStabilization - Introduce a body class for the page status''' (ERM39797)
:The page status is now defined as a body class for the extension <code>ContentStabilization</code>. Specifically, these are the classes: <code>cs-stable</code> / <code>cs-unstable</code>, <code>cs-state-first-unstable</code>, <code>cs-state-unstable</code>, <code>cs-state-stable</code>, and <code>cs-state-implicit-unstable</code>. For further information, please refer to our helpdesk.
*'''DrawioEditor - When approval is active, the approved version of draw.io is no longer displayed on a page, only the draft version is shown''' (ERM43640)
:If approval is active in a namespace and a new version of a draw.io diagram is created, the draft and the approved page will now be displayed correctly.
*'''DrawioEditor - Links are shifted if they are located within a container shape''' (ERM40870)
:If a draw.io diagram is created with containers that also contain linked shapes, these links now work both inside and outside the container.
*'''DrawioEditor - Improve the description for a draw.io diagram and support the display of the image''' (ERM43189)
:The link to the file description page is now located as an additional entry next to the function for editing the diagram. In addition, another option has been introduced during the insertion of the draw.io diagram, allowing the diagram itself to be aligned left, centered, or right on a page.
*'''DrawioEditor - SVG links from internal links (including jump links) do not work''' (ERM43382)
:SVG links from internal and external links in a draw.io diagram are now working properly again.
*'''DrawioEditor - Fix broken draw.io internal function for PDF export''' (ERM42986)
:The draw.io editor has its own PDF export function, which is now working again and can be used as an export option.
*'''DrawioEditor - When a draw.io diagram is exported as a PDF, the text inside shapes is cut off''' (ERM43383)
:If a draw.io diagram is created with shapes in which additional text has been inserted, the text will no longer be cut off in the PDF output. If the text extends beyond the shape, it is recommended to enlarge the shape and initiate a new export.
*'''DrawioEditor - Scaling draw.io causes links to shift''' (ERM40483)
:Scaling draw.io no longer causes links to shift. Links within shapes remain in place.
*'''DrawioEditor - If a description is added to a draw.io diagram, it is not visible in the HTML''' (ERM43679)
:If a description is added when inserting a draw.io diagram, it is now visible in the HTML.
*'''ImportOfficeFiles - Word import fails when importing a file with a duplicate image''' (ERM43212)
:If a Word file with a duplicate image is imported, the import no longer fails. In <code>Rename</code> mode, a duplicate of the image is created, and in <code>Override</code> mode, the duplicate of the image is overwritten.
*'''MultimediaViewer - MultimediaViewer fails to handle file names containing <code>+</code>''' '''character''' (ERM42881)
:If a file with a <code>+</code> in its name is uploaded to the wiki, the MultimediaViewer can now encode the file name correctly, allowing the file to be previewed again.
*'''NSFileRepo - File versioning fails''' (ERM43331)
:If a new version of a file is uploaded to a namespace, it is now possible to revert and delete the first / original file again.
*'''NumberHeadings - Heading numbering is not displayed correctly in exported file''' (ERM43395)
:If heading numbering is activated via the configuration manager, the heading numbering in the exported file will now be displayed correctly again.
*'''PDFCreator - The <code><pdfexcludestart></code> tag does not consider the exclusion of headings in the TOC''' (ERM42812)
:If an entire chapter is excluded from export via the <code><pdfexcludestart></code> tag, the heading will no longer be displayed in the PDF's table of contents.
*'''PDFCreator - The <code>embed-page-toc</code> config was not restricted for export and TOC was always shown''' (ERM42226)
:With setting config <code>embed-page-toc</code> the TOC for multiple page export is not added to PDF as well as the page TOC is not shown if setting is active.
*'''PDFCreator - The ampersand character causes to generate a blank page with no content when exporting to PDF''' (ERM42882)
:It is now possible to use an ampersand in the page title without causing display issues in an exported file.
*'''PDFCreator - Export of a page with a svg thumb image fails''' (ERM43074)
:If an SVG image is embedded on a page and displayed as a thumbnail, this page can now be exported again correctly.
*'''SemanticResultFormats - SearchPanes do not work and cause a DB language error''' (ERM42415)
:The issue has been fixed and using search panes is now possible again.
*'''UX BlueSpiceCategoryManager - When creating a new category, the behavior must be adapted to the creation of a new page, as otherwise an error message will appear in the case of duplicates''' (ERM43012)
:If a new category is created in the category manager that already exists, the user is now informed by a message in the dialog to rename the category.
*''' UX Workflows - Edit icon should not contain class <code>destructive</code>''' (ERM42987)
:As part of the UX review, the class <code>destructive</code> was removed from the edit icon on <code>Special:WorkflowTriggers</code>, as this could be misinterpreted when using a different skin.
*'''Workflows - Revision of a MediaWiki:Workflow_Example.bpmn page cannot be reset in the version history''' (ERM42381)
:If a new workflow is defined in the <code>MediaWiki</code> namespace using the Workflow UI Editor, it is now possible to reset changes via the version history.
*'''Workflows - Moving the definition page of a running workflow causes errors on <code>Special:Workflows_overview</code> and <code>Special:My_tasks</code>''' (ERM42826)
:Moving the workflow definition page is now prevented as soon as the workflow is active on a page in the wiki.
*'''Workflows - Missing german translations for Workflows extension''' (ERM43257)
:Some German translations for the extension <code>Workflows</code> have been updated and adapted. In addition, the translations for the extension <code>Forms</code> have also been updated as part of this ticket.

=== BlueSpice Farm ===
*'''BlueSpiceWikiFarm - Add link to <code>Special:Farm_management</code> to global actions''' (ERM43335)
:To enable faster access to farm management in the future, the link to it has been added to the global actions.
*'''BlueSpiceWikiFarm - The farm creation fails if the instance is created by a user with spaces in their username''' (ERM43525)
:If a user with spaces in their username wants to create a new farm instance, this now works correctly again.
*'''BlueSpiceWikiFarm - Group assignment is lost when creating a new instance''' (ERM42342)
:If a new instance is created or cloned via the page <code>Special:Farm_management</code> and a group is specified in the form, the new or cloned instance is now also assigned to this group and appears under the corresponding tab.

=== BlueSpice Cloud ===
*'''BlueSpiceCloudClient - Storage ratio is not displayed on <code>Special:Instance_Status</code> for Cloud edition''' (ERM43561)
:The storage ratio of the wiki is now displayed correctly on the page <code>Special:Instance_Status</code> for Cloud edition.

== 5.1.1 ==
{{#subobject:|Release=5|Releasedate=16.07.2025|Releasepatch=5.1.1}}
=== BlueSpice Free ===

==== Noteable changes ====
* '''BlueSpiceInsertCategory - Settings in ConfigManager do not work''' (ERM29755)
: The functionality of the setting <code>Set page categories as default in upload dialog</code> in the ConfigManager has been restored and can now be used again. In addition, the setting <code>Insert category with its parent</code> has been removed from the ConfigManager as it no longer has any functionality.
* '''MediaWiki - Newly uploaded files are not displayed on <code>Special:RecentChanges</code>''' (ERM41297)
:If a user uploads a new file, this action can now also be seen on the page <code>Special:RecentChanges</code>.

*'''NotifyMe - Improve concept of digest mails''' (ERM39568)
: The concept of digest mails has been adjusted. Mails are now sent at 7am for <code>Frequency: Daily</code> and at 7 am on Monday for <code>Frequency:Weekly</code>. In the course of this change, the introductory sentence was also adapted so that it is clear that the changes refer to the last 24 hours or the last week in the wiki.
==== Bugfixes ====
* '''BlueSpiceDiscovery - Header of dialog is shifted when using the ContentDroplet <code>Modal button</code>''' (ERM41380)
: When using the droplet <code>Modal button</code>, the header is now displayed correctly when opening the dialog.
* '''BlueSpiceDiscovery - Invalid page titles break enhanced sidebar subpage tree''' (ERM42605)
:Invalid pages titles no longer break the enhanced sidebar subpage tree.
* '''BlueSpiceDiscovery - Button for creating new pages should respect permission settings of a wiki''' (ERM42523)
: If a wiki is protected or can be viewed by anonymous readers via a custom setup, the button for creating new pages is now disabled and cannot be clicked.
*'''BlueSpiceExtendedSearch - AC doesn't feature <code>search in book</code> if user is on a book page''' (ERM43077)
:If a user is in a book and enters a search term via the autocomplete search, the option <code>in book</code> is now also suggested.
*'''BlueSpiceExtendedSearch - When using the ContentDroplet <code>Search field</code> with restriction of sources, the search is executed in all available indexes''' (ERM42563)
:If the droplet <code>Search field</code> with source restriction is inserted on a page, only search results from the current instance are displayed.
* '''BlueSpiceExtendedSearch - HTML tag visible when searching for page in subpages via Search center''' (ERM42560)
: The html tag is no longer displayed when searching for a subpage via Search center.
* '''BlueSpiceExtendedSearch - Display of results with many hits in ContentDroplet <code>Search field</code> looks broken''' (ERM42418)
: If many hits are found via the droplet <code>Search field</code>, these are displayed properly in the dropdown again.
* '''BlueSpiceExtendedStatistics - Label for namespace <code>(Pages)</code> is missing in namespace selection''' (ERM42777)
: When using the report type <code>Pages in categories</code> on <code>Special:AggregatedStatistic</code>, the label for the namespace <code>(Pages)</code> is visible again in the selection dropdown.
* '''BlueSpiceDistributionConnector - Params <code>poster</code>, <code>cover</code>and <code>title</code>for videos aren't working in Discovery''' (ERM35098)
: The params <code>poster</code>, <code>cover</code> and <code>title</code>work again when embedding a video on a page.
* '''BlueSpiceNamespaceManager - Action for hiding talk namespaces is non-functional''' (ERM39915)
: The handling of the action <code>Hide talk namespaces</code> on <code>Special:NamespaceManager</code> has been improved and was made more userfriendly.
* '''BlueSpicePageAssignments - User picker for assigning a page doesn't work''' (ERM42609)
: The assignment of a user to a page works again, as users are displayed and can be selected via the dropdown.
* '''BlueSpicePageTemplates - Page templates should not be displayed if the user does not have permission to create a page''' (ERM42564)
: If a user does not have the permission to create a page, a message about the missing permission is now displayed.
*'''BlueSpicePageTemplates - Templates from the namespace <code>Template</code> cannot be found''' (ERM42183)
:When selecting a template on <code>Special:PageTemplateAdmin</code>, templates from the <code>Template</code> namespace can be found again.
* '''BlueSpicePermissionManager - Setting permissions for anonymous users breaks inheritance''' (ERM42917)
:The permissions set for anonymous users no longer break the inheritance for other user groups.
* '''BlueSpiceSmartList - ContentDroplet <code>Recent Changes</code> shows username instead of real name''' (ERM37458)
: When inserting the droplet <code>Recent changes</code>, the real name of a user is now displayed, if available. If no real name of the user is specified, the user name is displayed instead.
* '''BlueSpiceUserSidebar - Editing the user menu is exclusively linked to the permission <code>editinterface</code>''' (ERM42526)
: Editing the user menu is now possible again for every user who has edit permissions in the wiki.
* '''BlueSpiceUserSidebar - Editing the user menu for the first time causes the default entries <code>PAGESVISITED</code> and <code>YOUREDITS</code> to disappear''' (ERM42527)
: If a user edits the user menu for the first time, the default entries <code>PAGESVISITED</code> as well as <code>YOUREDITS</code> are kept after saving the changes.
* '''BlueSpiceVisualEditorConnector - Hovering over colored text displays incorrect reference tooltip''' (ERM37603)
: When a user hovers over colored plain text that contains no further reference, the misleading tooltip is no longer displayed.
* '''BlueSpiceVisualEditorConnector - Coloring of cells and also cell borders does not work properly''' (ERM39942)
: The coloring of cells in tables works properly again. Coloring and removing the color of cell borders also works correctly now.
* '''BlueSpiceVisualEditorConnector - Preloaded template headers display an error in front of them''' (ERM41142)
: When using preloaded templates the error in front of the header is no longer displayed.
* '''BlueSpiceVisualEditorConnector - Implicit TOC breaks template''' (ERM42767)
: Implict TOC no longer affects and breaks templates.
* '''BlueSpiceVisualEditorConnector - Page cannot be saved after page access droplet has been inserted''' (ERM42768)
: If the droplet <code>Page access</code> is now inserted on a page, the page can be saved correctly.
* '''BlueSpiceVisualEditorConnector - Display of a table differs in read and edit mode''' (ERM41644)
: If a table with the style <code>Casablanca</code> in conjunction with the property <code>filterable</code> is inserted on a page, the display of the table in read and edit mode matches again.
* '''BlueSpiceVisualEditorConnector - Table syntax is updated on each page save, resulting in an incorrect diff view''' (ERM42062)
: The table syntax is not updated after each save unless real changes have been made. This means that the diff view is correct again and, above all, legible.
*'''EnhancedUpload - Fix visual issues with the button group of the embedded attachment tag''' (ERM38680)
:Visual issues with the <code><attachment></code> tag embedded on a page, like shifted buttons in the button group and their alignment, have been fixed.
* '''ImageMapEdit - ImageMap is not functional''' (ERM39350)
: The ImageMap has been fixed and overall improved, so that the desired functionalities are working again.
* '''NotifyMe - Incorrect user name in e-mail displayed if the user name contains a dot on user creation''' (ERM42713)
:If a user name with a dot is created, the user name contained in the email sent will be correct.
*'''OOJSPlus - Recently uploaded file is displayed in the file selection after the upload''' (ERM42584)
:If a user successfully uploads a file and the page <code>Special:Upload</code> is not reloaded, the previously uploaded file is no longer displayed in the file selection.
* '''StandardDialogs - Message on existing page name does not disappear, although it has been adjusted''' (ERM42228)
: If an already existing page name is selected when creating a new page and it is adjusted directly, the message about the necessary unique name of the page disappears now.
* '''UX BlueSpiceConfigManager - The same view should be retained after saving a config''' (ERM42192)
: After saving a configuration, a reload of the ConfigManager led to a jump back to the first selectable page. As part of the UX, the behavior was adjusted so that the user remains in the same view after saving.
* '''UX BlueSpiceExtendedSearch - Unified adjustment of font sizes in the AC search popup''' (ERM42246)
: In course of a UX review, the font sizes in the autocomplete search popup were standardized and adjusted.
*''' UX BlueSpiceUserManager - Improve wording for labels for deactivating users via UserManager''' (ERM41527)
:In course of a UX review, the wording of the labels for deactivating users via the user manager was made consistent and has been adjusted.
* '''UX BlueSpiceVisualEditorConnector - Standardization of buttons and labels in the table dialog''' (ERM42657)
: In course of a UX review, the labels and buttons of the <code>add table</code> dialog were standardized and adapted accordingly.
* '''UX EnhancedUpload - Standardization and alignment of labels in the upload dialog''' (ERM42423)
: In course of a UX review, the labels of the upload dialog were standardized and adapted accordingly.
=== BlueSpice Pro ===

==== Noteable changes ====
* '''CognitiveProcessDesigner - Hide category editor if content model of page is not supported''' (ERM42755)
: Due to the content model <code>CPD</code> it's not possible to assign categories to a process page. Therefore the category editor at the bottom of the page is not displayed anymore.
* '''DrawioEditor - Allow diagrams to be saved as <code>SVG</code>''' (ERM42236)
:In future, draw.io diagrams will be saved as <code>SVG</code>. However, it is still possible to save the diagrams as <code>PNG</code>.

==== Bugfixes ====
* '''BlueSpiceBookshelf - When adding a page to a book via the <code>Add to book</code> dialog, the book structure breaks''' (ERM42702)
: When adding a page to a book via the <code>Add to book</code> dialog, the book structure remains the same regardless of whether a page is added as the last chapter or under an existing chapter.
* ''' BlueSpiceExportableTables - Each time the report type is selected, the export button is added again on <code>Special:AggregatedStatistic</code>''' (ERM41375)
:The export button is now continuously retained and is no longer duplicated as soon as the report type is changed by the user.
* '''BlueSpiceExportTables - Export button is displayed on <code>Special:AllMessages</code>''' (ERM41565)
: The export button is no longer displayed on the page <code>Special:AllMessages</code>.
* '''BlueSpiceFilterableTables - Filterable table does not render links''' (ERM42007)
: If a filterable table is used on a page, links are rendered correctly again.
*'''BlueSpiceMatomoConnector - Description of BlueSpiceMatomoConnector is missing on <code>Special:Version</code>''' (ERM42299)
:The description of the extension <code>BlueSpiceMatomoConnector</code> has been added to <code>Special:Version</code>.
* '''BlueSpiceProDistributionConnector - Button of ContentDroplet <code>Modal button</code> is not changing its color''' (ERM40777)
: Changing the color of the button for the droplet <code>Modal button</code> is now displayed correctly again.
*'''BlueSpiceProDistributionConnector - Incorrect wording on <code>Special:Instance_Status</code> and <code>Special:UserManager</code>''' (ERM42943)
:The incorrect wording on <code>Special:Instance_Status</code> as well as on <code>Special:UserManager</code> has been adjusted.
* '''BlueSpiceSMWConnector - Using the input type <code>bs-usercombo</code> in a form does not display a user picker''' (ERM41361)
: If the input type <code>bs-usercombo</code> is used in a form, this now displays a user picker again so that users can be added easily.
* '''BluespiceUEModuleTable2Excel - Exportable tables do not display umlauts correctly after export''' (ERM40262)
: Umlauts are now displayed correctly when using exportable tables.
*'''CognitiveProcessDesigner - The creation of existing processes should not be allowed when clicking on <code>Create new process</code>''' (ERM42199)
:By clicking on <code>Create new process</code>, it is now possible to create new processes only. If a process already exists under the specified name, a message appears which advices to change the process name.
* '''CognitiveProcessDesigner - It's not possible to create multiple yes/no-decision labels for gateways''' (ERM42395)
: It is now possible to add multiple yes/no-decision labels to gateways, as well as all non subpage types.
* '''CognitiveProcessDesigner - Creating a new process is possible altough wiki is protected''' (ERM42519)
: The action <code>Create new process</code> now respects the permission settings of a wiki, means if a wiki is protected or grants read permission only to anonymous users, it is not possible anymore to create a new process.
* '''CognitiveProcessDesigner - Labels with hyphens and separators should be considered when creating process description pages''' (ERM42675)
: It is now possible to use special characters in labels for process description pages. It is possible to use soft hyphens as well as a dash and in addition illegal characters are stripped out.
* '''CognitiveProcessDesigner - Process diagrams are not included in the PDF export''' (ERM42738)
: If a page is exported on which a process diagram is embedded, the process diagram is now also displayed again in the PDF export.
* '''CognitiveProcessDesigner - Process description pages are not created for subtypes of tasks''' (ERM42743)
: In accordance with the BPMN standard, tasks can also be declared as specific subtypes, e.g. <code>ServiceTask</code> or <code>UserTask</code>. Process description pages are now also created for these subtypes of tasks.
* '''CognitiveProcessDesigner - Missing german translations for default <code>CPD</code> templates''' (ERM42809)
: The german translations for the <code>CPD</code> templates delivered by default have been added. This affects all pages that are located as subpages under <code>Template:CPD/...</code>.
* '''CollabPads - Page content isn't displayed when the page is opened in <code>Edit together</code>''' (ERM38918)
: If a page contains content that cannot be processed by using the <code>Edit together</code> mode, the session can no longer be started in order to avoid data loss.
* '''CommentStreams - Error message displayed when trying to add a comment as anonymous user''' (ERM42194)
: It is now possible to post comments and write replies as an anonymous user, as long as the wiki is publicly readable.
* '''CommentStreams - Use of quotation marks in comment titles does not work''' (ERM42347)
: The use of quotation marks in the title of a comment is now possible.
* '''ContentStabilization - <code>Special:Quality_management_overview</code> loads endlessly and doesn't shows results''' (ERM35099)
: Even if Approval is not enabled in any namespace, the grid can be viewed on the page <code>Special:Quality_management_overview</code> and results are displayed.
* '''EnhancedStandardUIs- Namespace filter <code>(Main)</code> is not displayed on <code>Special:File_list</code>''' (ERM40744)
: The <code>(Main)</code> namespace can now be selected again in the namespace filter on <code>Special:File_list</code>.
* '''Forms - Allow wikitext template editing via Forms editor''' (ERM41166)
: Similar to PageForms, wikitext template editing is now also possible in Forms editor.
* '''NSFileRepo - <code>Uploadable</code> form field doesn't respect namespace selection''' (ERM31432)
: The <code>uploadable</code> form field forwards to the standard MediaWiki upload page, where a target namespace can be selected and is now respected after uploading a file to a dedicated namespace.
*'''PDFCreator - Replace PDF-related maintenance scripts''' (ERM41932)
:Due to the release of a new major version, the old PDF-related maintenance scripts were no longer functional. This has now been fixed and the corresponding descriptions can be found on the helpdesk.
*'''Popups- Preview images aren't displayed for pages in a custom namespace''' (ERM33779)
:Preview images for pages in a custom namespace are now displayed again when hovering over a link.
*'''SemanticMediaWiki - Redirection to the main page when filtering for a subpage property''' (ERM42582)
:The filter for a subpage property now works properly again.
*''' SemanticMediaWiki - Page <code>Special:FacetedSearch</code> cannot load default profile and settings for SMW cannot be saved on <code>Special:Preferences</code>''' (ERM42698)
:The loading of the default profile on the page <code>Special:FacetedSearch</code> works now. In addition it's also possible to save the settings for Semantic MediaWiki on <code>Special:Preferences</code> again.
*'''SemanticMediaWiki - Page <code>Special:Statistics</code> displays Statistics RuntimeException''' (ERM42776)
:The page <code>Special:Statistics</code> is correctly displayed again.
*'''SemanticResultFormats - Template expansion doesn't work anymore''' (ERM42572)
:SMW queries showed an error when the template parameter value started with a space. Now template expansion works again if the template name starts with a space.
* '''SimpleBlogPage - Entrypoint <code>Blogs</code> in left sidebar cannot be hidden''' (ERM42190)
: The <code>Blogs</code> entrypoint can now be hidden again. This can be done via the ConfigManager and the tab <code>Skinning</code>.
* '''SimpleTasks - User is notified after copying a page with a completed task on it''' (ERM42808)
: When copying a page with a completed task on it, the mentioned user is only informed about the mention itself, but not about a new assigned task.
* '''UX BlueSpiceCategoryManager - Create consistency between "Add category" and "Create category" in the dialog''' (ERM42201)
: In the course of a UX review, consistency was created on the page <code>Special:Category_manager</code> between the labels in the grid and in the dialog.
* '''VueJsPlus - Issues on chapter view of book''' (ERM42608)
: The chapter view of a book works again. On the one hand, the checkboxes have their full functionality and on the other hand, the chapter export also works properly now.
* '''Workflows - Sorting on <code>Special:Workflows_overview</code> does not work properly''' (ERM40877)
: The sorting on <code>Special:Workflows_overview</code> has been improved. This mainly affects the columns <code>State</code>, <code>Started on</code> and <code>Last activity on</code>.
*'''Workflows - Missing description for the <code>EditRequest</code> workflow activity''' (ERM42217)
:The description text for the <code>EditRequest</code> workflow activity is now visible again.
* '''Workflows - Dialog for <code>groupVote</code> activity cannot be opened in the Workflows UI editor''' (ERM42168)
: If the <code>groupVote</code> activity is used in the Workflows UI editor, a dialog can be opened by double-clicking on it, which allows further data to be specified.
* '''Workflows - Links are not considered in <code>SendMail</code> activity''' (ERM42380)
:In the extension <code>Workflows</code> there is a format property which allows to change the content to HTML for e-mails. This makes it possible to create links.
*'''Workflows - It's not possible to start a workflow on a process page''' (ERM42203)
:It is now possible to start a workflow on a process page.

=== BlueSpice Farm ===

==== Noteable changes ====
*'''BlueSpiceTranslationTransfer - Add a configuration to the ConfigManager to allow translations in custom namespaces''' (ERM42344)
:The default setting for the translation workflow is that it is enabled in the namespace <code>(Main)</code>. To enable the translation workflow for custom namespaces as well, there is now a setting in the ConfigManager that allows you to define further custom namespaces.

==== Bugfixes ====
* '''BlueSpiceProDistributionConnector - Fix userlimit in BlueSpice Farm edition''' (ERM42779)
:The userlimit in BlueSpiceFarm edition has been fixed.
*'''BlueSpiceTranslationTransfer - Defined terms from the translation glossary are not taken into account for translations''' (ERM41868)
:If the corresponding terms are defined via the translation glossary before a translation workflow, they are now taken into account during the translation and displayed correctly in the output wiki page. Further helpful tips regarding the translation glossary can be found on the helpdesk.
*'''BlueSpiceTranslationTransfer - Translation overview doesn't work due to permanent loading''' (ERM42252)
:The page <code>Special:TranslationsOverview</code> now works correctly again and displays all the translations that have been done already.
*'''BlueSpiceTranslationTransfer - Translation dictionary doesn't work due to permanent loading''' (ERM42700)
:The page <code>Special:TranslationDictionary</code> now works correctly again and displays all the page titles that have been defined during the translation workflow.
*'''BlueSpiceTranslationTransfer - White gap in translation preview looks odd''' (ERM42770)
:The display of the preview translation dialog has been improved.
=== BlueSpice Cloud ===
* '''BlueSpiceFoundation - DeepL Translate API URL preset in the ConfigManager''' (ERM42195)
:The default DeepL Translate API URL in the ConfigManager has been fixed.
* '''BlueSpiceProDistributionConnector - Notification center displays new notification although everything has been read''' (ERM42646)
:If all notifications have been read already, there is no longer an indicator displayed for the notification menu.
*'''MediaWiki MWStakeComponent - Search on <code>Special:File_list</code> doesn't work''' (ERM42403)
:Searching for files on <code>Special:File_list</code> works again.
*'''NSFileRepo - Saving a page displays an error randomly''' (ERM42663)
:There's no longer an error displayed when saving a page.

==5.1==
{{#subobject:|Release=5|Releasedate=04.06.2025|Releasepatch=5.1|ContentChange=Mehrere Erweiterungen|ContentChangeDesc=Die folgenden Funktionen führen zu Inhaltsänderungen in BlueSpice 5 und sollten vor dem Update auf diese Version überprüft werden: Blog, Diskussionen, PDF-Export. [[BlueSpice 5/Inhaltsänderungen|Inhaltsänderungen ansehen]]}}{{askContentChange|release=5.1}}
===Extensions ===
====Extensions added ====
{| class="wikitable"
|+
! style="" class="col-blue-light-bg" |'''Extension'''
! style="" class="col-blue-light-bg" |'''Description'''
! style="" class="col-blue-light-bg" |'''BlueSpice Version'''
|-
| style="" |BlueSpiceMatomoConnector
| style="" |Allows the integration of Matomo to the wiki to create dashboards in Matomo
| style="" |BlueSpice Pro
|}
===Changes and bugfixes===

==== Notable changes ====

===== BlueSpice Free =====
*''' BlueSpice Discovery - Implement async subpage tree component''' (ERM41945)
:The subpage tree is now loaded asynchronously to improve performance across the entire application.
*'''BlueSpice UX - Introduce unified skeletons and loading indicators''' (ERM31194)
:In the course of improving the user experience, skeletons and loading indicators have been introduced in BlueSpice 5, which briefly appear when a page is set up.
*''' BlueSpice UX - Adjust the banner colors to the BlueSpice style guide''' (ERM42116)
:In the course of improving the user experience, the application banners have been revised and their color scheme adapted to the BlueSpice style guide.
*'''StandardDialogs - New page dialog does not give feedback on invalid page title''' (ERM41437)
:When creating a new page, the dialog now supports the user by displaying a note if characters are used for a page title that are not allowed or even if a page title already exists.
*'''NotifyMe - Improve labels and tooltips for notification subscriptions''' (ERM41409)
:The labels of the individual subscription sets have been simplified and improved. In addition, the tooltips now show for which event the respective set sends a notification.
*'''StandardDialogs - After a self-move, the button for move remains inactive after a change''' (ERM40351)
:The dialogs for moving and copying a page have been made more user-friendly and supportive. Self-referencing is now avoided (both when moving and copying) by providing a new name suggestion in the dialog, additionally displaying a note that the page title already exists and keeping the <code>Done</code> button inactive until the name of the page is unique.
*'''VisualEditorPlus - Visual editor toolbar breaks into two lines''' (ERM40066)
:To avoid the toolbar of the visual editor breaking into two lines, the help icon has been arranged in the hamburger menu and the label of the insert menu has been replaced by a plus icon.

===== BlueSpice Pro =====
*'''BlueSpiceBookshelf - Add semantic extra special property <code>Books</code>''' (ERM41743)
:A new page attribute <code>Books</code> was introduced as part of a feature request. This allows the user to search or filter for pages using an ask query.
*''' BlueSpiceBookshelf - Improve <code>Add to book</code> dialog and allow to determine the position of the page''' (ERM36147)
:In BlueSpice 5.1 the <code>Add to a book</code> dialog has been revised. The user is not only able to create new books by using this dialog, but also to determine the position of the page to be added to a book. This should save the user time of not having to edit the book and its structure again afterwards.
*'''BlueSpiceConfigManager - Avoid exposing license keys''' (ERM42099)
:The entry of license keys (such as for OpenAI or DeepL) in the configuration manager is now encrypted so that the values are no longer exposed.
*'''BlueSpiceDiscovery - Cancel button should display a message if unsaved changes have been made''' (ERM41895)
:A confirmation dialog has been introduced for editors, such as the book editor or process editor, so that unsaved changes cannot be lost unintentionally.
*'''BlueSpiceDistributionConnector - Add stub for <code><uenoexport /></code> tag''' (ERM41910)
: To simplify the upgrade to BlueSpice 5, a stub for the <code><uenoexport /></code> tag has been introduced so that it continues to work and does not need to be replaced manually. In the future, it is nevertheless recommended to use the new <code><pdfexclude /</code> tag.
*'''BlueSpiceMatomoConnector - Integrate BlueSpiceMatomoConnector into BlueSpice 5.1''' (ERM41109)
:The MatomoConnector becomes part of the product with BlueSpice 5.1 and allows Matomo to be integrated to BlueSpice so that dashboards can be created to analyze user behavior.
*'''CognitiveProcessDesigner - Display entrypoint <code>Processes</code> in the left sidebar by default''' (ERM41966)
:The <code>Processes</code> entry point is displayed by default in the left navigation. If this is not desired, it can be easily disabled by using the configuration manager.
*''' CognitiveProcessDesigner - Allow approval mechanism for processes''' (ERM34767)
:The extension <code>CognitiveProcessDesigner</code> for creating processes now also works using the approval. Stabilizing process digarams works according to the configuration in the wiki.
*'''CognitiveProcessDesigner - Improve version history for process diagrams''' (ERM40817)
:The version history of processes has been improved so that adding, removing and moving process shapes can now be easily recognized in the visual mode when using the diff view.
*'''CognitiveProcessDesigner - Add <code>pre to clip</code> feature for copying raw XML''' (ERM40796)
:In BlueSpice 5.1, the <code>pre to clip</code> feature has also been made compatible for the raw XML of a process. This allows the user to quickly add the XML to the clipboard for further editing or for creating a new process from it if required.
*'''ImportOfficeFiles - Introduction of a global server variable to limit the width of thumbnails''' (ERM29987)
:A new variable <code>$wgImportOfficeFilesWord2007ImageWidthThreshold</code> has been introduced, which allows to specify a threshold for large images that are being displayed as thumbnails.
*'''PDFCreator - Introduce a dialog for creating and editing PDF templates''' (ERM41125)
:BlueSpice 5.1 introduces a dialog for creating and editing PDF templates. This allows users to easily create PDF templates by guiding the user through the creation process.
*'''PDFCreator - Empty file when exporting the book tree view using export icon in right sidebar''' (ERM38501)
:If the book tree view is to be exported, this now only works via the export button above the tree. The export action in the right sidebar has been removed for this view.

===== BlueSpice Farm =====
*'''BlueSpiceWikiFarm - Add prefix <code>wiki-</code> to custom instance names'''(ERM41807)
:For an better overview of custom-created instances, these now have the prefix <code>wiki-</code> in front of specified instance name.

==== Bugfixes ====

===== BlueSpice Free =====
*'''BlueSpiceDiscovery - Subpagetree of Enhanced MediaWiki Sidebar should display subpages from level 1 already''' (ERM42100)
:The behavior of the subpage tree in the Enhanced MediaWiki Sidebar has been adjusted so that the subpages of a parent page are already displayed from level 1.
*'''BlueSpiceDiscovery - Enhanced MediaWiki Sidebar shows displaytitle instead of defined link label''' (ERM42054)
:If a page has a displaytitle, but a label has been set in the menu editor via the enhanced MediaWiki Sidebar, the defined label has priority and is displayed in the navigation.
*'''BlueSpiceDiscovery - Incorrect display of lists in combination with indented images''' (ERM41156)
:The display of lists using indented images is now correct again.
*'''BlueSpiceDiscovery - State of the on hover tooltip for primary and secondary sidebar are displayed incorrectly''' (ERM36302)
:The tooltips on hover were switched for the state of the left and right sidebar. This has now been fixed and the tooltips are displayed correctly again according to the sidebar state.
*'''BlueSpiceExtendedSearch - Parser fragments are displayed in the preview of the search results in the full text search''' (ERM40009)
:In the full text search, fragments of the parser function are no longer displayed in the preview of the search results.
*'''BlueSpiceInterWikiLinks - After an incorrect entry, the dialog must be reopened so that the changes can be saved''' (ERM40653)
:After an incorrect entry in the dialog for adding an Interwiki link, the entry can simply be corrected and then saved without having to reopen the dialog.
*'''EnhancedStandardUIs - Page content is shown in page history for first revision''' (ERM39584)
:In first drafts, only the wikitext is now parsed and the content is truncated after 400 characters.
*'''EnhancedUpload - When uploading a duplicate, the link in the warning is not rendered correctly''' (ERM37652)
:If a duplicate file is uploaded, the link in the warning message is now clickable again so that the user is redirected to the file page.
*'''EnhancedUpload - When uploading a file via a redlink, there is no way to return to the page (ERM41562)
:If a new file is uploaded via a redlink, it is now possible to return to the original page via a backlink in the title area of the upload mask. In addition, the label of the former <code>Cancel</code> button has been changed to <code>Reset</code>, so that it is clearer that the selection for uploading can be reset, but not the exit from the upload mask.
*'''MWStakeComponent - Subpages preview is not working on page in a custom namespace''' (ERM42155)
:The action <code>Add new subpage</code> to a parent page works again for pages in a custom namespace and also displays a preview of existing subpages.
*'''NotifyMe - The contents of the workflow e-mails are mixed in German and English''' (ERM38931)
:The workflow e-mail content is now adapted to the language of the recipient and no longer contains a mix of German and English.
*'''OOJSPlus - Group label of the page assignments is recognized but not saved''' (ERM41702)
:If a group label is entered completely in the page assignment dialog, it can be selected and is now also recognized and saved by the dialog.
*'''VisualEditorPlus - Inline inspector for formatting is incorrectly displayed in source edit mode''' (ERM42127)
:The inline inspector for formatting has no functionality in source edit mode and is therefore no longer displayed there; it can only be used in visual edit mode.

===== BlueSpice Pro =====
*'''BlueSpiceBookshelf - Integrate <code>NSFileRepo</code> to support background cover images from any namespace''' (ERM41077)
:By integrating the <code>NSFileRepo</code> into the <code>BlueSpiceBookshelf</code> extension, the dropdown for bookshelf images within the meta data dialog supports images from all namespaces now.
*'''BlueSpiceReminder - On return via the browser from <code>Reminders for this page</code> to the Reminder dialog, the dialog freezes''' (ERM39904)
:When returning via the browser, the reminder dialog no longer freezes and editing can be continued.
*'''Checklists - Checklist is not parsed correctly as soon as the tagsearch is also on the page''' (ERM41388)
:The tag search and checklists can be used on a page and are displayed correctly.
*'''Forms - When using the <code>User input</code> form, the <code>styling</code> and <code>others</code> tabs are not accessible''' (ERM41584)
:When using the <code>User input</code> form, the <code>styling</code> and <code>other</code> tabs are accessible again.
* '''LDAPAuthentication2xPluggableAuth - Button for login is moved to the top''' (ERM40950)
:The extension <code>PluggableAuth</code> handles additional login fields, which are now arranged correctly using extension <code>LDAPAuthentication2</code>.
*'''ImportOfficeFiles - Improve the handling of invalid characters when naming the page during import''' (ERM39271)
: If invalid characters are used when naming the page during the import of a file, a message now appears informing the user which character is not allowed. Also, the <code>Next</code> button only becomes active if it is a valid page name.
*'''Workflows - Illegible date format when exporting the workflow overview''' (ERM40880)
:When the workflow overview is exported, the excel file now contains a date format that is clear and legible.
*'''Workflows - Workflow query of data for entering users/user groups is not possible''' (ERM37951)
:Workflow query of data for entering users/user groups is now possible.
*'''Workflows - Workflow is displayed as active although it's expired''' (ERM41518)
:On the page <code>Special:Workflows_overview</code> expired workflows are no longer listed under active workflows.
*'''Workflows - Workflows detail dialog styling is inconsistent''' (ERM41571)
:The styling of the workflow detail dialog has been adjusted, as there were some inconsistencies here. The info icon is no longer progressive as there is no primary action and the underlined headings have been removed so that they cannot be confused with links.
*'''Workflows - Workflow ui editor does not trigger forms correctly ''' (ERM37990)
:The <code>custom_form</code> is marked as a <code>userTask</code> now and expects input from a user, so that the workflow is executed correctly.

===== BlueSpice Farm =====
*'''BlueSpiceExtendedSearch - Search droplet displays results from other instances''' (ERM40811)
:The indexing of imported pages has been fixed, so that the search droplet works as it should.
*'''BlueSpiceFarm - Avatars in farm are created in main instances images folder''' (ERM42064)
: The issue with creating an storing avatars in farm instances has been fixed, so that those are not overriding each other.
*'''BlueSpiceInterWikiSearch - Improve the display of search results from Interwikisearch and the dialog for accessing other instances''' (ERM40752)
:The display of search results from the Interwiki search has been made more balanced and the information dialog for accessing another instance (and possibly requiring a login there) has also been adjusted and improved according to their styling.
*'''ContentTransfer - Fix minor styling issues in the user interface''' (ERM41582)
:The styling of the <code>Special:ContentTransfer</code> page has been revised so that the labels are displayed correctly, a date picker is available for date selection and the loading indicator is also displayed more centered.
*''' ContentTransfer - Localization for some labels is missing''' (ERM41741)
:The labels on the page <code>Special:ContentTransfer</code> have been localized so that they are displayed correctly in the corresponding user language.

==5.0==
{{#subobject:|Release=5|Releasedate=09.04.2025|Releasepatch=5.0|ContentChange=Mehrere Erweiterungen|ContentChangeDesc=Die folgenden Funktionen führen zu Inhaltsänderungen in BlueSpice 5 und sollten vor dem Update auf diese Version überprüft werden: Blog, Diskussionen, PDF-Export. [[BlueSpice 5/Inhaltsänderungen|Inhaltsänderungen ansehen]]}}{{askContentChange|release=5.0}}
===Features===

* '''Upgrade to MediaWiki REL1.43 and PHP 8.3 compat''' (ERM38444)
** BlueSpice 5 is now based on the LTS version of MediaWiki REL1.43. All functionalities of BlueSpice have been made compatible with this MediaWiki version in order to maintain support for MediaWiki Core functionalities and to be provided with security fixes. Compatibility with PHP 8.3 has also been established.
* '''Allow the internationalization of wiki pages in farm environments through a translation feature''' (ERM40835, ERM37250, ERM41110)
** BlueSpice 5 introduces a new feature that can be used in the farm environment to internationalize wiki instances. This includes the possibility to translate content from a main instance and publish it in other language instances. It is also possible to define title dictionaries and glossary translations in order to ensure consistent word usage. The namespaces and their translations can also be mapped using the configuration manager.
** In addition, there is also a small feature for BlueSpice 5 Pro in the area of internationalization. Here, pages that do not correspond to your own user language can be easily translated in the browser. This makes it easier to read and understand content in another language more quickly and easily.
** '''Important information:'''
*** In order to use the multilingual feature, a '''valid DeepL license is required''', which can be stored in the Config manager.
*** In order to use the multilingual feature in a '''cloud environment the configuration needs to be done by Hallo Welt! GmbH'''.
* '''Redesign of the CognitiveProcessDesigner extension for improved use in the wiki''' (ERM34753, ERM34754, ERM34756, ERM34757)
** The basic functionalities of the Cognitive Process Designer are already familiar from previous versions, but it has been completely revised for BlueSpice 5. The Cognitive Process Designer now introduces an option for modeling bpmn processes in the wiki, which are saved in a separate <code>Process</code> namespace. It is also possible to extend the modeled process by automatically creating sub-pages for specific process steps. The process description pages can be pre-filled with standardized templates and also have a navigation concept linked to the page itself in order to stay informed about incoming and outgoing events and to click through the process using these. The process also contains the linked pages within the bpmn shapes, which are clickable for the user if a process is integrated on a page, for example.

* '''Provide an improved PDF export backend and allow PDF template editing in the wiki''' (ERM38759, ERM38695)
** The new PDF export in BlueSpice 5 comes with a completely new backend, primarily focused on updating existing tools. In the future, the PDF export will offer support for SVG and in the area of accessibility. Starting from BlueSpice 5, users can create and manage their own PDF templates in the wiki. This feature was previously only available in the Cloud but is now also available for OnPrem versions. The PDF template editor has also been integrated with FlexiSkin, so that the applied styles are reflected in the exported file.

=== Improvements ===
* '''Remove all <code>Social</code> extensions and offer an improved replacement''' (ERM39498, ERM38857, ERM39792, ERM39784)
** In BlueSpice 5, the former social extensions have been completely removed and rebuilt. The user profile has been visually redesigned and rewritten. The design is now more lightweight as well as modern. These visual changes also affect the ContentDroplet <code>User profile</code>, providing an improved display when embedding a user profile on a page. Additionally, a new blogging system has been introduced, which includes a comment and voting function, as well as a special page listing all blog posts. This special page can be displayed as an entrypoint for blogs in the left sidebar via the configuration manager. Both general and user-specific blog posts can now be created. Furthermore, discussion areas are replaced by comments, which can be configured based on a namespace using the Namespace manager. The former discussions in BlueSpice 5 are migrated via a migration path, ensuring that no information is lost.
** For further information please see the following page: [[BlueSpice 5/Inhaltsänderungen#Blog-Funktionalit.C3.A4t|BlueSpice_5/Content_changes#Blog_functionality]]
* '''Move from ExtJS framework to OOJSPlus'''
** BlueSpice 5 introduces some changes to the application interface. The former ExtJS framework has now also been completely replaced by OOJSPlus. The interfaces for the manager, maintenance pages and overview pages have been completely moved to OOJS, so that there is consistency in the application, which has a recognition value and is therefore improving the user experience.
** The following extensions are affected by the transition to the OOJSPlus framework
*** BlueSpiceArticleInfo (ERM39421)
*** BlueSpiceAvatars (ERM39422)
*** BlueSpiceCategoryManager (ERM39424)
*** BlueSpiceContextMenu (ERM39426)
*** BlueSpiceDistributionConnector (ERM39427)
*** BlueSpiceExpiry (ERM39428)
*** BlueSpiceExtendedSearch (ERM39431)
*** BlueSpiceExportTables (ERM39429)
*** BlueSpiceFilterableTables (ERM39434)
*** BlueSpiceFoundation (ERM39435)
*** BlueSpiceInsertCategory (ERM39436)
*** BlueSpiceInsertFile (ERM39437)
*** BlueSpiceInsertLink (ERM39438)
*** BlueSpiceInterWikiLinks (ERM39439)
*** BlueSpiceNamespaceManager (ERM39440)
*** BlueSpiceNSFileRepoConnector (ERM39441)
*** BlueSpicePageAccess (ERM39442)
*** BlueSpicePageAssignments (ERM39443)
*** BlueSpicePageTemplates (ERM39444)
*** BlueSpicePermissionManager (ERM39445)
*** BlueSpicePrivacy (ERM39446)
*** BlueSpiceReadConfirmation (ERM39447)
*** BlueSpiceReaders (ERM39448)
*** BlueSpiceReminder (ERM39449)
*** BlueSpiceRSSFeeder (ERM39450)
*** BlueSpiceSmartList (ERM39451)
*** BlueSpiceSMWConnector (ERM39452)
*** BlueSpiceUserInfo (ERM39456)
*** BlueSpiceUserManager (ERM39457)

===Changes and bugfixes===
===Notable changes===

==== Free ====
* '''BlueSpiceDiscovery - Implement backlinks in BlueSpiceDiscovery skin''' (ERM40112)
** BlueSpice 5 implements a backlink concept to optimize user guidance. If a user is on a special page (e.g. Recent Changes) that contains a link to another page, a backlink will be displayed under the page title in the future.
*'''BlueSpiceDiscovery - Improve BlueSpiceDiscovery skin for BlueSpice 5''' (ERM39274)
**The BlueSpiceDiscovery Skin has been further optimized as part of BlueSpice 5. The design is overall lighter and brighter. The whitespace in the header and title area has been reduced. The former <code>New</code> button has been replaced by a simple <code>+</code> button, now located next to the search field. In edit mode, the labels for the <code>Save</code> button have been standardized throughout the application, and the <code>Cancel</code> button is now located on the left side of the visual editor's toolbar. Additionally, the action <code>Add to a book</code> has been moved to the actions section in the right sidebar.

* '''BlueSpiceExtendedSearch - Optimization of the search results display''' (ERM41052)
** The display of search results has been improved during the development of BlueSpice 5. Both in the autocomplete search and in the search center, the results are now more clear and easier to read. The corresponding namespace and parent breadcrumb are displayed below each search result. This focuses more on the title of a page without neglecting important additional information.
* '''BlueSpiceExtendedSearch - Fine tuning the search behavior'''(ERM40591)
** The output of file names in the autocomplete search was often considered irritating and not useful. For this reason the <code>File:</code> and <code>Media:</code> namespaces are now excluded from the autocomplete search; instead, files and media can be found via the search center.
* '''BlueSpiceExtendedSearch - Retain user-related settings for the results in the Search center''' (ERM39588)
** This adjustment is a feature request aimed at retaining the search options in the search center for a user without having to set them again after each search. This should have a positive impact on the user experience and support the search process.
* '''BlueSpiceExtendedSearch - Replace star icon in the Search center to avoid misunderstandings''' (ERM41170)
** The icon for the ranking in the search center has been changed. The star gave the impression that the page would be added to the watchlist, as this icon is used in other places. To avoid misunderstandings, the icon has been replaced by a pin, which influences the ranking of the search results in the search center.
*'''MediaWiki - Replace the webinstaller with a command line wizard''' (ERM36767)
**The old web installer is being discontinued, as a CLI installer is available with MediaWiki 1.43, which has wizard-like behavior.
*'''PDFCreator - How to migrate custom PDF templates in BlueSpice Cloud''' (ERM40786)
**BlueSpice 5 does not offer a migration path for existing custom PDF templates, but they can still be used in the new major version. The custom PDF templates simply have to be adapted to the new structure for creating PDF templates. Instructions: [[Handbuch:Erweiterung/PDFCreator/Migration bestehender BlueSpice cloud PDF-Vorlagen|Migrating existing cloud templates]]
**For further information please see the following page: [[BlueSpice 5/Inhaltsänderungen#PDF-Vorlagen|BlueSpice_5/Content_changes#PDF_templates]]

* '''PDFCreator - Update PDF link droplet to PDFCreator''' (ERM38695)
**As the PDF export is based on a new extension and a new backend, a replacement for the tag <<code>bs:uenoexport /></code> had to be implemented. In BlueSpice 5 the new tag can be inserted as usual via ContentDroplets, but has a different name: <code><nowiki><pdfexcludestart /></nowiki> <nowiki><pdfexcludeend /></nowiki></code>. When upgrading to BlueSpice 5, the <code><bs:uenoexport /></code> tag is not automatically overwritten and must be removed manually. For support the ReplaceText can be used here.
**For further information please see the following page: h[[BlueSpice 5/Inhaltsänderungen#Parser-Tags|BlueSpice_5/Content_changes#Parser_tags]]

====Pro====

* '''BlueSpiceBookshelf - Remove setting <code>Suprress namespace prefix of book articles in output</code> from ConfigManager''' (ERM40935)
** The setting <code>Suppress namespace prefix of book articles in output</code> has been removed from the Config manager, since the PDFCreator offers a replacement for the general handling of the display.
*'''BlueSpiceBookshelf - Chapter number should be in a separate HTML element''' (ERM40989)
** The chapter numbers are now in a separate HTML element so that they can be targeted in a css class. This allows to hide chapter numbers in a book.
*'''BlueSpiceExpiry - Remove setting <code>Show watermark in print version</code> from ConfigManager''' (ERM40936)
** Due to technical limitation the setting <code>Show watermark in print version</code> has been removed from the Config manager.
* '''BlueSpiceExtendedStatistics - Remove <code>Special:ExtendededStatistics</code>''' (ERM40884)
** With BlueSpice 5 the page <code>Special:ExtendedStatistics</code> is no longer offered and has been removed from the product. The page <code>Special:AggregatedStatistic</code> page is still part of the product.
*'''BlueSpiceRating - Create page properties for Rating and Recommendations''' (ERM38908)
**BlueSpice 5 introduces two additional page properties in the course of a feature request. When ratings and recommendations are configured via the Namespace manager, the page properties are automatically created and displayed on Special:Browse. The properties are <code>Number of recommendations</code> and <code>Number of ratings</code> and can be used to create queries.
*'''CognitiveProcessDesigner - Migration of existing BPMN diagrams''' (ERM41546)
**Existing BPMN diagrams are migrated during the update. However, as there have been changes in the functionality of the <code>CognitiveProcessDesigner</code>, the diagrams may have to be revised again with regard to the naming of the individual shapes so that the new functions can be used to their full extent.
*'''CommentStreams - Implement extension CommentStreams''' (ERM39784)
**Since CommentStreams has been implemented as a replacement for the discussion area, the magic word <code>NODISCUSSION__</code> no longer has any functionality. The comment area can be configured via namespace and can be hidden on a page basis using the tag <code><nowiki><no-comment-streams /></nowiki></code> .
**For further information please see the following page: [[BlueSpice 5/Inhaltsänderungen#Diskussionen|BlueSpice_5/Content_changes#Discussions]]
*'''ContentStabilization - Remove property <code>Implicit draft</code> on <code>Special:Browse</code> overview''' (ERM40602)
** The <code>Implicit draft</code> property has been removed as it was causing confusion among users. Since the implicit draft doesn't refer to a change on the page itself, it is hardly understable when the property is displayed or whether it's not. The removal of this property does not affect the yellow banner information about an embedded resource change, but does affect the <code>QM/Document status</code> on <code>Special:Browse</code>.
*'''ContentStabilization - Configuration for creating lists related to stabilization information in PDF file has been removed''' (ERM40938)
**The setting for creating a list of pages related to their stabilization information has been removed from the Config manager. This affects:
***<code>Export: List of approved pages contained in the book</code>
***<code>Export: List not approved pages contained in the book</code>
***<code>Export: List pages contained in the book that do not have stabilization enabled</code>
* '''FlexiSkin - Add font <code>Hyperlegible</code> for selection in FlexiSkin''' (ERM40251)
** Due to a feature request, the font <code>Hyperlegible</code> was included in the FlexiSkin. It can be used from BlueSpice 5 onwards. This font is accessible and can therefore support accessible content.
*'''Workflows - Changes to the user interface and the visibility of WorkflowTriggers''' (ERM38103)
**The visibility of the page <code>Special:Workflow_triggers</code> is now tied to the permission <code>workflows-admin</code>, indicating that the entry in the global actions is only visible if a user has this permission. Furthermore, only the UI for creating and editing triggers can be found via the global actions. The source text of triggers can now be edited via the page <code>MediaWiki:WorkflowTriggers</code>.

==== Farm ====

* '''ContentTransfer - Improve the display of the receiving wiki''' (ERM35764)
** In course of a feature request, the wiki name is now displayed instead of the internal / canonical URL when transferring content from a wiki to a target wiki, so that the view is more legible.
*'''ContentTransfer - Auto-setup ContentTransfer in BlueSpiceWikiFarm''' (ERM40835)
**All wiki instances are wired for <code>Special:ContentTransfer</code>. There is no dedicated configruation necessary; it simply works by default when creating new wiki instances. The instances can then be found in the dropdown for the receiving wiki.

===Bugfixes===

==== BlueSpice Free ====
* '''BlueSpiceConfigManager - Improve arrangement of settings in the ConfigManager''' (ERM37256) '''and review as well as improve help texts also''' (ERM39597)
** The arrangement of settings in the ConfigManager has been reviewed in terms of their meaningfulness and rearranged. For example, the settings for books are now all located under the <code>Books</code> tab. Furthermore, the help texts have been reviewed and improved.
*'''BlueSpiceDiscovery - Media settings dialog is located above color picker''' (ERM40096)
** If the color of the image caption needs to be changed, the color picker is now in the foreground and usable.
*'''BlueSpiceDiscovery - If the term <code>News</code> is used as the name for a namespace and subpages are disabled, the breadcrumbs are broken''' (ERM41093)
** If the term <code>News</code> is used as a namespace and at the same time the subpages are disabled for this namespace, the breadcrumbs title will be parsed correctly.
*'''BlueSpiceExtendedSearch - Allow search with special characters <code>§</code>''' (ERM39662)
** If a search term contains a special character like <code>§</code>, results will now be displayed.
*'''BlueSpiceExtendedSearch - Search does not return exact results when using <code>""</code> as well as special characters (like <code>§</code>, <code>$</code>, ...)''' (ERM39924)
** The tokenization of special characters has been improved, so that matching results are displayed now when using special characters like <code>""</code>, <code>§</code> and <code>$</code>.
*'''BlueSpiceExtendedSearch - Operators do not work in Search center''' (ERM39923)
** The search operators <code>AND</code> and <code>OR</code> are now fully functional when using full-text search.
*'''BlueSpiceExtendedSearch - Type filter of TagSearch does not work''' (ERM40019)
** Using queries generated by the TagSearch do now preserve the type filter.
*'''BlueSpiceFoundation - Transclusions do not take the permissions into account (ERM39926)'''
**If the content of a page is transcluded to another page, which is protected by permissions in the corresponding namespace, this transcluded content is now only displayed to users who have the corresponding permissions.
*'''BlueSpiceInsertCategory - Content model <code>book</code> doesn't support categories''' (ERM39857)
** It is now prevented to add a category on a page with the content model <code>Book</code>. Categories can only be added to pages that correspond to the content model <code>Page</code>.
* '''BlueSpiceInsertCategory - Categories are not sorted''' (ERM40753)
** The categories are now sorted alphabetically to ensure consistent sorting logic.
*'''BlueSpiceInsertCategory & BlueSpicePageAssignments - Limitation of display for categories and page assignments to a quantity of 25''' (ERM40291)
** The limit for displaying categories and page assignments has been increased, as otherwise not all of them were shown.
*'''BlueSpiceNamespaceManager - If a namespace alread existed once, but was renamed and has now been created again, both namespaces are deleted''' (ERM40415)
** If the original name of a namespace that has been renamed in the meantime is reassigned and then deleted, only the deletion of the intended namespace will occur.
*'''BlueSpiceNamespaceManager - Alias for system namespaces is not saved''' (ERM41169)
** If an alias is defined for a system namespace, it is now saved properly again.
*'''BlueSpiceNamespaceManager - When creating an export of the NamespaceManager grid, the numbers of pages is not displayed correctly''' (ERM31448)
** If the grid of the NamespaceManager is exported, the number of pages in the respective namespaces appears correctly.
*'''BlueSpiceSaferEdit - Improve displaying the yellow banner during a page edit''' (ERM38986)
** The yellow banner which indicates that a user is editing a page has been enhanced for faster and more reliable display.
* '''EnhancedStandardUIs - Improve the design of the version history and introduce a backlink ('''ERM34702)
** The design of the version history in <code>Diff View</code> has been improved in terms of coloring, the default display mode and the removal of unnecessary information. Furthermore, the version history breadcrumbs have been made clickable and a backlink has been introduced to improve user guidance.
*'''EnhancedStandardUIs - Special:Pages must be bound to user permissions''' (ERM41321)
** The display of namespaces and the contained pages now depends on the permissions of a user. Namespaces or pages that the user does not have read permission to will no longer be shown on <code>Special:Pages</code>.
* '''NotifyMe - Faulty notification is displayed after a user has been anonymized''' (ERM40467)
** After successful anonymization of a user, a clear and accurate notification is now displayed.
*'''NotifyMe - Improve concept of digest mails''' (ERM39568)
** The concept of digest mails has been adjusted. Mails are now sent at 7am for <code>Frequency: Daily</code> and at 7 am on Monday for <code>Frequency:Weekly</code>. In the course of this change, the introductory sentence was also adapted so that it is clear that the changes refer to the last 24 hours or the last week in the wiki.
* '''OOJSPlus - Styling issue when accessing <code>Readers of this page</code> in page information dialog''' (ERM39064)
** The incorrect styling of the pager was fixed in the page information dialog.
*'''OOJSPlus - Cannot upload file in <code>tiff</code> format''' (ERM40697)
** Uploading a <code>tiff</code> file is now possible again.
* P'''ageHeader - Page status sentence is not displayed correctly when using french language''' (ERM40252)
** The page status sentence is now correctly displayed if user language is set to french.
*'''PDFCreator - When exporting pages that contain links with redirects, only the redirected page is printed in the file and not the target page''' (ERM40109)
** If a page with links for redirects is exported, now the target page will be exported instead of the redirected page.
*'''VisualEditorPlus - Inline inspector for formatting is dislocated when using <code>collab-edit</code>''' (ERM40411)
** The inline inspector is displayed correctly when using the collaborative editing mode.
*'''VisualEditorPlus - Underscores without spaces beforehand changes character to italic formatting''' (ERM39408)
** Italic formatting using underscores is only done when there is a space after the word. Thus, terms separated by underscores remain unchanged.

==== BlueSpice Pro ====
* '''BlueSpiceBookshelf - Setting for selecting the default view of the bookshelf is obsolete''' (ERM39946)
** On <code>Special:Preferences</code> the setting for selecting the default view of the bookshelf has been removed, as this is no longer necessary due to further development.
* '''BlueSpiceReadConfirmation - If the read confirmation is configured to only trigger a read confirmation for approved pages, then the redirection from the task overview leads to the draft version instead of the approved version''' (ERM40856)
** If the configuration of the read confirmation is changed to approved pages only, a task on <code>Special:My_tasks</code> forwards correctly to the approved version.
* '''Checklists - The content of the page is deleted if a collab session takes place and at the same time a user who is not part of the session changes the status of a checkbox''' (ERM40413)
** During an ongoing collab session, it is no longer possible to change the status of a checkbox. This ensures that the content is properly saved after the session is completed.
*'''CollabPads - Page content is displayed when the page is opened in <code>collab-edit</code>''' (ERM38918)
** If a page contains content that cannot be processed by using the <code>Edit together</code> mode, the session can no longer be started in order to avoid data loss.
*'''ContentStabilization - Align selection for user groups in config manager with groups from permission manager''' (ERM40862)
** The user groups should be aligned throughout the application to support more consistency. Therefore, the groups displayed in the configuration manager correspond to the groups defined in the permission manager.
* '''EnhancedStandardUIs - Sorting for namespaces or categories on <code>Special:File_list</code> breaks displaying results''' (ERM38961)
** Due to technical limitations the sorting option for the columns namespaces as well as categories on <code>Special:File_list</code> has been removed.
* '''Forms - Naming of a form is not consistent when a new page is created from that form''' (ERM37716)
** Saving the form now keeps the form name intact.
*'''HeaderTabs - The use of special characters or umlauts leads to issues when using HeaderTabs''' (ERM31276)
** If a heading contains special characters (like <code>/</code> or <code>(</code> ) or umlauts there are no more issues and switching the tabs with one single click works as well.
*'''ImportOfficeFiles - Adjust wording for word import in new button''' (ERM39686)
** The label for a new Word import via <code>+</code> button has been adjusted to ensure a consistent user interface.
*'''ImportOfficeFiles - Imported pages are not indexed in search''' (ERM41242)
** Importing new pages via the Word import leads to the indexing of these pages so that they can be found via the search again.
*'''PageForms - System user should be excluded from the selection using <code>bs-usercombo</code>''' (ERM39874)
** If the inputfield <code>bs-usercombo</code> is used when creating forms, system users are no longer displayed.
*'''SemanticMediaWiki - As soon as a namespace <code>GROUP</code> exists <code>Schema_properties</code> are created''' (ERM41141)
** When creating the <code>GROUP</code> namespace, system-generated pages such as <code>Schema_properties</code> and <code>Predefined_properties</code> are no longer created.
* '''Workflows - Message key instead of message is displayed on <code>Special:RecentChanges</code> if page was edited because of workflow activity <code>EditRequest</code>''' (ERM35247)
** If a page is now being edited due to the Workflow activity <code>EditRequest</code>, a readable message will appear on <code>Special:RecentChanges</code>.
*'''Workflows - If an incorrect email address is entered, the dialog is canceled''' (ERM41016)
** If an incorrect entry is made when starting a workflow, the dialog no longer aborts, but returns the user to the point where the incorrect entry was made via a <code>Dismiss</code> button.
*'''Workflows - <code>Special:Log</code> doesn't display start and end events''' (ERM39016)
** Besides the workflow activities (such as user votes, user feedback, send mails), the start and end events of the workflows will now also be displayed on the page <code>Special:Log</code>.
* '''Workflows - In the workflows ui editor it is not possible to pass variables such as <code>user</code>, <code>date</code>, <code>page</code>, etc.''' (ERM39361)
** It is now possible to pass variables for the workflow activities <code>checkin</code>, <code>checkout</code>, <code>uservote</code> and <code>approvepage</code>. Also using the parser function <code><nowiki>{{#time}}</nowiki></code> for due date works properly.
*'''Workflows - First column on <code>Special:Workflows_overview</code> is empty''' (ERM40879)
** If a workflow has exceeded the due date, an icon is now displayed again in the first column on the <code>Special:Workflows_overview</code>.

==== BlueSpice Farm ====
* '''BlueSpiceFarm - User who creates a new instance should receive sysop rights in this instance''' (ERM40078)
** If a user creates a new instance, this user is automatically created with the sysop group assignment in the new instance.
* '''ContentTransfer - Prevent displaying a empty dropdown for <code>Receiving wiki</code> or <code>Transfer as user</code> if it's not configured''' (ERM40818)
** The dropdown menu for selecting the receiving wiki or for selecting the transfer as user on <code>Special:ContentTransfer</code> is only displayed when the configuration is done.

[[en:{{FULLPAGENAME}}]]
[[Category:Setup]]

Setup:Release Notes

2026-06-24T15:43:33Z

Margit.link-rodrigue:

Vorlage:Textbox

2026-06-24T15:29:21Z

Margit.link-rodrigue:

<includeonly><templatestyles src="Textbox/styles.css" /><div class="cd-textbox cd-textbox-{{{boxtype}}}><div class="icon-col {{#switch: {{{icon}}}|yes=has-icon|ja=has-icon}}"></div><div class="text-col"><span class="boxheader">{{{header}}}</span><span class="boxtext>
{{{text}}}</span></div></div></includeonly>
<noinclude>
Kopiervorlage:
<pre>
{{Textbox|boxtype = |icon=|header =| text =}}
</pre>

</noinclude>

Setup:Releasehistorie

2026-06-24T15:28:37Z

Margit.link-rodrigue:

{{#vardefine:latestpatch|{{#ask: [[-Has subobject::Setup:Release_Notes]]|?Releasepatch|mainlabel=- |format=plainlist|headers=hide|limit=1|searchlabel=|sort=Releasedate|order=desc}}}}
{{Featureseite|featured=true|featuredesc=Release Notes: 5.2.5, 5.1.9|featurestart=24.06.2026}} {{Textbox|boxtype=important|header=Hinweis:|text=*Support für BlueSpice 4.x endet am 15. Juli 2026.
*Support für BlueSpice 3.x endete am 15. März 2023.|icon=yes}}

Die Versionierung von BlueSpice folgt der ''Semantic Versioning Spezifikation'' von [https://semver.org/lang/de/ semver.org].

==Minor Releases ==
{{#ask: [[:+]] [[~BlueSpice 5.*]] [[!~BlueSpice 5.*/*]] [[Modification date::+]]|format=ul|order=desc|default=Es gibt keine Minor-Releases.}}

==Alle Releases==
{| class="wikitable" style="width:100%;"
|+
! style="" |Major Release
! style="" |Version
! style="" |Veröffentlichung
! style="" |Details
! style="" |Typ
|-
! rowspan="13" |'''BlueSpice 5'''
|5.2.5, 5.1.9
|24.06.2026
|[[Setup:Release Notes#5.2.5|Release Notes 5.2.5]]
[[Setup:Release Notes#5.1.9|Release Notes 5.1.9]]
|Patch Release
|-
|5.2.4, 5.1.8
|26.05.2026
|[[Setup:Release Notes#5.2.4|Release Notes 5.2.4]]
[[Setup:Release Notes#5.1.8|Release Notes 5.1.8]]
|Patch Release
|-
|5.2.3, 5.1.7
|22.04.2026
|[[Setup:Release Notes#5.2.3|Release Notes 5.2.3]]
[[Setup:Release Notes#5.1.7|Release Notes 5.1.7]]
|Patch Release
|-
|5.2.2, 5.1.6
|26.02.2026
|[[Setup:Release Notes#5.2.2|Release Notes 5.2.2]]
[[Setup:Release Notes#5.1.6|Release Notes 5.1.6]]
|Patch Release
Sicherheits-Patch!
|-
|5.2.1
|22.01.2026
|[[Setup:Release Notes#5.2.1|Release Notes]]
|Patch Release
|-
|5.1.5
|22.01.2026
|[[Setup:Release Notes#5.1.5|Release Notes]]
|Patch Release
|-
|5.1.4
|9.12.2025
|[[Setup:Release Notes#5.1.4|Release Notes]]
|Patch Release
|-
|[[BlueSpice 5.2|5.2]] (cloud)
|18.11.2025
|[[BlueSpice 5.2|Beschreibung]],
[[Setup:Release Notes#5.2|Release Notes]]
|Minor Release (cloud only)
|-
|5.1.3
|28.10.2025
|[[Setup:Release Notes#5.1.3|Release Notes]]
|Patch Release
Sicherheits-Patch!
|-
|5.1.2
|18.09.2025
|[[Setup:Release Notes#5.1.2|Release Notes]]
|Patch Release
Sicherheits-Patch!
|-
|5.1.1
|16.07.2025
|[[Setup:Release Notes#5.1.1|Release Notes]]
|Patch Release
|-
| style="" |[[BlueSpice 5|5.1]]
| style="" |04.06.2025
| style="" |[[BlueSpice 5|Beschreibung]],
[[Setup:Release Notes#5.1|Release Notes]]
| style="" |Major Release
[[Setup:Release Notes/Content changes|Inhaltsänderungen beachten!]]
|-
| style="" |[[BlueSpice 5|5.0]]
| style="" |09.04.2025
| style="" |[[BlueSpice 5|Beschreibung]],
[[Setup:Release Notes#5.0|Release Notes]]
| style="" |Major Release (nur BlueSpice cloud)
[[Setup:Release Notes/Content changes|Inhaltsänderungen beachten!]]
|-
! style="" |'''BlueSpice 4'''
| colspan="4" style="" |[[Setup:Releasehistorie/BlueSpice 4|Releasehistorie]]
|-
! style="" |'''BlueSpice 1-3'''
| colspan="4" style="" |[[Setup:Releasehistorie/BlueSpice 1-3|Releasehistorie]]
|}

[[en:Setup:Release History]]
[[Category:Setup]]

Handbuch:Erweiterung/BlueSpiceTranslationTransfer

2026-06-23T09:38:07Z

Margit.link-rodrigue:

Der Übersetzungsmechanismus in einer Wiki-Farm wird über die Erweiterung '''BlueSpiceTranslationTransfer''' gesteuert.{{DISPLAYTITLE:Übersetzungen in der Wiki farm (TranslationTransfer)}}
{{Textbox|boxtype=important|header=DeepL API-Schlüssel erforderlich|text=Diese Funktion benötigt einen gültigen DeepL API-Schlüssel. Dieser wird nicht von BlueSpice bereitgestellt. Der Schlüssel wird in der [[Handbuch:Erweiterung/BlueSpiceConfigManager#DeepL_API|Konfigurationsverwaltung des Quellwikis]] angegeben.|icon=yes}}

== 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 mithilfe der 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.

=== Anlegen der Zielwikis ===
Sprachwikis werden immer mit ihrem zweistelligen [https://de.wikipedia.org/wiki/Liste_der_ISO-639-Sprachcodes ISO 639-1 Sprachkürzel] angelegt (zum Beispiel <code>EN</code> oder <code>en</code> für die englischsprachige Instanz, <code>FR</code> oder <code>fr</code> für die französische). Bei der Übersetzung können alle Sprachinstanzen angelegt werden, die vom DeepL Übersetzungsdienst unterstützt werden.

Dies bedeutet auch, dass eine Wiki-Instanz mit dem Namen <code>IT</code> 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. <code>IT-Wiki</code>).

=== Übereinstimmung von Pfad und Inhaltssprache ===
{{Textbox|boxtype=important|header=Richtige Sprache setzen!|text=Beim Anlegen einer Wiki-Instanz müssen Sie darauf achten, dass sowohl der Pfad als auch die Inhaltssprache dem ISO-Sprachkürzel entsprechen. Ansonsten wird die Instanz nicht als Sprachwiki erkannt. Der Seitenname kann frei gewählt werden, es bietet sich jedoch an, auch diesen konsequent mit dem Sprachkürzel anzulegen. Eine nachträgliche Umkonfiguration von Wikis, die bereits mit Inhalten gefüllt sind, kann schwierig sein, da einige Bezeichnungen sprachspezifisch sind (z.B. die Syntax von Bildattributen).|icon=yes}}[[Datei:BlueSpiceTranslationTransfer - neue Instanz anlegen.png|zentriert|mini|alternativtext=Dialogfenster zum Erstellen einer englischen Sprachinstanz in der Wikifarm|450x450px|Dialogfenster zum Erstellen einer neuen Sprachinstanz mit Seitennamen (1), Pfad (2) und übereinstimmender Inhaltssprache (3) in einem deutschen Stammwiki.]]
Die Beziehung zwischen den Instanzen einer Wiki-Farm mit Bezug auf Übersetzung sieht also verbildlicht so aus:

<drawio filename="TranslationTransfer_Instanzen" alt="">

</drawio>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:

# '''Klicken''' Sie auf der Quellseite auf den ''Übersetzen (Translate)''-Link in der Werkzeugleiste. Es öffnet sich ein Dialog.[[Datei:Extension BlueSpiceTranslationTransfer 1743770053694.png|alternativtext=Werkzeugleiste mit hervorgehobenem "Translate"-Link|zentriert|mini|206x206px|Übersetzen (Translate)-Link]]
# '''Wählen''' Sie die gewünschte Zielsprache aus.[[Datei:Extension BlueSpiceTranslationTransfer 1743770108045.png|alternativtext=Dialogfenster zur Auswahl aus verschiedenen Zielsprachen mit "Deutsch" ausgewählt|zentriert|mini|250x250px|Zielsprache auswählen]]
# '''Klicken''' Sie ''Übersetzen (Translate)'', um die Übersetzung zu starten.
# '''Ü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.[[Datei:Extension BlueSpiceTranslationTransfer 1743770150061.png|alternativtext=Dialogfenster zur Eingabe des Zielseitennamens|zentriert|mini|400x400px|Überprüfen Sie den gewünschten Zielseitennamen]]
# '''Klicken''' Sie erneut ''Übersetzen (Translate)'', um den Seitennamen zu speichern. Die Übersetzungsvorschau wird angezeigt.[[Datei:TranslationTransfer preview.png|alternativtext=Vorschaufenster mit übersetztem Seiteninhalt|zentriert|mini|400x400px|Übersetzungsvorschau]]
# '''Klicken''' Sie ''Speichern (Save)'', um die übersetzte Seite im Zielwiki zu speichern. Ein Bestätigungsfenster zeigt das Ergebnis des Transfers.[[Datei:TranslationTransfer confirmation.png|alternativtext=Bestätigungsdialog mit Informationen zu einer übertragenen eingebetteten Vorlage.|zentriert|mini|350x350px|Übersetzungsbestätigung]]
# '''Klicken''' Sie ''Fertig (Done)''. Sie können nun direkt zur Seite im Ziel-Wiki gelangen. Die Originalsprachenseite zeigt nun einen Sprachwechsler im Titelbereich an.[[Datei:Extension BlueSpiceTranslationTransfer 1743769862375.png|alternativtext=Sprachauswahl mit der Option "Deutsch".|zentriert|mini|200x200px|Sprachwechsler]]

== Nachfolgende Übersetzungen ==
Wenn eine Seite bereits im Ziel-Wiki existiert, werden eingebettete Ressourcen wie Vorlagen nicht erneut dorthin übertragen. Vorlagen werden in jedem Sprach-Wiki separat verwaltet, da der Übersetzungsdienst nicht feststellen kann, welche Vorlagenelemente übersetzt werden müssen. Nach Abschluss der Übersetzung zeigt das Wiki ein Bestätigungsfenster an, in dem alle eingebetteten Ressourcen aufgelistet sind, die nicht in das Ziel-Wiki übertragen wurden.
[[Datei:TranslationTransfer embedded resources.png|alternativtext=Dialogfenster, das anzeigt, dass eine Vorlage nicht in das Ziel-Wiki kopiert wurde.|zentriert|mini|350x350px|Hinweis zu eingebetteten Ressourcen]]

== 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:Erweiterung/MergeArticles|Handbuch-Seite der Erweiterung MergeArticles]] verfügbar.

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

* '''Seitentext'''
* '''Seitentitel''' (Anpassung des vorgeschlagenen Titels ist bei der Erstübersetzung möglich)
* '''Anzeigetitel'''
* '''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:''' Wiki-Links werden übersetzt. Falls eine Seite im Zielwiki nicht existiert, wird sie entsprechend als "Gewünschte Seite" (Redlink) angezeigt .
* '''Eingebundene Dateien (png, jpg, gif,...)''' werden ins Zielwiki übertragen:
** Der Dateiname wird beibehalten. Bei Text-Links wird die Linkbezeichnung übersetzt.
** Die Beschreibung und der Alternativtext von eingebetteten Dateien werden übersetzt.
** Die Übertragung von auf Dateien kann manuell unterdrückt werden ([[Handbuch:Erweiterung/BlueSpiceTranslationTransfer#Dateien ausschlie.C3.9Fen|siehe Dateien ausschließen]]).
* '''Dateianhänge:''' Dateianhänge werden wie alle Dateien ins Zielwiki übertragen. Die Linkbezeichnung wird übersetzt.
* '''Medien (pdf, docx, xlsx,...):''' Die Linkbeschreibung wird übersetzt und das Originaldokument wird in das Zielwiki kopiert.
* '''Galerien:''' Wenn ein Galerie-Droplet auf einer Seite eingefügt wird, werden die Dateinamen nicht übersetzt und die Galerie wird korrekt im Zielwiki angezeigt. Die Bildunterschriften werden übersetzt.
* '''Vorlagen:''' Vorlagen werden mit dem Original-Seitennamen übertragen, falls sie im Ziel-Wiki noch nicht vorhanden sind. Eine Übersetzung der Inhalte findet jedoch nicht statt. Die Vorlagen werden manuell in den jeweiligen Sprachversionen gepflegt. Es können jedoch auf dem Server [[Referenz:BlueSpiceTranslationTransfer#Zus.C3.A4tzliche Konfigurationsm.C3.B6glichkeiten|Vorlagenparameter konfiguriert]] werden, die übersetzt werden sollen.
* '''Magische Wörter''' werden in ihre kanonische Bezeichnung (EN) übersetzt.
{{Textbox|boxtype=note|header=Hinweis:|text=Einschränkung in früheren BlueSpice-Versionen: Wenn eine Seite zu groß ist, kann die DeepL API sie nicht übersetzen. Die beste Möglichkeit ist, die Seite in kleinere Unterseiten aufzuteilen oder auf die aktuellste BlueSpice-Version zu wechseln.

Aktuell wird eine Seite in mehreren Stapeln an den Übersetzungsdienst geschickt und sollte daher keine Fehlermeldung mehr auslösen.|icon=yes}}

== Nicht-übersetzte oder nicht-übertragene Elemente ==
Folgende Elemente werden für die Übersetzung nichtg berücksichtigt:

* '''Bereits im Ziel-Wiki vorhandene Vorlagen:''' Vorlagen werden im Ziel-Wiki nicht überschrieben, wenn sie dort bereits vorhanden sind.

* '''Vorlagen:''' Vorlagen, die bereits im Ziel-Wiki vorhanden sind werden nicht übertragen.
* '''Formulare für Vorlagen''' ([[Referenz:Page Forms|Page Forms]])''':''' Formulare müssen manuell in die Zielwikis übertragen werden und dort der jeweiligen Sprache angepasst werden.
* '''Transkludierte Seiten:''' Transkludierte Seiten werden derzeit ohne Übersetzung in das Zielwiki übertragen.
* '''Codeblöcke:''' werden nicht übersetzt.

== Inhalte von der Übersetzung ausschließen ==

=== Text ausschließen{{Bsvs|bsvFrom=5.2.2}} ===
Bevor Sie den Text schreiben:

# '''Öffnen''' Sie das ''Menü Einfügen (+)'' in der Editor-Symbolleiste.

# '''Klicken''' Sie auf ''Von der Übersetzung ausschließen''.

# '''Fügen''' Sie den Text hinzu, den Sie ausschließen möchten.

# '''Klicken''' Sie auf ''Einfügen''.

Wenn Ihr Text bereits auf der Seite vorhanden ist, müssen Sie in den Quelltextbearbeitungsmodus wechseln und das Tag „ignore“ manuell einfügen. Dieses Tag hat einen Start- und einen End-Tag:<syntaxhighlight lang="text">
<translation:ignore>Text hier</translation:ignore>

</syntaxhighlight>

=== Dateien 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:

# '''Fügen''' Sie den Umschalter <code><nowiki>__BS_NO_AUTOMATIC_DOCUMENT_TRANSLATION__</nowiki></code> im Quelltext der zu übersetzenden Seite '''ein'''.
# '''Übersetzen''' Sie die Seite in die Zielsprache. In der Vorschau werden die Dateien des Quellwikis noch angezeigt. Sie werden allerdings nicht mit übertragen.
# '''Ü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.

Hinweis: Falls die Datei schon auf dem Zielwiki existiert, wird die Datei angezeigt.

== Übersetzungsübersicht ==
Eine Übersicht über alle Übersetzungen ist unter <code>Spezial:TranslationsOverview</code> im Quellwiki verfügbar.
[[Datei:Handbuch:Erweiterung BlueSpiceTranslationTransfer 1743771129964.png|zentriert|mini|Übersetzungsübersicht|600x600px|alternativtext=Übersetzungsübersichtsseite mit drei Einträgen]]
== Übersetzungs-Wörterbuch ==
Das Wörterbuch mit allen Seitentiteln und Verknüpfungen kann unter <code>Spezial:TranslationDictionary</code> 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.
[[Datei:Handbuch:Erweiterung BlueSpiceTranslationTransfer 1743169370583.png|zentriert|mini|Übersetzungs-Wörterbuch|600x600px]]

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 <code>Spezial:Übersetzungsglossar</code> 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.[[Datei:Handbuch:Erweiterung BlueSpiceTranslationTransfer 1743169204822.png|zentriert|mini|Übersetzungs-Glossar|alternativtext=Spezialseite Übersetzungsglossar mit einem Eintrag|650x650px]]

Nicht alle Übersetzungssprachen unterstützen die Glossarfunktion ([https://developers.deepl.com/docs/api-reference/glossaries#list-supported-glossary-language-pairs siehe DeepL Dokumentation]).

Bitte beachten Sie die folgenden Empfehlungen zur Definition von Glossarbegriffen (bereitgestellt vom DeepL-Dienst):

* Wir empfehlen grundsätzlich die idiomatische Groß- und Kleinschreibung beim Hinzufügen eines Glossareintrags. Bitte verwenden Sie Groß- und Kleinschreibung, wenn dies in der jeweiligen Sprache angebracht ist.
* Da Substantive im Englischen generell klein geschrieben werden, empfehlen wir dringend die Verwendung des Glossarpaars „cat – Katze“. Andernfalls erkennt die KI „Cat“ (mit Großbuchstaben) als Eigennamen.

'''Best Practices für Glossare:'''

* Kein Plural
* Kein Präteritum
* Verwenden Sie idiomatische Groß- und Kleinschreibung, wenn dies in der jeweiligen Sprache angebracht ist.
* Die Verwendung von vorangestellten Artikeln bei Substantiven ist irrelevant und kann ignoriert werden.
* Verwenden Sie Infinitivmarkierungen bei Verben, wie z. B. „to“ im Englischen, um Missverständnisse zu vermeiden (Beispiel: to rain → regnen; rain → Regen).

== Konfiguration ==

===Zuordnung der Namensräume===
{{#dpl:title=Handbuch:Erweiterung/BlueSpiceConfigManager|include=##.*BlueSpiceTranslationTransfer.*}}

=== Konfiguration DeepL API ===
{{#dpl:title=Handbuch:Erweiterung/BlueSpiceConfigManager|include=#DeepL API}}

== Fehlermeldungen ==
Es kann zu Übersetzungskonflikten zwischen Quell- und Zielwiki kommen, wenn Seiten ohne Weiterleitung verschoben werden. Beispiel:

# '''Quellseite wurde verschoben:''' Eine Seite wurde in einem englischsprachigen Quellwiki ohne Weiterleitung von <code>A new page</code> nach <code>
A new page 1</code> verschoben. Die Seite wurde ursprünglich als <code>Eine neue Seite</code> ins deutsche Wiki übersetzt. Wenn der Benutzer <code>A new page 1</code> nach <code>Eine neue Seite</code> übersetzen möchte, zeigt das Wiki eine Fehlermeldung an, dass die vorgeschlagene Zielseite bereits existiert:[[File:translationtransfer error1.png|alt=Seite kann nicht in den ausgewählten Seitentitel übersetzt werden, da die Zielseite bereits existiert|center|thumb|450x450px|Fehlermeldung bei der Übersetzungsübertragung]]'''Lösung:''' Es ist notwendig, die ursprüngliche Zuordnung zwischen den beiden Seiten <code>A new page</code> und <code>Eine neue Seite</code> aus dem [[Handbuch:Erweiterung/BlueSpiceTranslationTransfer#.C3.9Cbersetzungs-W.C3.B6rterbuch|Übersetzungs-Wörterbuch]] zu löschen. Danach ist es möglich, das Übersetzungsziel für <code>A new page 1</code> problemlos auf <code>Eine neue Seite</code> zu setzen, ohne eine Fehlermeldung zu erhalten. Die Zielseite <code>Eine neue Seite</code> behält ihren Versionsverlauf.
== 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 [[Handbuch:Erweiterung/AdhocTranslation|Ad-hoc Übersetzung]] angezeigt. Diese Übersetzung ist nur solange gültig, bis die Seite neu geladen wird.

{{Box Links|Thema1=[[Handbuch:Erweiterung/ContentTransfer]]|Thema2=[[Handbuch:Erweiterung/MergeArticles]]|Thema3=[[Handbuch:Erweiterung/AdhocTranslation]]}}

{{translation}}
[[Kategorie:BlueSpice farm]]

Handbuch:Erweiterung/BlueSpiceTranslationTransfer

2026-06-23T09:33:07Z

Margit.link-rodrigue:

Der Übersetzungsmechanismus in einer Wiki-Farm wird über die Erweiterung '''BlueSpiceTranslationTransfer''' gesteuert.{{DISPLAYTITLE:Übersetzungen in der Wiki farm (TranslationTransfer)}}
{{Textbox|boxtype=important|header=DeepL API-Schlüssel erforderlich|text=Diese Funktion benötigt einen gültigen DeepL API-Schlüssel. Dieser wird nicht von BlueSpice bereitgestellt. Der Schlüssel wird in der [[Handbuch:Erweiterung/BlueSpiceConfigManager#DeepL_API|Konfigurationsverwaltung des Quellwikis]] angegeben.|icon=yes}}

== 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 mithilfe der 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.

=== Anlegen der Zielwikis ===
Sprachwikis werden immer mit ihrem zweistelligen [https://de.wikipedia.org/wiki/Liste_der_ISO-639-Sprachcodes ISO 639-1 Sprachkürzel] angelegt (zum Beispiel <code>EN</code> oder <code>en</code> für die englischsprachige Instanz, <code>FR</code> oder <code>fr</code> für die französische). Bei der Übersetzung können alle Sprachinstanzen angelegt werden, die vom DeepL Übersetzungsdienst unterstützt werden.

Dies bedeutet auch, dass eine Wiki-Instanz mit dem Namen <code>IT</code> 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. <code>IT-Wiki</code>).

=== Übereinstimmung von Pfad und Inhaltssprache ===
{{Textbox|boxtype=important|header=Richtige Sprache setzen!|text=Beim Anlegen einer Wiki-Instanz müssen Sie darauf achten, dass sowohl der Pfad als auch die Inhaltssprache dem ISO-Sprachkürzel entsprechen. Ansonsten wird die Instanz nicht als Sprachwiki erkannt. Der Seitenname kann frei gewählt werden, es bietet sich jedoch an, auch diesen konsequent mit dem Sprachkürzel anzulegen. Eine nachträgliche Umkonfiguration von Wikis, die bereits mit Inhalten gefüllt sind, kann schwierig sein, da einige Bezeichnungen sprachspezifisch sind (z.B. die Syntax von Bildattributen).|icon=yes}}[[Datei:BlueSpiceTranslationTransfer - neue Instanz anlegen.png|zentriert|mini|alternativtext=Dialogfenster zum Erstellen einer englischen Sprachinstanz in der Wikifarm|450x450px|Dialogfenster zum Erstellen einer neuen Sprachinstanz mit Seitennamen (1), Pfad (2) und übereinstimmender Inhaltssprache (3) in einem deutschen Stammwiki.]]
Die Beziehung zwischen den Instanzen einer Wiki-Farm mit Bezug auf Übersetzung sieht also verbildlicht so aus:

<drawio filename="TranslationTransfer_Instanzen" alt="">

</drawio>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:

# '''Klicken''' Sie auf der Quellseite auf den ''Übersetzen (Translate)''-Link in der Werkzeugleiste. Es öffnet sich ein Dialog.[[Datei:Extension BlueSpiceTranslationTransfer 1743770053694.png|alternativtext=Werkzeugleiste mit hervorgehobenem "Translate"-Link|zentriert|mini|206x206px|Übersetzen (Translate)-Link]]
# '''Wählen''' Sie die gewünschte Zielsprache aus.[[Datei:Extension BlueSpiceTranslationTransfer 1743770108045.png|alternativtext=Dialogfenster zur Auswahl aus verschiedenen Zielsprachen mit "Deutsch" ausgewählt|zentriert|mini|250x250px|Zielsprache auswählen]]
# '''Klicken''' Sie ''Übersetzen (Translate)'', um die Übersetzung zu starten.
# '''Ü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.[[Datei:Extension BlueSpiceTranslationTransfer 1743770150061.png|alternativtext=Dialogfenster zur Eingabe des Zielseitennamens|zentriert|mini|400x400px|Überprüfen Sie den gewünschten Zielseitennamen]]
# '''Klicken''' Sie erneut ''Übersetzen (Translate)'', um den Seitennamen zu speichern. Die Übersetzungsvorschau wird angezeigt.[[Datei:TranslationTransfer preview.png|alternativtext=Vorschaufenster mit übersetztem Seiteninhalt|zentriert|mini|400x400px|Übersetzungsvorschau]]
# '''Klicken''' Sie ''Speichern (Save)'', um die übersetzte Seite im Zielwiki zu speichern. Ein Bestätigungsfenster zeigt das Ergebnis des Transfers.[[Datei:TranslationTransfer confirmation.png|alternativtext=Bestätigungsdialog mit Informationen zu einer übertragenen eingebetteten Vorlage.|zentriert|mini|350x350px|Übersetzungsbestätigung]]
# '''Klicken''' Sie ''Fertig (Done)''. Sie können nun direkt zur Seite im Ziel-Wiki gelangen. Die Originalsprachenseite zeigt nun einen Sprachwechsler im Titelbereich an.[[Datei:Extension BlueSpiceTranslationTransfer 1743769862375.png|alternativtext=Sprachauswahl mit der Option "Deutsch".|zentriert|mini|200x200px|Sprachwechsler]]

== Nachfolgende Übersetzungen ==
Wenn eine Seite bereits im Ziel-Wiki existiert, werden eingebettete Ressourcen wie Vorlagen nicht erneut dorthin übertragen. Vorlagen werden in jedem Sprach-Wiki separat verwaltet, da der Übersetzungsdienst nicht feststellen kann, welche Vorlagenelemente übersetzt werden müssen. Nach Abschluss der Übersetzung zeigt das Wiki ein Bestätigungsfenster an, in dem alle eingebetteten Ressourcen aufgelistet sind, die nicht in das Ziel-Wiki übertragen wurden.
[[Datei:TranslationTransfer embedded resources.png|alternativtext=Dialogfenster, das anzeigt, dass eine Vorlage nicht in das Ziel-Wiki kopiert wurde.|zentriert|mini|350x350px|Hinweis zu eingebetteten Ressourcen]]

== 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:Erweiterung/MergeArticles|Handbuch-Seite der Erweiterung MergeArticles]] verfügbar.

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

* '''Seitentext'''
* '''Seitentitel''' (Anpassung des vorgeschlagenen Titels ist bei der Erstübersetzung möglich)
* '''Anzeigetitel'''
* '''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:''' Wiki-Links werden übersetzt. Falls eine Seite im Zielwiki nicht existiert, wird sie entsprechend als "Gewünschte Seite" (Redlink) angezeigt .
* '''Eingebundene Dateien (png, jpg, gif,...)''' werden ins Zielwiki übertragen:
** Der Dateiname wird beibehalten. Bei Text-Links wird die Linkbezeichnung übersetzt.
** Die Beschreibung und der Alternativtext von eingebetteten Dateien werden übersetzt.
** Die Übertragung von auf Dateien kann manuell unterdrückt werden ([[Handbuch:Erweiterung/BlueSpiceTranslationTransfer#Dateien ausschlie.C3.9Fen|siehe Dateien ausschließen]]).
* '''Dateianhänge:''' Dateianhänge werden wie alle Dateien ins Zielwiki übertragen. Die Linkbezeichnung wird übersetzt.
* '''Medien (pdf, docx, xlsx,...):''' Die Linkbeschreibung wird übersetzt und das Originaldokument wird in das Zielwiki kopiert.
* '''Galerien:''' Wenn ein Galerie-Droplet auf einer Seite eingefügt wird, werden die Dateinamen nicht übersetzt und die Galerie wird korrekt im Zielwiki angezeigt. Die Bildunterschriften werden übersetzt.
* '''Vorlagen:''' Vorlagen werden mit dem Original-Seitennamen übertragen, falls sie im Ziel-Wiki noch nicht vorhanden sind. Eine Übersetzung der Inhalte findet jedoch nicht statt. Die Vorlagen werden manuell in den jeweiligen Sprachversionen gepflegt. Es können jedoch auf dem Server [[Referenz:BlueSpiceTranslationTransfer#Zus.C3.A4tzliche Konfigurationsm.C3.B6glichkeiten|Vorlagenparameter konfiguriert]] werden, die übersetzt werden sollen.
* '''Magische Wörter''' werden in ihre kanonische Bezeichnung (EN) übersetzt.
{{Textbox|boxtype=note|header=Hinweis:|text=Einschränkung in früheren BlueSpice-Versionen: Wenn eine Seite zu groß ist, kann die DeepL API sie nicht übersetzen. Die beste Möglichkeit ist, die Seite in kleinere Unterseiten aufzuteilen oder auf die aktuellste BlueSpice-Version zu wechseln.|icon=yes}}

== Nicht-übersetzte oder nicht-übertragene Elemente ==
Folgende Elemente werden für die Übersetzung nichtg berücksichtigt:

* '''Bereits im Ziel-Wiki vorhandene Vorlagen:''' Vorlagen werden im Ziel-Wiki nicht überschrieben, wenn sie dort bereits vorhanden sind.

* '''Vorlagen:''' Vorlagen, die bereits im Ziel-Wiki vorhanden sind werden nicht übertragen.
* '''Formulare für Vorlagen''' ([[Referenz:Page Forms|Page Forms]])''':''' Formulare müssen manuell in die Zielwikis übertragen werden und dort der jeweiligen Sprache angepasst werden.
* '''Transkludierte Seiten:''' Transkludierte Seiten werden derzeit ohne Übersetzung in das Zielwiki übertragen.
* '''Codeblöcke:''' werden nicht übersetzt.

== Inhalte von der Übersetzung ausschließen ==

=== Text ausschließen{{Bsvs|bsvFrom=5.2.2}} ===
Bevor Sie den Text schreiben:

# '''Öffnen''' Sie das ''Menü Einfügen (+)'' in der Editor-Symbolleiste.

# '''Klicken''' Sie auf ''Von der Übersetzung ausschließen''.

# '''Fügen''' Sie den Text hinzu, den Sie ausschließen möchten.

# '''Klicken''' Sie auf ''Einfügen''.

Wenn Ihr Text bereits auf der Seite vorhanden ist, müssen Sie in den Quelltextbearbeitungsmodus wechseln und das Tag „ignore“ manuell einfügen. Dieses Tag hat einen Start- und einen End-Tag:<syntaxhighlight lang="text">
<translation:ignore>Text hier</translation:ignore>

</syntaxhighlight>

=== Dateien 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:

# '''Fügen''' Sie den Umschalter <code><nowiki>__BS_NO_AUTOMATIC_DOCUMENT_TRANSLATION__</nowiki></code> im Quelltext der zu übersetzenden Seite '''ein'''.
# '''Übersetzen''' Sie die Seite in die Zielsprache. In der Vorschau werden die Dateien des Quellwikis noch angezeigt. Sie werden allerdings nicht mit übertragen.
# '''Ü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.

Hinweis: Falls die Datei schon auf dem Zielwiki existiert, wird die Datei angezeigt.

== Übersetzungsübersicht ==
Eine Übersicht über alle Übersetzungen ist unter <code>Spezial:TranslationsOverview</code> im Quellwiki verfügbar.
[[Datei:Handbuch:Erweiterung BlueSpiceTranslationTransfer 1743771129964.png|zentriert|mini|Übersetzungsübersicht|600x600px|alternativtext=Übersetzungsübersichtsseite mit drei Einträgen]]
== Übersetzungs-Wörterbuch ==
Das Wörterbuch mit allen Seitentiteln und Verknüpfungen kann unter <code>Spezial:TranslationDictionary</code> 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.
[[Datei:Handbuch:Erweiterung BlueSpiceTranslationTransfer 1743169370583.png|zentriert|mini|Übersetzungs-Wörterbuch|600x600px]]

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 <code>Spezial:Übersetzungsglossar</code> 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.[[Datei:Handbuch:Erweiterung BlueSpiceTranslationTransfer 1743169204822.png|zentriert|mini|Übersetzungs-Glossar|alternativtext=Spezialseite Übersetzungsglossar mit einem Eintrag|650x650px]]

Nicht alle Übersetzungssprachen unterstützen die Glossarfunktion ([https://developers.deepl.com/docs/api-reference/glossaries#list-supported-glossary-language-pairs siehe DeepL Dokumentation]).

Bitte beachten Sie die folgenden Empfehlungen zur Definition von Glossarbegriffen (bereitgestellt vom DeepL-Dienst):

* Wir empfehlen grundsätzlich die idiomatische Groß- und Kleinschreibung beim Hinzufügen eines Glossareintrags. Bitte verwenden Sie Groß- und Kleinschreibung, wenn dies in der jeweiligen Sprache angebracht ist.
* Da Substantive im Englischen generell klein geschrieben werden, empfehlen wir dringend die Verwendung des Glossarpaars „cat – Katze“. Andernfalls erkennt die KI „Cat“ (mit Großbuchstaben) als Eigennamen.

'''Best Practices für Glossare:'''

* Kein Plural
* Kein Präteritum
* Verwenden Sie idiomatische Groß- und Kleinschreibung, wenn dies in der jeweiligen Sprache angebracht ist.
* Die Verwendung von vorangestellten Artikeln bei Substantiven ist irrelevant und kann ignoriert werden.
* Verwenden Sie Infinitivmarkierungen bei Verben, wie z. B. „to“ im Englischen, um Missverständnisse zu vermeiden (Beispiel: to rain → regnen; rain → Regen).

== Konfiguration ==

===Zuordnung der Namensräume===
{{#dpl:title=Handbuch:Erweiterung/BlueSpiceConfigManager|include=##.*BlueSpiceTranslationTransfer.*}}

=== Konfiguration DeepL API ===
{{#dpl:title=Handbuch:Erweiterung/BlueSpiceConfigManager|include=#DeepL API}}

== Fehlermeldungen ==
Es kann zu Übersetzungskonflikten zwischen Quell- und Zielwiki kommen, wenn Seiten ohne Weiterleitung verschoben werden. Beispiel:

# '''Quellseite wurde verschoben:''' Eine Seite wurde in einem englischsprachigen Quellwiki ohne Weiterleitung von <code>A new page</code> nach <code>
A new page 1</code> verschoben. Die Seite wurde ursprünglich als <code>Eine neue Seite</code> ins deutsche Wiki übersetzt. Wenn der Benutzer <code>A new page 1</code> nach <code>Eine neue Seite</code> übersetzen möchte, zeigt das Wiki eine Fehlermeldung an, dass die vorgeschlagene Zielseite bereits existiert:[[File:translationtransfer error1.png|alt=Seite kann nicht in den ausgewählten Seitentitel übersetzt werden, da die Zielseite bereits existiert|center|thumb|450x450px|Fehlermeldung bei der Übersetzungsübertragung]]'''Lösung:''' Es ist notwendig, die ursprüngliche Zuordnung zwischen den beiden Seiten <code>A new page</code> und <code>Eine neue Seite</code> aus dem [[Handbuch:Erweiterung/BlueSpiceTranslationTransfer#.C3.9Cbersetzungs-W.C3.B6rterbuch|Übersetzungs-Wörterbuch]] zu löschen. Danach ist es möglich, das Übersetzungsziel für <code>A new page 1</code> problemlos auf <code>Eine neue Seite</code> zu setzen, ohne eine Fehlermeldung zu erhalten. Die Zielseite <code>Eine neue Seite</code> behält ihren Versionsverlauf.
== 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 [[Handbuch:Erweiterung/AdhocTranslation|Ad-hoc Übersetzung]] angezeigt. Diese Übersetzung ist nur solange gültig, bis die Seite neu geladen wird.

{{Box Links|Thema1=[[Handbuch:Erweiterung/ContentTransfer]]|Thema2=[[Handbuch:Erweiterung/MergeArticles]]|Thema3=[[Handbuch:Erweiterung/AdhocTranslation]]}}

{{translation}}
[[Kategorie:BlueSpice farm]]

Handbuch:Erweiterung/BlueSpiceTranslationTransfer

2026-06-23T09:27:48Z

Margit.link-rodrigue:

Der Übersetzungsmechanismus in einer Wiki-Farm wird über die Erweiterung '''BlueSpiceTranslationTransfer''' gesteuert.{{DISPLAYTITLE:Übersetzungen in der Wiki farm (TranslationTransfer)}}
{{Textbox|boxtype=important|header=DeepL API-Schlüssel erforderlich|text=Diese Funktion benötigt einen gültigen DeepL API-Schlüssel. Dieser wird nicht von BlueSpice bereitgestellt. Der Schlüssel wird in der [[Handbuch:Erweiterung/BlueSpiceConfigManager#DeepL_API|Konfigurationsverwaltung des Quellwikis]] angegeben.|icon=yes}}

== 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.

=== Anlegen der Zielwikis ===
Sprachwikis werden immer mit ihrem zweistelligen [https://de.wikipedia.org/wiki/Liste_der_ISO-639-Sprachcodes ISO 639-1 Sprachkürzel] angelegt (zum Beispiel <code>EN</code> oder <code>en</code> für die englischsprachige Instanz, <code>FR</code> oder <code>fr</code> für die französische). Bei der Übersetzung können alle Sprachinstanzen angelegt werden, die vom DeepL Übersetzungsdienst unterstützt werden.

Dies bedeutet auch, dass eine Wiki-Instanz mit dem Namen <code>IT</code> 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. <code>IT-Wiki</code>).

=== Übereinstimmung von Pfad und Inhaltssprache ===
{{Textbox|boxtype=important|header=Richtige Sprache setzen!|text=Beim Anlegen einer Wiki-Instanz müssen Sie darauf achten, dass sowohl der Pfad als auch die Inhaltssprache dem ISO-Sprachkürzel entsprechen. Ansonsten wird die Instanz nicht als Sprachwiki erkannt. Der Seitenname kann frei gewählt werden, es bietet sich jedoch an, auch diesen konsequent mit dem Sprachkürzel anzulegen. Eine nachträgliche Umkonfiguration von Wikis, die bereits mit Inhalten gefüllt sind, kann schwierig sein, da einige Bezeichnungen sprachspezifisch sind (z.B. die Syntax von Bildattributen).|icon=yes}}[[Datei:BlueSpiceTranslationTransfer - neue Instanz anlegen.png|zentriert|mini|alternativtext=Dialogfenster zum Erstellen einer englischen Sprachinstanz in der Wikifarm|450x450px|Dialogfenster zum Erstellen einer neuen Sprachinstanz mit Seitennamen (1), Pfad (2) und übereinstimmender Inhaltssprache (3) in einem deutschen Stammwiki.]]
Die Beziehung zwischen den Instanzen einer Wiki-Farm mit Bezug auf Übersetzung sieht also verbildlicht so aus:

<drawio filename="TranslationTransfer_Instanzen" alt="">

</drawio>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:

# '''Klicken''' Sie auf der Quellseite auf den ''Übersetzen (Translate)''-Link in der Werkzeugleiste. Es öffnet sich ein Dialog.[[Datei:Extension BlueSpiceTranslationTransfer 1743770053694.png|alternativtext=Werkzeugleiste mit hervorgehobenem "Translate"-Link|zentriert|mini|206x206px|Übersetzen (Translate)-Link]]
# '''Wählen''' Sie die gewünschte Zielsprache aus.[[Datei:Extension BlueSpiceTranslationTransfer 1743770108045.png|alternativtext=Dialogfenster zur Auswahl aus verschiedenen Zielsprachen mit "Deutsch" ausgewählt|zentriert|mini|250x250px|Zielsprache auswählen]]
# '''Klicken''' Sie ''Übersetzen (Translate)'', um die Übersetzung zu starten.
# '''Ü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.[[Datei:Extension BlueSpiceTranslationTransfer 1743770150061.png|alternativtext=Dialogfenster zur Eingabe des Zielseitennamens|zentriert|mini|400x400px|Überprüfen Sie den gewünschten Zielseitennamen]]
# '''Klicken''' Sie erneut ''Übersetzen (Translate)'', um den Seitennamen zu speichern. Die Übersetzungsvorschau wird angezeigt.[[Datei:TranslationTransfer preview.png|alternativtext=Vorschaufenster mit übersetztem Seiteninhalt|zentriert|mini|400x400px|Übersetzungsvorschau]]
# '''Klicken''' Sie ''Speichern (Save)'', um die übersetzte Seite im Zielwiki zu speichern. Ein Bestätigungsfenster zeigt das Ergebnis des Transfers.[[Datei:TranslationTransfer confirmation.png|alternativtext=Bestätigungsdialog mit Informationen zu einer übertragenen eingebetteten Vorlage.|zentriert|mini|350x350px|Übersetzungsbestätigung]]
# '''Klicken''' Sie ''Fertig (Done)''. Sie können nun direkt zur Seite im Ziel-Wiki gelangen. Die Originalsprachenseite zeigt nun einen Sprachwechsler im Titelbereich an.[[Datei:Extension BlueSpiceTranslationTransfer 1743769862375.png|alternativtext=Sprachauswahl mit der Option "Deutsch".|zentriert|mini|200x200px|Sprachwechsler]]

== Nachfolgende Übersetzungen ==
Wenn eine Seite bereits im Ziel-Wiki existiert, werden eingebettete Ressourcen wie Vorlagen nicht erneut dorthin übertragen. Vorlagen werden in jedem Sprach-Wiki separat verwaltet, da der Übersetzungsdienst nicht feststellen kann, welche Vorlagenelemente übersetzt werden müssen. Nach Abschluss der Übersetzung zeigt das Wiki ein Bestätigungsfenster an, in dem alle eingebetteten Ressourcen aufgelistet sind, die nicht in das Ziel-Wiki übertragen wurden.
[[Datei:TranslationTransfer embedded resources.png|alternativtext=Dialogfenster, das anzeigt, dass eine Vorlage nicht in das Ziel-Wiki kopiert wurde.|zentriert|mini|350x350px|Hinweis zu eingebetteten Ressourcen]]

== 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:Erweiterung/MergeArticles|Handbuch-Seite der Erweiterung MergeArticles]] verfügbar.

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

* '''Seitentext'''
* '''Seitentitel''' (Anpassung des vorgeschlagenen Titels ist bei der Erstübersetzung möglich)
* '''Anzeigetitel'''
* '''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:''' Wiki-Links werden übersetzt. Falls eine Seite im Zielwiki nicht existiert, wird sie entsprechend als "Gewünschte Seite" (Redlink) angezeigt .
* '''Eingebundene Dateien (png, jpg, gif,...)''' werden ins Zielwiki übertragen:
** Der Dateiname wird beibehalten. Bei Text-Links wird die Linkbezeichnung übersetzt.
** Die Beschreibung und der Alternativtext von eingebetteten Dateien werden übersetzt.
** Die Übertragung von auf Dateien kann manuell unterdrückt werden ([[Handbuch:Erweiterung/BlueSpiceTranslationTransfer#Dateien ausschlie.C3.9Fen|siehe Dateien ausschließen]]).
* '''Dateianhänge:''' Dateianhänge werden wie alle Dateien ins Zielwiki übertragen. Die Linkbezeichnung wird übersetzt.
* '''Medien (pdf, docx, xlsx,...):''' Die Linkbeschreibung wird übersetzt und das Originaldokument wird in das Zielwiki kopiert.
* '''Galerien:''' Wenn ein Galerie-Droplet auf einer Seite eingefügt wird, werden die Dateinamen nicht übersetzt und die Galerie wird korrekt im Zielwiki angezeigt. Die Bildunterschriften werden übersetzt.
* '''Vorlagen:''' Vorlagen werden mit dem Original-Seitennamen übertragen, falls sie im Ziel-Wiki noch nicht vorhanden sind. Eine Übersetzung der Inhalte findet jedoch nicht statt. Die Vorlagen werden manuell in den jeweiligen Sprachversionen gepflegt. Es können jedoch auf dem Server [[Referenz:BlueSpiceTranslationTransfer#Zus.C3.A4tzliche Konfigurationsm.C3.B6glichkeiten|Vorlagenparameter konfiguriert]] werden, die übersetzt werden sollen.
* '''Magische Wörter''' werden in ihre kanonische Bezeichnung (EN) übersetzt.
{{Textbox|boxtype=note|header=Hinweis:|text=Einschränkung in früheren BlueSpice-Versionen: Wenn eine Seite zu groß ist, kann die DeepL API sie nicht übersetzen. Die beste Möglichkeit ist, die Seite in kleinere Unterseiten aufzuteilen oder auf die aktuellste BlueSpice-Version zu wechseln.|icon=yes}}

== Nicht-übersetzte oder nicht-übertragene Elemente ==
Folgende Elemente werden für die Übersetzung nichtg berücksichtigt:

* '''Bereits im Ziel-Wiki vorhandene Vorlagen:''' Vorlagen werden im Ziel-Wiki nicht überschrieben, wenn sie dort bereits vorhanden sind.

* '''Vorlagen:''' Vorlagen werden mit dem Original-Seitennamen übertragen, falls sie im Ziel-Wiki noch nicht vorhanden sind. Eine Übersetzung der Inhalte findet jedoch nicht statt. Die Vorlagen werden manuell in den jeweiligen Sprachversionen gepflegt. Es können jedoch auf dem Server [[Referenz:BlueSpiceTranslationTransfer#Zus.C3.A4tzliche Konfigurationsm.C3.B6glichkeiten|Vorlagenparameter konfiguriert]] werden, die übersetzt werden sollen.
* '''Formulare für Vorlagen''' ([[Referenz:Page Forms|Page Forms]])''':''' Formulare müssen manuell in die Zielwikis übertragen werden und dort der jeweiligen Sprache angepasst werden.
* '''Transkludierte Seiten:''' Transkludierte Seiten werden derzeit ohne Übersetzung in das Zielwiki übertragen.
* '''Codeblöcke:''' werden nicht übersetzt.

== Inhalte von der Übersetzung ausschließen ==

=== Text ausschließen{{Bsvs|bsvFrom=5.2.2}} ===
Bevor Sie den Text schreiben:

# '''Öffnen''' Sie das ''Menü Einfügen (+)'' in der Editor-Symbolleiste.

# '''Klicken''' Sie auf ''Von der Übersetzung ausschließen''.

# '''Fügen''' Sie den Text hinzu, den Sie ausschließen möchten.

# '''Klicken''' Sie auf ''Einfügen''.

Wenn Ihr Text bereits auf der Seite vorhanden ist, müssen Sie in den Quelltextbearbeitungsmodus wechseln und das Tag „ignore“ manuell einfügen. Dieses Tag hat einen Start- und einen End-Tag:<syntaxhighlight lang="text">
<translation:ignore>Text hier</translation:ignore>

</syntaxhighlight>

=== Dateien 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:

# '''Fügen''' Sie den Umschalter <code><nowiki>__BS_NO_AUTOMATIC_DOCUMENT_TRANSLATION__</nowiki></code> im Quelltext der zu übersetzenden Seite '''ein'''.
# '''Übersetzen''' Sie die Seite in die Zielsprache. In der Vorschau werden die Dateien des Quellwikis noch angezeigt. Sie werden allerdings nicht mit übertragen.
# '''Ü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.

Hinweis: Falls die Datei schon auf dem Zielwiki existiert, wird die Datei angezeigt.

== Übersetzungsübersicht ==
Eine Übersicht über alle Übersetzungen ist unter <code>Spezial:TranslationsOverview</code> im Quellwiki verfügbar.
[[Datei:Handbuch:Erweiterung BlueSpiceTranslationTransfer 1743771129964.png|zentriert|mini|Übersetzungsübersicht|600x600px|alternativtext=Übersetzungsübersichtsseite mit drei Einträgen]]
== Übersetzungs-Wörterbuch ==
Das Wörterbuch mit allen Seitentiteln und Verknüpfungen kann unter <code>Spezial:TranslationDictionary</code> 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.
[[Datei:Handbuch:Erweiterung BlueSpiceTranslationTransfer 1743169370583.png|zentriert|mini|Übersetzungs-Wörterbuch|600x600px]]

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 <code>Spezial:Übersetzungsglossar</code> 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.[[Datei:Handbuch:Erweiterung BlueSpiceTranslationTransfer 1743169204822.png|zentriert|mini|Übersetzungs-Glossar|alternativtext=Spezialseite Übersetzungsglossar mit einem Eintrag|650x650px]]

Nicht alle Übersetzungssprachen unterstützen die Glossarfunktion ([https://developers.deepl.com/docs/api-reference/glossaries#list-supported-glossary-language-pairs siehe DeepL Dokumentation]).

Bitte beachten Sie die folgenden Empfehlungen zur Definition von Glossarbegriffen (bereitgestellt vom DeepL-Dienst):

* Wir empfehlen grundsätzlich die idiomatische Groß- und Kleinschreibung beim Hinzufügen eines Glossareintrags. Bitte verwenden Sie Groß- und Kleinschreibung, wenn dies in der jeweiligen Sprache angebracht ist.
* Da Substantive im Englischen generell klein geschrieben werden, empfehlen wir dringend die Verwendung des Glossarpaars „cat – Katze“. Andernfalls erkennt die KI „Cat“ (mit Großbuchstaben) als Eigennamen.

'''Best Practices für Glossare:'''

* Kein Plural
* Kein Präteritum
* Verwenden Sie idiomatische Groß- und Kleinschreibung, wenn dies in der jeweiligen Sprache angebracht ist.
* Die Verwendung von vorangestellten Artikeln bei Substantiven ist irrelevant und kann ignoriert werden.
* Verwenden Sie Infinitivmarkierungen bei Verben, wie z. B. „to“ im Englischen, um Missverständnisse zu vermeiden (Beispiel: to rain → regnen; rain → Regen).

== Konfiguration ==

===Zuordnung der Namensräume===
{{#dpl:title=Handbuch:Erweiterung/BlueSpiceConfigManager|include=##.*BlueSpiceTranslationTransfer.*}}

=== Konfiguration DeepL API ===
{{#dpl:title=Handbuch:Erweiterung/BlueSpiceConfigManager|include=#DeepL API}}

== Fehlermeldungen ==
Es kann zu Übersetzungskonflikten zwischen Quell- und Zielwiki kommen, wenn Seiten ohne Weiterleitung verschoben werden. Beispiel:

# '''Quellseite wurde verschoben:''' Eine Seite wurde in einem englischsprachigen Quellwiki ohne Weiterleitung von <code>A new page</code> nach <code>
A new page 1</code> verschoben. Die Seite wurde ursprünglich als <code>Eine neue Seite</code> ins deutsche Wiki übersetzt. Wenn der Benutzer <code>A new page 1</code> nach <code>Eine neue Seite</code> übersetzen möchte, zeigt das Wiki eine Fehlermeldung an, dass die vorgeschlagene Zielseite bereits existiert:[[File:translationtransfer error1.png|alt=Seite kann nicht in den ausgewählten Seitentitel übersetzt werden, da die Zielseite bereits existiert|center|thumb|450x450px|Fehlermeldung bei der Übersetzungsübertragung]]'''Lösung:''' Es ist notwendig, die ursprüngliche Zuordnung zwischen den beiden Seiten <code>A new page</code> und <code>Eine neue Seite</code> aus dem [[Handbuch:Erweiterung/BlueSpiceTranslationTransfer#.C3.9Cbersetzungs-W.C3.B6rterbuch|Übersetzungs-Wörterbuch]] zu löschen. Danach ist es möglich, das Übersetzungsziel für <code>A new page 1</code> problemlos auf <code>Eine neue Seite</code> zu setzen, ohne eine Fehlermeldung zu erhalten. Die Zielseite <code>Eine neue Seite</code> behält ihren Versionsverlauf.
== 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 [[Handbuch:Erweiterung/AdhocTranslation|Ad-hoc Übersetzung]] angezeigt. Diese Übersetzung ist nur solange gültig, bis die Seite neu geladen wird.

{{Box Links|Thema1=[[Handbuch:Erweiterung/ContentTransfer]]|Thema2=[[Handbuch:Erweiterung/MergeArticles]]|Thema3=[[Handbuch:Erweiterung/AdhocTranslation]]}}

{{translation}}
[[Kategorie:BlueSpice farm]]

Handbuch:Erweiterung/BlueSpiceTranslationTransfer

2026-06-23T09:27:27Z

Margit.link-rodrigue:

Der Übersetzungsmechanismus in einer Wiki-Farm wird über die Erweiterung '''BlueSpiceTranslationTransfer''' gesteuert.{{DISPLAYTITLE:Übersetzungen in der Wiki farm (TranslationTransfer)}}
{{Textbox|boxtype=important|header=DeepL API-Schlüssel erforderlich|text=Diese Funktion benötigt einen gültigen DeepL API-Schlüssel. Dieser wird nicht von BlueSpice bereitgestellt. Der Schlüssel wird in der [[Handbuch:Erweiterung/BlueSpiceConfigManager#DeepL_API|Konfigurationsverwaltung des Quellwikis]] angegeben.|icon=yes}}

== 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.

=== Anlegen der Zielwikis ===
Sprachwikis werden immer mit ihrem zweistelligen [https://de.wikipedia.org/wiki/Liste_der_ISO-639-Sprachcodes ISO 639-1 Sprachkürzel] angelegt (zum Beispiel <code>EN</code> oder <code>en</code> für die englischsprachige Instanz, <code>FR</code> oder <code>fr</code> für die französische). Bei der Übersetzung können alle Sprachinstanzen angelegt werden, die vom DeepL Übersetzungsdienst unterstützt werden.

Dies bedeutet auch, dass eine Wiki-Instanz mit dem Namen <code>IT</code> 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. <code>IT-Wiki</code>).

=== Übereinstimmung von Pfad und Inhaltssprache ===
{{Textbox|boxtype=important|header=Richtige Sprache setzen!|text=Beim Anlegen einer Wiki-Instanz müssen Sie darauf achten, dass sowohl der Pfad als auch die Inhaltssprache dem ISO-Sprachkürzel entsprechen. Ansonsten wird die Instanz nicht als Sprachwiki erkannt. Der Seitenname kann frei gewählt werden, es bietet sich jedoch an, auch diesen konsequent mit dem Sprachkürzel anzulegen. Eine nachträgliche Umkonfiguration von Wikis, die bereits mit Inhalten gefüllt sind, kann schwierig sein, da einige Bezeichnungen sprachspezifisch sind (z.B. die Syntax von Bildattributen).|icon=yes}}[[Datei:BlueSpiceTranslationTransfer - neue Instanz anlegen.png|zentriert|mini|alternativtext=Dialogfenster zum Erstellen einer englischen Sprachinstanz in der Wikifarm|450x450px|Dialogfenster zum Erstellen einer neuen Sprachinstanz mit Seitennamen (1), Pfad (2) und übereinstimmender Inhaltssprache (3) in einem deutschen Stammwiki.]]
Die Beziehung zwischen den Instanzen einer Wiki-Farm mit Bezug auf Übersetzung sieht also verbildlicht so aus:

<drawio filename="TranslationTransfer_Instanzen" alt="">

</drawio>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:

# '''Klicken''' Sie auf der Quellseite auf den ''Übersetzen (Translate)''-Link in der Werkzeugleiste. Es öffnet sich ein Dialog.[[Datei:Extension BlueSpiceTranslationTransfer 1743770053694.png|alternativtext=Werkzeugleiste mit hervorgehobenem "Translate"-Link|zentriert|mini|206x206px|Übersetzen (Translate)-Link]]
# '''Wählen''' Sie die gewünschte Zielsprache aus.[[Datei:Extension BlueSpiceTranslationTransfer 1743770108045.png|alternativtext=Dialogfenster zur Auswahl aus verschiedenen Zielsprachen mit "Deutsch" ausgewählt|zentriert|mini|250x250px|Zielsprache auswählen]]
# '''Klicken''' Sie ''Übersetzen (Translate)'', um die Übersetzung zu starten.
# '''Ü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.[[Datei:Extension BlueSpiceTranslationTransfer 1743770150061.png|alternativtext=Dialogfenster zur Eingabe des Zielseitennamens|zentriert|mini|400x400px|Überprüfen Sie den gewünschten Zielseitennamen]]
# '''Klicken''' Sie erneut ''Übersetzen (Translate)'', um den Seitennamen zu speichern. Die Übersetzungsvorschau wird angezeigt.[[Datei:TranslationTransfer preview.png|alternativtext=Vorschaufenster mit übersetztem Seiteninhalt|zentriert|mini|400x400px|Übersetzungsvorschau]]
# '''Klicken''' Sie ''Speichern (Save)'', um die übersetzte Seite im Zielwiki zu speichern. Ein Bestätigungsfenster zeigt das Ergebnis des Transfers.[[Datei:TranslationTransfer confirmation.png|alternativtext=Bestätigungsdialog mit Informationen zu einer übertragenen eingebetteten Vorlage.|zentriert|mini|350x350px|Übersetzungsbestätigung]]
# '''Klicken''' Sie ''Fertig (Done)''. Sie können nun direkt zur Seite im Ziel-Wiki gelangen. Die Originalsprachenseite zeigt nun einen Sprachwechsler im Titelbereich an.[[Datei:Extension BlueSpiceTranslationTransfer 1743769862375.png|alternativtext=Sprachauswahl mit der Option "Deutsch".|zentriert|mini|200x200px|Sprachwechsler]]

== Nachfolgende Übersetzungen ==
Wenn eine Seite bereits im Ziel-Wiki existiert, werden eingebettete Ressourcen wie Vorlagen nicht erneut dorthin übertragen. Vorlagen werden in jedem Sprach-Wiki separat verwaltet, da der Übersetzungsdienst nicht feststellen kann, welche Vorlagenelemente übersetzt werden müssen. Nach Abschluss der Übersetzung zeigt das Wiki ein Bestätigungsfenster an, in dem alle eingebetteten Ressourcen aufgelistet sind, die nicht in das Ziel-Wiki übertragen wurden.
[[Datei:TranslationTransfer embedded resources.png|alternativtext=Dialogfenster, das anzeigt, dass eine Vorlage nicht in das Ziel-Wiki kopiert wurde.|zentriert|mini|350x350px|Hinweis zu eingebetteten Ressourcen]]

== 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:Erweiterung/MergeArticles|Handbuch-Seite der Erweiterung MergeArticles]] verfügbar.

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

* '''Seitentext'''
* '''Seitentitel''' (Anpassung des vorgeschlagenen Titels ist bei der Erstübersetzung möglich)
* '''Anzeigetitel'''
* '''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:''' Wiki-Links werden übersetzt. Falls eine Seite im Zielwiki nicht existiert, wird sie entsprechend als "Gewünschte Seite" (Redlink) angezeigt .
* '''Eingebundene Dateien (png, jpg, gif,...)''' werden ins Zielwiki übertragen:
** Der Dateiname wird beibehalten. Bei Text-Links wird die Linkbezeichnung übersetzt.
** Die Beschreibung und der Alternativtext von eingebetteten Dateien werden übersetzt.
** Die Übertragung von auf Dateien kann manuell unterdrückt werden ([[Handbuch:Erweiterung/BlueSpiceTranslationTransfer#Dateien ausschlie.C3.9Fen|siehe Dateien ausschließen]]).
* '''Dateianhänge:''' Dateianhänge werden wie alle Dateien ins Zielwiki übertragen. Die Linkbezeichnung wird übersetzt.
* '''Medien (pdf, docx, xlsx,...):''' Die Linkbeschreibung wird übersetzt und das Originaldokument wird in das Zielwiki kopiert.
* '''Galerien:''' Wenn ein Galerie-Droplet auf einer Seite eingefügt wird, werden die Dateinamen nicht übersetzt und die Galerie wird korrekt im Zielwiki angezeigt. Die Bildunterschriften werden übersetzt.
* '''Vorlagen:''' Vorlagen werden mit dem Original-Seitennamen übertragen, falls sie im Ziel-Wiki noch nicht vorhanden sind. Eine Übersetzung der Inhalte findet jedoch nicht statt. Die Vorlagen werden manuell in den jeweiligen Sprachversionen gepflegt. Es können jedoch auf dem Server [[Referenz:BlueSpiceTranslationTransfer#Zus.C3.A4tzliche Konfigurationsm.C3.B6glichkeiten|Vorlagenparameter konfiguriert]] werden, die übersetzt werden sollen.
* '''Magische Wörter''' werden in ihre kanonische Bezeichnung (EN) übersetzt.
{{Textbox|boxtype=note|header=Hinweis:|text=Einschränkung in früheren BlueSpice-Versionen: Wenn eine Seite zu groß ist, kann die DeepL API sie nicht übersetzen. Die beste Möglichkeit ist, die Seite in kleinere Unterseiten aufzuteilen oder auf die aktuellste BlueSpice-Version zu wechseln.|icon=yes}}

== Nicht-übersetzte oder nicht-übertragene Elemente ==
Folgende Elemente werden für die Übersetzung nichtg berücksichtigt:

* '''Bereits im Ziel-Wiki vorhandene Vorlagen:''' Vorlagen werden im Ziel-Wiki nicht überschrieben, wenn sie dort bereits vorhanden sind.

* '''Vorlagen:''' Vorlagen werden mit dem Original-Seitennamen übertragen, falls sie im Ziel-Wiki noch nicht vorhanden sind. Eine Übersetzung der Inhalte findet jedoch nicht statt. Die Vorlagen werden manuell in den jeweiligen Sprachversionen gepflegt. Es können jedoch auf dem Server [[Referenz:BlueSpiceTranslationTransfer#Zus.C3.A4tzliche Konfigurationsm.C3.B6glichkeiten|Vorlagenparameter konfiguriert]] werden, die übersetzt werden sollen.
* '''Formulare für Vorlagen''' ([[Referenz:Page Forms|Page Forms]])''':''' Formulare müssen manuell in die Zielwikis übertragen werden und dort der jeweiligen Sprache angepasst werden.
* '''Transkludierte Seiten:''' Transkludierte Seiten werden derzeit ohne Übersetzung in das Zielwiki übertragen.
* '''Codeblöcke:''' werden nicht übersetzt.

== Inhalte von der Übersetzung ausschließen ==

=== Text ausschließen{{Bsvs|bsvFrom=5.2.2}} ===
Bevor Sie den Text schreiben:

# '''Öffnen''' Sie das ''Menü Einfügen (+)'' in der Editor-Symbolleiste.

# '''Klicken''' Sie auf ''Von der Übersetzung ausschließen''.

# '''Fügen''' Sie den Text hinzu, den Sie ausschließen möchten.

# '''Klicken''' Sie auf ''Einfügen''.

Wenn Ihr Text bereits auf der Seite vorhanden ist, müssen Sie in den Quelltextbearbeitungsmodus wechseln und das Tag „ignore“ manuell einfügen. Dieses Tag hat einen Start- und einen End-Tag:<syntaxhighlight lang="text">
<translation:ignore>Text hier</translation:ignore>

</syntaxhighlight>

=== Dateien 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:

# '''Fügen''' Sie den Umschalter <code><nowiki>__BS_NO_AUTOMATIC_DOCUMENT_TRANSLATION__</nowiki></code> im Quelltext der zu übersetzenden Seite '''ein'''.
# '''Übersetzen''' Sie die Seite in die Zielsprache. In der Vorschau werden die Dateien des Quellwikis noch angezeigt. Sie werden allerdings nicht mit übertragen.
# '''Ü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.

Hinweis: Falls die Datei schon auf dem Zielwiki existiert, wird die Datei angezeigt.

== Übersetzungsübersicht ==
Eine Übersicht über alle Übersetzungen ist unter <code>Spezial:TranslationsOverview</code> im Quellwiki verfügbar.
[[Datei:Handbuch:Erweiterung BlueSpiceTranslationTransfer 1743771129964.png|zentriert|mini|Übersetzungsübersicht|600x600px|alternativtext=Übersetzungsübersichtsseite mit drei Einträgen]]
== Übersetzungs-Wörterbuch ==
Das Wörterbuch mit allen Seitentiteln und Verknüpfungen kann unter <code>Spezial:TranslationDictionary</code> 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.
[[Datei:Handbuch:Erweiterung BlueSpiceTranslationTransfer 1743169370583.png|zentriert|mini|Übersetzungs-Wörterbuch|600x600px]]

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 <code>Spezial:Übersetzungsglossar</code> 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.[[Datei:Handbuch:Erweiterung BlueSpiceTranslationTransfer 1743169204822.png|zentriert|mini|Übersetzungs-Glossar|alternativtext=Spezialseite Übersetzungsglossar mit einem Eintrag|650x650px]]

Nicht alle Übersetzungssprachen unterstützen die Glossarfunktion ([https://developers.deepl.com/docs/api-reference/glossaries#list-supported-glossary-language-pairs siehe DeepL Dokumentation]).

Bitte beachten Sie die folgenden Empfehlungen zur Definition von Glossarbegriffen (bereitgestellt vom DeepL-Dienst):

* Wir empfehlen grundsätzlich die idiomatische Groß- und Kleinschreibung beim Hinzufügen eines Glossareintrags. Bitte verwenden Sie Groß- und Kleinschreibung, wenn dies in der jeweiligen Sprache angebracht ist.
* Da Substantive im Englischen generell klein geschrieben werden, empfehlen wir dringend die Verwendung des Glossarpaars „cat – Katze“. Andernfalls erkennt die KI „Cat“ (mit Großbuchstaben) als Eigennamen.

'''Best Practices für Glossare:'''

* Kein Plural
* Kein Präteritum
* Verwenden Sie idiomatische Groß- und Kleinschreibung, wenn dies in der jeweiligen Sprache angebracht ist.
* Die Verwendung von vorangestellten Artikeln bei Substantiven ist irrelevant und kann ignoriert werden.
* Verwenden Sie Infinitivmarkierungen bei Verben, wie z. B. „to“ im Englischen, um Missverständnisse zu vermeiden (Beispiel: to rain → regnen; rain → Regen).

== Konfiguration ==

===Zuordnung der Namensräume===
{{#dpl:title=Handbuch:Erweiterung/BlueSpiceConfigManager|include=##.*BlueSpiceTranslationTransfer.*}}

=== Konfiguration DeepL API ===
{{#dpl:title=Handbuch:Erweiterung/BlueSpiceConfigManager|include=#DeepL API}}

== Fehlermeldungen ==
Es kann zu Übersetzungskonflikten zwischen Quell- und Zielwiki kommen, wenn Seiten ohne Weiterleitung verschoben werden. Beispiel:

# '''Quellseite wurde verschoben:''' Eine Seite wurde in einem englischsprachigen Quellwiki ohne Weiterleitung von <code>A new page</code> nach <code>
A new page 1</code> verschoben. Die Seite wurde ursprünglich als <code>Eine neue Seite</code> ins deutsche Wiki übersetzt. Wenn der Benutzer <code>A new page 1</code> nach <code>Eine neue Seite</code> übersetzen möchte, zeigt das Wiki eine Fehlermeldung an, dass die vorgeschlagene Zielseite bereits existiert:[[File:translationtransfer error1.png|alt=Seite kann nicht in den ausgewählten Seitentitel übersetzt werden, da die Zielseite bereits existiert|center|thumb|450x450px|Fehlermeldung bei der Übersetzungsübertragung]]'''Lösung:''' Es ist notwendig, die ursprüngliche Zuordnung zwischen den beiden Seiten <code>A new page</code> und <code>Eine neue Seite</code> aus dem [[Manual:Extension/BlueSpiceTranslationTransfer#Titelverzeichnis|Übersetzungswörterbuch]] zu löschen. Danach ist es möglich, das Übersetzungsziel für <code>A new page 1</code> problemlos auf <code>Eine neue Seite</code> zu setzen, ohne eine Fehlermeldung zu erhalten. Die Zielseite <code>Eine neue Seite</code> behält ihren Versionsverlauf.
== 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 [[Handbuch:Erweiterung/AdhocTranslation|Ad-hoc Übersetzung]] angezeigt. Diese Übersetzung ist nur solange gültig, bis die Seite neu geladen wird.

{{Box Links|Thema1=[[Handbuch:Erweiterung/ContentTransfer]]|Thema2=[[Handbuch:Erweiterung/MergeArticles]]|Thema3=[[Handbuch:Erweiterung/AdhocTranslation]]}}

{{translation}}
[[Kategorie:BlueSpice farm]]

Handbuch:Erweiterung/BlueSpiceTranslationTransfer

2026-06-23T09:26:29Z

Margit.link-rodrigue:

Der Übersetzungsmechanismus in einer Wiki-Farm wird über die Erweiterung '''BlueSpiceTranslationTransfer''' gesteuert.{{DISPLAYTITLE:Übersetzungen in der Wiki farm (TranslationTransfer)}}
{{Textbox|boxtype=important|header=DeepL API-Schlüssel erforderlich|text=Diese Funktion benötigt einen gültigen DeepL API-Schlüssel. Dieser wird nicht von BlueSpice bereitgestellt. Der Schlüssel wird in der [[Handbuch:Erweiterung/BlueSpiceConfigManager#DeepL_API|Konfigurationsverwaltung des Quellwikis]] angegeben.|icon=yes}}

== 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.

=== Anlegen der Zielwikis ===
Sprachwikis werden immer mit ihrem zweistelligen [https://de.wikipedia.org/wiki/Liste_der_ISO-639-Sprachcodes ISO 639-1 Sprachkürzel] angelegt (zum Beispiel <code>EN</code> oder <code>en</code> für die englischsprachige Instanz, <code>FR</code> oder <code>fr</code> für die französische). Bei der Übersetzung können alle Sprachinstanzen angelegt werden, die vom DeepL Übersetzungsdienst unterstützt werden.

Dies bedeutet auch, dass eine Wiki-Instanz mit dem Namen <code>IT</code> 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. <code>IT-Wiki</code>).

=== Übereinstimmung von Pfad und Inhaltssprache ===
{{Textbox|boxtype=important|header=Richtige Sprache setzen!|text=Beim Anlegen einer Wiki-Instanz müssen Sie darauf achten, dass sowohl der Pfad als auch die Inhaltssprache dem ISO-Sprachkürzel entsprechen. Ansonsten wird die Instanz nicht als Sprachwiki erkannt. Der Seitenname kann frei gewählt werden, es bietet sich jedoch an, auch diesen konsequent mit dem Sprachkürzel anzulegen. Eine nachträgliche Umkonfiguration von Wikis, die bereits mit Inhalten gefüllt sind, kann schwierig sein, da einige Bezeichnungen sprachspezifisch sind (z.B. die Syntax von Bildattributen).|icon=yes}}[[Datei:BlueSpiceTranslationTransfer - neue Instanz anlegen.png|zentriert|mini|alternativtext=Dialogfenster zum Erstellen einer englischen Sprachinstanz in der Wikifarm|450x450px|Dialogfenster zum Erstellen einer neuen Sprachinstanz mit Seitennamen (1), Pfad (2) und übereinstimmender Inhaltssprache (3) in einem deutschen Stammwiki.]]
Die Beziehung zwischen den Instanzen einer Wiki-Farm mit Bezug auf Übersetzung sieht also verbildlicht so aus:

<drawio filename="TranslationTransfer_Instanzen" alt="">

</drawio>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:

# '''Klicken''' Sie auf der Quellseite auf den ''Übersetzen (Translate)''-Link in der Werkzeugleiste. Es öffnet sich ein Dialog.[[Datei:Extension BlueSpiceTranslationTransfer 1743770053694.png|alternativtext=Werkzeugleiste mit hervorgehobenem "Translate"-Link|zentriert|mini|206x206px|Übersetzen (Translate)-Link]]
# '''Wählen''' Sie die gewünschte Zielsprache aus.[[Datei:Extension BlueSpiceTranslationTransfer 1743770108045.png|alternativtext=Dialogfenster zur Auswahl aus verschiedenen Zielsprachen mit "Deutsch" ausgewählt|zentriert|mini|250x250px|Zielsprache auswählen]]
# '''Klicken''' Sie ''Übersetzen (Translate)'', um die Übersetzung zu starten.
# '''Ü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.[[Datei:Extension BlueSpiceTranslationTransfer 1743770150061.png|alternativtext=Dialogfenster zur Eingabe des Zielseitennamens|zentriert|mini|400x400px|Überprüfen Sie den gewünschten Zielseitennamen]]
# '''Klicken''' Sie erneut ''Übersetzen (Translate)'', um den Seitennamen zu speichern. Die Übersetzungsvorschau wird angezeigt.[[Datei:TranslationTransfer preview.png|alternativtext=Vorschaufenster mit übersetztem Seiteninhalt|zentriert|mini|400x400px|Übersetzungsvorschau]]
# '''Klicken''' Sie ''Speichern (Save)'', um die übersetzte Seite im Zielwiki zu speichern. Ein Bestätigungsfenster zeigt das Ergebnis des Transfers.[[Datei:TranslationTransfer confirmation.png|alternativtext=Bestätigungsdialog mit Informationen zu einer übertragenen eingebetteten Vorlage.|zentriert|mini|350x350px|Übersetzungsbestätigung]]
# '''Klicken''' Sie ''Fertig (Done)''. Sie können nun direkt zur Seite im Ziel-Wiki gelangen. Die Originalsprachenseite zeigt nun einen Sprachwechsler im Titelbereich an.[[Datei:Extension BlueSpiceTranslationTransfer 1743769862375.png|alternativtext=Sprachauswahl mit der Option "Deutsch".|zentriert|mini|200x200px|Sprachwechsler]]

== Nachfolgende Übersetzungen ==
Wenn eine Seite bereits im Ziel-Wiki existiert, werden eingebettete Ressourcen wie Vorlagen nicht erneut dorthin übertragen. Vorlagen werden in jedem Sprach-Wiki separat verwaltet, da der Übersetzungsdienst nicht feststellen kann, welche Vorlagenelemente übersetzt werden müssen. Nach Abschluss der Übersetzung zeigt das Wiki ein Bestätigungsfenster an, in dem alle eingebetteten Ressourcen aufgelistet sind, die nicht in das Ziel-Wiki übertragen wurden.
[[Datei:TranslationTransfer embedded resources.png|alternativtext=Dialogfenster, das anzeigt, dass eine Vorlage nicht in das Ziel-Wiki kopiert wurde.|zentriert|mini|350x350px|Hinweis zu eingebetteten Ressourcen]]

== 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:Erweiterung/MergeArticles|Handbuch-Seite der Erweiterung MergeArticles]] verfügbar.

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

* '''Seitentext'''
* '''Seitentitel''' (Anpassung des vorgeschlagenen Titels ist bei der Erstübersetzung möglich)
* '''Anzeigetitel'''
* '''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:''' Wiki-Links werden übersetzt. Falls eine Seite im Zielwiki nicht existiert, wird sie entsprechend als "Gewünschte Seite" (Redlink) angezeigt .
* '''Eingebundene Dateien (png, jpg, gif,...)''' werden ins Zielwiki übertragen:
** Der Dateiname wird beibehalten. Bei Text-Links wird die Linkbezeichnung übersetzt.
** Die Beschreibung und der Alternativtext von eingebetteten Dateien werden übersetzt.
** Die Übertragung von auf Dateien kann manuell unterdrückt werden ([[Handbuch:Erweiterung/BlueSpiceTranslationTransfer#Dateien ausschlie.C3.9Fen|siehe Dateien ausschließen]]).
* '''Dateianhänge:''' Dateianhänge werden wie alle Dateien ins Zielwiki übertragen. Die Linkbezeichnung wird übersetzt.
* '''Medien (pdf, docx, xlsx,...):''' Die Linkbeschreibung wird übersetzt und das Originaldokument wird in das Zielwiki kopiert.
* '''Galerien:''' Wenn ein Galerie-Droplet auf einer Seite eingefügt wird, werden die Dateinamen nicht übersetzt und die Galerie wird korrekt im Zielwiki angezeigt. Die Bildunterschriften werden übersetzt.
* '''Vorlagen:''' Vorlagen werden mit dem Original-Seitennamen übertragen, falls sie im Ziel-Wiki noch nicht vorhanden sind. Eine Übersetzung der Inhalte findet jedoch nicht statt. Die Vorlagen werden manuell in den jeweiligen Sprachversionen gepflegt. Es können jedoch auf dem Server [[Referenz:BlueSpiceTranslationTransfer#Zus.C3.A4tzliche Konfigurationsm.C3.B6glichkeiten|Vorlagenparameter konfiguriert]] werden, die übersetzt werden sollen.
* '''Magische Wörter''' werden in ihre kanonische Bezeichnung (EN) übersetzt.
{{Textbox|boxtype=note|header=Hinweis:|text=Einschränkung in früheren BlueSpice-Versionen: Wenn eine Seite zu groß ist, kann die DeepL API sie nicht übersetzen. Die beste Möglichkeit ist, die Seite in kleinere Unterseiten aufzuteilen oder auf die aktuellste BlueSpice-Version zu wechseln.|icon=yes}}

== Nicht-übersetzte oder nicht-übertragene Elemente ==
Folgende Elemente werden für die Übersetzung nichtg berücksichtigt:

* '''Bereits im Ziel-Wiki vorhandene Vorlagen:''' Vorlagen werden im Ziel-Wiki nicht überschrieben, wenn sie dort bereits vorhanden sind.

* '''Vorlagen:''' Vorlagen werden mit dem Original-Seitennamen übertragen, falls sie im Ziel-Wiki noch nicht vorhanden sind. Eine Übersetzung der Inhalte findet jedoch nicht statt. Die Vorlagen werden manuell in den jeweiligen Sprachversionen gepflegt. Es können jedoch auf dem Server [[Referenz:BlueSpiceTranslationTransfer#Zus.C3.A4tzliche Konfigurationsm.C3.B6glichkeiten|Vorlagenparameter konfiguriert]] werden, die übersetzt werden sollen.
* '''Formulare für Vorlagen''' ([[Referenz:Page Forms|Page Forms]])''':''' Formulare müssen manuell in die Zielwikis übertragen werden und dort der jeweiligen Sprache angepasst werden.
* '''Transkludierte Seiten:''' Transkludierte Seiten werden derzeit ohne Übersetzung in das Zielwiki übertragen.
* '''Codeblöcke:''' werden nicht übersetzt.

== Inhalte von der Übersetzung ausschließen ==

=== Text ausschließen{{Bsvs|bsvFrom=5.2.2}} ===
Bevor Sie den Text schreiben:

# '''Öffnen''' Sie das ''Menü Einfügen (+)'' in der Editor-Symbolleiste.

# '''Klicken''' Sie auf ''Von der Übersetzung ausschließen''.

# '''Fügen''' Sie den Text hinzu, den Sie ausschließen möchten.

# '''Klicken''' Sie auf ''Einfügen''.

Wenn Ihr Text bereits auf der Seite vorhanden ist, müssen Sie in den Quelltextbearbeitungsmodus wechseln und das Tag „ignore“ manuell einfügen. Dieses Tag hat einen Start- und einen End-Tag:<syntaxhighlight lang="text">
<translation:ignore>Text hier</translation:ignore>

</syntaxhighlight>

=== Dateien 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:

# '''Fügen''' Sie den Umschalter <code><nowiki>__BS_NO_AUTOMATIC_DOCUMENT_TRANSLATION__</nowiki></code> im Quelltext der zu übersetzenden Seite '''ein'''.
# '''Übersetzen''' Sie die Seite in die Zielsprache. In der Vorschau werden die Dateien des Quellwikis noch angezeigt. Sie werden allerdings nicht mit übertragen.
# '''Ü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.

Hinweis: Falls die Datei schon auf dem Zielwiki existiert, wird die Datei angezeigt.

== Übersetzungsübersicht ==
Eine Übersicht über alle Übersetzungen ist unter <code>Spezial:TranslationsOverview</code> im Quellwiki verfügbar.
[[Datei:Handbuch:Erweiterung BlueSpiceTranslationTransfer 1743771129964.png|zentriert|mini|Übersetzungsübersicht|600x600px|alternativtext=Übersetzungsübersichtsseite mit drei Einträgen]]
== Titelverzeichnis ==
Das Wörterbuch mit allen Seitentiteln und Verknüpfungen kann unter <code>Spezial:TranslationDictionary</code> 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.
[[Datei:Handbuch:Erweiterung BlueSpiceTranslationTransfer 1743169370583.png|zentriert|mini|Übersetzungs-Wörterbuch|600x600px]]

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 <code>Spezial:Übersetzungsglossar</code> 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.[[Datei:Handbuch:Erweiterung BlueSpiceTranslationTransfer 1743169204822.png|zentriert|mini|Übersetzungs-Glossar|alternativtext=Spezialseite Übersetzungsglossar mit einem Eintrag|650x650px]]

Nicht alle Übersetzungssprachen unterstützen die Glossarfunktion ([https://developers.deepl.com/docs/api-reference/glossaries#list-supported-glossary-language-pairs siehe DeepL Dokumentation]).

Bitte beachten Sie die folgenden Empfehlungen zur Definition von Glossarbegriffen (bereitgestellt vom DeepL-Dienst):

* Wir empfehlen grundsätzlich die idiomatische Groß- und Kleinschreibung beim Hinzufügen eines Glossareintrags. Bitte verwenden Sie Groß- und Kleinschreibung, wenn dies in der jeweiligen Sprache angebracht ist.
* Da Substantive im Englischen generell klein geschrieben werden, empfehlen wir dringend die Verwendung des Glossarpaars „cat – Katze“. Andernfalls erkennt die KI „Cat“ (mit Großbuchstaben) als Eigennamen.

'''Best Practices für Glossare:'''

* Kein Plural
* Kein Präteritum
* Verwenden Sie idiomatische Groß- und Kleinschreibung, wenn dies in der jeweiligen Sprache angebracht ist.
* Die Verwendung von vorangestellten Artikeln bei Substantiven ist irrelevant und kann ignoriert werden.
* Verwenden Sie Infinitivmarkierungen bei Verben, wie z. B. „to“ im Englischen, um Missverständnisse zu vermeiden (Beispiel: to rain → regnen; rain → Regen).

== Konfiguration ==

===Zuordnung der Namensräume===
{{#dpl:title=Handbuch:Erweiterung/BlueSpiceConfigManager|include=##.*BlueSpiceTranslationTransfer.*}}

=== Konfiguration DeepL API ===
{{#dpl:title=Handbuch:Erweiterung/BlueSpiceConfigManager|include=#DeepL API}}

== Fehlermeldungen ==
Es kann zu Übersetzungskonflikten zwischen Quell- und Zielwiki kommen, wenn Seiten ohne Weiterleitung verschoben werden. Beispiel:

# '''Quellseite wurde verschoben:''' Eine Seite wurde in einem englischsprachigen Quellwiki ohne Weiterleitung von <code>A new page</code> nach <code>
A new page 1</code> verschoben. Die Seite wurde ursprünglich als <code>Eine neue Seite</code> ins deutsche Wiki übersetzt. Wenn der Benutzer <code>A new page 1</code> nach <code>Eine neue Seite</code> übersetzen möchte, zeigt das Wiki eine Fehlermeldung an, dass die vorgeschlagene Zielseite bereits existiert:[[File:translationtransfer error1.png|alt=Seite kann nicht in den ausgewählten Seitentitel übersetzt werden, da die Zielseite bereits existiert|center|thumb|450x450px|Fehlermeldung bei der Übersetzungsübertragung]]'''Lösung:''' Es ist notwendig, die ursprüngliche Zuordnung zwischen den beiden Seiten <code>A new page</code> und <code>Eine neue Seite</code> aus dem [[Manual:Extension/BlueSpiceTranslationTransfer#Titelverzeichnis|Übersetzungswörterbuch]] zu löschen. Danach ist es möglich, das Übersetzungsziel für <code>A new page 1</code> problemlos auf <code>Eine neue Seite</code> zu setzen, ohne eine Fehlermeldung zu erhalten. Die Zielseite <code>Eine neue Seite</code> behält ihren Versionsverlauf.
== 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 [[Handbuch:Erweiterung/AdhocTranslation|Ad-hoc Übersetzung]] angezeigt. Diese Übersetzung ist nur solange gültig, bis die Seite neu geladen wird.

{{Box Links|Thema1=[[Handbuch:Erweiterung/ContentTransfer]]|Thema2=[[Handbuch:Erweiterung/MergeArticles]]|Thema3=[[Handbuch:Erweiterung/AdhocTranslation]]}}

{{translation}}
[[Kategorie:BlueSpice farm]]

Handbuch:Erweiterung/BlueSpiceTranslationTransfer

2026-06-23T09:25:18Z

Margit.link-rodrigue:

Der Übersetzungsmechanismus in einer Wiki-Farm wird über die Erweiterung '''BlueSpiceTranslationTransfer''' gesteuert.{{DISPLAYTITLE:Übersetzungen in der Wiki farm (TranslationTransfer)}}
{{Textbox|boxtype=important|header=DeepL API-Schlüssel erforderlich|text=Diese Funktion benötigt einen gültigen DeepL API-Schlüssel. Dieser wird nicht von BlueSpice bereitgestellt. Der Schlüssel wird in der [[Handbuch:Erweiterung/BlueSpiceConfigManager#DeepL_API|Konfigurationsverwaltung des Quellwikis]] angegeben.|icon=yes}}

== 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.

=== Anlegen der Zielwikis ===
Sprachwikis werden immer mit ihrem zweistelligen [https://de.wikipedia.org/wiki/Liste_der_ISO-639-Sprachcodes ISO 639-1 Sprachkürzel] angelegt (zum Beispiel <code>EN</code> oder <code>en</code> für die englischsprachige Instanz, <code>FR</code> oder <code>fr</code> für die französische). Bei der Übersetzung können alle Sprachinstanzen angelegt werden, die vom DeepL Übersetzungsdienst unterstützt werden.

Dies bedeutet auch, dass eine Wiki-Instanz mit dem Namen <code>IT</code> 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. <code>IT-Wiki</code>).

=== Übereinstimmung von Pfad und Inhaltssprache ===
{{Textbox|boxtype=important|header=Richtige Sprache setzen!|text=Beim Anlegen einer Wiki-Instanz müssen Sie darauf achten, dass sowohl der Pfad als auch die Inhaltssprache dem ISO-Sprachkürzel entsprechen. Ansonsten wird die Instanz nicht als Sprachwiki erkannt. Der Seitenname kann frei gewählt werden, es bietet sich jedoch an, auch diesen konsequent mit dem Sprachkürzel anzulegen. Eine nachträgliche Umkonfiguration von Wikis, die bereits mit Inhalten gefüllt sind, kann schwierig sein, da einige Bezeichnungen sprachspezifisch sind (z.B. die Syntax von Bildattributen).|icon=yes}}[[Datei:BlueSpiceTranslationTransfer - neue Instanz anlegen.png|zentriert|mini|alternativtext=Dialogfenster zum Erstellen einer englischen Sprachinstanz in der Wikifarm|450x450px|Dialogfenster zum Erstellen einer neuen Sprachinstanz mit Seitennamen (1), Pfad (2) und übereinstimmender Inhaltssprache (3) in einem deutschen Stammwiki.]]
Die Beziehung zwischen den Instanzen einer Wiki-Farm mit Bezug auf Übersetzung sieht also verbildlicht so aus:

<drawio filename="TranslationTransfer_Instanzen" alt="">

</drawio>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:

# '''Klicken''' Sie auf der Quellseite auf den ''Übersetzen (Translate)''-Link in der Werkzeugleiste. Es öffnet sich ein Dialog.[[Datei:Extension BlueSpiceTranslationTransfer 1743770053694.png|alternativtext=Werkzeugleiste mit hervorgehobenem "Translate"-Link|zentriert|mini|206x206px|Übersetzen (Translate)-Link]]
# '''Wählen''' Sie die gewünschte Zielsprache aus.[[Datei:Extension BlueSpiceTranslationTransfer 1743770108045.png|alternativtext=Dialogfenster zur Auswahl aus verschiedenen Zielsprachen mit "Deutsch" ausgewählt|zentriert|mini|250x250px|Zielsprache auswählen]]
# '''Klicken''' Sie ''Übersetzen (Translate)'', um die Übersetzung zu starten.
# '''Ü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.[[Datei:Extension BlueSpiceTranslationTransfer 1743770150061.png|alternativtext=Dialogfenster zur Eingabe des Zielseitennamens|zentriert|mini|400x400px|Überprüfen Sie den gewünschten Zielseitennamen]]
# '''Klicken''' Sie erneut ''Übersetzen (Translate)'', um den Seitennamen zu speichern. Die Übersetzungsvorschau wird angezeigt.[[Datei:TranslationTransfer preview.png|alternativtext=Vorschaufenster mit übersetztem Seiteninhalt|zentriert|mini|400x400px|Übersetzungsvorschau]]
# '''Klicken''' Sie ''Speichern (Save)'', um die übersetzte Seite im Zielwiki zu speichern. Ein Bestätigungsfenster zeigt das Ergebnis des Transfers.[[Datei:TranslationTransfer confirmation.png|alternativtext=Bestätigungsdialog mit Informationen zu einer übertragenen eingebetteten Vorlage.|zentriert|mini|350x350px|Übersetzungsbestätigung]]
# '''Klicken''' Sie ''Fertig (Done)''. Sie können nun direkt zur Seite im Ziel-Wiki gelangen. Die Originalsprachenseite zeigt nun einen Sprachwechsler im Titelbereich an.[[Datei:Extension BlueSpiceTranslationTransfer 1743769862375.png|alternativtext=Sprachauswahl mit der Option "Deutsch".|zentriert|mini|200x200px|Sprachwechsler]]

== Nachfolgende Übersetzungen ==
Wenn eine Seite bereits im Ziel-Wiki existiert, werden eingebettete Ressourcen wie Vorlagen nicht erneut dorthin übertragen. Vorlagen werden in jedem Sprach-Wiki separat verwaltet, da der Übersetzungsdienst nicht feststellen kann, welche Vorlagenelemente übersetzt werden müssen. Nach Abschluss der Übersetzung zeigt das Wiki ein Bestätigungsfenster an, in dem alle eingebetteten Ressourcen aufgelistet sind, die nicht in das Ziel-Wiki übertragen wurden.
[[Datei:TranslationTransfer embedded resources.png|alternativtext=Dialogfenster, das anzeigt, dass eine Vorlage nicht in das Ziel-Wiki kopiert wurde.|zentriert|mini|350x350px|Hinweis zu eingebetteten Ressourcen]]

== 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:Erweiterung/MergeArticles|Handbuch-Seite der Erweiterung MergeArticles]] verfügbar.

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

* '''Seitentext'''
* '''Seitentitel''' (Anpassung des vorgeschlagenen Titels ist bei der Erstübersetzung möglich)
* '''Anzeigetitel'''
* '''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:''' Wiki-Links werden übersetzt. Falls eine Seite im Zielwiki nicht existiert, wird sie entsprechend als "Gewünschte Seite" (Redlink) angezeigt .
* '''Eingebundene Dateien (png, jpg, gif,...)''' werden ins Zielwiki übertragen:
** Der Dateiname wird beibehalten. Bei Text-Links wird die Linkbezeichnung übersetzt.
** Die Beschreibung und der Alternativtext von eingebetteten Dateien werden übersetzt.
** Die Übertragung von auf Dateien kann manuell unterdrückt werden ([[Handbuch:Erweiterung/BlueSpiceTranslationTransfer#Dateien ausschlie.C3.9Fen|siehe Dateien ausschließen]]).
* '''Dateianhänge:''' Dateianhänge werden wie alle Dateien ins Zielwiki übertragen. Die Linkbezeichnung wird übersetzt.
* '''Medien (pdf, docx, xlsx,...):''' Die Linkbeschreibung wird übersetzt und das Originaldokument wird in das Zielwiki kopiert.
* '''Galerien:''' Wenn ein Galerie-Droplet auf einer Seite eingefügt wird, werden die Dateinamen nicht übersetzt und die Galerie wird korrekt im Zielwiki angezeigt. Die Bildunterschriften werden übersetzt.
* '''Vorlagen:''' Vorlagen werden mit dem Original-Seitennamen übertragen, falls sie im Ziel-Wiki noch nicht vorhanden sind. Eine Übersetzung der Inhalte findet jedoch nicht statt. Die Vorlagen werden manuell in den jeweiligen Sprachversionen gepflegt. Es können jedoch auf dem Server [[Referenz:BlueSpiceTranslationTransfer#Zus.C3.A4tzliche Konfigurationsm.C3.B6glichkeiten|Vorlagenparameter konfiguriert]] werden, die übersetzt werden sollen.
* '''Magische Wörter''' werden in ihre kanonische Bezeichnung (EN) übersetzt.
{{Textbox|boxtype=note|header=Hinweis:|text=Einschränkung in früheren BlueSpice-Versionen: Wenn eine Seite zu groß ist, kann die DeepL API sie nicht übersetzen. Die beste Möglichkeit ist, die Seite in kleinere Unterseiten aufzuteilen oder auf die aktuellste BlueSpice-Version zu wechseln.|icon=yes}}

== Nicht-übersetzte oder nicht-übertragene Elemente ==
Folgende Elemente werden für die Übersetzung nichtg berücksichtigt:

* '''Bereits im Ziel-Wiki vorhandene Vorlagen:''' Vorlagen werden im Ziel-Wiki nicht überschrieben, wenn sie dort bereits vorhanden sind.

* '''Vorlagen:''' Vorlagen werden mit dem Original-Seitennamen übertragen, falls sie im Ziel-Wiki noch nicht vorhanden sind. Eine Übersetzung der Inhalte findet jedoch nicht statt. Die Vorlagen werden manuell in den jeweiligen Sprachversionen gepflegt. Es können jedoch auf dem Server [[Referenz:BlueSpiceTranslationTransfer#Zus.C3.A4tzliche Konfigurationsm.C3.B6glichkeiten|Vorlagenparameter konfiguriert]] werden, die übersetzt werden sollen.
* '''Formulare für Vorlagen''' ([[Referenz:Page Forms|Page Forms]])''':''' Formulare müssen manuell in die Zielwikis übertragen werden und dort der jeweiligen Sprache angepasst werden.
* '''Transkludierte Seiten:''' Transkludierte Seiten werden derzeit ohne Übersetzung in das Zielwiki übertragen.
* '''Codeblöcke:''' werden nicht übersetzt.

== Inhalte von der Übersetzung ausschließen ==

=== Text ausschließen{{Bsvs|bsvFrom=5.2.2}} ===
Bevor Sie den Text schreiben:

# '''Öffnen''' Sie das ''Menü Einfügen (+)'' in der Editor-Symbolleiste.

# '''Klicken''' Sie auf ''Von der Übersetzung ausschließen''.

# '''Fügen''' Sie den Text hinzu, den Sie ausschließen möchten.

# '''Klicken''' Sie auf ''Einfügen''.

Wenn Ihr Text bereits auf der Seite vorhanden ist, müssen Sie in den Quelltextbearbeitungsmodus wechseln und das Tag „ignore“ manuell einfügen. Dieses Tag hat einen Start- und einen End-Tag:<syntaxhighlight lang="text">
<translation:ignore>Text hier</translation:ignore>

</syntaxhighlight>

=== Dateien 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:

# '''Fügen''' Sie den Umschalter <code><nowiki>__BS_NO_AUTOMATIC_DOCUMENT_TRANSLATION__</nowiki></code> im Quelltext der zu übersetzenden Seite '''ein'''.
# '''Übersetzen''' Sie die Seite in die Zielsprache. In der Vorschau werden die Dateien des Quellwikis noch angezeigt. Sie werden allerdings nicht mit übertragen.
# '''Ü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.

Hinweis: Falls die Datei schon auf dem Zielwiki existiert, wird die Datei angezeigt.

== Übersetzungsübersicht ==
Eine Übersicht über alle Übersetzungen ist unter <code>Spezial:TranslationsOverview</code> im Quellwiki verfügbar.
[[Datei:Handbuch:Erweiterung BlueSpiceTranslationTransfer 1743771129964.png|zentriert|mini|Übersetzungsübersicht|600x600px|alternativtext=Übersetzungsübersichtsseite mit drei Einträgen]]
== Titelverzeichnis ==
Das Wörterbuch mit allen Seitentiteln und Verknüpfungen kann unter <code>Spezial:TranslationDictionary</code> 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.
[[Datei:Handbuch:Erweiterung BlueSpiceTranslationTransfer 1743169370583.png|zentriert|mini|Übersetzungs-Wörterbuch|600x600px]]

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 <code>Spezial:Übersetzungsglossar</code> 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.[[Datei:Handbuch:Erweiterung BlueSpiceTranslationTransfer 1743169204822.png|zentriert|mini|Übersetzungs-Glossar|alternativtext=Spezialseite Übersetzungsglossar mit einem Eintrag|650x650px]]

Nicht alle Übersetzungssprachen unterstützen die Glossarfunktion ([https://developers.deepl.com/docs/api-reference/glossaries#list-supported-glossary-language-pairs siehe DeepL Dokumentation]).

Bitte beachten Sie die folgenden Empfehlungen zur Definition von Glossarbegriffen (bereitgestellt vom DeepL-Dienst):

* Wir empfehlen grundsätzlich die idiomatische Groß- und Kleinschreibung beim Hinzufügen eines Glossareintrags. Bitte verwenden Sie Groß- und Kleinschreibung, wenn dies in der jeweiligen Sprache angebracht ist.
* Da Substantive im Englischen generell klein geschrieben werden, empfehlen wir dringend die Verwendung des Glossarpaars „cat – Katze“. Andernfalls erkennt die KI „Cat“ (mit Großbuchstaben) als Eigennamen.

'''Best Practices für Glossare:'''

* Kein Plural
* Kein Präteritum
* Verwenden Sie idiomatische Groß- und Kleinschreibung, wenn dies in der jeweiligen Sprache angebracht ist.
* Die Verwendung von vorangestellten Artikeln bei Substantiven ist irrelevant und kann ignoriert werden.
* Verwenden Sie Infinitivmarkierungen bei Verben, wie z. B. „to“ im Englischen, um Missverständnisse zu vermeiden (Beispiel: to rain → regnen; rain → Regen).

== Konfiguration ==

===Zuordnung der Namensräume===
{{#dpl:title=Handbuch:Erweiterung/BlueSpiceConfigManager|include=##.*BlueSpiceTranslationTransfer.*}}

=== Konfiguration DeepL API ===
{{#dpl:title=Handbuch:Erweiterung/BlueSpiceConfigManager|include=#DeepL API}}

== Fehlermeldungen ==
Es kann zu Übersetzungskonflikten zwischen Quell- und Zielwiki kommen, wenn Seiten ohne Weiterleitung verschoben werden. Beispiel:

# '''Quellseite wurde verschoben:''' Eine Seite wurde in einem englischsprachigen Quellwiki ohne Weiterleitung von <code>A new page</code> nach <code>
A new page 1</code> verschoben. Die Seite wurde ursprünglich als <code>Eine neue Seite</code> ins deutsche Wiki übersetzt. Wenn der Benutzer <code>A new page 1</code> nach <code>Eine neue Seite</code> übersetzen möchte, zeigt das Wiki eine Fehlermeldung an, dass die vorgeschlagene Zielseite bereits existiert:[[File:translationtransfer error1.png|alt=Seite kann nicht in den ausgewählten Seitentitel übersetzt werden, da die Zielseite bereits existiert|center|thumb|450x450px|Fehlermeldung bei der Übersetzungsübertragung]]'''Lösung:''' Es ist notwendig, die ursprüngliche Zuordnung zwischen den beiden Seiten <code>A new page</code> und <code>Eine neue Seite</code> aus dem [[Manual:Extension/BlueSpiceTranslationTransfer#Translation dictionary|Übersetzungswörterbuch]] zu löschen. Danach ist es möglich, das Übersetzungsziel für <code>A new page 1</code> problemlos auf <code>Eine neue Seite</code> zu setzen, ohne eine Fehlermeldung zu erhalten. Die Zielseite <code>Eine neue Seite</code> behält ihren Versionsverlauf.
== 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 [[Handbuch:Erweiterung/AdhocTranslation|Ad-hoc Übersetzung]] angezeigt. Diese Übersetzung ist nur solange gültig, bis die Seite neu geladen wird.

{{Box Links|Thema1=[[Handbuch:Erweiterung/ContentTransfer]]|Thema2=[[Handbuch:Erweiterung/MergeArticles]]|Thema3=[[Handbuch:Erweiterung/AdhocTranslation]]}}

{{translation}}
[[Kategorie:BlueSpice farm]]

Referenz:BlueSpiceTranslationTransfer

2026-06-23T09:20:57Z

Margit.link-rodrigue:

{{BSExtensionInfo
|status=stable
|developer=HalloWelt
|type=BlueSpice
|edition=BlueSpice farm
|compatible=BlueSpice
|category=Administration
|bsvFrom=5.0
|features=BlueSpiceTranslationTransfer (BSTT) ermöglicht es Nutzern eines Wikis, ihre übersetzten Artikel an ein anderes Wiki zu senden.

{{Textbox|boxtype=important|header=DeepL API-Schlüssel erforderlich|text=Diese Funktion benötigt einen gültigen DeepL API-Schlüssel. Dieser wird nicht von BlueSpice bereitgestellt.|icon=yes}}

=== 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 [[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.
* 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 <code>bs_translationtransfer_translations</code> (kann in der Stammdatei <code>LocalSettings.php</code> oder in einer der <code>settings.d</code>-Dateien angegeben werden, z. B. <code>settings.d/050-BlueSpiceTranslationTransfer</code>
|license=GPL v3 only
}}
===Zertifikate===
Wenn selbstsignierte Zertifikate verwendet werden (und keine ausgehenden Verbindungen erlaubt sind), muss
<syntaxhighlight lang="text">
$GLOBALS['wgWikiFarmConfig_internalServer'] = 'http://wiki-web:9090';
</syntaxhighlight>
in <code>data/bluespice/pre-init-settings.php</code> konfiguriert werden.

=== Zusätzliche Konfigurationsmöglichkeiten ===
{| class="wikitable"
|+
!Name
!Wert
|-
|bsgTranslateTransferUsePipeline
|
# Wenn diese Option aktiviert ist, wird die neue, platzhalterbasierte Übersetzungspipeline anstelle der bisherigen Methode <code>ignore_tags</code> verwendet. <br />'''Standardeinstellung:true'''. <br />Die bisherige Pipeline ist veraltet und wird zukünftig entfernt.
# Setzen Sie die Option auf <code>false</code>, 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.
|}

Handbuch:Erweiterung/BlueSpiceTranslationTransfer

2026-06-23T09:20:22Z

Margit.link-rodrigue:

Der Übersetzungsmechanismus in einer Wiki-Farm wird über die Erweiterung '''BlueSpiceTranslationTransfer''' gesteuert.{{DISPLAYTITLE:Übersetzungen in der Wiki farm (TranslationTransfer)}}
{{Textbox|boxtype=important|header=DeepL API-Schlüssel erforderlich|text=Diese Funktion benötigt einen gültigen DeepL API-Schlüssel. Dieser wird nicht von BlueSpice bereitgestellt. Der Schlüssel wird in der [[Handbuch:Erweiterung/BlueSpiceConfigManager#DeepL_API|Konfigurationsverwaltung des Quellwikis]] angegeben.|icon=yes}}

== 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.

=== Anlegen der Zielwikis ===
Sprachwikis werden immer mit ihrem zweistelligen [https://de.wikipedia.org/wiki/Liste_der_ISO-639-Sprachcodes ISO 639-1 Sprachkürzel] angelegt (zum Beispiel <code>EN</code> oder <code>en</code> für die englischsprachige Instanz, <code>FR</code> oder <code>fr</code> für die französische). Bei der Übersetzung können alle Sprachinstanzen angelegt werden, die vom DeepL Übersetzungsdienst unterstützt werden.

Dies bedeutet auch, dass eine Wiki-Instanz mit dem Namen <code>IT</code> 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. <code>IT-Wiki</code>).

=== Übereinstimmung von Pfad und Inhaltssprache ===
{{Textbox|boxtype=important|header=Richtige Sprache setzen!|text=Beim Anlegen einer Wiki-Instanz müssen Sie darauf achten, dass sowohl der Pfad als auch die Inhaltssprache dem ISO-Sprachkürzel entsprechen. Ansonsten wird die Instanz nicht als Sprachwiki erkannt. Der Seitenname kann frei gewählt werden, es bietet sich jedoch an, auch diesen konsequent mit dem Sprachkürzel anzulegen. Eine nachträgliche Umkonfiguration von Wikis, die bereits mit Inhalten gefüllt sind, kann schwierig sein, da einige Bezeichnungen sprachspezifisch sind (z.B. die Syntax von Bildattributen).|icon=yes}}[[Datei:BlueSpiceTranslationTransfer - neue Instanz anlegen.png|zentriert|mini|alternativtext=Dialogfenster zum Erstellen einer englischen Sprachinstanz in der Wikifarm|450x450px|Dialogfenster zum Erstellen einer neuen Sprachinstanz mit Seitennamen (1), Pfad (2) und übereinstimmender Inhaltssprache (3) in einem deutschen Stammwiki.]]
Die Beziehung zwischen den Instanzen einer Wiki-Farm mit Bezug auf Übersetzung sieht also verbildlicht so aus:

<drawio filename="TranslationTransfer_Instanzen" alt="">

</drawio>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:

# '''Klicken''' Sie auf der Quellseite auf den ''Übersetzen (Translate)''-Link in der Werkzeugleiste. Es öffnet sich ein Dialog.[[Datei:Extension BlueSpiceTranslationTransfer 1743770053694.png|alternativtext=Werkzeugleiste mit hervorgehobenem "Translate"-Link|zentriert|mini|206x206px|Übersetzen (Translate)-Link]]
# '''Wählen''' Sie die gewünschte Zielsprache aus.[[Datei:Extension BlueSpiceTranslationTransfer 1743770108045.png|alternativtext=Dialogfenster zur Auswahl aus verschiedenen Zielsprachen mit "Deutsch" ausgewählt|zentriert|mini|250x250px|Zielsprache auswählen]]
# '''Klicken''' Sie ''Übersetzen (Translate)'', um die Übersetzung zu starten.
# '''Ü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.[[Datei:Extension BlueSpiceTranslationTransfer 1743770150061.png|alternativtext=Dialogfenster zur Eingabe des Zielseitennamens|zentriert|mini|400x400px|Überprüfen Sie den gewünschten Zielseitennamen]]
# '''Klicken''' Sie erneut ''Übersetzen (Translate)'', um den Seitennamen zu speichern. Die Übersetzungsvorschau wird angezeigt.[[Datei:TranslationTransfer preview.png|alternativtext=Vorschaufenster mit übersetztem Seiteninhalt|zentriert|mini|400x400px|Übersetzungsvorschau]]
# '''Klicken''' Sie ''Speichern (Save)'', um die übersetzte Seite im Zielwiki zu speichern. Ein Bestätigungsfenster zeigt das Ergebnis des Transfers.[[Datei:TranslationTransfer confirmation.png|alternativtext=Bestätigungsdialog mit Informationen zu einer übertragenen eingebetteten Vorlage.|zentriert|mini|350x350px|Übersetzungsbestätigung]]
# '''Klicken''' Sie ''Fertig (Done)''. Sie können nun direkt zur Seite im Ziel-Wiki gelangen. Die Originalsprachenseite zeigt nun einen Sprachwechsler im Titelbereich an.[[Datei:Extension BlueSpiceTranslationTransfer 1743769862375.png|alternativtext=Sprachauswahl mit der Option "Deutsch".|zentriert|mini|200x200px|Sprachwechsler]]

== Nachfolgende Übersetzungen ==
Wenn eine Seite bereits im Ziel-Wiki existiert, werden eingebettete Ressourcen wie Vorlagen nicht erneut dorthin übertragen. Vorlagen werden in jedem Sprach-Wiki separat verwaltet, da der Übersetzungsdienst nicht feststellen kann, welche Vorlagenelemente übersetzt werden müssen. Nach Abschluss der Übersetzung zeigt das Wiki ein Bestätigungsfenster an, in dem alle eingebetteten Ressourcen aufgelistet sind, die nicht in das Ziel-Wiki übertragen wurden.
[[Datei:TranslationTransfer embedded resources.png|alternativtext=Dialogfenster, das anzeigt, dass eine Vorlage nicht in das Ziel-Wiki kopiert wurde.|zentriert|mini|350x350px|Hinweis zu eingebetteten Ressourcen]]

== 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:Erweiterung/MergeArticles|Handbuch-Seite der Erweiterung MergeArticles]] verfügbar.

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

* '''Seitentext'''
* '''Seitentitel''' (Anpassung des vorgeschlagenen Titels ist bei der Erstübersetzung möglich)
* '''Anzeigetitel'''
* '''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:''' Wiki-Links werden übersetzt. Falls eine Seite im Zielwiki nicht existiert, wird sie entsprechend als "Gewünschte Seite" (Redlink) angezeigt .
* '''Eingebundene Dateien (png, jpg, gif,...)''' werden ins Zielwiki übertragen:
** Der Dateiname wird beibehalten. Bei Text-Links wird die Linkbezeichnung übersetzt.
** Die Beschreibung und der Alternativtext von eingebetteten Dateien werden übersetzt.
** Die Übertragung von auf Dateien kann manuell unterdrückt werden ([[Handbuch:Erweiterung/BlueSpiceTranslationTransfer#Dateien ausschlie.C3.9Fen|siehe Dateien ausschließen]]).
* '''Dateianhänge:''' Dateianhänge werden wie alle Dateien ins Zielwiki übertragen. Die Linkbezeichnung wird übersetzt.
* '''Medien (pdf, docx, xlsx,...):''' Die Linkbeschreibung wird übersetzt und das Originaldokument wird in das Zielwiki kopiert.
* '''Galerien:''' Wenn ein Galerie-Droplet auf einer Seite eingefügt wird, werden die Dateinamen nicht übersetzt und die Galerie wird korrekt im Zielwiki angezeigt. Die Bildunterschriften werden übersetzt.
* '''Vorlagen:''' Vorlagen werden mit dem Original-Seitennamen übertragen, falls sie im Ziel-Wiki noch nicht vorhanden sind. Eine Übersetzung der Inhalte findet jedoch nicht statt. Die Vorlagen werden manuell in den jeweiligen Sprachversionen gepflegt. Es können jedoch auf dem Server Vorlagenparameter konfiguriert werden, die übersetzt werden sollen.
* '''Magische Wörter''' werden in ihre kanonische Bezeichnung (EN) übersetzt.
{{Textbox|boxtype=note|header=Hinweis:|text=Einschränkung in früheren BlueSpice-Versionen: Wenn eine Seite zu groß ist, kann die DeepL API sie nicht übersetzen. Die beste Möglichkeit ist, die Seite in kleinere Unterseiten aufzuteilen oder auf die aktuellste BlueSpice-Version zu wechseln.|icon=yes}}

== Nicht-übersetzte oder nicht-übertragene Elemente ==
Folgende Elemente werden für die Übersetzung nichtg berücksichtigt:

* '''Bereits im Ziel-Wiki vorhandene Vorlagen:''' Vorlagen werden im Ziel-Wiki nicht überschrieben, wenn sie dort bereits vorhanden sind.

* '''Vorlageninhalte:''' Vorlagen werden bei der Übersetzung in das Zielwiki übertragen, eine Übersetzung der Inhalte findet jedoch nicht statt.
* '''Formulare für Vorlagen ([[Referenz:Page Forms|Page Forms]]):''' Formulare müssen manuell in die Zielwikis übertragen werden und dort der jeweiligen Sprache angepasst werden.
* '''Transkludierte Seiten:''' Transkludierte Seiten werden derzeit ohne Übersetzung in das Zielwiki übertragen.
* '''Codeblöcke:''' werden nicht übersetzt.

== Inhalte von der Übersetzung ausschließen ==

=== Text ausschließen{{Bsvs|bsvFrom=5.2.2}} ===
Bevor Sie den Text schreiben:

# '''Öffnen''' Sie das ''Menü Einfügen (+)'' in der Editor-Symbolleiste.

# '''Klicken''' Sie auf ''Von der Übersetzung ausschließen''.

# '''Fügen''' Sie den Text hinzu, den Sie ausschließen möchten.

# '''Klicken''' Sie auf ''Einfügen''.

Wenn Ihr Text bereits auf der Seite vorhanden ist, müssen Sie in den Quelltextbearbeitungsmodus wechseln und das Tag „ignore“ manuell einfügen. Dieses Tag hat einen Start- und einen End-Tag:<syntaxhighlight lang="text">
<translation:ignore>Text hier</translation:ignore>

</syntaxhighlight>

=== Dateien 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:

# '''Fügen''' Sie den Umschalter <code><nowiki>__BS_NO_AUTOMATIC_DOCUMENT_TRANSLATION__</nowiki></code> im Quelltext der zu übersetzenden Seite '''ein'''.
# '''Übersetzen''' Sie die Seite in die Zielsprache. In der Vorschau werden die Dateien des Quellwikis noch angezeigt. Sie werden allerdings nicht mit übertragen.
# '''Ü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.

Hinweis: Falls die Datei schon auf dem Zielwiki existiert, wird die Datei angezeigt.

== Übersetzungsübersicht ==
Eine Übersicht über alle Übersetzungen ist unter <code>Spezial:TranslationsOverview</code> im Quellwiki verfügbar.
[[Datei:Handbuch:Erweiterung BlueSpiceTranslationTransfer 1743771129964.png|zentriert|mini|Übersetzungsübersicht|600x600px|alternativtext=Übersetzungsübersichtsseite mit drei Einträgen]]
== Titelverzeichnis ==
Das Wörterbuch mit allen Seitentiteln und Verknüpfungen kann unter <code>Spezial:TranslationDictionary</code> 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.
[[Datei:Handbuch:Erweiterung BlueSpiceTranslationTransfer 1743169370583.png|zentriert|mini|Übersetzungs-Wörterbuch|600x600px]]

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 <code>Spezial:Übersetzungsglossar</code> 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.[[Datei:Handbuch:Erweiterung BlueSpiceTranslationTransfer 1743169204822.png|zentriert|mini|Übersetzungs-Glossar|alternativtext=Spezialseite Übersetzungsglossar mit einem Eintrag|650x650px]]

Nicht alle Übersetzungssprachen unterstützen die Glossarfunktion ([https://developers.deepl.com/docs/api-reference/glossaries#list-supported-glossary-language-pairs siehe DeepL Dokumentation]).

Bitte beachten Sie die folgenden Empfehlungen zur Definition von Glossarbegriffen (bereitgestellt vom DeepL-Dienst):

* Wir empfehlen grundsätzlich die idiomatische Groß- und Kleinschreibung beim Hinzufügen eines Glossareintrags. Bitte verwenden Sie Groß- und Kleinschreibung, wenn dies in der jeweiligen Sprache angebracht ist.
* Da Substantive im Englischen generell klein geschrieben werden, empfehlen wir dringend die Verwendung des Glossarpaars „cat – Katze“. Andernfalls erkennt die KI „Cat“ (mit Großbuchstaben) als Eigennamen.

'''Best Practices für Glossare:'''

* Kein Plural
* Kein Präteritum
* Verwenden Sie idiomatische Groß- und Kleinschreibung, wenn dies in der jeweiligen Sprache angebracht ist.
* Die Verwendung von vorangestellten Artikeln bei Substantiven ist irrelevant und kann ignoriert werden.
* Verwenden Sie Infinitivmarkierungen bei Verben, wie z. B. „to“ im Englischen, um Missverständnisse zu vermeiden (Beispiel: to rain → regnen; rain → Regen).

== Konfiguration ==

===Zuordnung der Namensräume===
{{#dpl:title=Handbuch:Erweiterung/BlueSpiceConfigManager|include=##.*BlueSpiceTranslationTransfer.*}}

=== Konfiguration DeepL API ===
{{#dpl:title=Handbuch:Erweiterung/BlueSpiceConfigManager|include=#DeepL API}}

== Fehlermeldungen ==
Es kann zu Übersetzungskonflikten zwischen Quell- und Zielwiki kommen, wenn Seiten ohne Weiterleitung verschoben werden. Beispiel:

# '''Quellseite wurde verschoben:''' Eine Seite wurde in einem englischsprachigen Quellwiki ohne Weiterleitung von <code>A new page</code> nach <code>
A new page 1</code> verschoben. Die Seite wurde ursprünglich als <code>Eine neue Seite</code> ins deutsche Wiki übersetzt. Wenn der Benutzer <code>A new page 1</code> nach <code>Eine neue Seite</code> übersetzen möchte, zeigt das Wiki eine Fehlermeldung an, dass die vorgeschlagene Zielseite bereits existiert:[[File:translationtransfer error1.png|alt=Seite kann nicht in den ausgewählten Seitentitel übersetzt werden, da die Zielseite bereits existiert|center|thumb|450x450px|Fehlermeldung bei der Übersetzungsübertragung]]'''Lösung:''' Es ist notwendig, die ursprüngliche Zuordnung zwischen den beiden Seiten <code>A new page</code> und <code>Eine neue Seite</code> aus dem [[Manual:Extension/BlueSpiceTranslationTransfer#Translation dictionary|Übersetzungswörterbuch]] zu löschen. Danach ist es möglich, das Übersetzungsziel für <code>A new page 1</code> problemlos auf <code>Eine neue Seite</code> zu setzen, ohne eine Fehlermeldung zu erhalten. Die Zielseite <code>Eine neue Seite</code> behält ihren Versionsverlauf.
== 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 [[Handbuch:Erweiterung/AdhocTranslation|Ad-hoc Übersetzung]] angezeigt. Diese Übersetzung ist nur solange gültig, bis die Seite neu geladen wird.

{{Box Links|Thema1=[[Handbuch:Erweiterung/ContentTransfer]]|Thema2=[[Handbuch:Erweiterung/MergeArticles]]|Thema3=[[Handbuch:Erweiterung/AdhocTranslation]]}}

{{translation}}
[[Kategorie:BlueSpice farm]]

Handbuch:Erweiterung/BlueSpiceTranslationTransfer

2026-06-23T07:42:11Z

Margit.link-rodrigue:

Der Übersetzungsmechanismus in einer Wiki-Farm wird über die Erweiterung '''BlueSpiceTranslationTransfer''' gesteuert.{{DISPLAYTITLE:Übersetzungen in der Wiki farm (TranslationTransfer)}}
{{Textbox|boxtype=important|header=DeepL API-Schlüssel erforderlich|text=Diese Funktion benötigt einen gültigen DeepL API-Schlüssel. Dieser wird nicht von BlueSpice bereitgestellt. Der Schlüssel wird in der [[Handbuch:Erweiterung/BlueSpiceConfigManager#DeepL_API|Konfigurationsverwaltung des Quellwikis]] angegeben.|icon=yes}}

== 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.

=== Anlegen der Zielwikis ===
Sprachwikis werden immer mit ihrem zweistelligen [https://de.wikipedia.org/wiki/Liste_der_ISO-639-Sprachcodes ISO 639-1 Sprachkürzel] angelegt (zum Beispiel <code>EN</code> oder <code>en</code> für die englischsprachige Instanz, <code>FR</code> oder <code>fr</code> für die französische). Bei der Übersetzung können alle Sprachinstanzen angelegt werden, die vom DeepL Übersetzungsdienst unterstützt werden.

Dies bedeutet auch, dass eine Wiki-Instanz mit dem Namen <code>IT</code> 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. <code>IT-Wiki</code>).

=== Übereinstimmung von Pfad und Inhaltssprache ===
{{Textbox|boxtype=important|header=Richtige Sprache setzen!|text=Beim Anlegen einer Wiki-Instanz müssen Sie darauf achten, dass sowohl der Pfad als auch die Inhaltssprache dem ISO-Sprachkürzel entsprechen. Ansonsten wird die Instanz nicht als Sprachwiki erkannt. Der Seitenname kann frei gewählt werden, es bietet sich jedoch an, auch diesen konsequent mit dem Sprachkürzel anzulegen. Eine nachträgliche Umkonfiguration von Wikis, die bereits mit Inhalten gefüllt sind, kann schwierig sein, da einige Bezeichnungen sprachspezifisch sind (z.B. die Syntax von Bildattributen).|icon=yes}}[[Datei:BlueSpiceTranslationTransfer - neue Instanz anlegen.png|zentriert|mini|alternativtext=Dialogfenster zum Erstellen einer englischen Sprachinstanz in der Wikifarm|450x450px|Dialogfenster zum Erstellen einer neuen Sprachinstanz mit Seitennamen (1), Pfad (2) und übereinstimmender Inhaltssprache (3) in einem deutschen Stammwiki.]]
Die Beziehung zwischen den Instanzen einer Wiki-Farm mit Bezug auf Übersetzung sieht also verbildlicht so aus:

<drawio filename="TranslationTransfer_Instanzen" alt="">

</drawio>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:

# '''Klicken''' Sie auf der Quellseite auf den ''Übersetzen (Translate)''-Link in der Werkzeugleiste. Es öffnet sich ein Dialog.[[Datei:Extension BlueSpiceTranslationTransfer 1743770053694.png|alternativtext=Werkzeugleiste mit hervorgehobenem "Translate"-Link|zentriert|mini|206x206px|Übersetzen (Translate)-Link]]
# '''Wählen''' Sie die gewünschte Zielsprache aus.[[Datei:Extension BlueSpiceTranslationTransfer 1743770108045.png|alternativtext=Dialogfenster zur Auswahl aus verschiedenen Zielsprachen mit "Deutsch" ausgewählt|zentriert|mini|250x250px|Zielsprache auswählen]]
# '''Klicken''' Sie ''Übersetzen (Translate)'', um die Übersetzung zu starten.
# '''Ü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.[[Datei:Extension BlueSpiceTranslationTransfer 1743770150061.png|alternativtext=Dialogfenster zur Eingabe des Zielseitennamens|zentriert|mini|400x400px|Überprüfen Sie den gewünschten Zielseitennamen]]
# '''Klicken''' Sie erneut ''Übersetzen (Translate)'', um den Seitennamen zu speichern. Die Übersetzungsvorschau wird angezeigt.[[Datei:TranslationTransfer preview.png|alternativtext=Vorschaufenster mit übersetztem Seiteninhalt|zentriert|mini|400x400px|Übersetzungsvorschau]]
# '''Klicken''' Sie ''Speichern (Save)'', um die übersetzte Seite im Zielwiki zu speichern. Ein Bestätigungsfenster zeigt das Ergebnis des Transfers.[[Datei:TranslationTransfer confirmation.png|alternativtext=Bestätigungsdialog mit Informationen zu einer übertragenen eingebetteten Vorlage.|zentriert|mini|350x350px|Übersetzungsbestätigung]]
# '''Klicken''' Sie ''Fertig (Done)''. Sie können nun direkt zur Seite im Ziel-Wiki gelangen. Die Originalsprachenseite zeigt nun einen Sprachwechsler im Titelbereich an.[[Datei:Extension BlueSpiceTranslationTransfer 1743769862375.png|alternativtext=Sprachauswahl mit der Option "Deutsch".|zentriert|mini|200x200px|Sprachwechsler]]

== Nachfolgende Übersetzungen ==
Wenn eine Seite bereits im Ziel-Wiki existiert, werden eingebettete Ressourcen wie Vorlagen nicht erneut dorthin übertragen. Vorlagen werden in jedem Sprach-Wiki separat verwaltet, da der Übersetzungsdienst nicht feststellen kann, welche Vorlagenelemente übersetzt werden müssen. Nach Abschluss der Übersetzung zeigt das Wiki ein Bestätigungsfenster an, in dem alle eingebetteten Ressourcen aufgelistet sind, die nicht in das Ziel-Wiki übertragen wurden.
[[Datei:TranslationTransfer embedded resources.png|alternativtext=Dialogfenster, das anzeigt, dass eine Vorlage nicht in das Ziel-Wiki kopiert wurde.|zentriert|mini|350x350px|Hinweis zu eingebetteten Ressourcen]]

== 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:Erweiterung/MergeArticles|Handbuch-Seite der Erweiterung MergeArticles]] verfügbar.

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

* '''Seitentext'''
* '''Seitentitel''' (Anpassung des vorgeschlagenen Titels ist bei der Erstübersetzung möglich)
* '''Anzeigetitel'''
* '''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:''' Wiki-Links werden übersetzt. Falls eine Seite im Zielwiki nicht existiert, wird sie entsprechend als "Gewünschte Seite" (Redlink) angezeigt .
* '''Eingebundene Dateien (png, jpg, gif,...)''' werden ins Zielwiki übertragen:
** Der Dateiname wird beibehalten. Bei Text-Links wird die Linkbezeichnung übersetzt.
** Die Beschreibung und der Alternativtext von eingebetteten Dateien werden übersetzt.
** Die Übertragung von auf Dateien kann manuell unterdrückt werden ([[Handbuch:Erweiterung/BlueSpiceTranslationTransfer#Dateien ausschlie.C3.9Fen|siehe Dateien ausschließen]]).
* '''Dateianhänge:''' Dateianhänge werden wie alle Dateien ins Zielwiki übertragen. Die Linkbezeichnung wird übersetzt.
* '''Medien (pdf, docx, xlsx,...):''' Die Linkbeschreibung wird übersetzt und das Originaldokument wird in das Zielwiki kopiert.
* '''Galerien:''' Wenn ein Galerie-Droplet auf einer Seite eingefügt wird, werden die Dateinamen nicht übersetzt und die Galerie wird korrekt im Zielwiki angezeigt. Die Bildunterschriften werden übersetzt.
* '''Vorlagen:''' Vorlagen werden mit dem Original-Seitennamen übertragen, falls sie im Ziel-Wiki nicht vorhanden sind.
* '''Magische Wörter''' werden in ihre kanonische Bezeichnung (EN) übersetzt.
{{Textbox|boxtype=note|header=Hinweis:|text=Einschränkung in früheren BlueSpice-Versionen: Wenn eine Seite zu groß ist, kann die DeepL API sie nicht übersetzen. Die beste Möglichkeit ist, die Seite in kleinere Unterseiten aufzuteilen oder auf die aktuellste BlueSpice-Version zu wechseln.|icon=yes}}

== Nicht-übersetzte oder nicht-übertragene Elemente ==
Folgende Elemente werden für die Übersetzung nichtg berücksichtigt:

* '''Bereits im Ziel-Wiki vorhandene Vorlagen:''' Vorlagen werden im Ziel-Wiki nicht überschrieben, wenn sie dort bereits vorhanden sind.

* '''Vorlageninhalte:''' Vorlagen werden bei der Übersetzung in das Zielwiki übertragen, eine Übersetzung der Inhalte findet jedoch nicht statt.
* '''Formulare für Vorlagen ([[Referenz:Page Forms|Page Forms]]):''' Formulare müssen manuell in die Zielwikis übertragen werden und dort der jeweiligen Sprache angepasst werden.
* '''Transkludierte Seiten:''' Transkludierte Seiten werden derzeit ohne Übersetzung in das Zielwiki übertragen.
* '''Codeblöcke:''' werden nicht übersetzt.

== Inhalte von der Übersetzung ausschließen ==

=== Text ausschließen{{Bsvs|bsvFrom=5.2.2}} ===
Bevor Sie den Text schreiben:

# '''Öffnen''' Sie das ''Menü Einfügen (+)'' in der Editor-Symbolleiste.

# '''Klicken''' Sie auf ''Von der Übersetzung ausschließen''.

# '''Fügen''' Sie den Text hinzu, den Sie ausschließen möchten.

# '''Klicken''' Sie auf ''Einfügen''.

Wenn Ihr Text bereits auf der Seite vorhanden ist, müssen Sie in den Quelltextbearbeitungsmodus wechseln und das Tag „ignore“ manuell einfügen. Dieses Tag hat einen Start- und einen End-Tag:<syntaxhighlight lang="text">
<translation:ignore>Text hier</translation:ignore>

</syntaxhighlight>

=== Dateien 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:

# '''Fügen''' Sie den Umschalter <code><nowiki>__BS_NO_AUTOMATIC_DOCUMENT_TRANSLATION__</nowiki></code> im Quelltext der zu übersetzenden Seite '''ein'''.
# '''Übersetzen''' Sie die Seite in die Zielsprache. In der Vorschau werden die Dateien des Quellwikis noch angezeigt. Sie werden allerdings nicht mit übertragen.
# '''Ü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.

Hinweis: Falls die Datei schon auf dem Zielwiki existiert, wird die Datei angezeigt.

== Übersetzungsübersicht ==
Eine Übersicht über alle Übersetzungen ist unter <code>Spezial:TranslationsOverview</code> im Quellwiki verfügbar.
[[Datei:Handbuch:Erweiterung BlueSpiceTranslationTransfer 1743771129964.png|zentriert|mini|Übersetzungsübersicht|600x600px|alternativtext=Übersetzungsübersichtsseite mit drei Einträgen]]
== Titelverzeichnis ==
Das Wörterbuch mit allen Seitentiteln und Verknüpfungen kann unter <code>Spezial:TranslationDictionary</code> 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.
[[Datei:Handbuch:Erweiterung BlueSpiceTranslationTransfer 1743169370583.png|zentriert|mini|Übersetzungs-Wörterbuch|600x600px]]

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 <code>Spezial:Übersetzungsglossar</code> 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.[[Datei:Handbuch:Erweiterung BlueSpiceTranslationTransfer 1743169204822.png|zentriert|mini|Übersetzungs-Glossar|alternativtext=Spezialseite Übersetzungsglossar mit einem Eintrag|650x650px]]

Nicht alle Übersetzungssprachen unterstützen die Glossarfunktion ([https://developers.deepl.com/docs/api-reference/glossaries#list-supported-glossary-language-pairs siehe DeepL Dokumentation]).

Bitte beachten Sie die folgenden Empfehlungen zur Definition von Glossarbegriffen (bereitgestellt vom DeepL-Dienst):

* Wir empfehlen grundsätzlich die idiomatische Groß- und Kleinschreibung beim Hinzufügen eines Glossareintrags. Bitte verwenden Sie Groß- und Kleinschreibung, wenn dies in der jeweiligen Sprache angebracht ist.
* Da Substantive im Englischen generell klein geschrieben werden, empfehlen wir dringend die Verwendung des Glossarpaars „cat – Katze“. Andernfalls erkennt die KI „Cat“ (mit Großbuchstaben) als Eigennamen.

'''Best Practices für Glossare:'''

* Kein Plural
* Kein Präteritum
* Verwenden Sie idiomatische Groß- und Kleinschreibung, wenn dies in der jeweiligen Sprache angebracht ist.
* Die Verwendung von vorangestellten Artikeln bei Substantiven ist irrelevant und kann ignoriert werden.
* Verwenden Sie Infinitivmarkierungen bei Verben, wie z. B. „to“ im Englischen, um Missverständnisse zu vermeiden (Beispiel: to rain → regnen; rain → Regen).

== Konfiguration ==

===Zuordnung der Namensräume===
{{#dpl:title=Handbuch:Erweiterung/BlueSpiceConfigManager|include=##.*BlueSpiceTranslationTransfer.*}}

=== Konfiguration DeepL API ===
{{#dpl:title=Handbuch:Erweiterung/BlueSpiceConfigManager|include=#DeepL API}}

== Fehlermeldungen ==
Es kann zu Übersetzungskonflikten zwischen Quell- und Zielwiki kommen, wenn Seiten ohne Weiterleitung verschoben werden. Beispiel:

# '''Quellseite wurde verschoben:''' Eine Seite wurde in einem englischsprachigen Quellwiki ohne Weiterleitung von <code>A new page</code> nach <code>
A new page 1</code> verschoben. Die Seite wurde ursprünglich als <code>Eine neue Seite</code> ins deutsche Wiki übersetzt. Wenn der Benutzer <code>A new page 1</code> nach <code>Eine neue Seite</code> übersetzen möchte, zeigt das Wiki eine Fehlermeldung an, dass die vorgeschlagene Zielseite bereits existiert:[[File:translationtransfer error1.png|alt=Seite kann nicht in den ausgewählten Seitentitel übersetzt werden, da die Zielseite bereits existiert|center|thumb|450x450px|Fehlermeldung bei der Übersetzungsübertragung]]'''Lösung:''' Es ist notwendig, die ursprüngliche Zuordnung zwischen den beiden Seiten <code>A new page</code> und <code>Eine neue Seite</code> aus dem [[Manual:Extension/BlueSpiceTranslationTransfer#Translation dictionary|Übersetzungswörterbuch]] zu löschen. Danach ist es möglich, das Übersetzungsziel für <code>A new page 1</code> problemlos auf <code>Eine neue Seite</code> zu setzen, ohne eine Fehlermeldung zu erhalten. Die Zielseite <code>Eine neue Seite</code> behält ihren Versionsverlauf.
== 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 [[Handbuch:Erweiterung/AdhocTranslation|Ad-hoc Übersetzung]] angezeigt. Diese Übersetzung ist nur solange gültig, bis die Seite neu geladen wird.

{{Box Links|Thema1=[[Handbuch:Erweiterung/ContentTransfer]]|Thema2=[[Handbuch:Erweiterung/MergeArticles]]|Thema3=[[Handbuch:Erweiterung/AdhocTranslation]]}}

{{translation}}
[[Kategorie:BlueSpice farm]]

Handbuch:Erweiterung/BlueSpiceTranslationTransfer

2026-06-23T07:15:38Z

Margit.link-rodrigue:

Der Übersetzungsmechanismus in einer Wiki-Farm wird über die Erweiterung '''BlueSpiceTranslationTransfer''' gesteuert.{{DISPLAYTITLE:Übersetzungen in der Wiki farm (TranslationTransfer)}}
{{Textbox|boxtype=important|header=DeepL API-Schlüssel erforderlich|text=Diese Funktion benötigt einen gültigen DeepL API-Schlüssel. Dieser wird nicht von BlueSpice bereitgestellt. Der Schlüssel wird in der [[Handbuch:Erweiterung/BlueSpiceConfigManager#DeepL_API|Konfigurationsverwaltung des Quellwikis]] angegeben.|icon=yes}}

== 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.

=== Anlegen der Zielwikis ===
Sprachwikis werden immer mit ihrem zweistelligen [https://de.wikipedia.org/wiki/Liste_der_ISO-639-Sprachcodes ISO 639-1 Sprachkürzel] angelegt (zum Beispiel <code>EN</code> oder <code>en</code> für die englischsprachige Instanz, <code>FR</code> oder <code>fr</code> für die französische). Bei der Übersetzung können alle Sprachinstanzen angelegt werden, die vom DeepL Übersetzungsdienst unterstützt werden.

Dies bedeutet auch, dass eine Wiki-Instanz mit dem Namen <code>IT</code> 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. <code>IT-Wiki</code>).

=== Übereinstimmung von Pfad und Inhaltssprache ===
{{Textbox|boxtype=important|header=Richtige Sprache setzen!|text=Beim Anlegen einer Wiki-Instanz müssen Sie darauf achten, dass sowohl der Pfad als auch die Inhaltssprache dem ISO-Sprachkürzel entsprechen. Ansonsten wird die Instanz nicht als Sprachwiki erkannt. Der Seitenname kann frei gewählt werden, es bietet sich jedoch an, auch diesen konsequent mit dem Sprachkürzel anzulegen. Eine nachträgliche Umkonfiguration von Wikis, die bereits mit Inhalten gefüllt sind, kann schwierig sein, da einige Bezeichnungen sprachspezifisch sind (z.B. die Syntax von Bildattributen).|icon=yes}}[[Datei:BlueSpiceTranslationTransfer - neue Instanz anlegen.png|zentriert|mini|alternativtext=Dialogfenster zum Erstellen einer englischen Sprachinstanz in der Wikifarm|450x450px|Dialogfenster zum Erstellen einer neuen Sprachinstanz mit Seitennamen (1), Pfad (2) und übereinstimmender Inhaltssprache (3) in einem deutschen Stammwiki.]]
Die Beziehung zwischen den Instanzen einer Wiki-Farm mit Bezug auf Übersetzung sieht also verbildlicht so aus:

<drawio filename="TranslationTransfer_Instanzen" alt="">

</drawio>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:

# '''Klicken''' Sie auf der Quellseite auf den ''Übersetzen (Translate)''-Link in der Werkzeugleiste. Es öffnet sich ein Dialog.[[Datei:Extension BlueSpiceTranslationTransfer 1743770053694.png|alternativtext=Werkzeugleiste mit hervorgehobenem "Translate"-Link|zentriert|mini|206x206px|Übersetzen (Translate)-Link]]
# '''Wählen''' Sie die gewünschte Zielsprache aus.[[Datei:Extension BlueSpiceTranslationTransfer 1743770108045.png|alternativtext=Dialogfenster zur Auswahl aus verschiedenen Zielsprachen mit "Deutsch" ausgewählt|zentriert|mini|250x250px|Zielsprache auswählen]]
# '''Klicken''' Sie ''Übersetzen (Translate)'', um die Übersetzung zu starten.
# '''Ü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.[[Datei:Extension BlueSpiceTranslationTransfer 1743770150061.png|alternativtext=Dialogfenster zur Eingabe des Zielseitennamens|zentriert|mini|400x400px|Überprüfen Sie den gewünschten Zielseitennamen]]
# '''Klicken''' Sie erneut ''Übersetzen (Translate)'', um den Seitennamen zu speichern. Die Übersetzungsvorschau wird angezeigt.[[Datei:TranslationTransfer preview.png|alternativtext=Vorschaufenster mit übersetztem Seiteninhalt|zentriert|mini|400x400px|Übersetzungsvorschau]]
# '''Klicken''' Sie ''Speichern (Save)'', um die übersetzte Seite im Zielwiki zu speichern. Ein Bestätigungsfenster zeigt das Ergebnis des Transfers.[[Datei:TranslationTransfer confirmation.png|alternativtext=Bestätigungsdialog mit Informationen zu einer übertragenen eingebetteten Vorlage.|zentriert|mini|350x350px|Übersetzungsbestätigung]]
# '''Klicken''' Sie ''Fertig (Done)''. Sie können nun direkt zur Seite im Ziel-Wiki gelangen. Die Originalsprachenseite zeigt nun einen Sprachwechsler im Titelbereich an.[[Datei:Extension BlueSpiceTranslationTransfer 1743769862375.png|alternativtext=Sprachauswahl mit der Option "Deutsch".|zentriert|mini|200x200px|Sprachwechsler]]

== Nachfolgende Übersetzungen ==
Wenn eine Seite bereits im Ziel-Wiki existiert, werden eingebettete Ressourcen wie Vorlagen nicht erneut dorthin übertragen. Vorlagen werden in jedem Sprach-Wiki separat verwaltet, da der Übersetzungsdienst nicht feststellen kann, welche Vorlagenelemente übersetzt werden müssen. Nach Abschluss der Übersetzung zeigt das Wiki ein Bestätigungsfenster an, in dem alle eingebetteten Ressourcen aufgelistet sind, die nicht in das Ziel-Wiki übertragen wurden.
[[Datei:TranslationTransfer embedded resources.png|alternativtext=Dialogfenster, das anzeigt, dass eine Vorlage nicht in das Ziel-Wiki kopiert wurde.|zentriert|mini|350x350px|Hinweis zu eingebetteten Ressourcen]]

== 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:Erweiterung/MergeArticles|Handbuch-Seite der Erweiterung MergeArticles]] verfügbar.

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

* '''Seitentext'''
* '''Seitentitel''' (Anpassung des vorgeschlagenen Titels ist bei der Erstübersetzung möglich)
* '''Anzeigetitel'''
* '''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:''' Wiki-Links werden übersetzt. Falls eine Seite im Zielwiki nicht existiert, wird sie entsprechend als "Gewünschte Seite" (Redlink) angezeigt .
* '''Eingebundene Dateien (png, jpg, gif,...)''' werden ins Zielwiki übertragen:
** Der Dateiname wird beibehalten. Bei Text-Links wird die Linkbezeichnung übersetzt.
** Die Beschreibung und der Alternativtext von eingebetteten Dateien werden übersetzt.
** Die Übertragung von auf Dateien kann manuell unterdrückt werden ([[Handbuch:Erweiterung/BlueSpiceTranslationTransfer#Dateien ausschlie.C3.9Fen|siehe Dateien ausschließen]]).
* '''Dateianhänge:''' Dateianhänge werden wie alle Dateien ins Zielwiki übertragen.
* '''Medien (pdf, docx, pdf,...):''' Die Linkbeschreibung wird übersetzt und das Originaldokument wird in das Zielwiki kopiert.
* '''Galerien:''' Wenn ein Galerie-Droplet auf einer Seite eingefügt wird, werden die Dateinamen nicht übersetzt und die Galerie wird korrekt im Zielwiki angezeigt. Die Bildunterschriften werden übersetzt.
* '''Vorlagen:''' Vorlagen werden mit dem Original-Seitennamen übertragen, falls sie im Ziel-Wiki nicht vorhanden sind.
* '''Magische Wörter''' werden in ihre kanonische Bezeichnung (EN) übersetzt.
{{Textbox|boxtype=note|header=Hinweis:|text=Einschränkung in früheren BlueSpice-Versionen: Wenn eine Seite zu groß ist, kann die DeepL API sie nicht übersetzen. Die beste Möglichkeit ist, die Seite in kleinere Unterseiten aufzuteilen oder auf die aktuellste BlueSpice-Version zu wechseln.|icon=yes}}

== Nicht-übersetzte oder nicht-übertragene Elemente ==
Folgende Elemente werden für die Übersetzung nichtg berücksichtigt:

* '''Bereits im Ziel-Wiki vorhandene Vorlagen:''' Vorlagen werden im Ziel-Wiki nicht überschrieben, wenn sie dort bereits vorhanden sind.

* '''Vorlageninhalte:''' Vorlagen werden bei der Übersetzung in das Zielwiki übertragen, eine Übersetzung der Inhalte findet jedoch nicht statt.
* '''Formulare für Vorlagen ([[Referenz:Page Forms|Page Forms]]):''' Formulare müssen manuell in die Zielwikis übertragen werden und dort der jeweiligen Sprache angepasst werden.
* '''Transkludierte Seiten:''' Transkludierte Seiten werden derzeit ohne Übersetzung in das Zielwiki übertragen.
* '''Codeblöcke:''' werden nicht übersetzt.

== Inhalte von der Übersetzung ausschließen ==

=== Text ausschließen{{Bsvs|bsvFrom=5.2.2}} ===
Bevor Sie den Text schreiben:

# '''Öffnen''' Sie das ''Menü Einfügen (+)'' in der Editor-Symbolleiste.

# '''Klicken''' Sie auf ''Von der Übersetzung ausschließen''.

# '''Fügen''' Sie den Text hinzu, den Sie ausschließen möchten.

# '''Klicken''' Sie auf ''Einfügen''.

Wenn Ihr Text bereits auf der Seite vorhanden ist, müssen Sie in den Quelltextbearbeitungsmodus wechseln und das Tag „ignore“ manuell einfügen. Dieses Tag hat einen Start- und einen End-Tag:<syntaxhighlight lang="text">
<translation:ignore>Text hier</translation:ignore>

</syntaxhighlight>

=== Dateien 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:

# '''Fügen''' Sie den Umschalter <code><nowiki>__BS_NO_AUTOMATIC_DOCUMENT_TRANSLATION__</nowiki></code> im Quelltext der zu übersetzenden Seite '''ein'''.
# '''Übersetzen''' Sie die Seite in die Zielsprache. In der Vorschau werden die Dateien des Quellwikis noch angezeigt. Sie werden allerdings nicht mit übertragen.
# '''Ü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.

Hinweis: Falls die Datei schon auf dem Zielwiki existiert, wird die Datei angezeigt.

== Übersetzungsübersicht ==
Eine Übersicht über alle Übersetzungen ist unter <code>Spezial:TranslationsOverview</code> im Quellwiki verfügbar.
[[Datei:Handbuch:Erweiterung BlueSpiceTranslationTransfer 1743771129964.png|zentriert|mini|Übersetzungsübersicht|600x600px|alternativtext=Übersetzungsübersichtsseite mit drei Einträgen]]
== Titelverzeichnis ==
Das Wörterbuch mit allen Seitentiteln und Verknüpfungen kann unter <code>Spezial:TranslationDictionary</code> 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.
[[Datei:Handbuch:Erweiterung BlueSpiceTranslationTransfer 1743169370583.png|zentriert|mini|Übersetzungs-Wörterbuch|600x600px]]

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 <code>Spezial:Übersetzungsglossar</code> 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.[[Datei:Handbuch:Erweiterung BlueSpiceTranslationTransfer 1743169204822.png|zentriert|mini|Übersetzungs-Glossar|alternativtext=Spezialseite Übersetzungsglossar mit einem Eintrag|650x650px]]

Nicht alle Übersetzungssprachen unterstützen die Glossarfunktion ([https://developers.deepl.com/docs/api-reference/glossaries#list-supported-glossary-language-pairs siehe DeepL Dokumentation]).

Bitte beachten Sie die folgenden Empfehlungen zur Definition von Glossarbegriffen (bereitgestellt vom DeepL-Dienst):

* Wir empfehlen grundsätzlich die idiomatische Groß- und Kleinschreibung beim Hinzufügen eines Glossareintrags. Bitte verwenden Sie Groß- und Kleinschreibung, wenn dies in der jeweiligen Sprache angebracht ist.
* Da Substantive im Englischen generell klein geschrieben werden, empfehlen wir dringend die Verwendung des Glossarpaars „cat – Katze“. Andernfalls erkennt die KI „Cat“ (mit Großbuchstaben) als Eigennamen.

'''Best Practices für Glossare:'''

* Kein Plural
* Kein Präteritum
* Verwenden Sie idiomatische Groß- und Kleinschreibung, wenn dies in der jeweiligen Sprache angebracht ist.
* Die Verwendung von vorangestellten Artikeln bei Substantiven ist irrelevant und kann ignoriert werden.
* Verwenden Sie Infinitivmarkierungen bei Verben, wie z. B. „to“ im Englischen, um Missverständnisse zu vermeiden (Beispiel: to rain → regnen; rain → Regen).

== Konfiguration ==

===Zuordnung der Namensräume===
{{#dpl:title=Handbuch:Erweiterung/BlueSpiceConfigManager|include=##.*BlueSpiceTranslationTransfer.*}}

=== Konfiguration DeepL API ===
{{#dpl:title=Handbuch:Erweiterung/BlueSpiceConfigManager|include=#DeepL API}}

== Fehlermeldungen ==
Es kann zu Übersetzungskonflikten zwischen Quell- und Zielwiki kommen, wenn Seiten ohne Weiterleitung verschoben werden. Beispiel:

# '''Quellseite wurde verschoben:''' Eine Seite wurde in einem englischsprachigen Quellwiki ohne Weiterleitung von <code>A new page</code> nach <code>
A new page 1</code> verschoben. Die Seite wurde ursprünglich als <code>Eine neue Seite</code> ins deutsche Wiki übersetzt. Wenn der Benutzer <code>A new page 1</code> nach <code>Eine neue Seite</code> übersetzen möchte, zeigt das Wiki eine Fehlermeldung an, dass die vorgeschlagene Zielseite bereits existiert:[[File:translationtransfer error1.png|alt=Seite kann nicht in den ausgewählten Seitentitel übersetzt werden, da die Zielseite bereits existiert|center|thumb|450x450px|Fehlermeldung bei der Übersetzungsübertragung]]'''Lösung:''' Es ist notwendig, die ursprüngliche Zuordnung zwischen den beiden Seiten <code>A new page</code> und <code>Eine neue Seite</code> aus dem [[Manual:Extension/BlueSpiceTranslationTransfer#Translation dictionary|Übersetzungswörterbuch]] zu löschen. Danach ist es möglich, das Übersetzungsziel für <code>A new page 1</code> problemlos auf <code>Eine neue Seite</code> zu setzen, ohne eine Fehlermeldung zu erhalten. Die Zielseite <code>Eine neue Seite</code> behält ihren Versionsverlauf.
== 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 [[Handbuch:Erweiterung/AdhocTranslation|Ad-hoc Übersetzung]] angezeigt. Diese Übersetzung ist nur solange gültig, bis die Seite neu geladen wird.

{{Box Links|Thema1=[[Handbuch:Erweiterung/ContentTransfer]]|Thema2=[[Handbuch:Erweiterung/MergeArticles]]|Thema3=[[Handbuch:Erweiterung/AdhocTranslation]]}}

{{translation}}
[[Kategorie:BlueSpice farm]]

Referenz:BlueSpiceTranslationTransfer

2026-06-23T07:14:03Z

Margit.link-rodrigue:

{{BSExtensionInfo
|status=stable
|developer=HalloWelt
|type=BlueSpice
|edition=BlueSpice farm
|compatible=BlueSpice
|category=Administration
|bsvFrom=5.0
|features=BlueSpiceTranslationTransfer (BSTT) ermöglicht es Nutzern eines Wikis, ihre übersetzten Artikel an ein anderes Wiki zu senden.

{{Textbox|boxtype=important|header=DeepL API-Schlüssel erforderlich|text=Diese Funktion benötigt einen gültigen DeepL API-Schlüssel. Dieser wird nicht von BlueSpice bereitgestellt.|icon=yes}}

=== 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 [[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.
* 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 <code>bs_translationtransfer_translations</code> (kann in der Stammdatei <code>LocalSettings.php</code> oder in einer der <code>settings.d</code>-Dateien angegeben werden, z. B. <code>settings.d/050-BlueSpiceTranslationTransfer</code>
|license=GPL v3 only
}}
===Zertifikate===
Wenn selbstsignierte Zertifikate verwendet werden (und keine ausgehenden Verbindungen erlaubt sind), muss
<syntaxhighlight lang="text">
$GLOBALS['wgWikiFarmConfig_internalServer'] = 'http://wiki-web:9090';
</syntaxhighlight>
in <code>data/bluespice/pre-init-settings.php</code> konfiguriert werden.
==Zusätzliche Konfigurationsmöglichkeiten==
{| class="wikitable"
|+
!Name
!Wert
|-
|bsgTranslateTransferUsePipeline
|
# Wenn diese Option aktiviert ist, wird die neue, platzhalterbasierte Übersetzungspipeline anstelle der bisherigen Methode <code>ignore_tags</code> verwendet. <br />'''Standardeinstellung:true'''. <br />Die bisherige Pipeline ist veraltet und wird zukünftig entfernt.
# Setzen Sie die Option auf <code>false</code>, 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.
|}

Referenz:BlueSpiceTranslationTransfer

2026-06-23T07:09:03Z

Margit.link-rodrigue:

{{BSExtensionInfo
|status=stable
|developer=HalloWelt
|type=BlueSpice
|edition=BlueSpice farm
|compatible=BlueSpice
|category=Administration
|bsvFrom=5.0
|features=BlueSpiceTranslationTransfer (BSTT) ermöglicht es Nutzern eines Wikis, ihre übersetzten Artikel an ein anderes Wiki zu senden.

{{Textbox|boxtype=important|header=DeepL API-Schlüssel erforderlich|text=Diese Funktion benötigt einen gültigen DeepL API-Schlüssel. Dieser wird nicht von BlueSpice bereitgestellt.|icon=yes}}

=== 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 [[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.
* 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 <code>bs_translationtransfer_translations</code> (kann in der Stammdatei <code>LocalSettings.php</code> oder in einer der <code>settings.d</code>-Dateien angegeben werden, z. B. <code>settings.d/050-BlueSpiceTranslationTransfer</code>
|license=GPL v3 only
}}
===Zertifikate===
Wenn selbstsignierte Zertifikate verwendet werden (und keine ausgehenden Verbindungen erlaubt sind), muss
<syntaxhighlight lang="text">
$GLOBALS['wgWikiFarmConfig_internalServer'] = 'http://wiki-web:9090';
</syntaxhighlight>
in <code>data/bluespice/pre-init-settings.php</code> konfiguriert werden.
==Zusätzliche Konfigurationsmöglichkeiten==
{| class="wikitable"
|+
!Name
!Wert
|-
|bsgTranslateTransferUsePipeline
|
# 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.
# Setzen Sie die Option auf <code>false</code>, 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.
|}

Referenz:BlueSpiceTranslationTransfer

2026-06-23T07:07:18Z

Margit.link-rodrigue:

{{BSExtensionInfo
|status=stable
|developer=HalloWelt
|type=BlueSpice
|edition=BlueSpice farm
|compatible=BlueSpice
|category=Administration
|bsvFrom=5.0
|features=BlueSpiceTranslationTransfer (BSTT) ermöglicht es Nutzern eines Wikis, ihre übersetzten Artikel an ein anderes Wiki zu senden.

{{Textbox|boxtype=important|header=DeepL API-Schlüssel erforderlich|text=Diese Funktion benötigt einen gültigen DeepL API-Schlüssel. Dieser wird nicht von BlueSpice bereitgestellt.|icon=yes}}

=== 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 [[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.
* 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 <code>bs_translationtransfer_translations</code> (kann in der Stammdatei <code>LocalSettings.php</code> oder in einer der <code>settings.d</code>-Dateien angegeben werden, z. B. <code>settings.d/050-BlueSpiceTranslationTransfer</code>
|license=GPL v3 only
}}
===Zertifikate===
Wenn selbstsignierte Zertifikate verwendet werden (und keine ausgehenden Verbindungen erlaubt sind), muss
<syntaxhighlight lang="text">
$GLOBALS['wgWikiFarmConfig_internalServer'] = 'http://wiki-web:9090';
</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.
|}

Handbuch:Erweiterung/BlueSpiceTranslationTransfer

2026-06-23T07:04:27Z

Margit.link-rodrigue:

Der Übersetzungsmechanismus in einer Wiki-Farm wird über die Erweiterung '''BlueSpiceTranslationTransfer''' gesteuert.{{DISPLAYTITLE:Übersetzungen in der Wiki farm (TranslationTransfer)}}
{{Textbox|boxtype=important|header=DeepL API-Schlüssel erforderlich|text=Diese Funktion benötigt einen gültigen DeepL API-Schlüssel. Dieser wird nicht von BlueSpice bereitgestellt. Der Schlüssel wird in der [[Handbuch:Erweiterung/BlueSpiceConfigManager#DeepL_API|Konfigurationsverwaltung des Quellwikis]] angegeben.|icon=yes}}

== 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.

=== Anlegen der Zielwikis ===
Sprachwikis werden immer mit ihrem zweistelligen [https://de.wikipedia.org/wiki/Liste_der_ISO-639-Sprachcodes ISO 639-1 Sprachkürzel] angelegt (zum Beispiel <code>EN</code> oder <code>en</code> für die englischsprachige Instanz, <code>FR</code> oder <code>fr</code> für die französische). Bei der Übersetzung können alle Sprachinstanzen angelegt werden, die vom DeepL Übersetzungsdienst unterstützt werden.

Dies bedeutet auch, dass eine Wiki-Instanz mit dem Namen <code>IT</code> 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. <code>IT-Wiki</code>).

=== Übereinstimmung von Pfad und Inhaltssprache ===
{{Textbox|boxtype=important|header=Richtige Sprache setzen!|text=Beim Anlegen einer Wiki-Instanz müssen Sie darauf achten, dass sowohl der Pfad als auch die Inhaltssprache dem ISO-Sprachkürzel entsprechen. Ansonsten wird die Instanz nicht als Sprachwiki erkannt. Der Seitenname kann frei gewählt werden, es bietet sich jedoch an, auch diesen konsequent mit dem Sprachkürzel anzulegen. Eine nachträgliche Umkonfiguration von Wikis, die bereits mit Inhalten gefüllt sind, kann schwierig sein, da einige Bezeichnungen sprachspezifisch sind (z.B. die Syntax von Bildattributen).|icon=yes}}[[Datei:BlueSpiceTranslationTransfer - neue Instanz anlegen.png|zentriert|mini|alternativtext=Dialogfenster zum Erstellen einer englischen Sprachinstanz in der Wikifarm|450x450px|Dialogfenster zum Erstellen einer neuen Sprachinstanz mit Seitennamen (1), Pfad (2) und übereinstimmender Inhaltssprache (3) in einem deutschen Stammwiki.]]
Die Beziehung zwischen den Instanzen einer Wiki-Farm mit Bezug auf Übersetzung sieht also verbildlicht so aus:

<drawio filename="TranslationTransfer_Instanzen" alt="">

</drawio>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:

# '''Klicken''' Sie auf der Quellseite auf den ''Übersetzen (Translate)''-Link in der Werkzeugleiste. Es öffnet sich ein Dialog.[[Datei:Extension BlueSpiceTranslationTransfer 1743770053694.png|alternativtext=Werkzeugleiste mit hervorgehobenem "Translate"-Link|zentriert|mini|206x206px|Übersetzen (Translate)-Link]]
# '''Wählen''' Sie die gewünschte Zielsprache aus.[[Datei:Extension BlueSpiceTranslationTransfer 1743770108045.png|alternativtext=Dialogfenster zur Auswahl aus verschiedenen Zielsprachen mit "Deutsch" ausgewählt|zentriert|mini|250x250px|Zielsprache auswählen]]
# '''Klicken''' Sie ''Übersetzen (Translate)'', um die Übersetzung zu starten.
# '''Ü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.[[Datei:Extension BlueSpiceTranslationTransfer 1743770150061.png|alternativtext=Dialogfenster zur Eingabe des Zielseitennamens|zentriert|mini|400x400px|Überprüfen Sie den gewünschten Zielseitennamen]]
# '''Klicken''' Sie erneut ''Übersetzen (Translate)'', um den Seitennamen zu speichern. Die Übersetzungsvorschau wird angezeigt.[[Datei:TranslationTransfer preview.png|alternativtext=Vorschaufenster mit übersetztem Seiteninhalt|zentriert|mini|400x400px|Übersetzungsvorschau]]
# '''Klicken''' Sie ''Speichern (Save)'', um die übersetzte Seite im Zielwiki zu speichern. Ein Bestätigungsfenster zeigt das Ergebnis des Transfers.[[Datei:TranslationTransfer confirmation.png|alternativtext=Bestätigungsdialog mit Informationen zu einer übertragenen eingebetteten Vorlage.|zentriert|mini|350x350px|Übersetzungsbestätigung]]
# '''Klicken''' Sie ''Fertig (Done)''. Sie können nun direkt zur Seite im Ziel-Wiki gelangen. Die Originalsprachenseite zeigt nun einen Sprachwechsler im Titelbereich an.[[Datei:Extension BlueSpiceTranslationTransfer 1743769862375.png|alternativtext=Sprachauswahl mit der Option "Deutsch".|zentriert|mini|200x200px|Sprachwechsler]]

== Nachfolgende Übersetzungen ==
Wenn eine Seite bereits im Ziel-Wiki existiert, werden eingebettete Ressourcen wie Vorlagen nicht erneut dorthin übertragen. Vorlagen werden in jedem Sprach-Wiki separat verwaltet, da der Übersetzungsdienst nicht feststellen kann, welche Vorlagenelemente übersetzt werden müssen. Nach Abschluss der Übersetzung zeigt das Wiki ein Bestätigungsfenster an, in dem alle eingebetteten Ressourcen aufgelistet sind, die nicht in das Ziel-Wiki übertragen wurden.
[[Datei:TranslationTransfer embedded resources.png|alternativtext=Dialogfenster, das anzeigt, dass eine Vorlage nicht in das Ziel-Wiki kopiert wurde.|zentriert|mini|350x350px|Hinweis zu eingebetteten Ressourcen]]

== 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:Erweiterung/MergeArticles|Handbuch-Seite der Erweiterung MergeArticles]] verfügbar.

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

* '''Seitentext'''
* '''Seitentitel''' (Anpassung des vorgeschlagenen Titels ist bei der Erstübersetzung möglich)
* '''Anzeigetitel'''
* '''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:''' Wiki-Links werden übersetzt. Falls eine Seite im Zielwiki nicht existiert, wird sie entsprechend als "Gewünschte Seite" (Redlink) angezeigt .
* '''Eingebundene Dateien (png, jpg, gif,...)''' werden ins Zielwiki übertragen:
** Der Dateiname wird beibehalten. Bei Text-Links wird die Linkbezeichnung übersetzt.
** Die Beschreibung und der Alternativtext von eingebetteten Dateien werden übersetzt.
** Die Übertragung von auf Dateien kann manuell unterdrückt werden ([[Handbuch:Erweiterung/BlueSpiceTranslationTransfer#Dateien ausschlie.C3.9Fen|siehe Dateien ausschließen]]).
* '''Dateianhänge:''' Dateianhänge werden wie alle Dateien ins Zielwiki übertragen.
* '''Medien (pdf, docx, pdf,...):''' Die Linkbeschreibung wird übersetzt und das Originaldokument wird in das Zielwiki kopiert.
* '''Galerien:''' Wenn ein Galerie-Droplet auf einer Seite eingefügt wird, werden die Dateinamen nicht übersetzt und die Galerie wird korrekt im Zielwiki angezeigt. Die Bildunterschriften werden übersetzt.
* '''Vorlagen:''' Vorlagen werden mit dem Original-Seitennamen übertragen, falls sie im Ziel-Wiki nicht vorhanden sind.
* '''Magische Wörter''' werden in ihre kanonische Bezeichnung (EN) übersetzt.
{{Textbox|boxtype=note|header=Hinweis:|text=Einschränkung in früheren BlueSpice-Versionen: Wenn eine Seite zu groß ist, kann die DeepL API sie nicht übersetzen. Die beste Möglichkeit ist, die Seite in kleinere Unterseiten aufzuteilen oder auf die aktuellste BlueSpice-Version zu wechseln.|icon=yes}}

== Nicht-übersetzte oder nicht-übertragene Elemente ==
Folgende Elemente werden für die Übersetzung nichtg berücksichtigt:

* '''Bereits im Ziel-Wiki vorhandene Vorlagen:''' Vorlagen werden im Ziel-Wiki nicht überschrieben, wenn sie dort bereits vorhanden sind.

* '''Vorlageninhalte:''' Vorlagen werden bei der Übersetzung in das Zielwiki übertragen, eine Übersetzung der Inhalte findet jedoch nicht statt.
* '''Formulare für Vorlagen ([[Referenz:Page Forms|Page Forms]]):''' Formulare müssen manuell in die Zielwikis übertragen werden und dort der jeweiligen Sprache angepasst werden.
* '''Transkludierte Seiten:''' Transkludierte Seiten werden derzeit ohne Übersetzung in das Zielwiki übertragen.
* '''Codeblöcke:''' werden nicht übersetzt.

== Inhalte von der Übersetzung ausschließen ==

=== Text ausschließen{{Bsvs|bsvFrom=5.2.2}} ===
Bevor Sie den Text schreiben:

# '''Öffnen''' Sie das ''Menü Einfügen (+)'' in der Editor-Symbolleiste.

# '''Klicken''' Sie auf ''Von der Übersetzung ausschließen''.

# '''Fügen''' Sie den Text hinzu, den Sie ausschließen möchten.

# '''Klicken''' Sie auf ''Einfügen''.

Wenn Ihr Text bereits auf der Seite vorhanden ist, müssen Sie in den Quelltextbearbeitungsmodus wechseln und das Tag „ignore“ manuell einfügen. Dieses Tag hat einen Start- und einen End-Tag:<syntaxhighlight lang="text">
<translation:ignore>Text hier</translation:ignore>

</syntaxhighlight>

=== Dateien 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:

# '''Fügen''' Sie den Umschalter <code><nowiki>__BS_NO_AUTOMATIC_DOCUMENT_TRANSLATION__</nowiki></code> im Quelltext der zu übersetzenden Seite '''ein'''.
# '''Übersetzen''' Sie die Seite in die Zielsprache. In der Vorschau werden die Dateien des Quellwikis noch angezeigt. Sie werden allerdings nicht mit übertragen.
# '''Ü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.

Hinweis: Falls die Datei schon auf dem Zielwiki existiert, wird die Datei angezeigt.

== Übersetzungsübersicht ==
Eine Übersicht über alle Übersetzungen ist unter <code>Spezial:TranslationsOverview</code> im Quellwiki verfügbar.
[[Datei:Handbuch:Erweiterung BlueSpiceTranslationTransfer 1743771129964.png|zentriert|mini|Übersetzungsübersicht|600x600px|alternativtext=Übersetzungsübersichtsseite mit drei Einträgen]]
== Titelverzeichnis ==
Das Wörterbuch mit allen Seitentiteln und Verknüpfungen kann unter <code>Spezial:TranslationDictionary</code> 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.
[[Datei:Handbuch:Erweiterung BlueSpiceTranslationTransfer 1743169370583.png|zentriert|mini|Übersetzungs-Wörterbuch|600x600px]]

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 <code>Spezial:Übersetzungsglossar</code> 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.[[Datei:Handbuch:Erweiterung BlueSpiceTranslationTransfer 1743169204822.png|zentriert|mini|Übersetzungs-Glossar|alternativtext=Spezialseite Übersetzungsglossar mit einem Eintrag|650x650px]]

Nicht alle Übersetzungssprachen unterstützen die Glossarfunktion ([https://developers.deepl.com/docs/api-reference/glossaries#list-supported-glossary-language-pairs siehe DeepL Dokumentation]).

Bitte beachten Sie die folgenden Empfehlungen zur Definition von Glossarbegriffen (bereitgestellt vom DeepL-Dienst):

* Wir empfehlen grundsätzlich die idiomatische Groß- und Kleinschreibung beim Hinzufügen eines Glossareintrags. Bitte verwenden Sie Groß- und Kleinschreibung, wenn dies in der jeweiligen Sprache angebracht ist.
* Da Substantive im Englischen generell klein geschrieben werden, empfehlen wir dringend die Verwendung des Glossarpaars „cat – Katze“. Andernfalls erkennt die KI „Cat“ (mit Großbuchstaben) als Eigennamen.

'''Best Practices für Glossare:'''

* Kein Plural
* Kein Präteritum
* Verwenden Sie idiomatische Groß- und Kleinschreibung, wenn dies in der jeweiligen Sprache angebracht ist.
* Die Verwendung von vorangestellten Artikeln bei Substantiven ist irrelevant und kann ignoriert werden.
* Verwenden Sie Infinitivmarkierungen bei Verben, wie z. B. „to“ im Englischen, um Missverständnisse zu vermeiden (Beispiel: to rain → regnen; rain → Regen).

== Konfiguration ==

===Zuordnung der Namensräume===
{{#dpl:title=Handbuch:Erweiterung/BlueSpiceConfigManager|include=##.*BlueSpiceTranslationTransfer.*}}

=== Konfiguration DeepL API ===
{{#dpl:title=Handbuch:Erweiterung/BlueSpiceConfigManager|include=#DeepL API}}

== Fehlermeldungen ==
Es kann zu Übersetzungskonflikten zwischen Quell- und Zielwiki kommen, wenn Seiten ohne Weiterleitung verschoben werden. Beispiel:

# '''Quellseite wurde verschoben:''' Eine Seite wurde in einem englischsprachigen Quellwiki ohne Weiterleitung von <code>A new page</code> nach <code>
A new page 1</code> verschoben. Die Seite wurde ursprünglich als <code>Eine neue Seite</code> ins deutsche Wiki übersetzt. Wenn der Benutzer <code>A new page 1</code> nach <code>Eine neue Seite</code> übersetzen möchte, zeigt das Wiki eine Fehlermeldung an, dass die vorgeschlagene Zielseite bereits existiert:[[File:translationtransfer error1.png|alt=Seite kann nicht in den ausgewählten Seitentitel übersetzt werden, da die Zielseite bereits existiert|center|thumb|450x450px|Fehlermeldung bei der Übersetzungsübertragung]]'''Lösung:''' Es ist notwendig, die ursprüngliche Zuordnung zwischen den beiden Seiten <code>A new page</code> und <code>Eine neue Seite</code> aus dem [[Manual:Extension/BlueSpiceTranslationTransfer#Translation dictionary|Übersetzungswörterbuch]] zu löschen. Danach ist es möglich, das Übersetzungsziel für <code>A new page 1</code> problemlos auf <code>Eine neue Seite</code> zu setzen, ohne eine Fehlermeldung zu erhalten. Die Zielseite <code>Eine neue Seite</code> behält ihren Versionsverlauf.

== Konfiguration ==

== 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 [[Handbuch:Erweiterung/AdhocTranslation|Ad-hoc Übersetzung]] angezeigt. Diese Übersetzung ist nur solange gültig, bis die Seite neu geladen wird.

{{Box Links|Thema1=[[Handbuch:Erweiterung/ContentTransfer]]|Thema2=[[Handbuch:Erweiterung/MergeArticles]]|Thema3=[[Handbuch:Erweiterung/AdhocTranslation]]}}

{{translation}}
[[Kategorie:BlueSpice farm]]

Handbuch:Erweiterung/BlueSpiceTranslationTransfer

2026-06-22T09:35:41Z

Margit.link-rodrigue:

Der Übersetzungsmechanismus in einer Wiki-Farm wird über die Erweiterung '''BlueSpiceTranslationTransfer''' gesteuert.{{DISPLAYTITLE:Übersetzungen in der Wiki farm (TranslationTransfer)}}
{{Textbox|boxtype=important|header=DeepL API-Schlüssel erforderlich|text=Diese Funktion benötigt einen gültigen DeepL API-Schlüssel. Dieser wird nicht von BlueSpice bereitgestellt. Der Schlüssel wird in der [[Handbuch:Erweiterung/BlueSpiceConfigManager#DeepL_API|Konfigurationsverwaltung des Quellwikis]] angegeben.|icon=yes}}

== 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.

=== Anlegen der Zielwikis ===
Sprachwikis werden immer mit ihrem zweistelligen [https://de.wikipedia.org/wiki/Liste_der_ISO-639-Sprachcodes ISO 639-1 Sprachkürzel] angelegt (zum Beispiel <code>EN</code> oder <code>en</code> für die englischsprachige Instanz, <code>FR</code> oder <code>fr</code> für die französische). Bei der Übersetzung können alle Sprachinstanzen angelegt werden, die vom DeepL Übersetzungsdienst unterstützt werden.

Dies bedeutet auch, dass eine Wiki-Instanz mit dem Namen <code>IT</code> 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. <code>IT-Wiki</code>).

=== Übereinstimmung von Pfad und Inhaltssprache ===
{{Textbox|boxtype=important|header=Richtige Sprache setzen!|text=Beim Anlegen einer Wiki-Instanz müssen Sie darauf achten, dass sowohl der Pfad als auch die Inhaltssprache dem ISO-Sprachkürzel entsprechen. Ansonsten wird die Instanz nicht als Sprachwiki erkannt. Der Seitenname kann frei gewählt werden, es bietet sich jedoch an, auch diesen konsequent mit dem Sprachkürzel anzulegen. Eine nachträgliche Umkonfiguration von Wikis, die bereits mit Inhalten gefüllt sind, kann schwierig sein, da einige Bezeichnungen sprachspezifisch sind (z.B. die Syntax von Bildattributen).|icon=yes}}[[Datei:BlueSpiceTranslationTransfer - neue Instanz anlegen.png|zentriert|mini|alternativtext=Dialogfenster zum Erstellen einer englischen Sprachinstanz in der Wikifarm|450x450px|Dialogfenster zum Erstellen einer neuen Sprachinstanz mit Seitennamen (1), Pfad (2) und übereinstimmender Inhaltssprache (3) in einem deutschen Stammwiki.]]
Die Beziehung zwischen den Instanzen einer Wiki-Farm mit Bezug auf Übersetzung sieht also verbildlicht so aus:

<drawio filename="TranslationTransfer_Instanzen" alt="">

</drawio>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:

# '''Klicken''' Sie auf der Quellseite auf den ''Übersetzen (Translate)''-Link in der Werkzeugleiste. Es öffnet sich ein Dialog.[[Datei:Extension BlueSpiceTranslationTransfer 1743770053694.png|alternativtext=Werkzeugleiste mit hervorgehobenem "Translate"-Link|zentriert|mini|206x206px|Übersetzen (Translate)-Link]]
# '''Wählen''' Sie die gewünschte Zielsprache aus.[[Datei:Extension BlueSpiceTranslationTransfer 1743770108045.png|alternativtext=Dialogfenster zur Auswahl aus verschiedenen Zielsprachen mit "Deutsch" ausgewählt|zentriert|mini|250x250px|Zielsprache auswählen]]
# '''Klicken''' Sie ''Übersetzen (Translate)'', um die Übersetzung zu starten.
# '''Ü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.[[Datei:Extension BlueSpiceTranslationTransfer 1743770150061.png|alternativtext=Dialogfenster zur Eingabe des Zielseitennamens|zentriert|mini|400x400px|Überprüfen Sie den gewünschten Zielseitennamen]]
# '''Klicken''' Sie erneut ''Übersetzen (Translate)'', um den Seitennamen zu speichern. Die Übersetzungsvorschau wird angezeigt.[[Datei:TranslationTransfer preview.png|alternativtext=Vorschaufenster mit übersetztem Seiteninhalt|zentriert|mini|400x400px|Übersetzungsvorschau]]
# '''Klicken''' Sie ''Speichern (Save)'', um die übersetzte Seite im Zielwiki zu speichern. Ein Bestätigungsfenster zeigt das Ergebnis des Transfers.[[Datei:TranslationTransfer confirmation.png|alternativtext=Bestätigungsdialog mit Informationen zu einer übertragenen eingebetteten Vorlage.|zentriert|mini|350x350px|Übersetzungsbestätigung]]
# '''Klicken''' Sie ''Fertig (Done)''. Sie können nun direkt zur Seite im Ziel-Wiki gelangen. Die Originalsprachenseite zeigt nun einen Sprachwechsler im Titelbereich an.[[Datei:Extension BlueSpiceTranslationTransfer 1743769862375.png|alternativtext=Sprachauswahl mit der Option "Deutsch".|zentriert|mini|200x200px|Sprachwechsler]]

== Nachfolgende Übersetzungen ==
Wenn eine Seite bereits im Ziel-Wiki existiert, werden eingebettete Ressourcen wie Vorlagen nicht erneut dorthin übertragen. Vorlagen werden in jedem Sprach-Wiki separat verwaltet, da der Übersetzungsdienst nicht feststellen kann, welche Vorlagenelemente übersetzt werden müssen. Nach Abschluss der Übersetzung zeigt das Wiki ein Bestätigungsfenster an, in dem alle eingebetteten Ressourcen aufgelistet sind, die nicht in das Ziel-Wiki übertragen wurden.
[[Datei:TranslationTransfer embedded resources.png|alternativtext=Dialogfenster, das anzeigt, dass eine Vorlage nicht in das Ziel-Wiki kopiert wurde.|zentriert|mini|350x350px|Hinweis zu eingebetteten Ressourcen]]

== 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:Erweiterung/MergeArticles|Handbuch-Seite der Erweiterung MergeArticles]] verfügbar.

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

* '''Seitentext'''
* '''Seitentitel''' (Anpassung des Titels ist bei der Erstübersetzung möglich)
* '''Anzeigetitel'''
* '''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:''' Wiki-Links werden übersetzt. Falls eine Seite im Zielwiki nicht existiert, wird sie entsprechend als "Gewünschte Seite" (Redlink) angezeigt .
* '''Eingebundene Dateien (png, jpg, gif,...)''' werden ins Zielwiki übertragen:
** Der Dateiname wird beibehalten
** Die Beschreibung und der Alternativtext von eingebetteten Dateien werden übersetzt
** Die Übertragung von auf Dateien kann manuell unterdrückt werden ([[Handbuch:Erweiterung/BlueSpiceTranslationTransfer#Dateien ausschlie.C3.9Fen|siehe Dateien ausschließen]]).
* '''Dateianhänge:''' Dateien werden wie alle Dateien ins Zielwiki übertragen.
* '''Medien (pdf, docx, pdf,...):''' Die Linkbeschreibung wird übersetzt und das Originaldokument wird in das Zielwiki kopiert.
* '''Galerien:''' Wenn ein Galerie-Droplet auf einer Seite eingefügt wird, werden die Dateinamen nicht übersetzt und die Galerie wird korrekt im Zielwiki angezeigt. Die Bildunterschriften werden übersetzt.
* '''Vorlagen:''' Vorlagen werden mit dem Original-Seitennamen übertragen, falls sie im Ziel-Wiki nicht vorhanden sind.
* '''Magische Wörter''' werden in ihre kanonische Bezeichnung (EN) übersetzt.
{{Textbox|boxtype=note|header=Hinweis:|text=Einschränkung in früheren BlueSpice-Versionen: Wenn eine Seite zu groß ist, kann die DeepL API sie nicht übersetzen. Die beste Möglichkeit ist, die Seite in kleinere Unterseiten aufzuteilen oder auf die aktuellste BlueSpice-Version zu wechseln.|icon=yes}}

== Nicht-übersetzte oder nicht-übertragene Elemente ==
Folgende Elemente werden für die Übersetzung nichtg berücksichtigt:

* '''Bereits im Ziel-Wiki vorhandene Vorlagen:''' Vorlagen werden im Ziel-Wiki nicht überschrieben, wenn sie dort bereits vorhanden sind.

* '''Vorlageninhalte:''' Vorlagen werden bei der Übersetzung in das Zielwiki übertragen, eine Übersetzung der Inhalte findet jedoch nicht statt.
* '''Formulare für Vorlagen ([[Referenz:Page Forms|Page Forms]]):''' Formulare müssen manuell in die Zielwikis übertragen werden und dort der jeweiligen Sprache angepasst werden.
* '''Transkludierte Seiten:''' Transkludierte Seiten werden derzeit ohne Übersetzung in das Zielwiki übertragen.
* '''Codeblöcke:''' werden nicht übersetzt.

== Inhalte von der Übersetzung ausschließen ==

=== Text ausschließen{{Bsvs|bsvFrom=5.2.2}} ===
Bevor Sie den Text schreiben:

# '''Öffnen''' Sie das ''Menü Einfügen (+)'' in der Editor-Symbolleiste.

# '''Klicken''' Sie auf ''Von der Übersetzung ausschließen''.

# '''Fügen''' Sie den Text hinzu, den Sie ausschließen möchten.

# '''Klicken''' Sie auf ''Einfügen''.

Wenn Ihr Text bereits auf der Seite vorhanden ist, müssen Sie in den Quelltextbearbeitungsmodus wechseln und das Tag „ignore“ manuell einfügen. Dieses Tag hat einen Start- und einen End-Tag:<syntaxhighlight lang="text">
<translation:ignore>Text hier</translation:ignore>

</syntaxhighlight>

=== Dateien 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:

# '''Fügen''' Sie den Umschalter <code><nowiki>__BS_NO_AUTOMATIC_DOCUMENT_TRANSLATION__</nowiki></code> im Quelltext der zu übersetzenden Seite '''ein'''.
# '''Übersetzen''' Sie die Seite in die Zielsprache. In der Vorschau werden die Dateien des Quellwikis noch angezeigt. Sie werden allerdings nicht mit übertragen.
# '''Ü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.

Hinweis: Falls die Datei schon auf dem Zielwiki existiert, wird die Datei angezeigt.

== Übersetzungsübersicht ==
Eine Übersicht über alle Übersetzungen ist unter <code>Spezial:TranslationsOverview</code> im Quellwiki verfügbar.
[[Datei:Handbuch:Erweiterung BlueSpiceTranslationTransfer 1743771129964.png|zentriert|mini|Übersetzungsübersicht|600x600px|alternativtext=Übersetzungsübersichtsseite mit drei Einträgen]]
== Titelverzeichnis ==
Das Wörterbuch mit allen Seitentiteln und Verknüpfungen kann unter <code>Spezial:TranslationDictionary</code> 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.
[[Datei:Handbuch:Erweiterung BlueSpiceTranslationTransfer 1743169370583.png|zentriert|mini|Übersetzungs-Wörterbuch|600x600px]]

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 <code>Spezial:Übersetzungsglossar</code> 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.[[Datei:Handbuch:Erweiterung BlueSpiceTranslationTransfer 1743169204822.png|zentriert|mini|Übersetzungs-Glossar|alternativtext=Spezialseite Übersetzungsglossar mit einem Eintrag|650x650px]]

Nicht alle Übersetzungssprachen unterstützen die Glossarfunktion ([https://developers.deepl.com/docs/api-reference/glossaries#list-supported-glossary-language-pairs siehe DeepL Dokumentation]).

Bitte beachten Sie die folgenden Empfehlungen zur Definition von Glossarbegriffen (bereitgestellt vom DeepL-Dienst):

* Wir empfehlen grundsätzlich die idiomatische Groß- und Kleinschreibung beim Hinzufügen eines Glossareintrags. Bitte verwenden Sie Groß- und Kleinschreibung, wenn dies in der jeweiligen Sprache angebracht ist.
* Da Substantive im Englischen generell klein geschrieben werden, empfehlen wir dringend die Verwendung des Glossarpaars „cat – Katze“. Andernfalls erkennt die KI „Cat“ (mit Großbuchstaben) als Eigennamen.

'''Best Practices für Glossare:'''

* Kein Plural
* Kein Präteritum
* Verwenden Sie idiomatische Groß- und Kleinschreibung, wenn dies in der jeweiligen Sprache angebracht ist.
* Die Verwendung von vorangestellten Artikeln bei Substantiven ist irrelevant und kann ignoriert werden.
* Verwenden Sie Infinitivmarkierungen bei Verben, wie z. B. „to“ im Englischen, um Missverständnisse zu vermeiden (Beispiel: to rain → regnen; rain → Regen).

== Konfiguration ==

===Zuordnung der Namensräume===
{{#dpl:title=Handbuch:Erweiterung/BlueSpiceConfigManager|include=##.*BlueSpiceTranslationTransfer.*}}

=== Konfiguration DeepL API ===
{{#dpl:title=Handbuch:Erweiterung/BlueSpiceConfigManager|include=#DeepL API}}

== Fehlermeldungen ==
Es kann zu Übersetzungskonflikten zwischen Quell- und Zielwiki kommen, wenn Seiten ohne Weiterleitung verschoben werden. Beispiel:

# '''Quellseite wurde verschoben:''' Eine Seite wurde in einem englischsprachigen Quellwiki ohne Weiterleitung von <code>A new page</code> nach <code>
A new page 1</code> verschoben. Die Seite wurde ursprünglich als <code>Eine neue Seite</code> ins deutsche Wiki übersetzt. Wenn der Benutzer <code>A new page 1</code> nach <code>Eine neue Seite</code> übersetzen möchte, zeigt das Wiki eine Fehlermeldung an, dass die vorgeschlagene Zielseite bereits existiert:[[File:translationtransfer error1.png|alt=Seite kann nicht in den ausgewählten Seitentitel übersetzt werden, da die Zielseite bereits existiert|center|thumb|450x450px|Fehlermeldung bei der Übersetzungsübertragung]]'''Lösung:''' Es ist notwendig, die ursprüngliche Zuordnung zwischen den beiden Seiten <code>A new page</code> und <code>Eine neue Seite</code> aus dem [[Manual:Extension/BlueSpiceTranslationTransfer#Translation dictionary|Übersetzungswörterbuch]] zu löschen. Danach ist es möglich, das Übersetzungsziel für <code>A new page 1</code> problemlos auf <code>Eine neue Seite</code> zu setzen, ohne eine Fehlermeldung zu erhalten. Die Zielseite <code>Eine neue Seite</code> behält ihren Versionsverlauf.

== 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 [[Handbuch:Erweiterung/AdhocTranslation|Ad-hoc Übersetzung]] angezeigt. Diese Übersetzung ist nur solange gültig, bis die Seite neu geladen wird.

{{Box Links|Thema1=[[Handbuch:Erweiterung/ContentTransfer]]|Thema2=[[Handbuch:Erweiterung/MergeArticles]]|Thema3=[[Handbuch:Erweiterung/AdhocTranslation]]}}

{{translation}}
[[Kategorie:BlueSpice farm]]

Handbuch:Erweiterung/BlueSpiceTranslationTransfer

2026-06-22T09:33:47Z

Margit.link-rodrigue:

Der Übersetzungsmechanismus in einer Wiki-Farm wird über die Erweiterung '''BlueSpiceTranslationTransfer''' gesteuert.{{DISPLAYTITLE:Übersetzungen in der Wiki farm (TranslationTransfer)}}
{{Textbox|boxtype=important|header=DeepL API-Schlüssel erforderlich|text=Diese Funktion benötigt einen gültigen DeepL API-Schlüssel. Dieser wird nicht von BlueSpice bereitgestellt. Der Schlüssel wird in der [[Handbuch:Erweiterung/BlueSpiceConfigManager#DeepL_API|Konfigurationsverwaltung des Quellwikis]] angegeben.|icon=yes}}

== 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.

=== Anlegen der Zielwikis ===
Sprachwikis werden immer mit ihrem zweistelligen [https://de.wikipedia.org/wiki/Liste_der_ISO-639-Sprachcodes ISO 639-1 Sprachkürzel] angelegt (zum Beispiel <code>EN</code> oder <code>en</code> für die englischsprachige Instanz, <code>FR</code> oder <code>fr</code> für die französische). Bei der Übersetzung können alle Sprachinstanzen angelegt werden, die vom DeepL Übersetzungsdienst unterstützt werden.

Dies bedeutet auch, dass eine Wiki-Instanz mit dem Namen <code>IT</code> 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. <code>IT-Wiki</code>).

=== Übereinstimmung von Pfad und Inhaltssprache ===
{{Textbox|boxtype=important|header=Richtige Sprache setzen!|text=Beim Anlegen einer Wiki-Instanz müssen Sie darauf achten, dass sowohl der Pfad als auch die Inhaltssprache dem ISO-Sprachkürzel entsprechen. Ansonsten wird die Instanz nicht als Sprachwiki erkannt. Der Seitenname kann frei gewählt werden, es bietet sich jedoch an, auch diesen konsequent mit dem Sprachkürzel anzulegen. Eine nachträgliche Umkonfiguration von Wikis, die bereits mit Inhalten gefüllt sind, kann schwierig sein, da einige Bezeichnungen sprachspezifisch sind (z.B. die Syntax von Bildattributen).|icon=yes}}[[Datei:BlueSpiceTranslationTransfer - neue Instanz anlegen.png|zentriert|mini|alternativtext=Dialogfenster zum Erstellen einer englischen Sprachinstanz in der Wikifarm|450x450px|Dialogfenster zum Erstellen einer neuen Sprachinstanz mit Seitennamen (1), Pfad (2) und übereinstimmender Inhaltssprache (3) in einem deutschen Stammwiki.]]
Die Beziehung zwischen den Instanzen einer Wiki-Farm mit Bezug auf Übersetzung sieht also verbildlicht so aus:

<drawio filename="TranslationTransfer_Instanzen" alt="">

</drawio>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:

# '''Klicken''' Sie auf der Quellseite auf den ''Übersetzen (Translate)''-Link in der Werkzeugleiste. Es öffnet sich ein Dialog.[[Datei:Extension BlueSpiceTranslationTransfer 1743770053694.png|alternativtext=Werkzeugleiste mit hervorgehobenem "Translate"-Link|zentriert|mini|206x206px|Übersetzen (Translate)-Link]]
# '''Wählen''' Sie die gewünschte Zielsprache aus.[[Datei:Extension BlueSpiceTranslationTransfer 1743770108045.png|alternativtext=Dialogfenster zur Auswahl aus verschiedenen Zielsprachen mit "Deutsch" ausgewählt|zentriert|mini|250x250px|Zielsprache auswählen]]
# '''Klicken''' Sie ''Übersetzen (Translate)'', um die Übersetzung zu starten.
# '''Ü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.[[Datei:Extension BlueSpiceTranslationTransfer 1743770150061.png|alternativtext=Dialogfenster zur Eingabe des Zielseitennamens|zentriert|mini|400x400px|Überprüfen Sie den gewünschten Zielseitennamen]]
# '''Klicken''' Sie erneut ''Übersetzen (Translate)'', um den Seitennamen zu speichern. Die Übersetzungsvorschau wird angezeigt.[[Datei:TranslationTransfer preview.png|alternativtext=Vorschaufenster mit übersetztem Seiteninhalt|zentriert|mini|400x400px|Übersetzungsvorschau]]
# '''Klicken''' Sie ''Speichern (Save)'', um die übersetzte Seite im Zielwiki zu speichern. Ein Bestätigungsfenster zeigt das Ergebnis des Transfers.[[Datei:TranslationTransfer confirmation.png|alternativtext=Bestätigungsdialog mit Informationen zu einer übertragenen eingebetteten Vorlage.|zentriert|mini|350x350px|Übersetzungsbestätigung]]
# '''Klicken''' Sie ''Fertig (Done)''. Sie können nun direkt zur Seite im Ziel-Wiki gelangen. Die Originalsprachenseite zeigt nun einen Sprachwechsler im Titelbereich an.[[Datei:Extension BlueSpiceTranslationTransfer 1743769862375.png|alternativtext=Sprachauswahl mit der Option "Deutsch".|zentriert|mini|200x200px|Sprachwechsler]]

== Nachfolgende Übersetzungen ==
Wenn eine Seite bereits im Ziel-Wiki existiert, werden eingebettete Ressourcen wie Vorlagen nicht erneut dorthin übertragen. Vorlagen werden in jedem Sprach-Wiki separat verwaltet, da der Übersetzungsdienst nicht feststellen kann, welche Vorlagenelemente übersetzt werden müssen. Nach Abschluss der Übersetzung zeigt das Wiki ein Bestätigungsfenster an, in dem alle eingebetteten Ressourcen aufgelistet sind, die nicht in das Ziel-Wiki übertragen wurden.
[[Datei:TranslationTransfer embedded resources.png|alternativtext=Dialogfenster, das anzeigt, dass eine Vorlage nicht in das Ziel-Wiki kopiert wurde.|zentriert|mini|350x350px|Hinweis zu eingebetteten Ressourcen]]

== 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:Erweiterung/MergeArticles|Handbuch-Seite der Erweiterung MergeArticles]] verfügbar.

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

* '''Seitentext'''
* '''Seitentitel''' (Anpassung des Titels ist bei der Erstübersetzung möglich)
* '''Anzeigetitel'''
* '''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:''' Wiki-Links werden übersetzt. Falls eine Seite im Zielwiki nicht existiert, wird sie entsprechend als "Gewünschte Seite" (Redlink) angezeigt .
* '''Eingebundene Dateien (png, jpg, gif,...)''' werden ins Zielwiki übertragen:
** Der Dateiname wird beibehalten
** Die Beschreibung und der Alternativtext von eingebetteten Dateien werden übersetzt
** Die Übertragung von auf Dateien kann manuell unterdrückt werden (siehe Dateien ausschließen).
* '''Dateianhänge:''' Dateien werden wie alle Dateien ins Zielwiki übertragen.
* '''Medien (pdf, docx, pdf,...):''' Die Linkbeschreibung wird übersetzt und das Originaldokument wird in das Zielwiki kopiert.
* '''Galerien:''' Wenn ein Galerie-Droplet auf einer Seite eingefügt wird, werden die Dateinamen nicht übersetzt und die Galerie wird korrekt im Zielwiki angezeigt. Die Bildunterschriften werden übersetzt.
* '''Vorlagen:''' Vorlagen werden mit dem Original-Seitennamen übertragen, falls sie im Ziel-Wiki nicht vorhanden sind.
* '''Magische Wörter''' werden in ihre kanonische Bezeichnung (EN) übersetzt.
{{Textbox|boxtype=note|header=Hinweis:|text=Einschränkung in früheren BlueSpice-Versionen: Wenn eine Seite zu groß ist, kann die DeepL API sie nicht übersetzen. Die beste Möglichkeit ist, die Seite in kleinere Unterseiten aufzuteilen oder auf die aktuellste BlueSpice-Version zu wechseln.|icon=yes}}

== Nicht-übersetzte oder nicht-übertragene Elemente ==
Folgende Elemente werden für die Übersetzung nichtg berücksichtigt:

* '''Bereits im Ziel-Wiki vorhandene Vorlagen:''' Vorlagen werden im Ziel-Wiki nicht überschrieben, wenn sie dort bereits vorhanden sind.

* '''Vorlageninhalte:''' Vorlagen werden bei der Übersetzung in das Zielwiki übertragen, eine Übersetzung der Inhalte findet jedoch nicht statt.
* '''Formulare für Vorlagen ([[Referenz:Page Forms|Page Forms]]):''' Formulare müssen manuell in die Zielwikis übertragen werden und dort der jeweiligen Sprache angepasst werden.
* '''Transkludierte Seiten:''' Transkludierte Seiten werden derzeit ohne Übersetzung in das Zielwiki übertragen.
* '''Codeblöcke:''' werden nicht übersetzt.

== Inhalte von der Übersetzung ausschließen ==

=== Text ausschließen{{Bsvs|bsvFrom=5.2.2}} ===
Bevor Sie den Text schreiben:

# '''Öffnen''' Sie das ''Menü Einfügen (+)'' in der Editor-Symbolleiste.

# '''Klicken''' Sie auf ''Von der Übersetzung ausschließen''.

# '''Fügen''' Sie den Text hinzu, den Sie ausschließen möchten.

# '''Klicken''' Sie auf ''Einfügen''.

Wenn Ihr Text bereits auf der Seite vorhanden ist, müssen Sie in den Quelltextbearbeitungsmodus wechseln und das Tag „ignore“ manuell einfügen. Dieses Tag hat einen Start- und einen End-Tag:<syntaxhighlight lang="text">
<translation:ignore>Text hier</translation:ignore>

</syntaxhighlight>

=== Dateien 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:

# '''Fügen''' Sie das Tag <code><nowiki>__BS_NO_AUTOMATIC_DOCUMENT_TRANSLATION__</nowiki></code> im Quelltext der zu übersetzenden Seite '''ein'''.
# '''Übersetzen''' Sie die Seite in die Zielsprache. In der Vorschau werden die Dateien des Quellwikis noch angezeigt. Sie werden allerdings nicht mit übertragen.
# '''Ü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.

Hinweis: Falls die Datei schon auf dem Zielwiki existiert, wird die Datei angezeigt.

== Übersetzungsübersicht ==
Eine Übersicht über alle Übersetzungen ist unter <code>Spezial:TranslationsOverview</code> im Quellwiki verfügbar.
[[Datei:Handbuch:Erweiterung BlueSpiceTranslationTransfer 1743771129964.png|zentriert|mini|Übersetzungsübersicht|600x600px|alternativtext=Übersetzungsübersichtsseite mit drei Einträgen]]
== Titelverzeichnis ==
Das Wörterbuch mit allen Seitentiteln und Verknüpfungen kann unter <code>Spezial:TranslationDictionary</code> 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.
[[Datei:Handbuch:Erweiterung BlueSpiceTranslationTransfer 1743169370583.png|zentriert|mini|Übersetzungs-Wörterbuch|600x600px]]

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 <code>Spezial:Übersetzungsglossar</code> 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.[[Datei:Handbuch:Erweiterung BlueSpiceTranslationTransfer 1743169204822.png|zentriert|mini|Übersetzungs-Glossar|alternativtext=Spezialseite Übersetzungsglossar mit einem Eintrag|650x650px]]

Nicht alle Übersetzungssprachen unterstützen die Glossarfunktion ([https://developers.deepl.com/docs/api-reference/glossaries#list-supported-glossary-language-pairs siehe DeepL Dokumentation]).

Bitte beachten Sie die folgenden Empfehlungen zur Definition von Glossarbegriffen (bereitgestellt vom DeepL-Dienst):

* Wir empfehlen grundsätzlich die idiomatische Groß- und Kleinschreibung beim Hinzufügen eines Glossareintrags. Bitte verwenden Sie Groß- und Kleinschreibung, wenn dies in der jeweiligen Sprache angebracht ist.
* Da Substantive im Englischen generell klein geschrieben werden, empfehlen wir dringend die Verwendung des Glossarpaars „cat – Katze“. Andernfalls erkennt die KI „Cat“ (mit Großbuchstaben) als Eigennamen.

'''Best Practices für Glossare:'''

* Kein Plural
* Kein Präteritum
* Verwenden Sie idiomatische Groß- und Kleinschreibung, wenn dies in der jeweiligen Sprache angebracht ist.
* Die Verwendung von vorangestellten Artikeln bei Substantiven ist irrelevant und kann ignoriert werden.
* Verwenden Sie Infinitivmarkierungen bei Verben, wie z. B. „to“ im Englischen, um Missverständnisse zu vermeiden (Beispiel: to rain → regnen; rain → Regen).

== Konfiguration ==

===Zuordnung der Namensräume===
{{#dpl:title=Handbuch:Erweiterung/BlueSpiceConfigManager|include=##.*BlueSpiceTranslationTransfer.*}}

=== Konfiguration DeepL API ===
{{#dpl:title=Handbuch:Erweiterung/BlueSpiceConfigManager|include=#DeepL API}}

== Fehlermeldungen ==
Es kann zu Übersetzungskonflikten zwischen Quell- und Zielwiki kommen, wenn Seiten ohne Weiterleitung verschoben werden. Beispiel:

# '''Quellseite wurde verschoben:''' Eine Seite wurde in einem englischsprachigen Quellwiki ohne Weiterleitung von <code>A new page</code> nach <code>
A new page 1</code> verschoben. Die Seite wurde ursprünglich als <code>Eine neue Seite</code> ins deutsche Wiki übersetzt. Wenn der Benutzer <code>A new page 1</code> nach <code>Eine neue Seite</code> übersetzen möchte, zeigt das Wiki eine Fehlermeldung an, dass die vorgeschlagene Zielseite bereits existiert:[[File:translationtransfer error1.png|alt=Seite kann nicht in den ausgewählten Seitentitel übersetzt werden, da die Zielseite bereits existiert|center|thumb|450x450px|Fehlermeldung bei der Übersetzungsübertragung]]'''Lösung:''' Es ist notwendig, die ursprüngliche Zuordnung zwischen den beiden Seiten <code>A new page</code> und <code>Eine neue Seite</code> aus dem [[Manual:Extension/BlueSpiceTranslationTransfer#Translation dictionary|Übersetzungswörterbuch]] zu löschen. Danach ist es möglich, das Übersetzungsziel für <code>A new page 1</code> problemlos auf <code>Eine neue Seite</code> zu setzen, ohne eine Fehlermeldung zu erhalten. Die Zielseite <code>Eine neue Seite</code> behält ihren Versionsverlauf.

== 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 [[Handbuch:Erweiterung/AdhocTranslation|Ad-hoc Übersetzung]] angezeigt. Diese Übersetzung ist nur solange gültig, bis die Seite neu geladen wird.

{{Box Links|Thema1=[[Handbuch:Erweiterung/ContentTransfer]]|Thema2=[[Handbuch:Erweiterung/MergeArticles]]|Thema3=[[Handbuch:Erweiterung/AdhocTranslation]]}}

{{translation}}
[[Kategorie:BlueSpice farm]]

Referenz:StandardDialogs

2026-06-11T13:15:34Z

Margit.link-rodrigue:

{{BSExtensionInfo
|status=stable
|developer=Hallo Welt!
|type=BlueSpice
|edition=BlueSpice free, BlueSpice pro, BlueSpice farm, BlueSpice cloud
|compatible=BlueSpice
|category=Skinning
|features=Diese Erweiterung stellt Dialoge für verschiedene Aktionen bereit, darunter:

* Löschen
* Verschieben
* Schützen
* Aktualisieren
* Neue Seite
* Neue Unterseite
|desc=Bietet Dialogbenutzeroberflächen für allgemeine Seitenaktionen.
|license=GPL v3+
}}

Referenz:StandardDialogs

2026-06-11T13:14:41Z

Margit.link-rodrigue:

{{BSExtensionInfo
|desc=Bietet Dialogbenutzeroberflächen für allgemeine Seitenaktionen.
|status=stable
|developer=Hallo Welt!
|type=BlueSpice
|edition=BlueSpice free, BlueSpice pro, BlueSpice farm, BlueSpice cloud
|compatible=BlueSpice
|category=Skinning
|license=GPL v3+
}}

Referenz:UnifiedTaskOverview

2026-06-11T13:14:21Z

Margit.link-rodrigue:

{{BSExtensionInfo
|desc=Stellt die Spezialseite "Meine Aufgaben" zur Verfügung.
|status=stable
|developer=Hallo Welt!
|type=MediaWiki
|edition=BlueSpice pro, BlueSpice farm, BlueSpice cloud
|compatible=MediaWiki
|category=Personalisierung
|license=GPL v3+
|features=
Die neue Übersichtsseite “Meine Aufgaben” (''Spezial:Meine Aufgaben'') ermöglicht es Benutzern, ihre im Wiki anstehenden Aufgaben einzusehen. Die Spezialseite ist über das Benutzermenü unter ''Benutzerwerkzeuge > Aufgaben'' zu erreichen.

* Derzeit werden [[Referenz:Workflows|Workflow-Aufgaben]] und ausstehende [[Referenz:BlueSpiceReadConfirmation|Lesebestätigungen]] angezeigt.
* Wenn Aufgaben anstehen, wird dies über ein rotes Benachrichtigungs-Icon im Benutzermenü angekündigt.
* Die Aufgaben-Karte führt zur Wikiseite, die mit der Aufgabe verknüpft ist.

[[Datei:meine aufgaben.png|alternativtext=Spezialseite "Meine Aufgaben"|zentriert|mini|650x650px|Spezialseite "Meine Aufgaben"]]
}}

MediaWiki:Common.css

2026-06-10T10:31:06Z

Margit.link-rodrigue:

/* Das folgende CSS wird für alle Benutzeroberflächen geladen. */
/*Sidebar subpagetree */

#sb-pri ul.tree-node-list > li > div, #sb-pri ul.tree-node-list > li > ul.tree-node-list {
margin-left: 0px!important;
border-left: 5px solid transparent;
box-sizing: border-box!important;
}

/*Entry links*/

#sb-pri .list-group-item a {
margin-left: 0px!important;
border-left: 5px solid transparent;
box-sizing: border-box!important;
}

/*Custom formatting for centering footer links*/

#footer ul {
position: relative;
}

li.edit-footerlinks-link {
position: absolute;
top: 2.2em;}

/*Custom formatting for EmbedVideo overlay on dark background image*/
.embedvideo-thumbnail {
position: absolute;
z-index: 1;
top:-10px
}
.embedvideo-overlay {
display: block;
position: absolute;
top: 0;
}
.embedvideo-overlay a {
color:white!important;
font-size:1.1em!important;
}
.embedvideo-loader__title {
white-space: normal;
text-align:center;
padding-top:20px
}
.embedvideo-loader__footer > div {
background-color: rgba(226, 0, 0, .8);
}
.embedvideo-privacyNotice {
height:110%
}
.embedvideo-privacyNotice__continue {
border: none;
padding: 2px 5px;
border-radius:5px;
outline: inherit;
background-color: #36c;
color:white ;
}
.embedvideo-privacyNotice__dismiss {
border: none;
padding: 2px 5px;
border-radius:5px;
background-color:white;
}
.embedvideo-loader__fakeButton {
margin-top:30px;
}

/*WCAG 1.4.3 discernable links*/
.mw-body-content a:not([class*='oo-ui-']),
[class^='mw-content-'] a:not([class*='oo-ui-']) {
text-decoration: underline dotted;
text-underline-offset: 4px;
text-decoration-thickness: 1px;
text-decoration-color: grey
}

/*MW overrides */
.wikitable {
background-color: #fff
}

.wikitable tr th {
background-color: #f1f3f9
}

figure[typeof~='mw:File/Thumb'].mw-halign-center,
figure[typeof~='mw:File/Frame'].mw-halign-center {
margin: 2em auto;
}

.mw-body-content li {
margin-bottom: 0.6em;
}

/*Main Page banner */
#mpbanner {
margin-top: -55px;
}

h1#mpbanner-byline {
font-size: 1.8em;
color: #3e5389;
line-height: 1em;
padding-top: 20px;
}

#mpbanner-title {
font-size: 3.4rem;
color: #4b80eb;
line-height: 1.2em;
font-weight: 900;
letter-spacing: 1px;
display: block
}

#mpbsv {
color: #4666cd
}

/*Main Page general */
.mpbs5 .section-featured h2 {
font-size: 1.2em;
margin: 0 0 1em 0;
border-bottom: none;
color: #555
}

#startpage.mpbs5 .sectionflexcontainer>div h2 {
padding: 20px 15px 5px 15px
}

/*Softwarekatalog*/
table.casablanca.swc tbody tr,
table.casablanca.swc th {
color: #333
}

table.casablanca.swc thead tr,
table.casablanca tbody th.swc {
background: #e9e9ee
}

a.pdfcreator-export {
background: #efefef;
padding: 10px;
border-radius: 6px;
float: right;
font-weight: bold;
}

a.pdfcreator-export:before {
font-family: 'bootstrap-icons';
content: '\F1B9';
vertical-align: -0.3em;
padding-right: 0.5em;
}

/* Hide PDF Exclude Tags*/
.hf-nsheader .pdfcreator-excludestart,
.hf-nsheader .pdfcreator-excludeend,
.hf-nsfooter .pdfcreator-excludestart,
.hf-nsfooter .pdfcreator-excludeend {
display: none;
}

/*Quiz */
/*Quiz*/
.quiz .question {
margin-bottom: 3em;
}

.questionText {
font-weight: 700;
margin-bottom: 1.2em;
}

.question .header {
background: #fff0e1;
padding: 1px 6px;
}

span.questionText {
display: block;
}

.question td {
background: #f6f6f6;
border-bottom: 2px solid #fff;
padding: 8px 6px 6px;
}

.question th {
background: #f6f6f6;
border-bottom: 2px solid #fff;
padding: 8px 6px 6px;
}

.quiz table {
width: 100%;
}

.quizQuestions .question .sign {
width: 26px;
}

.quiz table.settings {
margin-left: 30px !important;
}

.mw-content-ltr .quiz .question .border {
border-width: 0 0 0 12px !important;
}

.quiz .margin.right {
background-color: #8ed27d !important;
}

.quiz .margin.NA {
background-color: #337ecc !important;
}

.quiz .margin.wrong {
background-color: #ff5c64 !important;
}

.quiz .question .border.right {
border-color: #8ed27d !important;
}

.quiz .question .border.NA {
border-color: #337ecc !important;
}

.quiz .question .border.wrong {
border-color: #ff5c64 !important;
}

.quiz .question .check.right {
outline: 3px solid #8ed27d !important;
}

.quiz .question .check.NA {
outline: 3px solid #337ecc !important;
}

.quiz .question .check.wrong {
outline: 3px solid #ff5c64 !important;
}

.quizForm input[value="Submit"] {
background: #36c;
border: none;
color: #FFF;
margin-right: 10px;
margin-left: 30px;
padding: 6px 12px;
}

.quizForm input:hover[value="Submit"] {
background: #2551aa;
}

.quizForm input[value="Reset"] {
background: #a4a4a4;
border: none;
color: #FFF;
margin-right: 10px;
padding: 6px 12px;
}

.quizForm input:hover[value="Reset"] {
background: #858585;
}

.quiz .correction {
background-color: #ffe4c9;
display: block;
font-weight: 700;
margin: 10px 0 30px 28px;
padding: 20px;
}

/** Template downloads **/
.cards {
display: flex;
flex-wrap: wrap;
justify-content: space-between;
gap: 20px
}

.cards>div {
margin-left: 5px;
margin-right: 5px;
flex-basis: 290px;
margin-bottom: 50px;
border-top: 1px solid #f0f0f0;
box-shadow: 0 1px 3px rgba(0, 0, 0, .12), 0 1px 2px rgba(0, 0, 0, .24);
transition: all .3s cubic-bezier(.25, .8, .25, 1);
cursor: pointer;
text-align: center
}

.cards>div:hover {
box-shadow: 0 6px 8px rgba(0, 0, 0, .10), 0 10px 10px rgba(0, 0, 0, .10);
}

.cards a.image img {
max-width: 600px
}

.cards .screenshot {
width: 300px;
height: 200px;
overflow: hidden;
border-top: 14px solid #eee;
border-bottom: 14px solid #eee
}

#content #bodyContent .cards h2 {
margin: 10px;
padding: 0;
font-size: 1.1rem;
font-color: #444;
border: none;
text-align: center
}

.cards h2 .mw-editsection {
display: none
}

.cards .text {
font-size: 0.85rem;
padding: 20px 10px;
text-align: center;
font-weight: bold;
}

#mw-content-text text a:not(.new),
[class^="mw-content-"] .text a:not(.new),
#mw-content-text .text a:link:not(.new),
[class^="mw-content-"] .text a:link:not(.new),
#mw-content-text .text a:not(.new):visited,
[class^="mw-content-"] .text a:not(.new):visited,
#mw-content-text .text a:link:not(.new):visited,
[class^="mw-content-"] .text a:link:not(.new):visited {
color: #444;
}

.cards .emptycard,
.cards>div.emptycard:hover {
border: 0;
box-shadow: none;
}

@media only screen and (max-width: 768px) {
.cards>div {
flex-basis: 98%;
}

.cards .screenshot {
width: auto;
text-align: center
}

}

.getButton {
display: inline-block;
background-color: #4CAF50;
border: none;
color: white;
padding: 8px 20px;
text-align: center;
text-decoration: none;
font-size: 16px;
margin: 0 0 10px 0;
-webkit-transition-duration: 0.4s;
transition-duration: 0.4s;
border-radius: 8px;
}

#mw-content-text .getButton a {
color: #ffffff !important;
}

.getButton:hover {
box-shadow: 0 12px 16px 0 rgba(0, 0, 0, 0.24), 0 17px 50px 0 rgba(0, 0, 0, 0.19);
color: 'f5f5f5';
}

.getButton:active {
position: relative;
top: 1px;
}

.getButton a:before {
font-family: 'fontawesome';
content: '\f019 ';
font-size: 1.3em;
vertical-align: middle;
margin-right: 10px;
}

.cart a:before {
font-family: 'fontawesome';
content: '\f217 ';
}

.downloadarea {
text-align: center;
display: inline-block;
float: right;
margin: 0 0 20px 40px;
padding: 10px;
background: #efefef;
background: linear-gradient(270deg, rgb(240, 240, 240) 0%, rgb(224, 224, 224) 52%, rgb(240, 240, 240) 100%);
}

.downloadarea p {
margin: 0
}

@media only screen and (max-width: 768px) {
.cards>div {
flex-basis: 98%;
}
}

.oo-ui-panelLayout-framed {
border: 0;
}

.oo-ui-tabSelectWidget-framed {
border-bottom: 1px solid #d3d5da;
}

/*404 system message badaccess-groups*/
#system404-error {
text-align: center;
}

#system404-error div.floatnone a.image img {
padding: 0;
margin: 0;
}

#system404-error hr {
margin-top: 0px;
margin-bottom: 2rem;
border: 0;
max-width: 600px;
border-top: 3px dotted #ddd;
}

/*Quick Search */
#bs-extendedsearch-box .bs-extendedsearch-autocomplete-popup {
overflow-y: scroll;
max-height: 750px
}

.bs-extendedsearch-autocomplete-popup .bs-extendedsearch-autocomplete-popup-item {
background: #f1f3f9;
margin: 0 10px 6px 0;
border-radius: 4px;
}

#bs-extendedsearch-box .bs-extendedsearch-autocomplete-popup .bs-extendedsearch-autocomplete-popup-primary .bs-extendedsearch-autocomplete-popup-primary-item:hover {
background: #fff
}

.oo-ui-icon-articleRedirect {
background-size: 80%
}

.bs-extendedsearch-autocomplete-popup-item-header-redirect a {
width: 85% !important;
font-size: 0.9em
}

/* Styles for section cards */
.sectionflex {
display: flex;
flex-wrap: wrap;
justify-content: space-between;
gap: 20px
}

.sectionflex.col1>div {
flex-basis: 100%;
padding: 10px 20px;
}

.sectionflex.col2>div {
flex-basis: 48%;
padding: 10px 20px;
}

.sectionflex.col3>div {
flex-basis: 32%;
padding: 10px 20px;
}

.sectionflex.col4>div {
flex-basis: 23%;
padding: 10px 20px;
}

.sectionflex>div.empty {
border: none;
background: none
}

#mw-content-text .sectionflex>div h2 {
margin: 0 0 1em 0;
font-size: 1.3em
}

#mw-content-text .sectionflex>div h3 {
margin: 0 0 1em;
font-size: 1.2em
}

.sectionflex.frame>div {
border: 1px solid #e7e7e7
}

.sectionflex.background>div {
background: #f1f3f9
}

.sectionflex .ve-ce-branchNode-slug,
.sectionflex span.mw-editsection {
display: none
}

.sectionflex.linked a {
display: block
}

.sectionflex.centered>div {
text-align: center;
}

/*All topics */
/*Themen*/
.sectionflex.themenhd div [class*=" bi-"]::before {
font-size: 1.6em;
vertical-align: middle;
padding: 6px;
border-radius: 50%;
}

.sectionflex.themenhd div [class*=" bi-"]::before {
font-size: 2em;
vertical-align: middle;
background-color: #f1f3f9;
padding: 10px;
}

.sectionflex.themenhd.background div [class*=" bi-"]::before {
font-size: 2em;
vertical-align: middle;
background-color: #fff;
padding: 10px;
}

.themenhd div a {
display: block
}

.themenhd div:hover {
background: rgb(233, 233, 238, 0.5)
}

/* bootstrap icons in blue and big */
.bi-big,
.fa-big {
font-size: 2rem;
color: #2b80ea
}

ul.smw-format.ul-format.alltopics-col {
column-count: 3;
}

@media (max-width: 767px) {

.sectionflex.col2>div,
.sectionflex.col3>div {
flex-basis: 100%;
margin-top: 2em
}
}

/*Referenz Seiten */
.extension-infobox {
width: 25em;
font-size: 90%;
background-color: #f1f3f9;
color: black;
margin-bottom: 0.5em;
margin-left: 1em;
padding: 0.2em;
float: right;
clear: right;
text-align: left;
}

.extension-infobox-header {
text-align: center;
background-color: #2e6096;
padding: 8px;
color: #ffffff;
}

.extension-infobox-headertext {
font-size: larger;
color: #FFFFFF;
}

.extension-infobox-description {
font-weight: normal !important;
text-align: left;
background-color: #f1f3f9;
padding: 20px 10px 20px 10px !important;
}

.extension-infobox-first-row {
vertical-align: top;
padding: 20px 10px 0 10px;
}

.extension-infobox-row {
vertical-align: top;
padding: 0 10px;
}

.extension-infobox-last-row {
vertical-align: top;
padding: 0 10px 20px 10px;
}

.extension-infobox-helppage {
font-weight: normal;
text-align: center;
vertical-align: top;
padding-left: 10px;
padding-top: 10px;
padding-bottom: 10px;
background-color: #eeeeee;
}

.extension-infobox.fullwidth {
width: 100%;
float: none;
font-size: 1em;
margin-left: 0;
}

.extension-infobox.fullwidth th {
text-align: right;
}

.extension-infobox-header,
.extension-infobox-helppage {
text-align: center !important;
font-size: 1.1em
}

.extension-infobox.fullwidth th,
.extension-infobox.fullwidth td {
padding: 8px;
width: 100px;
border: 1px solid #ffffff;
}

.extension-infobox.fullwidth td {
width: 300px;
}

.extension-infobox-helppage {
background-color: #eaecf0;
}

.flexbox {
display: flex;
flex-direction: row;
flex-wrap: wrap;
justify-content: flex-start;
align-items: stretch;
align-content: stretch;
}

#content #bodyContent #importdata h3 {
margin: 1em 0 1.4em;
}

#importdata .flexbox {
justify-content: space-between;
margin-top: 2em;
}

#mw-content-text #importdata .flexbox h3,
[class^="mw-content-"] #importdata .flexbox h3 {
background: #d8d8d9;
margin: 0 0 12px 0;
padding: 8px;
font-size: 1em !important;
font-weight: bold
}

#importdata .mw li {
margin-left: 0;
list-style-type: none;
padding-left: 30px;
background: no-repeat left 1px top 3px / 18px url('/w/nsfr_img_auth.php/c/c6/MediaWiki-2020-small-icon.svg');
}

#importdata .bs li {
margin-left: 0;
list-style-type: none;
padding-left: 30px;
background: no-repeat left 2px top 4px / 15px url('/w/nsfr_img_auth.php/c/c4/Bluespice_Icon.svg');
}

#importdata .flexbox div {
background: #f1f3f9;
text-align: left;
margin: 0;
flex-basis: 33%;
padding: 0
}

#importdata table.wikitable>tr>th,
#importdata table.wikitable>*>tr>th,
table.wikitable.reference>tr>th,
.importdata .wikitable.reference>*>tr>th {
background-color: #eaecf0;
text-align: left;
padding: 8px;
border: 1px solid #ffffff
}

#importdata table.wikitable>tr>td,
#importdata table.wikitable>*>tr>td,
#importdata table.wikitable.reference>tr>td,
#importdata table.wikitable.reference>*>tr>td {
padding: 8px;
border: 1px solid #ffffff;
}

#importdata div .inner {
padding: 8px 12px
}

#importdata .bs p {
font-size: 0.9rem;
margin-left: 2.1em;
display: list-item;
}

.smwtable-clean {
width: auto;
max-width: 100%;
margin-bottom: 20px;
background-color: transparent;
border-spacing: 0px;
}

.smwtable-clean tr>th {
padding: 8px !important;
line-height: 1.42857143;
vertical-align: top;
border-top: 1px solid #dddddd;
border-collapse: collapse;
border-spacing: 0;
text-align: center;
vertical-align: middle;
}

.smwtable-clean tr>td {
padding: 8px !important;
line-height: 1.42857143;
vertical-align: top;
border-top: 1px solid #dddddd;
border-collapse: collapse;
border-spacing: 0;
}

.smwtable-clean tbody>tr:nth-child(even) {
background-color: #f5f5f5;
}

/*Stile für die Unterseitennavigation über Erweiterung HeaderFooter */
.hf-navbox {
background: #f2f3f9;
padding: 1em;
margin-bottom: 2em
}

.hf-subpages .subpagelist ul {
margin-top: 1em;
margin-bottom: 1em;
column-count: 3
}

#mw-content-text .hf-subpages .subpagelist li {
margin-top: 0
}

.hf-subpages .default {
display: none;
line-height: 0;
overflow: hidden
}

/*avoid empty space if there are no subpages*/
.wcagnote {
border: 1px solid #e9bb06;
padding: 2px 6px;
border-radius: 6px;
background: #fffdeb;
}

/* See ERM45154 */
html {
filter: none !important;
color-scheme: light !important;
}

/*Lingo tooltip */
.qtip {
font-size: 0.9em;
}

MediaWiki:Hf-nsheader-Handbuch

2026-06-10T10:29:16Z

Margit.link-rodrigue:

<div class="hf-navbox">
<div class="hf-nav" aria-role="navigation" aria-label="Unterseiten" >{{#ifeq:{{SUBPAGENAME}}|{{PAGENAME}}|| ← [[{{NAMESPACE}}:{{BASEPAGENAME}}|{{BASEPAGENAME}}]]}}
<div class="hf-subpages">{{#subpages:kidsonly=yes|default=<span class="default">no subpages</span>}}
</div></div></div>

MediaWiki:Hf-nsheader-Handbuch

2026-06-10T10:29:02Z

Margit.link-rodrigue:

<div class="hf-navbox">
<div class="hf-nav" aria-role="navigation" aria-label="subpages" >{{#ifeq:{{SUBPAGENAME}}|{{PAGENAME}}|| ← [[{{NAMESPACE}}:{{BASEPAGENAME}}|{{BASEPAGENAME}}]]}}
<div class="hf-subpages">{{#subpages:kidsonly=yes|default=<span class="default">no subpages</span>}}
</div></div></div>

MediaWiki:Hf-nsheader-Handbuch

2026-06-10T10:16:21Z

Margit.link-rodrigue:

MediaWiki:Hf-nsheader-Handbuch

2026-06-10T10:07:26Z

Margit.link-rodrigue:

MediaWiki:Common.css

2026-06-10T10:04:24Z

Margit.link-rodrigue:

/* Das folgende CSS wird für alle Benutzeroberflächen geladen. */
/*Sidebar subpagetree */

#sb-pri ul.tree-node-list > li > div, #sb-pri ul.tree-node-list > li > ul.tree-node-list {
margin-left: 0px!important;
border-left: 5px solid transparent;
box-sizing: border-box!important;
}

/*Entry links*/

#sb-pri .list-group-item a {
margin-left: 0px!important;
border-left: 5px solid transparent;
box-sizing: border-box!important;
}

/*Custom formatting for centering footer links*/

#footer ul {
position: relative;
}

li.edit-footerlinks-link {
position: absolute;
top: 2.2em;}

/*Custom formatting for EmbedVideo overlay on dark background image*/
.embedvideo-thumbnail {
position: absolute;
z-index: 1;
top:-10px
}
.embedvideo-overlay {
display: block;
position: absolute;
top: 0;
}
.embedvideo-overlay a {
color:white!important;
font-size:1.1em!important;
}
.embedvideo-loader__title {
white-space: normal;
text-align:center;
padding-top:20px
}
.embedvideo-loader__footer > div {
background-color: rgba(226, 0, 0, .8);
}
.embedvideo-privacyNotice {
height:110%
}
.embedvideo-privacyNotice__continue {
border: none;
padding: 2px 5px;
border-radius:5px;
outline: inherit;
background-color: #36c;
color:white ;
}
.embedvideo-privacyNotice__dismiss {
border: none;
padding: 2px 5px;
border-radius:5px;
background-color:white;
}
.embedvideo-loader__fakeButton {
margin-top:30px;
}

/*WCAG 1.4.3 discernable links*/
.mw-body-content a:not([class*='oo-ui-']),
[class^='mw-content-'] a:not([class*='oo-ui-']) {
text-decoration: underline dotted;
text-underline-offset: 4px;
text-decoration-thickness: 1px;
text-decoration-color: grey
}

/*MW overrides */
.wikitable {
background-color: #fff
}

.wikitable tr th {
background-color: #f1f3f9
}

figure[typeof~='mw:File/Thumb'].mw-halign-center,
figure[typeof~='mw:File/Frame'].mw-halign-center {
margin: 2em auto;
}

.mw-body-content li {
margin-bottom: 0.6em;
}

/*Main Page banner */
#mpbanner {
margin-top: -55px;
}

h1#mpbanner-byline {
font-size: 1.8em;
color: #3e5389;
line-height: 1em;
padding-top: 20px;
}

#mpbanner-title {
font-size: 3.4rem;
color: #4b80eb;
line-height: 1.2em;
font-weight: 900;
letter-spacing: 1px;
display: block
}

#mpbsv {
color: #4666cd
}

/*Main Page general */
.mpbs5 .section-featured h2 {
font-size: 1.2em;
margin: 0 0 1em 0;
border-bottom: none;
color: #555
}

#startpage.mpbs5 .sectionflexcontainer>div h2 {
padding: 20px 15px 5px 15px
}

/*Softwarekatalog*/
table.casablanca.swc tbody tr,
table.casablanca.swc th {
color: #333
}

table.casablanca.swc thead tr,
table.casablanca tbody th.swc {
background: #e9e9ee
}

a.pdfcreator-export {
background: #efefef;
padding: 10px;
border-radius: 6px;
float: right;
font-weight: bold;
}

a.pdfcreator-export:before {
font-family: 'bootstrap-icons';
content: '\F1B9';
vertical-align: -0.3em;
padding-right: 0.5em;
}

/* Hide PDF Exclude Tags*/
.hf-nsheader .pdfcreator-excludestart,
.hf-nsheader .pdfcreator-excludeend,
.hf-nsfooter .pdfcreator-excludestart,
.hf-nsfooter .pdfcreator-excludeend {
display: none;
}

/*Quiz */
/*Quiz*/
.quiz .question {
margin-bottom: 3em;
}

.questionText {
font-weight: 700;
margin-bottom: 1.2em;
}

.question .header {
background: #fff0e1;
padding: 1px 6px;
}

span.questionText {
display: block;
}

.question td {
background: #f6f6f6;
border-bottom: 2px solid #fff;
padding: 8px 6px 6px;
}

.question th {
background: #f6f6f6;
border-bottom: 2px solid #fff;
padding: 8px 6px 6px;
}

.quiz table {
width: 100%;
}

.quizQuestions .question .sign {
width: 26px;
}

.quiz table.settings {
margin-left: 30px !important;
}

.mw-content-ltr .quiz .question .border {
border-width: 0 0 0 12px !important;
}

.quiz .margin.right {
background-color: #8ed27d !important;
}

.quiz .margin.NA {
background-color: #337ecc !important;
}

.quiz .margin.wrong {
background-color: #ff5c64 !important;
}

.quiz .question .border.right {
border-color: #8ed27d !important;
}

.quiz .question .border.NA {
border-color: #337ecc !important;
}

.quiz .question .border.wrong {
border-color: #ff5c64 !important;
}

.quiz .question .check.right {
outline: 3px solid #8ed27d !important;
}

.quiz .question .check.NA {
outline: 3px solid #337ecc !important;
}

.quiz .question .check.wrong {
outline: 3px solid #ff5c64 !important;
}

.quizForm input[value="Submit"] {
background: #36c;
border: none;
color: #FFF;
margin-right: 10px;
margin-left: 30px;
padding: 6px 12px;
}

.quizForm input:hover[value="Submit"] {
background: #2551aa;
}

.quizForm input[value="Reset"] {
background: #a4a4a4;
border: none;
color: #FFF;
margin-right: 10px;
padding: 6px 12px;
}

.quizForm input:hover[value="Reset"] {
background: #858585;
}

.quiz .correction {
background-color: #ffe4c9;
display: block;
font-weight: 700;
margin: 10px 0 30px 28px;
padding: 20px;
}

/** Template downloads **/
.cards {
display: flex;
flex-wrap: wrap;
justify-content: space-between;
gap: 20px
}

.cards>div {
margin-left: 5px;
margin-right: 5px;
flex-basis: 290px;
margin-bottom: 50px;
border-top: 1px solid #f0f0f0;
box-shadow: 0 1px 3px rgba(0, 0, 0, .12), 0 1px 2px rgba(0, 0, 0, .24);
transition: all .3s cubic-bezier(.25, .8, .25, 1);
cursor: pointer;
text-align: center
}

.cards>div:hover {
box-shadow: 0 6px 8px rgba(0, 0, 0, .10), 0 10px 10px rgba(0, 0, 0, .10);
}

.cards a.image img {
max-width: 600px
}

.cards .screenshot {
width: 300px;
height: 200px;
overflow: hidden;
border-top: 14px solid #eee;
border-bottom: 14px solid #eee
}

#content #bodyContent .cards h2 {
margin: 10px;
padding: 0;
font-size: 1.1rem;
font-color: #444;
border: none;
text-align: center
}

.cards h2 .mw-editsection {
display: none
}

.cards .text {
font-size: 0.85rem;
padding: 20px 10px;
text-align: center;
font-weight: bold;
}

#mw-content-text text a:not(.new),
[class^="mw-content-"] .text a:not(.new),
#mw-content-text .text a:link:not(.new),
[class^="mw-content-"] .text a:link:not(.new),
#mw-content-text .text a:not(.new):visited,
[class^="mw-content-"] .text a:not(.new):visited,
#mw-content-text .text a:link:not(.new):visited,
[class^="mw-content-"] .text a:link:not(.new):visited {
color: #444;
}

.cards .emptycard,
.cards>div.emptycard:hover {
border: 0;
box-shadow: none;
}

@media only screen and (max-width: 768px) {
.cards>div {
flex-basis: 98%;
}

.cards .screenshot {
width: auto;
text-align: center
}

}

.getButton {
display: inline-block;
background-color: #4CAF50;
border: none;
color: white;
padding: 8px 20px;
text-align: center;
text-decoration: none;
font-size: 16px;
margin: 0 0 10px 0;
-webkit-transition-duration: 0.4s;
transition-duration: 0.4s;
border-radius: 8px;
}

#mw-content-text .getButton a {
color: #ffffff !important;
}

.getButton:hover {
box-shadow: 0 12px 16px 0 rgba(0, 0, 0, 0.24), 0 17px 50px 0 rgba(0, 0, 0, 0.19);
color: 'f5f5f5';
}

.getButton:active {
position: relative;
top: 1px;
}

.getButton a:before {
font-family: 'fontawesome';
content: '\f019 ';
font-size: 1.3em;
vertical-align: middle;
margin-right: 10px;
}

.cart a:before {
font-family: 'fontawesome';
content: '\f217 ';
}

.downloadarea {
text-align: center;
display: inline-block;
float: right;
margin: 0 0 20px 40px;
padding: 10px;
background: #efefef;
background: linear-gradient(270deg, rgb(240, 240, 240) 0%, rgb(224, 224, 224) 52%, rgb(240, 240, 240) 100%);
}

.downloadarea p {
margin: 0
}

@media only screen and (max-width: 768px) {
.cards>div {
flex-basis: 98%;
}
}

.oo-ui-panelLayout-framed {
border: 0;
}

.oo-ui-tabSelectWidget-framed {
border-bottom: 1px solid #d3d5da;
}

/*404 system message badaccess-groups*/
#system404-error {
text-align: center;
}

#system404-error div.floatnone a.image img {
padding: 0;
margin: 0;
}

#system404-error hr {
margin-top: 0px;
margin-bottom: 2rem;
border: 0;
max-width: 600px;
border-top: 3px dotted #ddd;
}

/*Quick Search */
#bs-extendedsearch-box .bs-extendedsearch-autocomplete-popup {
overflow-y: scroll;
max-height: 750px
}

.bs-extendedsearch-autocomplete-popup .bs-extendedsearch-autocomplete-popup-item {
background: #f1f3f9;
margin: 0 10px 6px 0;
border-radius: 4px;
}

#bs-extendedsearch-box .bs-extendedsearch-autocomplete-popup .bs-extendedsearch-autocomplete-popup-primary .bs-extendedsearch-autocomplete-popup-primary-item:hover {
background: #fff
}

.oo-ui-icon-articleRedirect {
background-size: 80%
}

.bs-extendedsearch-autocomplete-popup-item-header-redirect a {
width: 85% !important;
font-size: 0.9em
}

/* Styles for section cards */
.sectionflex {
display: flex;
flex-wrap: wrap;
justify-content: space-between;
gap: 20px
}

.sectionflex.col1>div {
flex-basis: 100%;
padding: 10px 20px;
}

.sectionflex.col2>div {
flex-basis: 48%;
padding: 10px 20px;
}

.sectionflex.col3>div {
flex-basis: 32%;
padding: 10px 20px;
}

.sectionflex.col4>div {
flex-basis: 23%;
padding: 10px 20px;
}

.sectionflex>div.empty {
border: none;
background: none
}

#mw-content-text .sectionflex>div h2 {
margin: 0 0 1em 0;
font-size: 1.3em
}

#mw-content-text .sectionflex>div h3 {
margin: 0 0 1em;
font-size: 1.2em
}

.sectionflex.frame>div {
border: 1px solid #e7e7e7
}

.sectionflex.background>div {
background: #f1f3f9
}

.sectionflex .ve-ce-branchNode-slug,
.sectionflex span.mw-editsection {
display: none
}

.sectionflex.linked a {
display: block
}

.sectionflex.centered>div {
text-align: center;
}

/*All topics */
/*Themen*/
.sectionflex.themenhd div [class*=" bi-"]::before {
font-size: 1.6em;
vertical-align: middle;
padding: 6px;
border-radius: 50%;
}

.sectionflex.themenhd div [class*=" bi-"]::before {
font-size: 2em;
vertical-align: middle;
background-color: #f1f3f9;
padding: 10px;
}

.sectionflex.themenhd.background div [class*=" bi-"]::before {
font-size: 2em;
vertical-align: middle;
background-color: #fff;
padding: 10px;
}

.themenhd div a {
display: block
}

.themenhd div:hover {
background: rgb(233, 233, 238, 0.5)
}

/* bootstrap icons in blue and big */
.bi-big,
.fa-big {
font-size: 2rem;
color: #2b80ea
}

ul.smw-format.ul-format.alltopics-col {
column-count: 3;
}

@media (max-width: 767px) {

.sectionflex.col2>div,
.sectionflex.col3>div {
flex-basis: 100%;
margin-top: 2em
}
}

/*Referenz Seiten */
.extension-infobox {
width: 25em;
font-size: 90%;
background-color: #f1f3f9;
color: black;
margin-bottom: 0.5em;
margin-left: 1em;
padding: 0.2em;
float: right;
clear: right;
text-align: left;
}

.extension-infobox-header {
text-align: center;
background-color: #2e6096;
padding: 8px;
color: #ffffff;
}

.extension-infobox-headertext {
font-size: larger;
color: #FFFFFF;
}

.extension-infobox-description {
font-weight: normal !important;
text-align: left;
background-color: #f1f3f9;
padding: 20px 10px 20px 10px !important;
}

.extension-infobox-first-row {
vertical-align: top;
padding: 20px 10px 0 10px;
}

.extension-infobox-row {
vertical-align: top;
padding: 0 10px;
}

.extension-infobox-last-row {
vertical-align: top;
padding: 0 10px 20px 10px;
}

.extension-infobox-helppage {
font-weight: normal;
text-align: center;
vertical-align: top;
padding-left: 10px;
padding-top: 10px;
padding-bottom: 10px;
background-color: #eeeeee;
}

.extension-infobox.fullwidth {
width: 100%;
float: none;
font-size: 1em;
margin-left: 0;
}

.extension-infobox.fullwidth th {
text-align: right;
}

.extension-infobox-header,
.extension-infobox-helppage {
text-align: center !important;
font-size: 1.1em
}

.extension-infobox.fullwidth th,
.extension-infobox.fullwidth td {
padding: 8px;
width: 100px;
border: 1px solid #ffffff;
}

.extension-infobox.fullwidth td {
width: 300px;
}

.extension-infobox-helppage {
background-color: #eaecf0;
}

.flexbox {
display: flex;
flex-direction: row;
flex-wrap: wrap;
justify-content: flex-start;
align-items: stretch;
align-content: stretch;
}

#content #bodyContent #importdata h3 {
margin: 1em 0 1.4em;
}

#importdata .flexbox {
justify-content: space-between;
margin-top: 2em;
}

#mw-content-text #importdata .flexbox h3,
[class^="mw-content-"] #importdata .flexbox h3 {
background: #d8d8d9;
margin: 0 0 12px 0;
padding: 8px;
font-size: 1em !important;
font-weight: bold
}

#importdata .mw li {
margin-left: 0;
list-style-type: none;
padding-left: 30px;
background: no-repeat left 1px top 3px / 18px url('/w/nsfr_img_auth.php/c/c6/MediaWiki-2020-small-icon.svg');
}

#importdata .bs li {
margin-left: 0;
list-style-type: none;
padding-left: 30px;
background: no-repeat left 2px top 4px / 15px url('/w/nsfr_img_auth.php/c/c4/Bluespice_Icon.svg');
}

#importdata .flexbox div {
background: #f1f3f9;
text-align: left;
margin: 0;
flex-basis: 33%;
padding: 0
}

#importdata table.wikitable>tr>th,
#importdata table.wikitable>*>tr>th,
table.wikitable.reference>tr>th,
.importdata .wikitable.reference>*>tr>th {
background-color: #eaecf0;
text-align: left;
padding: 8px;
border: 1px solid #ffffff
}

#importdata table.wikitable>tr>td,
#importdata table.wikitable>*>tr>td,
#importdata table.wikitable.reference>tr>td,
#importdata table.wikitable.reference>*>tr>td {
padding: 8px;
border: 1px solid #ffffff;
}

#importdata div .inner {
padding: 8px 12px
}

#importdata .bs p {
font-size: 0.9rem;
margin-left: 2.1em;
display: list-item;
}

.smwtable-clean {
width: auto;
max-width: 100%;
margin-bottom: 20px;
background-color: transparent;
border-spacing: 0px;
}

.smwtable-clean tr>th {
padding: 8px !important;
line-height: 1.42857143;
vertical-align: top;
border-top: 1px solid #dddddd;
border-collapse: collapse;
border-spacing: 0;
text-align: center;
vertical-align: middle;
}

.smwtable-clean tr>td {
padding: 8px !important;
line-height: 1.42857143;
vertical-align: top;
border-top: 1px solid #dddddd;
border-collapse: collapse;
border-spacing: 0;
}

.smwtable-clean tbody>tr:nth-child(even) {
background-color: #f5f5f5;
}

/* See ERM45154 */
html {
filter: none !important;
color-scheme: light !important;
}

/* Permissionsmatrix */

.matrix td,
.matrix th {
font-size: 0.85em
}

.wikitable th,
.wikitable td {
padding: 10px;
vertical-align: top
}

th.firstcol-sm {
width: 200px !important
}

/*Lingo tooltip */
.qtip {
font-size: 0.9em;
}

/*hf- styling für subpage box */
.hf-navbox {background: #f2f3f9; padding:1em; margin-bottom:2em}
.hf-subpages .subpagelist ul { margin-top:1em; margin-bottom:1em; column-count:3 }
#mw-content-text .hf-subpages .subpagelist li {margin-top:0}
.hf-subpages .default {display:none; line-height:0; overflow:hidden} /*avoid empty space if there are no subpages*/

MediaWiki:Hf-nsheader-Handbuch

2026-06-10T10:04:10Z

Margit.link-rodrigue:

{{#ifeq:{{PAGENAME}}|{{SUBPAGENAME}}||<div class="hf-navbox">
<div class="hf-nav" aria-role="navigation" aria-label="Unterseiten" >{{#ifeq:{{SUBPAGENAME}}|{{PAGENAME}}|| ← [[{{NAMESPACE}}:{{BASEPAGENAME}}|{{BASEPAGENAME}}]]}}
<div class="hf-subpages">{{#subpages:kidsonly=yes|default=<span class="default"> </span>}}
</div></div></div>}}

MediaWiki:Common.css

2026-06-10T10:03:50Z

Margit.link-rodrigue:

/* Das folgende CSS wird für alle Benutzeroberflächen geladen. */
/*Sidebar subpagetree */

#sb-pri ul.tree-node-list > li > div, #sb-pri ul.tree-node-list > li > ul.tree-node-list {
margin-left: 0px!important;
border-left: 5px solid transparent;
box-sizing: border-box!important;
}

/*Entry links*/

#sb-pri .list-group-item a {
margin-left: 0px!important;
border-left: 5px solid transparent;
box-sizing: border-box!important;
}

/*Custom formatting for centering footer links*/

#footer ul {
position: relative;
}

li.edit-footerlinks-link {
position: absolute;
top: 2.2em;}

/*Custom formatting for EmbedVideo overlay on dark background image*/
.embedvideo-thumbnail {
position: absolute;
z-index: 1;
top:-10px
}
.embedvideo-overlay {
display: block;
position: absolute;
top: 0;
}
.embedvideo-overlay a {
color:white!important;
font-size:1.1em!important;
}
.embedvideo-loader__title {
white-space: normal;
text-align:center;
padding-top:20px
}
.embedvideo-loader__footer > div {
background-color: rgba(226, 0, 0, .8);
}
.embedvideo-privacyNotice {
height:110%
}
.embedvideo-privacyNotice__continue {
border: none;
padding: 2px 5px;
border-radius:5px;
outline: inherit;
background-color: #36c;
color:white ;
}
.embedvideo-privacyNotice__dismiss {
border: none;
padding: 2px 5px;
border-radius:5px;
background-color:white;
}
.embedvideo-loader__fakeButton {
margin-top:30px;
}

/*WCAG 1.4.3 discernable links*/
.mw-body-content a:not([class*='oo-ui-']),
[class^='mw-content-'] a:not([class*='oo-ui-']) {
text-decoration: underline dotted;
text-underline-offset: 4px;
text-decoration-thickness: 1px;
text-decoration-color: grey
}

/*MW overrides */
.wikitable {
background-color: #fff
}

.wikitable tr th {
background-color: #f1f3f9
}

figure[typeof~='mw:File/Thumb'].mw-halign-center,
figure[typeof~='mw:File/Frame'].mw-halign-center {
margin: 2em auto;
}

.mw-body-content li {
margin-bottom: 0.6em;
}

/*Main Page banner */
#mpbanner {
margin-top: -55px;
}

h1#mpbanner-byline {
font-size: 1.8em;
color: #3e5389;
line-height: 1em;
padding-top: 20px;
}

#mpbanner-title {
font-size: 3.4rem;
color: #4b80eb;
line-height: 1.2em;
font-weight: 900;
letter-spacing: 1px;
display: block
}

#mpbsv {
color: #4666cd
}

/*Main Page general */
.mpbs5 .section-featured h2 {
font-size: 1.2em;
margin: 0 0 1em 0;
border-bottom: none;
color: #555
}

#startpage.mpbs5 .sectionflexcontainer>div h2 {
padding: 20px 15px 5px 15px
}

/*Softwarekatalog*/
table.casablanca.swc tbody tr,
table.casablanca.swc th {
color: #333
}

table.casablanca.swc thead tr,
table.casablanca tbody th.swc {
background: #e9e9ee
}

a.pdfcreator-export {
background: #efefef;
padding: 10px;
border-radius: 6px;
float: right;
font-weight: bold;
}

a.pdfcreator-export:before {
font-family: 'bootstrap-icons';
content: '\F1B9';
vertical-align: -0.3em;
padding-right: 0.5em;
}

/* Hide PDF Exclude Tags*/
.hf-nsheader .pdfcreator-excludestart,
.hf-nsheader .pdfcreator-excludeend,
.hf-nsfooter .pdfcreator-excludestart,
.hf-nsfooter .pdfcreator-excludeend {
display: none;
}

/*Quiz */
/*Quiz*/
.quiz .question {
margin-bottom: 3em;
}

.questionText {
font-weight: 700;
margin-bottom: 1.2em;
}

.question .header {
background: #fff0e1;
padding: 1px 6px;
}

span.questionText {
display: block;
}

.question td {
background: #f6f6f6;
border-bottom: 2px solid #fff;
padding: 8px 6px 6px;
}

.question th {
background: #f6f6f6;
border-bottom: 2px solid #fff;
padding: 8px 6px 6px;
}

.quiz table {
width: 100%;
}

.quizQuestions .question .sign {
width: 26px;
}

.quiz table.settings {
margin-left: 30px !important;
}

.mw-content-ltr .quiz .question .border {
border-width: 0 0 0 12px !important;
}

.quiz .margin.right {
background-color: #8ed27d !important;
}

.quiz .margin.NA {
background-color: #337ecc !important;
}

.quiz .margin.wrong {
background-color: #ff5c64 !important;
}

.quiz .question .border.right {
border-color: #8ed27d !important;
}

.quiz .question .border.NA {
border-color: #337ecc !important;
}

.quiz .question .border.wrong {
border-color: #ff5c64 !important;
}

.quiz .question .check.right {
outline: 3px solid #8ed27d !important;
}

.quiz .question .check.NA {
outline: 3px solid #337ecc !important;
}

.quiz .question .check.wrong {
outline: 3px solid #ff5c64 !important;
}

.quizForm input[value="Submit"] {
background: #36c;
border: none;
color: #FFF;
margin-right: 10px;
margin-left: 30px;
padding: 6px 12px;
}

.quizForm input:hover[value="Submit"] {
background: #2551aa;
}

.quizForm input[value="Reset"] {
background: #a4a4a4;
border: none;
color: #FFF;
margin-right: 10px;
padding: 6px 12px;
}

.quizForm input:hover[value="Reset"] {
background: #858585;
}

.quiz .correction {
background-color: #ffe4c9;
display: block;
font-weight: 700;
margin: 10px 0 30px 28px;
padding: 20px;
}

/** Template downloads **/
.cards {
display: flex;
flex-wrap: wrap;
justify-content: space-between;
gap: 20px
}

.cards>div {
margin-left: 5px;
margin-right: 5px;
flex-basis: 290px;
margin-bottom: 50px;
border-top: 1px solid #f0f0f0;
box-shadow: 0 1px 3px rgba(0, 0, 0, .12), 0 1px 2px rgba(0, 0, 0, .24);
transition: all .3s cubic-bezier(.25, .8, .25, 1);
cursor: pointer;
text-align: center
}

.cards>div:hover {
box-shadow: 0 6px 8px rgba(0, 0, 0, .10), 0 10px 10px rgba(0, 0, 0, .10);
}

.cards a.image img {
max-width: 600px
}

.cards .screenshot {
width: 300px;
height: 200px;
overflow: hidden;
border-top: 14px solid #eee;
border-bottom: 14px solid #eee
}

#content #bodyContent .cards h2 {
margin: 10px;
padding: 0;
font-size: 1.1rem;
font-color: #444;
border: none;
text-align: center
}

.cards h2 .mw-editsection {
display: none
}

.cards .text {
font-size: 0.85rem;
padding: 20px 10px;
text-align: center;
font-weight: bold;
}

#mw-content-text text a:not(.new),
[class^="mw-content-"] .text a:not(.new),
#mw-content-text .text a:link:not(.new),
[class^="mw-content-"] .text a:link:not(.new),
#mw-content-text .text a:not(.new):visited,
[class^="mw-content-"] .text a:not(.new):visited,
#mw-content-text .text a:link:not(.new):visited,
[class^="mw-content-"] .text a:link:not(.new):visited {
color: #444;
}

.cards .emptycard,
.cards>div.emptycard:hover {
border: 0;
box-shadow: none;
}

@media only screen and (max-width: 768px) {
.cards>div {
flex-basis: 98%;
}

.cards .screenshot {
width: auto;
text-align: center
}

}

.getButton {
display: inline-block;
background-color: #4CAF50;
border: none;
color: white;
padding: 8px 20px;
text-align: center;
text-decoration: none;
font-size: 16px;
margin: 0 0 10px 0;
-webkit-transition-duration: 0.4s;
transition-duration: 0.4s;
border-radius: 8px;
}

#mw-content-text .getButton a {
color: #ffffff !important;
}

.getButton:hover {
box-shadow: 0 12px 16px 0 rgba(0, 0, 0, 0.24), 0 17px 50px 0 rgba(0, 0, 0, 0.19);
color: 'f5f5f5';
}

.getButton:active {
position: relative;
top: 1px;
}

.getButton a:before {
font-family: 'fontawesome';
content: '\f019 ';
font-size: 1.3em;
vertical-align: middle;
margin-right: 10px;
}

.cart a:before {
font-family: 'fontawesome';
content: '\f217 ';
}

.downloadarea {
text-align: center;
display: inline-block;
float: right;
margin: 0 0 20px 40px;
padding: 10px;
background: #efefef;
background: linear-gradient(270deg, rgb(240, 240, 240) 0%, rgb(224, 224, 224) 52%, rgb(240, 240, 240) 100%);
}

.downloadarea p {
margin: 0
}

@media only screen and (max-width: 768px) {
.cards>div {
flex-basis: 98%;
}
}

.oo-ui-panelLayout-framed {
border: 0;
}

.oo-ui-tabSelectWidget-framed {
border-bottom: 1px solid #d3d5da;
}

/*404 system message badaccess-groups*/
#system404-error {
text-align: center;
}

#system404-error div.floatnone a.image img {
padding: 0;
margin: 0;
}

#system404-error hr {
margin-top: 0px;
margin-bottom: 2rem;
border: 0;
max-width: 600px;
border-top: 3px dotted #ddd;
}

/*Quick Search */
#bs-extendedsearch-box .bs-extendedsearch-autocomplete-popup {
overflow-y: scroll;
max-height: 750px
}

.bs-extendedsearch-autocomplete-popup .bs-extendedsearch-autocomplete-popup-item {
background: #f1f3f9;
margin: 0 10px 6px 0;
border-radius: 4px;
}

#bs-extendedsearch-box .bs-extendedsearch-autocomplete-popup .bs-extendedsearch-autocomplete-popup-primary .bs-extendedsearch-autocomplete-popup-primary-item:hover {
background: #fff
}

.oo-ui-icon-articleRedirect {
background-size: 80%
}

.bs-extendedsearch-autocomplete-popup-item-header-redirect a {
width: 85% !important;
font-size: 0.9em
}

/* Styles for section cards */
.sectionflex {
display: flex;
flex-wrap: wrap;
justify-content: space-between;
gap: 20px
}

.sectionflex.col1>div {
flex-basis: 100%;
padding: 10px 20px;
}

.sectionflex.col2>div {
flex-basis: 48%;
padding: 10px 20px;
}

.sectionflex.col3>div {
flex-basis: 32%;
padding: 10px 20px;
}

.sectionflex.col4>div {
flex-basis: 23%;
padding: 10px 20px;
}

.sectionflex>div.empty {
border: none;
background: none
}

#mw-content-text .sectionflex>div h2 {
margin: 0 0 1em 0;
font-size: 1.3em
}

#mw-content-text .sectionflex>div h3 {
margin: 0 0 1em;
font-size: 1.2em
}

.sectionflex.frame>div {
border: 1px solid #e7e7e7
}

.sectionflex.background>div {
background: #f1f3f9
}

.sectionflex .ve-ce-branchNode-slug,
.sectionflex span.mw-editsection {
display: none
}

.sectionflex.linked a {
display: block
}

.sectionflex.centered>div {
text-align: center;
}

/*All topics */
/*Themen*/
.sectionflex.themenhd div [class*=" bi-"]::before {
font-size: 1.6em;
vertical-align: middle;
padding: 6px;
border-radius: 50%;
}

.sectionflex.themenhd div [class*=" bi-"]::before {
font-size: 2em;
vertical-align: middle;
background-color: #f1f3f9;
padding: 10px;
}

.sectionflex.themenhd.background div [class*=" bi-"]::before {
font-size: 2em;
vertical-align: middle;
background-color: #fff;
padding: 10px;
}

.themenhd div a {
display: block
}

.themenhd div:hover {
background: rgb(233, 233, 238, 0.5)
}

/* bootstrap icons in blue and big */
.bi-big,
.fa-big {
font-size: 2rem;
color: #2b80ea
}

ul.smw-format.ul-format.alltopics-col {
column-count: 3;
}

@media (max-width: 767px) {

.sectionflex.col2>div,
.sectionflex.col3>div {
flex-basis: 100%;
margin-top: 2em
}
}

/*Referenz Seiten */
.extension-infobox {
width: 25em;
font-size: 90%;
background-color: #f1f3f9;
color: black;
margin-bottom: 0.5em;
margin-left: 1em;
padding: 0.2em;
float: right;
clear: right;
text-align: left;
}

.extension-infobox-header {
text-align: center;
background-color: #2e6096;
padding: 8px;
color: #ffffff;
}

.extension-infobox-headertext {
font-size: larger;
color: #FFFFFF;
}

.extension-infobox-description {
font-weight: normal !important;
text-align: left;
background-color: #f1f3f9;
padding: 20px 10px 20px 10px !important;
}

.extension-infobox-first-row {
vertical-align: top;
padding: 20px 10px 0 10px;
}

.extension-infobox-row {
vertical-align: top;
padding: 0 10px;
}

.extension-infobox-last-row {
vertical-align: top;
padding: 0 10px 20px 10px;
}

.extension-infobox-helppage {
font-weight: normal;
text-align: center;
vertical-align: top;
padding-left: 10px;
padding-top: 10px;
padding-bottom: 10px;
background-color: #eeeeee;
}

.extension-infobox.fullwidth {
width: 100%;
float: none;
font-size: 1em;
margin-left: 0;
}

.extension-infobox.fullwidth th {
text-align: right;
}

.extension-infobox-header,
.extension-infobox-helppage {
text-align: center !important;
font-size: 1.1em
}

.extension-infobox.fullwidth th,
.extension-infobox.fullwidth td {
padding: 8px;
width: 100px;
border: 1px solid #ffffff;
}

.extension-infobox.fullwidth td {
width: 300px;
}

.extension-infobox-helppage {
background-color: #eaecf0;
}

.flexbox {
display: flex;
flex-direction: row;
flex-wrap: wrap;
justify-content: flex-start;
align-items: stretch;
align-content: stretch;
}

#content #bodyContent #importdata h3 {
margin: 1em 0 1.4em;
}

#importdata .flexbox {
justify-content: space-between;
margin-top: 2em;
}

#mw-content-text #importdata .flexbox h3,
[class^="mw-content-"] #importdata .flexbox h3 {
background: #d8d8d9;
margin: 0 0 12px 0;
padding: 8px;
font-size: 1em !important;
font-weight: bold
}

#importdata .mw li {
margin-left: 0;
list-style-type: none;
padding-left: 30px;
background: no-repeat left 1px top 3px / 18px url('/w/nsfr_img_auth.php/c/c6/MediaWiki-2020-small-icon.svg');
}

#importdata .bs li {
margin-left: 0;
list-style-type: none;
padding-left: 30px;
background: no-repeat left 2px top 4px / 15px url('/w/nsfr_img_auth.php/c/c4/Bluespice_Icon.svg');
}

#importdata .flexbox div {
background: #f1f3f9;
text-align: left;
margin: 0;
flex-basis: 33%;
padding: 0
}

#importdata table.wikitable>tr>th,
#importdata table.wikitable>*>tr>th,
table.wikitable.reference>tr>th,
.importdata .wikitable.reference>*>tr>th {
background-color: #eaecf0;
text-align: left;
padding: 8px;
border: 1px solid #ffffff
}

#importdata table.wikitable>tr>td,
#importdata table.wikitable>*>tr>td,
#importdata table.wikitable.reference>tr>td,
#importdata table.wikitable.reference>*>tr>td {
padding: 8px;
border: 1px solid #ffffff;
}

#importdata div .inner {
padding: 8px 12px
}

#importdata .bs p {
font-size: 0.9rem;
margin-left: 2.1em;
display: list-item;
}

.smwtable-clean {
width: auto;
max-width: 100%;
margin-bottom: 20px;
background-color: transparent;
border-spacing: 0px;
}

.smwtable-clean tr>th {
padding: 8px !important;
line-height: 1.42857143;
vertical-align: top;
border-top: 1px solid #dddddd;
border-collapse: collapse;
border-spacing: 0;
text-align: center;
vertical-align: middle;
}

.smwtable-clean tr>td {
padding: 8px !important;
line-height: 1.42857143;
vertical-align: top;
border-top: 1px solid #dddddd;
border-collapse: collapse;
border-spacing: 0;
}

.smwtable-clean tbody>tr:nth-child(even) {
background-color: #f5f5f5;
}

/* See ERM45154 */
html {
filter: none !important;
color-scheme: light !important;
}

/* Permissionsmatrix */

.matrix td,
.matrix th {
font-size: 0.85em
}

.wikitable th,
.wikitable td {
padding: 10px;
vertical-align: top
}

th.firstcol-sm {
width: 200px !important
}

/*Lingo tooltip */
.qtip {
font-size: 0.9em;
}

/*hf- styling für subpage box */
.hf-navbox {background: #f2f3f9!important; padding:1em; margin-bottom:2em}
.hf-subpages .subpagelist ul { margin-top:1em; margin-bottom:1em; column-count:3 }
#mw-content-text .hf-subpages .subpagelist li {margin-top:0}
.hf-subpages .default {display:none; line-height:0; overflow:hidden} /*avoid empty space if there are no subpages*/

MediaWiki:Hf-nsheader-Handbuch

2026-06-10T10:03:18Z

Margit.link-rodrigue:

{{#ifeq:{{PAGENAME}}|{{SUBPAGENAME}}||<div class="hf-navbox" style="border:1px solid red">
<div class="hf-nav" aria-role="navigation" aria-label="Unterseiten" >{{#ifeq:{{SUBPAGENAME}}|{{PAGENAME}}|| ← [[{{NAMESPACE}}:{{BASEPAGENAME}}|{{BASEPAGENAME}}]]}}
<div class="hf-subpages">{{#subpages:kidsonly=yes|default=<span class="default"> </span>}}
</div></div></div>}}

MediaWiki:Hf-nsheader-Handbuch

2026-06-10T10:02:57Z

Margit.link-rodrigue:

MediaWiki:Hf-nsheader-Handbuch

2026-06-10T09:57:09Z

Margit.link-rodrigue:

<div class="hf-navbox">
<div class="hf-nav" aria-role="navigation" aria-label="Unterseiten" >{{#ifeq:{{SUBPAGENAME}}|{{PAGENAME}}|| ← [[{{NAMESPACE}}:{{BASEPAGENAME}}|{{BASEPAGENAME}}]]}}
<div class="hf-subpages">{{#subpages:kidsonly=yes|default=<span class="default"> </span>}}
</div></div></div>

MediaWiki:Common.css

2026-06-10T09:54:55Z

Margit.link-rodrigue:

/* Das folgende CSS wird für alle Benutzeroberflächen geladen. */
/*Sidebar subpagetree */

#sb-pri ul.tree-node-list > li > div, #sb-pri ul.tree-node-list > li > ul.tree-node-list {
margin-left: 0px!important;
border-left: 5px solid transparent;
box-sizing: border-box!important;
}

/*Entry links*/

#sb-pri .list-group-item a {
margin-left: 0px!important;
border-left: 5px solid transparent;
box-sizing: border-box!important;
}

/*Custom formatting for centering footer links*/

#footer ul {
position: relative;
}

li.edit-footerlinks-link {
position: absolute;
top: 2.2em;}

/*Custom formatting for EmbedVideo overlay on dark background image*/
.embedvideo-thumbnail {
position: absolute;
z-index: 1;
top:-10px
}
.embedvideo-overlay {
display: block;
position: absolute;
top: 0;
}
.embedvideo-overlay a {
color:white!important;
font-size:1.1em!important;
}
.embedvideo-loader__title {
white-space: normal;
text-align:center;
padding-top:20px
}
.embedvideo-loader__footer > div {
background-color: rgba(226, 0, 0, .8);
}
.embedvideo-privacyNotice {
height:110%
}
.embedvideo-privacyNotice__continue {
border: none;
padding: 2px 5px;
border-radius:5px;
outline: inherit;
background-color: #36c;
color:white ;
}
.embedvideo-privacyNotice__dismiss {
border: none;
padding: 2px 5px;
border-radius:5px;
background-color:white;
}
.embedvideo-loader__fakeButton {
margin-top:30px;
}

/*WCAG 1.4.3 discernable links*/
.mw-body-content a:not([class*='oo-ui-']),
[class^='mw-content-'] a:not([class*='oo-ui-']) {
text-decoration: underline dotted;
text-underline-offset: 4px;
text-decoration-thickness: 1px;
text-decoration-color: grey
}

/*MW overrides */
.wikitable {
background-color: #fff
}

.wikitable tr th {
background-color: #f1f3f9
}

figure[typeof~='mw:File/Thumb'].mw-halign-center,
figure[typeof~='mw:File/Frame'].mw-halign-center {
margin: 2em auto;
}

.mw-body-content li {
margin-bottom: 0.6em;
}

/*Main Page banner */
#mpbanner {
margin-top: -55px;
}

h1#mpbanner-byline {
font-size: 1.8em;
color: #3e5389;
line-height: 1em;
padding-top: 20px;
}

#mpbanner-title {
font-size: 3.4rem;
color: #4b80eb;
line-height: 1.2em;
font-weight: 900;
letter-spacing: 1px;
display: block
}

#mpbsv {
color: #4666cd
}

/*Main Page general */
.mpbs5 .section-featured h2 {
font-size: 1.2em;
margin: 0 0 1em 0;
border-bottom: none;
color: #555
}

#startpage.mpbs5 .sectionflexcontainer>div h2 {
padding: 20px 15px 5px 15px
}

/*Softwarekatalog*/
table.casablanca.swc tbody tr,
table.casablanca.swc th {
color: #333
}

table.casablanca.swc thead tr,
table.casablanca tbody th.swc {
background: #e9e9ee
}

a.pdfcreator-export {
background: #efefef;
padding: 10px;
border-radius: 6px;
float: right;
font-weight: bold;
}

a.pdfcreator-export:before {
font-family: 'bootstrap-icons';
content: '\F1B9';
vertical-align: -0.3em;
padding-right: 0.5em;
}

/* Hide PDF Exclude Tags*/
.hf-nsheader .pdfcreator-excludestart,
.hf-nsheader .pdfcreator-excludeend,
.hf-nsfooter .pdfcreator-excludestart,
.hf-nsfooter .pdfcreator-excludeend {
display: none;
}

/*Quiz */
/*Quiz*/
.quiz .question {
margin-bottom: 3em;
}

.questionText {
font-weight: 700;
margin-bottom: 1.2em;
}

.question .header {
background: #fff0e1;
padding: 1px 6px;
}

span.questionText {
display: block;
}

.question td {
background: #f6f6f6;
border-bottom: 2px solid #fff;
padding: 8px 6px 6px;
}

.question th {
background: #f6f6f6;
border-bottom: 2px solid #fff;
padding: 8px 6px 6px;
}

.quiz table {
width: 100%;
}

.quizQuestions .question .sign {
width: 26px;
}

.quiz table.settings {
margin-left: 30px !important;
}

.mw-content-ltr .quiz .question .border {
border-width: 0 0 0 12px !important;
}

.quiz .margin.right {
background-color: #8ed27d !important;
}

.quiz .margin.NA {
background-color: #337ecc !important;
}

.quiz .margin.wrong {
background-color: #ff5c64 !important;
}

.quiz .question .border.right {
border-color: #8ed27d !important;
}

.quiz .question .border.NA {
border-color: #337ecc !important;
}

.quiz .question .border.wrong {
border-color: #ff5c64 !important;
}

.quiz .question .check.right {
outline: 3px solid #8ed27d !important;
}

.quiz .question .check.NA {
outline: 3px solid #337ecc !important;
}

.quiz .question .check.wrong {
outline: 3px solid #ff5c64 !important;
}

.quizForm input[value="Submit"] {
background: #36c;
border: none;
color: #FFF;
margin-right: 10px;
margin-left: 30px;
padding: 6px 12px;
}

.quizForm input:hover[value="Submit"] {
background: #2551aa;
}

.quizForm input[value="Reset"] {
background: #a4a4a4;
border: none;
color: #FFF;
margin-right: 10px;
padding: 6px 12px;
}

.quizForm input:hover[value="Reset"] {
background: #858585;
}

.quiz .correction {
background-color: #ffe4c9;
display: block;
font-weight: 700;
margin: 10px 0 30px 28px;
padding: 20px;
}

/** Template downloads **/
.cards {
display: flex;
flex-wrap: wrap;
justify-content: space-between;
gap: 20px
}

.cards>div {
margin-left: 5px;
margin-right: 5px;
flex-basis: 290px;
margin-bottom: 50px;
border-top: 1px solid #f0f0f0;
box-shadow: 0 1px 3px rgba(0, 0, 0, .12), 0 1px 2px rgba(0, 0, 0, .24);
transition: all .3s cubic-bezier(.25, .8, .25, 1);
cursor: pointer;
text-align: center
}

.cards>div:hover {
box-shadow: 0 6px 8px rgba(0, 0, 0, .10), 0 10px 10px rgba(0, 0, 0, .10);
}

.cards a.image img {
max-width: 600px
}

.cards .screenshot {
width: 300px;
height: 200px;
overflow: hidden;
border-top: 14px solid #eee;
border-bottom: 14px solid #eee
}

#content #bodyContent .cards h2 {
margin: 10px;
padding: 0;
font-size: 1.1rem;
font-color: #444;
border: none;
text-align: center
}

.cards h2 .mw-editsection {
display: none
}

.cards .text {
font-size: 0.85rem;
padding: 20px 10px;
text-align: center;
font-weight: bold;
}

#mw-content-text text a:not(.new),
[class^="mw-content-"] .text a:not(.new),
#mw-content-text .text a:link:not(.new),
[class^="mw-content-"] .text a:link:not(.new),
#mw-content-text .text a:not(.new):visited,
[class^="mw-content-"] .text a:not(.new):visited,
#mw-content-text .text a:link:not(.new):visited,
[class^="mw-content-"] .text a:link:not(.new):visited {
color: #444;
}

.cards .emptycard,
.cards>div.emptycard:hover {
border: 0;
box-shadow: none;
}

@media only screen and (max-width: 768px) {
.cards>div {
flex-basis: 98%;
}

.cards .screenshot {
width: auto;
text-align: center
}

}

.getButton {
display: inline-block;
background-color: #4CAF50;
border: none;
color: white;
padding: 8px 20px;
text-align: center;
text-decoration: none;
font-size: 16px;
margin: 0 0 10px 0;
-webkit-transition-duration: 0.4s;
transition-duration: 0.4s;
border-radius: 8px;
}

#mw-content-text .getButton a {
color: #ffffff !important;
}

.getButton:hover {
box-shadow: 0 12px 16px 0 rgba(0, 0, 0, 0.24), 0 17px 50px 0 rgba(0, 0, 0, 0.19);
color: 'f5f5f5';
}

.getButton:active {
position: relative;
top: 1px;
}

.getButton a:before {
font-family: 'fontawesome';
content: '\f019 ';
font-size: 1.3em;
vertical-align: middle;
margin-right: 10px;
}

.cart a:before {
font-family: 'fontawesome';
content: '\f217 ';
}

.downloadarea {
text-align: center;
display: inline-block;
float: right;
margin: 0 0 20px 40px;
padding: 10px;
background: #efefef;
background: linear-gradient(270deg, rgb(240, 240, 240) 0%, rgb(224, 224, 224) 52%, rgb(240, 240, 240) 100%);
}

.downloadarea p {
margin: 0
}

@media only screen and (max-width: 768px) {
.cards>div {
flex-basis: 98%;
}
}

.oo-ui-panelLayout-framed {
border: 0;
}

.oo-ui-tabSelectWidget-framed {
border-bottom: 1px solid #d3d5da;
}

/*404 system message badaccess-groups*/
#system404-error {
text-align: center;
}

#system404-error div.floatnone a.image img {
padding: 0;
margin: 0;
}

#system404-error hr {
margin-top: 0px;
margin-bottom: 2rem;
border: 0;
max-width: 600px;
border-top: 3px dotted #ddd;
}

/*Quick Search */
#bs-extendedsearch-box .bs-extendedsearch-autocomplete-popup {
overflow-y: scroll;
max-height: 750px
}

.bs-extendedsearch-autocomplete-popup .bs-extendedsearch-autocomplete-popup-item {
background: #f1f3f9;
margin: 0 10px 6px 0;
border-radius: 4px;
}

#bs-extendedsearch-box .bs-extendedsearch-autocomplete-popup .bs-extendedsearch-autocomplete-popup-primary .bs-extendedsearch-autocomplete-popup-primary-item:hover {
background: #fff
}

.oo-ui-icon-articleRedirect {
background-size: 80%
}

.bs-extendedsearch-autocomplete-popup-item-header-redirect a {
width: 85% !important;
font-size: 0.9em
}

/* Styles for section cards */
.sectionflex {
display: flex;
flex-wrap: wrap;
justify-content: space-between;
gap: 20px
}

.sectionflex.col1>div {
flex-basis: 100%;
padding: 10px 20px;
}

.sectionflex.col2>div {
flex-basis: 48%;
padding: 10px 20px;
}

.sectionflex.col3>div {
flex-basis: 32%;
padding: 10px 20px;
}

.sectionflex.col4>div {
flex-basis: 23%;
padding: 10px 20px;
}

.sectionflex>div.empty {
border: none;
background: none
}

#mw-content-text .sectionflex>div h2 {
margin: 0 0 1em 0;
font-size: 1.3em
}

#mw-content-text .sectionflex>div h3 {
margin: 0 0 1em;
font-size: 1.2em
}

.sectionflex.frame>div {
border: 1px solid #e7e7e7
}

.sectionflex.background>div {
background: #f1f3f9
}

.sectionflex .ve-ce-branchNode-slug,
.sectionflex span.mw-editsection {
display: none
}

.sectionflex.linked a {
display: block
}

.sectionflex.centered>div {
text-align: center;
}

/*All topics */
/*Themen*/
.sectionflex.themenhd div [class*=" bi-"]::before {
font-size: 1.6em;
vertical-align: middle;
padding: 6px;
border-radius: 50%;
}

.sectionflex.themenhd div [class*=" bi-"]::before {
font-size: 2em;
vertical-align: middle;
background-color: #f1f3f9;
padding: 10px;
}

.sectionflex.themenhd.background div [class*=" bi-"]::before {
font-size: 2em;
vertical-align: middle;
background-color: #fff;
padding: 10px;
}

.themenhd div a {
display: block
}

.themenhd div:hover {
background: rgb(233, 233, 238, 0.5)
}

/* bootstrap icons in blue and big */
.bi-big,
.fa-big {
font-size: 2rem;
color: #2b80ea
}

ul.smw-format.ul-format.alltopics-col {
column-count: 3;
}

@media (max-width: 767px) {

.sectionflex.col2>div,
.sectionflex.col3>div {
flex-basis: 100%;
margin-top: 2em
}
}

/*Referenz Seiten */
.extension-infobox {
width: 25em;
font-size: 90%;
background-color: #f1f3f9;
color: black;
margin-bottom: 0.5em;
margin-left: 1em;
padding: 0.2em;
float: right;
clear: right;
text-align: left;
}

.extension-infobox-header {
text-align: center;
background-color: #2e6096;
padding: 8px;
color: #ffffff;
}

.extension-infobox-headertext {
font-size: larger;
color: #FFFFFF;
}

.extension-infobox-description {
font-weight: normal !important;
text-align: left;
background-color: #f1f3f9;
padding: 20px 10px 20px 10px !important;
}

.extension-infobox-first-row {
vertical-align: top;
padding: 20px 10px 0 10px;
}

.extension-infobox-row {
vertical-align: top;
padding: 0 10px;
}

.extension-infobox-last-row {
vertical-align: top;
padding: 0 10px 20px 10px;
}

.extension-infobox-helppage {
font-weight: normal;
text-align: center;
vertical-align: top;
padding-left: 10px;
padding-top: 10px;
padding-bottom: 10px;
background-color: #eeeeee;
}

.extension-infobox.fullwidth {
width: 100%;
float: none;
font-size: 1em;
margin-left: 0;
}

.extension-infobox.fullwidth th {
text-align: right;
}

.extension-infobox-header,
.extension-infobox-helppage {
text-align: center !important;
font-size: 1.1em
}

.extension-infobox.fullwidth th,
.extension-infobox.fullwidth td {
padding: 8px;
width: 100px;
border: 1px solid #ffffff;
}

.extension-infobox.fullwidth td {
width: 300px;
}

.extension-infobox-helppage {
background-color: #eaecf0;
}

.flexbox {
display: flex;
flex-direction: row;
flex-wrap: wrap;
justify-content: flex-start;
align-items: stretch;
align-content: stretch;
}

#content #bodyContent #importdata h3 {
margin: 1em 0 1.4em;
}

#importdata .flexbox {
justify-content: space-between;
margin-top: 2em;
}

#mw-content-text #importdata .flexbox h3,
[class^="mw-content-"] #importdata .flexbox h3 {
background: #d8d8d9;
margin: 0 0 12px 0;
padding: 8px;
font-size: 1em !important;
font-weight: bold
}

#importdata .mw li {
margin-left: 0;
list-style-type: none;
padding-left: 30px;
background: no-repeat left 1px top 3px / 18px url('/w/nsfr_img_auth.php/c/c6/MediaWiki-2020-small-icon.svg');
}

#importdata .bs li {
margin-left: 0;
list-style-type: none;
padding-left: 30px;
background: no-repeat left 2px top 4px / 15px url('/w/nsfr_img_auth.php/c/c4/Bluespice_Icon.svg');
}

#importdata .flexbox div {
background: #f1f3f9;
text-align: left;
margin: 0;
flex-basis: 33%;
padding: 0
}

#importdata table.wikitable>tr>th,
#importdata table.wikitable>*>tr>th,
table.wikitable.reference>tr>th,
.importdata .wikitable.reference>*>tr>th {
background-color: #eaecf0;
text-align: left;
padding: 8px;
border: 1px solid #ffffff
}

#importdata table.wikitable>tr>td,
#importdata table.wikitable>*>tr>td,
#importdata table.wikitable.reference>tr>td,
#importdata table.wikitable.reference>*>tr>td {
padding: 8px;
border: 1px solid #ffffff;
}

#importdata div .inner {
padding: 8px 12px
}

#importdata .bs p {
font-size: 0.9rem;
margin-left: 2.1em;
display: list-item;
}

.smwtable-clean {
width: auto;
max-width: 100%;
margin-bottom: 20px;
background-color: transparent;
border-spacing: 0px;
}

.smwtable-clean tr>th {
padding: 8px !important;
line-height: 1.42857143;
vertical-align: top;
border-top: 1px solid #dddddd;
border-collapse: collapse;
border-spacing: 0;
text-align: center;
vertical-align: middle;
}

.smwtable-clean tr>td {
padding: 8px !important;
line-height: 1.42857143;
vertical-align: top;
border-top: 1px solid #dddddd;
border-collapse: collapse;
border-spacing: 0;
}

.smwtable-clean tbody>tr:nth-child(even) {
background-color: #f5f5f5;
}

/* See ERM45154 */
html {
filter: none !important;
color-scheme: light !important;
}

/* Permissionsmatrix */

.matrix td,
.matrix th {
font-size: 0.85em
}

.wikitable th,
.wikitable td {
padding: 10px;
vertical-align: top
}

th.firstcol-sm {
width: 200px !important
}

/*Lingo tooltip */
.qtip {
font-size: 0.9em;
}

/*hf- styling für subpage box */
.hf-navbox {background: #f2f3f9; padding:1em; margin-bottom:2em}
.hf-subpages .subpagelist ul { margin-top:1em; margin-bottom:1em; column-count:3 }
#mw-content-text .hf-subpages .subpagelist li {margin-top:0}
.hf-subpages .default {display:none; line-height:0; overflow:hidden} /*avoid empty space if there are no subpages*/