{{DISPLAYTITLE:BlueSpice farm}}{{Featureseite|featured=true|featuredesc=Whitepaper: BlueSpice at Enterprise Scale für Anwendungsfälle im Maßstab von 10.000 Sub-Wikis. (englisch)|featurestart=12.05.2026}}{{Hinweisbox|boxtype=Hinweis|Note text=Die Erweiterung '''BlueSpiceWikiFarm''' muss separat erworben werden und ist kein automatischer Bestandteil von BlueSpice pro.}}{{Whitepaper|title=BlueSpice at Enterprise Scale|description=Technisches Briefing für den Lead Architect und das DevOps-/Operations-Team zur Evaluierung der betrieblichen Auswirkungen des Betriebs einer BlueSpice-Farm in einem Umfang von 10.000 Sub-Wikis.|filename=Whitepaper BlueSpice at Enterprise Scale EN.pdf}}

'''Wiki farm''' ist eine Architektur für BlueSpice Wikis, mit der mehrere Wikis zentral verwaltet werden können. Wikis können erstellt, geklont, gelöscht und deaktiviert werden. Dafür wird eine Verwaltungsoberfläche zur Verfügung gestellt. Durch die Architektur wird auch die Wartung der Wikis erleichtert, da sich alle Wikis in der Farm in einem Schwung updaten lassen.
__TOC__
== Farmverwaltung ==

=== Begriffe ===

* '''Wiki farm:''' Zentrale Verwaltung aller vorhandenen Wikis
* '''Wurzelwiki:''' Das Wiki, das als Verwaltungswiki für alle Wiki-Instanzen funktioniert
* '''Wiki-Instanz:''' Ein einzelnes Wiki innerhalb der Farm
* '''Musterwiki:''' Ein Wiki, das die Inhalte zur Vorbefüllung bereitstellt und durch klonen vervielfältigt werden kann

=== Zugriff ===
Die einzelnen Wiki-Instanzen werden auf der Seite <code>Special:FarmManagement</code> im Stammwiki verwaltet.

Diese Seite ist über das Menü „Globale Aktionen“ {{Bsvs|bsvFrom=5.1.2}} erreichbar.
[[Datei:global actions - Administration.png|alternativtext=Administrationslinks im Menü "Globale Aktionen"|zentriert|mini|450x450px|Globale Aktionen]]
In der Liste aller Spezialseiten (<code>Spezial:Spezialseiten</code>) findet man die Farmverwaltung im Abschnitt ''Andere Spezialseiten''.

Die Farmverwaltung zeigt eine Auflistung aller vorhanden Wiki-Instanzen mit Informationen zu:

* ''Name:'' Link zur Wiki-Instanz
* ''Global durchsuchbar:'' Durchsuchbar über alle Wiki-Instanzen.
* Erstellungsdatum
* Stichwörter (Metainformationen)
* Beschreibung (Metainformationen)

Diese Liste kann sortiert und gefiltert werden.

== Funktionen ==
In der Verwaltungsoberfläche lässt sich ein:

* Wiki erstellen
* Wiki klonen
* Wiki bearbeiten
* Wiki abschalten (archivieren)
* Wiki löschen
* Wiki von der globalen Suche ausschließen
* Wiki mit Metainformationen (Beschreibung, Gruppe, Stichwort) versehen

=== Wiki erstellen ===
Über die Schaltfläche ''Wiki erstellen'' läßt sich eine neue Wiki-Instanz einrichten:

# '''Geben''' Sie den Namen der neuen Wiki-Instanz an.
# '''Geben''' Sie die gewünschten Einstellungen ein. Wenn das Wiki global durchsuchbar ist, wird es von anderen Wiki-Instanzen in der Volltextsuche berücksichtigt.
# '''Wählen''' Sie aus, ob Sie ein Leeres Wiki erstellen möchten oder die Inhalte und Konfigurationen einer bestehenden Instanz kopieren möchten. Bei einer Kopie geben Sie den entsprechenden Pfad-Namen des zu kopierenden Wikis im Feld ''Quellpfad'' ein.
# '''Klicken''' ''Sie'' Erstellen.

Wiki-Instanzen benötigen eine eindeutige URL, um sie im Browser aufrufbar zu machen. Der Pfad wird automatisch aus dem eingegebenen Namen generiert.

'''Ein Beispiel:'''

Die Wiki farm ist unter der URL <code><nowiki>https://wiki.bluespice.com</nowiki></code> aufrufbar.

Beim erstellen der neuen Wiki-Instanz wurde der Websitetitel "hallo welt" gewählt. Daraus generiert sich der Pfad und damit die URL der neuen Wiki-Instanz als <code><nowiki>https://wiki.bluespice.com/hallo-welt</nowiki></code>.
{{Hinweisbox|boxtype=Hinweis|Note text=Websitetitel und Pfad können nachträglich nicht geändert werden.}}

=== Wiki klonen ===
Um ein Wiki zu klonen, muss erst ein bereits erstelltes Wiki als Quelle ausgewählt werden. Ein Klick auf den Listeneintrag aktiviert die Schaltfläche ''Wiki klonen''.

Im Gegensatz zum Erstellen eines neuen Wikis werden beim Klonen bereits die Inhalte und Daten mitübergeben.

Folgende Inhalte und Einstellungen werden übernommen:

* Alle Seiten (auch aus den Nicht-Inhaltsnamensräumen wie MediaWiki, Vorlage, Formular, Attribut, usw.)
* Alle hochgeladenen Dateien
* Konfigurationseinstellungen über die Wiki-Spezialseiten (z.B. Benutzer, Benutzergruppen, Rechteverwaltung)

Folgende Einstellungen werden nicht übernommen:

* Benutzereinstellungen (z.B. Benachrichtigungseinstellungen)

=== Wiki löschen ===
'''So löschen Sie eine Wiki-Instanz:'''

# '''Wählen''' Sie das Wiki aus der Liste.
# '''Klicken''' Sie auf ''Wiki löschen''. Es öffnet sich der entsprechende Dialog. Darin wird lediglich der Pfad des Wiki abgefragt. Dieser entspricht dem Namen der Wiki-Instanz, so wie er in der Farmverwaltung gelistet ist.
# '''Geben''' Sie den Wiki-Namen in genauer Schreibweise (Trennzeichen, Groß- und Kleinschreibung) in das Feld '''ein'''.
# '''Klicken''' Sie ''Löschen''. Das Wiki wird komplett gelöscht.

=== Wiki abschalten (archivieren) ===
Wenn Sie ein Wiki nicht direkt löschen, sondern die Inhalte vorsichtshalber noch aufbewahren möchten, können Sie dieses auch abschalten und damit archivieren. Das Abschalten bewirkt, dass das Wiki nicht mehr zugänglich ist. Bei dem Versuch, dieses über die URL aufzurufen erfolgt eine Umleitung auf die Farmverwaltung.

Abgeschaltene Wiki-Instanzen bleiben in der Liste der Farmverwaltung, werden aber durchgestrichen dargestellt und der Websitetitel linkt nicht mehr auf die Instanz. Ein abgeschaltetes Wiki kann nachträglich wieder angeschaltet werden.

=== Metainformationen erstellen ===
Den einzelnen Wikis können über die Schaltfläche ''Wiki Metainformationen bearbeiten'' zusätzliche Metadaten zugeordnet werden. Folgende Meta-Informationen sind möglich:

* Beschreibung
* Gruppe
* Stichwörter

Sind in ''Gruppe'' und ''Stichwörter'' bereits von anderen Wikis Informationen vorhanden, werden diese auch in einem Dropdown-Menü zur Auswahl angeboten.

Die Beschreibung und die Stichwörter werden in der Liste der Farmverwaltung als Information hinterlegt. Dadurch werden diese auch filterbar und sortierbar. Bei der Gruppe verhält es sich anders, denn diese bewirkt eben eine Gruppierung der Wikis in der Liste. Die Gruppen können ein- und ausgeklappt werden.

=== Gruppen und Stichwörter anlegen ===
Gruppen und Stichwörter werden direkt im Dialogfenster für Metainformationen angelegt.

* '''Gruppe:''' Wenn Sie für eine Wiki-Instanz eine neue Gruppe brauchen, tippen Sie den Gruppennamen einfach im Textfeld ein und klicken anschließend ''Fertig''.
* '''Stichwort:''' Wenn Sie ein neues Stichwort anlegen wollen, tippen Sie das Stichwort im Textfeld ein und schließen Sie das Stichwort mit einem Komma ab.

== Zulässige Namen und Pfadangaben ==
Beim Erstellen und Klonen eines Wikis können Leerzeichen oder Umlaute bei der Eingabe des Websitetitels verwendet werden. Leerzeichen werden im Pfad automatisch zu Bindestrichen und Umlaute entsprechend umgewandelt, z.B. "ü" zu "ue". Auch Groß- und Kleinschreibung ist möglich und wird berücksichtigt.

Beim Löschen einer Wiki-Instanz muss die Eingabe genau mit der Pfadangabe übereinstimmen, damit das Wiki gelöscht werden kann.

== Logs ==
Alle Aktionen werden in einem Logfile (Wiki farm management) auf ''Spezial:Logs'' hinterlegt, sodass sie jederzeit nachvollziehbar sind.

== Authentifizierung ==
Neben der Standard-Authentifizierung direkt im Wiki ist auch ein Comfort-Sign-on möglich. Hierbei gibt es Unterschiede zwischen einer On-Premise Installation und der Cloud:

{| class="wikitable"
|+Vergleich von Comfort Sign-On Optionen
! style="" |Anmeldungsart
! style="" |On-Premise
! style="" |Cloud
|-
| style="" |SAML
| style="" |mehrere Identity-Provider möglich
| style="" |nur 1 Identity-Provider für alle Instanzen
|-
| style="" |OpenID Connect
| style="" |unterschiedliche ID-Provider nutzbar
(zentral konfigurierbar)
| style="" |unterschiedliche ID-Provider nutzbar
(muss in jeder Instanz separat konfiguriert werden)
|-
| style="" |Benutzersession
| style="" |geteilte Benutzersession möglich
| style="" |keine geteilte Benutzersession, separate Anmeldung in Instanzen erforderlich
|}
{{Box Links|Thema1=[[Handbuch:Erweiterung/ContentTransfer|Inhalte zwischen Wiki-Instanzen transferieren ]]|Thema2=}}
{{translation}}

Handbuch:Erweiterung/BlueSpiceWikiFarm

2026-05-12T10:11:08Z

Margit.link-rodrigue:

{{DISPLAYTITLE:BlueSpice farm}}{{Featureseite|featured=true|featuredesc=Whitepaper: BlueSpice at Enterprise Scale für Anwendungsfälle im Maßstab von 10.000 Sub-Wikis. (englisch)|featurestart=05/12/2026}}{{Hinweisbox|boxtype=Hinweis|Note text=Die Erweiterung '''BlueSpiceWikiFarm''' muss separat erworben werden und ist kein automatischer Bestandteil von BlueSpice pro.}}{{Whitepaper|title=BlueSpice at Enterprise Scale|description=Technisches Briefing für den Lead Architect und das DevOps-/Operations-Team zur Evaluierung der betrieblichen Auswirkungen des Betriebs einer BlueSpice-Farm in einem Umfang von 10.000 Sub-Wikis.|filename=Whitepaper BlueSpice at Enterprise Scale EN.pdf}}

'''Wiki farm''' ist eine Architektur für BlueSpice Wikis, mit der mehrere Wikis zentral verwaltet werden können. Wikis können erstellt, geklont, gelöscht und deaktiviert werden. Dafür wird eine Verwaltungsoberfläche zur Verfügung gestellt. Durch die Architektur wird auch die Wartung der Wikis erleichtert, da sich alle Wikis in der Farm in einem Schwung updaten lassen.
__TOC__
== Farmverwaltung ==

=== Begriffe ===

* '''Wiki farm:''' Zentrale Verwaltung aller vorhandenen Wikis
* '''Wurzelwiki:''' Das Wiki, das als Verwaltungswiki für alle Wiki-Instanzen funktioniert
* '''Wiki-Instanz:''' Ein einzelnes Wiki innerhalb der Farm
* '''Musterwiki:''' Ein Wiki, das die Inhalte zur Vorbefüllung bereitstellt und durch klonen vervielfältigt werden kann

=== Zugriff ===
Die einzelnen Wiki-Instanzen werden auf der Seite <code>Special:FarmManagement</code> im Stammwiki verwaltet.

Diese Seite ist über das Menü „Globale Aktionen“ {{Bsvs|bsvFrom=5.1.2}} erreichbar.
[[Datei:global actions - Administration.png|alternativtext=Administrationslinks im Menü "Globale Aktionen"|zentriert|mini|450x450px|Globale Aktionen]]
In der Liste aller Spezialseiten (<code>Spezial:Spezialseiten</code>) findet man die Farmverwaltung im Abschnitt ''Andere Spezialseiten''.

Die Farmverwaltung zeigt eine Auflistung aller vorhanden Wiki-Instanzen mit Informationen zu:

* ''Name:'' Link zur Wiki-Instanz
* ''Global durchsuchbar:'' Durchsuchbar über alle Wiki-Instanzen.
* Erstellungsdatum
* Stichwörter (Metainformationen)
* Beschreibung (Metainformationen)

Diese Liste kann sortiert und gefiltert werden.

== Funktionen ==
In der Verwaltungsoberfläche lässt sich ein:

* Wiki erstellen
* Wiki klonen
* Wiki bearbeiten
* Wiki abschalten (archivieren)
* Wiki löschen
* Wiki von der globalen Suche ausschließen
* Wiki mit Metainformationen (Beschreibung, Gruppe, Stichwort) versehen

=== Wiki erstellen ===
Über die Schaltfläche ''Wiki erstellen'' läßt sich eine neue Wiki-Instanz einrichten:

# '''Geben''' Sie den Namen der neuen Wiki-Instanz an.
# '''Geben''' Sie die gewünschten Einstellungen ein. Wenn das Wiki global durchsuchbar ist, wird es von anderen Wiki-Instanzen in der Volltextsuche berücksichtigt.
# '''Wählen''' Sie aus, ob Sie ein Leeres Wiki erstellen möchten oder die Inhalte und Konfigurationen einer bestehenden Instanz kopieren möchten. Bei einer Kopie geben Sie den entsprechenden Pfad-Namen des zu kopierenden Wikis im Feld ''Quellpfad'' ein.
# '''Klicken''' ''Sie'' Erstellen.

Wiki-Instanzen benötigen eine eindeutige URL, um sie im Browser aufrufbar zu machen. Der Pfad wird automatisch aus dem eingegebenen Namen generiert.

'''Ein Beispiel:'''

Die Wiki farm ist unter der URL <code><nowiki>https://wiki.bluespice.com</nowiki></code> aufrufbar.

Beim erstellen der neuen Wiki-Instanz wurde der Websitetitel "hallo welt" gewählt. Daraus generiert sich der Pfad und damit die URL der neuen Wiki-Instanz als <code><nowiki>https://wiki.bluespice.com/hallo-welt</nowiki></code>.
{{Hinweisbox|boxtype=Hinweis|Note text=Websitetitel und Pfad können nachträglich nicht geändert werden.}}

=== Wiki klonen ===
Um ein Wiki zu klonen, muss erst ein bereits erstelltes Wiki als Quelle ausgewählt werden. Ein Klick auf den Listeneintrag aktiviert die Schaltfläche ''Wiki klonen''.

Im Gegensatz zum Erstellen eines neuen Wikis werden beim Klonen bereits die Inhalte und Daten mitübergeben.

Folgende Inhalte und Einstellungen werden übernommen:

* Alle Seiten (auch aus den Nicht-Inhaltsnamensräumen wie MediaWiki, Vorlage, Formular, Attribut, usw.)
* Alle hochgeladenen Dateien
* Konfigurationseinstellungen über die Wiki-Spezialseiten (z.B. Benutzer, Benutzergruppen, Rechteverwaltung)

Folgende Einstellungen werden nicht übernommen:

* Benutzereinstellungen (z.B. Benachrichtigungseinstellungen)

=== Wiki löschen ===
'''So löschen Sie eine Wiki-Instanz:'''

# '''Wählen''' Sie das Wiki aus der Liste.
# '''Klicken''' Sie auf ''Wiki löschen''. Es öffnet sich der entsprechende Dialog. Darin wird lediglich der Pfad des Wiki abgefragt. Dieser entspricht dem Namen der Wiki-Instanz, so wie er in der Farmverwaltung gelistet ist.
# '''Geben''' Sie den Wiki-Namen in genauer Schreibweise (Trennzeichen, Groß- und Kleinschreibung) in das Feld '''ein'''.
# '''Klicken''' Sie ''Löschen''. Das Wiki wird komplett gelöscht.

=== Wiki abschalten (archivieren) ===
Wenn Sie ein Wiki nicht direkt löschen, sondern die Inhalte vorsichtshalber noch aufbewahren möchten, können Sie dieses auch abschalten und damit archivieren. Das Abschalten bewirkt, dass das Wiki nicht mehr zugänglich ist. Bei dem Versuch, dieses über die URL aufzurufen erfolgt eine Umleitung auf die Farmverwaltung.

Abgeschaltene Wiki-Instanzen bleiben in der Liste der Farmverwaltung, werden aber durchgestrichen dargestellt und der Websitetitel linkt nicht mehr auf die Instanz. Ein abgeschaltetes Wiki kann nachträglich wieder angeschaltet werden.

=== Metainformationen erstellen ===
Den einzelnen Wikis können über die Schaltfläche ''Wiki Metainformationen bearbeiten'' zusätzliche Metadaten zugeordnet werden. Folgende Meta-Informationen sind möglich:

* Beschreibung
* Gruppe
* Stichwörter

Sind in ''Gruppe'' und ''Stichwörter'' bereits von anderen Wikis Informationen vorhanden, werden diese auch in einem Dropdown-Menü zur Auswahl angeboten.

Die Beschreibung und die Stichwörter werden in der Liste der Farmverwaltung als Information hinterlegt. Dadurch werden diese auch filterbar und sortierbar. Bei der Gruppe verhält es sich anders, denn diese bewirkt eben eine Gruppierung der Wikis in der Liste. Die Gruppen können ein- und ausgeklappt werden.

=== Gruppen und Stichwörter anlegen ===
Gruppen und Stichwörter werden direkt im Dialogfenster für Metainformationen angelegt.

* '''Gruppe:''' Wenn Sie für eine Wiki-Instanz eine neue Gruppe brauchen, tippen Sie den Gruppennamen einfach im Textfeld ein und klicken anschließend ''Fertig''.
* '''Stichwort:''' Wenn Sie ein neues Stichwort anlegen wollen, tippen Sie das Stichwort im Textfeld ein und schließen Sie das Stichwort mit einem Komma ab.

== Zulässige Namen und Pfadangaben ==
Beim Erstellen und Klonen eines Wikis können Leerzeichen oder Umlaute bei der Eingabe des Websitetitels verwendet werden. Leerzeichen werden im Pfad automatisch zu Bindestrichen und Umlaute entsprechend umgewandelt, z.B. "ü" zu "ue". Auch Groß- und Kleinschreibung ist möglich und wird berücksichtigt.

Beim Löschen einer Wiki-Instanz muss die Eingabe genau mit der Pfadangabe übereinstimmen, damit das Wiki gelöscht werden kann.

== Logs ==
Alle Aktionen werden in einem Logfile (Wiki farm management) auf ''Spezial:Logs'' hinterlegt, sodass sie jederzeit nachvollziehbar sind.

== Authentifizierung ==
Neben der Standard-Authentifizierung direkt im Wiki ist auch ein Comfort-Sign-on möglich. Hierbei gibt es Unterschiede zwischen einer On-Premise Installation und der Cloud:

{| class="wikitable"
|+Vergleich von Comfort Sign-On Optionen
! style="" |Anmeldungsart
! style="" |On-Premise
! style="" |Cloud
|-
| style="" |SAML
| style="" |mehrere Identity-Provider möglich
| style="" |nur 1 Identity-Provider für alle Instanzen
|-
| style="" |OpenID Connect
| style="" |unterschiedliche ID-Provider nutzbar
(zentral konfigurierbar)
| style="" |unterschiedliche ID-Provider nutzbar
(muss in jeder Instanz separat konfiguriert werden)
|-
| style="" |Benutzersession
| style="" |geteilte Benutzersession möglich
| style="" |keine geteilte Benutzersession, separate Anmeldung in Instanzen erforderlich
|}
{{Box Links|Thema1=[[Handbuch:Erweiterung/ContentTransfer|Inhalte zwischen Wiki-Instanzen transferieren ]]|Thema2=}}
{{translation}}

Vorlage:Whitepaper

2026-05-12T10:10:08Z

Margit.link-rodrigue:

<div style="float:right; width:340px"><div class="d-flex justify-content-end my-4">{{#fas:}}
<div class="card shadow-sm border-0" style="max-width: 340px; margin-left:20px">
<div class="card-header bg-light fw-semibold"><i class="fas fa-file-pdf text-danger me-2"></i>Whitepaper</div>
<div class="card-body">
<h3 class="card-title fs-6" style="margin:0">{{{title|}}}</h3>
<p class="card-text small text-muted">
{{{description|}}}
</p>
<i class="fas fa-download me-1"></i> [[Media:{{{filename|}}}|PDF herunterladen]]
</div>
</div>
</div></div>
<noinclude>
<templatedata>
{
"params": {
"title": {
"label": "Title",
"description": {
"de": "Titel"
},
"required": true
},
"description": {
"description": {
"en": "Description",
"de": "Beschreibung"
},
"required": true
},
"filename": {
"label": "File (e.g. myfile.pdf)",
"description": {
"de": "Dateiname"
},
"type": "wiki-file-name",
"required": true
}
},
"description": {
"en": "Whitepaper infobox",
"de": "Whitepaper download"
}
}
</templatedata>
</noinclude>

2026-04-30T14:28:42Z

Margit.link-rodrigue:

Datei:HW-Profilgalerie.7z

2026-04-30T14:26:22Z

Margit.link-rodrigue: Leere Seite erstellt

2026-04-21T14:21:24Z

Margit.link-rodrigue: (Benutzername entfernt) (Logbucheinzelheiten entfernt)

#WEITERLEITUNG [[Handbuch:Erweiterung/BlueSpiceInsertCategory]]

Handbuch:Erweiterung/BlueSpiceInsertCategory

2026-04-21T14:21:24Z

Margit.link-rodrigue: (Benutzername entfernt) (Logbucheinzelheiten entfernt)

{{DISPLAYTITLE:Kategorien}}
<bookshelf src="Buch:Benutzerhandbuch" />
Kategorien sind eine Software-Funktion von MediaWiki. Für Kategorien wird automatisch eine Indexseite erstellt.

Seiten können kategorisiert werden, indem Kategorie-Tags zum Inhalt hinzugefügt werden. Diese Tags generieren Links am Ende der Seite, welche zu einer Übersicht über alle Seiten der gleichen Kategorie führen. Dies ermöglicht ein einfaches Durchsuchen von verwandten Artikeln.
==Wie benutze ich Kategorien?==
Kategorien sind neben Namensräumen ein wichtiges Organisationsprinzip im Wiki. Sie ermöglichen es, Seiten zu gruppieren und auf den zugehörigen Kategorienseiten automatisch zu verlinken.
Kategorien werden normalerweise von Benutzern erstellt. In besonderen Fällen weist MediaWiki jedoch auch automatisch generierte Kategorien zu (z. B. ''Seiten mit fehlerhaften Links'').

==Merkmale==
*'''Kategorienbaum:''' Kategorien können unter Hauptkategorien organisiert werden.
*'''Tagging ("Verschlagwortung")''': Kategorien können genutzt werden, um Seiten spontan zu "verschlagworten".
*'''Kategoriensystem:''' Über die Kategorienverwaltung lassen sich Kategorien systematisch anlegen und von allen Benutzern verwendet werden.
*'''Mehrere Kategorien pro Seite''': Eine Seite kann mehreren Kategorien zugeordnet werden.
*'''Unabhängig von Namensräumen''': Kategorien sind immer im gesamten Wiki gültig.
*'''Seitenabfragen: '''Kategorien sind für Erweiterungen wie [[Handbuch:Erweiterung/BlueSpiceSmartList|Smartlist]] oder Semantic Mediawiki nützlich, da sie als Abfrage-Filter verfügbar sind.

==Kategorien zuweisen==
<div class="training anwender">Um eine Seite Kategorien zuzuordnen, gibt es verschiedene Möglichkeiten:

#Im [[Handbuch:Erweiterung/BlueSpiceDiscovery#Ergänzungsbereich|Ergänzungsbereich]] am Seitenende
#Über das Optionsmenü von [[Handbuch:Erweiterung/VisualEditor|VisualEditor]] (Visuelle Bearbeitung)
#Über manuelle Eingabe als [[Handbuch:Wikitext|Wikitext]] (Quelltextbearbeitung)
#Über den Link ''[[Handbuch:Erweiterung/BlueSpiceDiscovery#Seitenwerkzeuge|Seitenwerkzeuge > ...alle Aktionen > Kategorie einfügen]]''
<gallery widths="200" heights="200">
Datei:Handbuch:1647506685380.png|alt=Ergänzungsbereich |Ergänzungsbereich
Datei:Handbuch:1647506812482.png|alt=Visueller Editor|Visueller Editor
Datei:Handbuch:Kategorien im Wikitext.png|alt=Wikitext|Wikitext
Datei:Handbuch:alle aktionen - kategorien.png|alt=Link "alle Aktionen"|Link "alle Aktionen"
</gallery></div>

===Im Ergänzungsbereich am Seitenende===
Der Ergänzungsbereich enthält ein Feld für die Kategoriezuweisung. Jeder Benutzer mit Bearbeitungsrechten kann auf den Bearbeitungslink klicken, um Kategorien zur Seite hinzuzufügen oder daraus zu entfernen. Um alle vorhandenen Kategorien mit Unterkategorien anzuzeigen, können Sie auf das Baumsymbol klicken. Sobald Sie fertig sind, werden die Kategorien mit dem Häkchen bestätig.

<span style="color: rgb(37, 37, 37); font-family: Lato, "sans-serif"; font-size: 15px; font-style: normal; font-variant-ligatures: normal; font-variant-caps: normal; font-weight: 400; letter-spacing: normal; orphans: 2; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; widows: 2; word-spacing: 0px; -webkit-text-stroke-width: 0px; background-color: rgb(255, 255, 255); text-decoration-thickness: initial; text-decoration-style: initial; text-decoration-color: initial; display: inline !important; float: none;">Außerdem läßt sich die Anzeige der Kategorien über die</span> [[Handbuch:Erweiterung/BlueSpiceConfigManager#Positionierung%20von%20Skin-Elementen|Konfigurationsverwaltung]] <span style="color: rgb(37, 37, 37); font-family: Lato, "sans-serif"; font-size: 15px; font-style: normal; font-variant-ligatures: normal; font-variant-caps: normal; font-weight: 400; letter-spacing: normal; orphans: 2; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; widows: 2; word-spacing: 0px; -webkit-text-stroke-width: 0px; background-color: rgb(255, 255, 255); text-decoration-thickness: initial; text-decoration-style: initial; text-decoration-color: initial; display: inline !important; float: none;">in den Titelbereich verschieben.</span><br />
[[Datei:GUI-category-autofill.png|zentriert|mini|450x450px|Eine Kategorie zuweisen|verweis=Special:FilePath/GUI-category-autofill.png|alternativtext=Konfigurationsbereich zum zuordnen einer Kategorie]]

===Im visuellen Editor (VisualEditor)===
Im Seitenoptionen-Menü von [[Handbuch:Erweiterung/VisualEditor|VisualEditor]] gibt es den Menüpunkt Kategorien. Hier können Sie Kategoriezuweisungen zur Seite im Bearbeitungsmodus aktualisieren sowie der Kategorie einen Sortierschlüssel hinzufügen.
<br />
[[Datei:VE-category-DE.png|alt=Menü von VisualEditor|zentriert|mini|300x300px|Optionsmenü von VisualEditor]]

===In Wikitext===
Öffnen Sie einen Artikel, den Sie einer Kategorie zuordnen wollen im Bearbeitungsmodus. Geben Sie nun an einer beliebigen Stelle im Wiki-Code (meist allerdings am Ende der Seite) z.B. Folgendes ein:
<syntaxhighlight lang="text">
[[Category:Produktion]]
oder
[[Kategorie:Produktion]]
</syntaxhighlight>

{{Hinweisbox|boxtype=Hinweis|Note text=Auf Kategorienseiten werden Umlaute am Ende der Liste aufgeführt, z.B. "Märchen" nach "Muh". Sie können die Variable <nowiki>{{DEFAULTSORT:sortkey}}</nowiki> benutzen,um einen Alternativtitel für die Sortierung zu erstellen (z.B. <nowiki>{{DEFAULTSORT:Maerchen}}</nowiki>).}}

Beachten Sie, dass:

:*Kategorien in beliebiger Anzahl und von jedem Nutzer erzeugt werden können. Bevor Sie also einfach loslegen, prüfen Sie deswegen am besten immer, welche Kategorien bereits vorhanden sind, um unnötige Doppelungen zu vermeiden.
:*eine Seite grundsätzlich natürlich mehreren Kategorien zugeordnet werden kann.
:*der Ort im Quelltext, an dem die Zuordnung eingebaut wird, technisch irrelevant ist. Allerdings ist es Konvention, Kategorien '''am Ende eines Artikels''' einzufügen.<code><nowiki/></code>

==Links auf Kategorienseiten==
Für Links direkt auf eine Kategorienseite ist ein Doppelpunkt vor dem Namensraum erforderlich.

Beispiel: <code><nowiki>[[:Kategorie: new_page]]</nowiki></code>

Wenn dieser Doppelpunkt fehlt, wird der Artikel nicht mit der Kategorieseite verknüpft, sondern der Artikel der entsprechenden Kategorie zugewiesen.
==Kategorienseite==
Wenn Benutzer auf eine Kategorie klicken, wird dieSeite ''Kategorie:Kategorie_Name'' geladen. Dort werden alle Seiten und Medien aufgelistet, die einer bestimmten Kategorie zugeordnet sind.

Wenn Sie eine bisher noch nicht angelegte- rot verlinkte - Kategorienseite anklicken, haben Sie die Möglichkeit, die Kategorienseite zu erstellen.
==Anzeige aller Kategorienseiten ==
[[Datei:Spezial_Categories.png|alternativtext=Link zu Spezialseite um bestehende Kategorien im Wiki anzuschauen]]

Auf der Spezialseite <code>Spezial:Kategorien</code> können Sie sich eine Liste aller bestehender Kategorien im Wiki anzeigen lassen. Klicken Sie auf eine Kategorie, um zur entsprechenden Kategorienseite zu gelangen. Ist eine Seite in der Auflistung rot unterlegt, wurde die Kategorie bisher nur verlinkt, die zugehörige Kategorienseite aber noch nicht erstellt.

== Welche Seiten können kategorisiert werden? ==
Ob eine Seite kategorisiert werden kann, hängt von ihrem Seiteninhaltsmodell ab. Generell können alle Seiten in Inhaltsnamensräumen kategorisiert werden, da sie dem Seiteninhaltsmodell <code>wikitext</code> entsprechen.

Das Inhaltsmodell einer Seite kann über die Werkzeugleiste > Seiteninformationen > allgemein ermittelt werden. Ab BlueSpice {{Bsvs|bsvFrom=5.1.7}} ist es möglich, Seiten mit weiteren Seiteninhaltsmodellen zu verschlagworten:

* book
* FormDefinition (Erweiterung:[[Handbuch:Erweiterung/Forms|Forms]])
* BPMN (Erweiterung:[[Handbuch:Erweiterung/CognitiveProcessDesigner|CognitiveProcessDesigner]])
* css
* javascript

* json
* mail_template
* pdfcreator_template (Erweiterung:[[Handbuch:Erweiterung/PDFCreator|PDFCreator]])

==Kategorieverwaltung==
Die einfachste Möglichkeit zum Verwalten von Kategorien und Unterkategorien ist die Seite ''Spezial: Kategorieverwaltung''. Die [[Handbuch:Erweiterung/BlueSpiceCategoryManager|Kategorieverwaltung]] kann über den Menüpunkt ''Globale Aktionen > Bearbeiten > Kategorien'' erreicht werden.

Die Kategorieverwaltung erlaubt das Anlegen einer Baumstruktur. Machen Sie sich daher Gedanken über sinnvolle Haupt- und Unterkategorien. Um den Kategorienbaum nachvollziehen zu können, bietet es sich an, mit einer Wurzelkategorie (z.B. 1-Wiki) zu beginnen.

Wenn über die Kategorienverwaltung eine Kategorie umbenannt wird, dann wird der Kategorienname auch auf allen Seiten, die diese Kategorie verwenden, umbenannt.

{{Box_Links | Thema1 = [[Handbuch:Erweiterung/BlueSpiceCategoryManager|Kategorieverwaltung]] | Thema2 =[https://www.mediawiki.org/wiki/Help:Categories/de https://www.mediawiki.org/wiki/Help:Categories/de]}}

[[de:{{FULLPAGENAME}}]]
[[en:Manual:Creating and using categories]]

[[Category:Konzept]]
[[Category:Organisation]]

Handbuch:Erweiterung/BlueSpiceInsertCategory

2026-04-21T14:20:38Z

Margit.link-rodrigue:

Handbuch:Erweiterung/BlueSpiceTranslationTransfer

2026-04-21T13:57:46Z

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'''
** Ein Link zu einer Wiki-Seite verlinkt auf die Ursprungsseite im Quellwiki, falls sie nicht ins im Zielwiki existiert.Beispiel:
*** Wenn die deutsche Seite A auf die deutsche Seite B verlinkt, wird die englische Übersetzungsseite A auf die deutsche Seite B verlinkt, wenn die Seite B im Zielwiki nicht existiert.
*** Wenn die deutsche Seite A auf die deutsche Seite B verlinkt, wird die englische Übersetzungsseite A auf die englische Übersetzungsseite B verlinkt, wenn die Seite B im Zielwiki existiert.
* '''Eingebundene Dateien (png, jpg, gif,...)''' werden ins Zielwiki übertragen:
** Der Dateiname wird beibehalten
** Die Beschreibung und der Alternativtext von eingebetteten Dateien werden übersetzt
* '''Vorlagen:''' Vorlagen werden übertragen, falls sie im Ziel-Wiki nicht vorhanden sind
* '''Magische Wörter''' werden in ihre kanonische Bezeichnung (EN) übersetzt
* '''Codeblöcke''' selbst werden nicht übersetzt; Kommentare in Code-Blöcken werden übersetzt
{{Textbox|boxtype=note|header=Hinweis:|text=Einschränkung: Wenn eine Seite zu groß ist, kann die DeepL API sie nicht übersetzen. Die beste Möglichkeit ist, die Seite in kleinere Unterseiten aufzuteilen.|icon=yes}}

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

* '''Medien (pdf, docx, pdf,...):''' Die Linkbeschreibung wird übersetzt, das Dokument selbst wird jedoch nicht übertragen. Es muss manuell hochgeladen werden, falls eine zielsprachliche Version des Dokuments lokal vorhanden ist.
* '''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.
* '''Dateianhänge:''' Dateien werden nicht ins Zielwiki übertragen, wenn sie nur als Anhänge über das <code><nowiki><attachments></nowiki></code>-Tag auf einer Seite angezeigt werden.
* '''Transkludierte Seiten:''' Transkludierte Seiten werden derzeit ohne Übersetzung in das Zielwiki übertragen.
* '''Codeblöcke''' selbst werden nicht übersetzt; Kommentare innerhalb von Codeblöcken werden ü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>

=== Bilddateien 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]]

Kategorie:BlueSpice farm

2026-04-21T13:55:53Z

Margit.link-rodrigue: Leere Seite erstellt

Handbuch:Erweiterung/BlueSpiceTranslationTransfer

2026-04-21T13:55:45Z

Margit.link-rodrigue: Updated page categories

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 ===
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):
[[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'''
** Ein Link zu einer Wiki-Seite verlinkt auf die Ursprungsseite im Quellwiki, falls sie nicht ins im Zielwiki existiert.Beispiel:
*** Wenn die deutsche Seite A auf die deutsche Seite B verlinkt, wird die englische Übersetzungsseite A auf die deutsche Seite B verlinkt, wenn die Seite B im Zielwiki nicht existiert.
*** Wenn die deutsche Seite A auf die deutsche Seite B verlinkt, wird die englische Übersetzungsseite A auf die englische Übersetzungsseite B verlinkt, wenn die Seite B im Zielwiki existiert.
* '''Eingebundene Dateien (png, jpg, gif,...)''' werden ins Zielwiki übertragen:
** Der Dateiname wird beibehalten
** Die Beschreibung und der Alternativtext von eingebetteten Dateien werden übersetzt
* '''Vorlagen:''' Vorlagen werden übertragen, falls sie im Ziel-Wiki nicht vorhanden sind
* '''Magische Wörter''' werden in ihre kanonische Bezeichnung (EN) übersetzt
* '''Codeblöcke''' selbst werden nicht übersetzt; Kommentare in Code-Blöcken werden übersetzt
{{Textbox|boxtype=note|header=Hinweis:|text=Einschränkung: Wenn eine Seite zu groß ist, kann die DeepL API sie nicht übersetzen. Die beste Möglichkeit ist, die Seite in kleinere Unterseiten aufzuteilen.|icon=yes}}

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

* '''Medien (pdf, docx, pdf,...):''' Die Linkbeschreibung wird übersetzt, das Dokument selbst wird jedoch nicht übertragen. Es muss manuell hochgeladen werden, falls eine zielsprachliche Version des Dokuments lokal vorhanden ist.
* '''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.
* '''Dateianhänge:''' Dateien werden nicht ins Zielwiki übertragen, wenn sie nur als Anhänge über das <code><nowiki><attachments></nowiki></code>-Tag auf einer Seite angezeigt werden.
* '''Transkludierte Seiten:''' Transkludierte Seiten werden derzeit ohne Übersetzung in das Zielwiki übertragen.
* '''Codeblöcke''' selbst werden nicht übersetzt; Kommentare innerhalb von Codeblöcken werden ü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>

=== Bilddateien 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]]

Vorlagen Download/Transklusion

2026-04-17T06:55:55Z

Margit.link-rodrigue:

<div class="downloadarea">
<span class="getButton">[[Medium:HW-SektionTranskludiert.zip|Download]]</span>

[[File:HW-transclusion.png|450x450px]]
</div>Diese Vorlage ermöglicht es, einen Abschnitt aus einer Wiki-Seite auf einer anderen Seite einzubinden. Sie kann als farbige Box gestaltet werden.

== Import der Vorlage ==
Die benötigte Import-Datei befindet sich im Archiv ''HW-SektionTranskludiert.zip''. Sie enthält die Datei ''HW-SektionTranskludiert.xml''.

Führen Sie auf der Seite <code>Spezial:Import</code> in Ihrem Wiki folgende Schritte durch:

#'''Entpacken''' Sie die zip-Datei.
#'''Klicken''' Sie ''Browse...'' und wählen Sie die Datei ''HW-SektionTranskludiert.xml''.
#'''Geben''' Sie ein Interwiki-Präfix '''an'''. Da dieses Feld erforderlich ist, geben Sie hier einfach ''hw'' (für hallowelt) ein.
#Belassen Sie die Vorauswahl ''Zu den Standard-Speicherorten'' importieren.
#'''Klicken''' Sie ''Datei hochladen...'' .

Die Vorlage ist nun in Ihrem Wiki verfügbar.

==Enthaltene Importdateien==
Der xml-Import erstellt folgende Datei in Ihrem Wiki:

*Vorlage:Transklusion
*Vorlage:Transklusion/styles.css

==Anwendung==

#'''Fügen''' Sie die Vorlage über den [[Handbuch:Erweiterung/VisualEditor|visuellen Editor]] ein.
#'''Füllen''' Sie die Eingabefelder wie benötigt aus.

{{Textbox|boxtype=note|header=Hinweis|text=Falls nach dem Importieren der Vorlage in Ihr Wiki die Eingabefelder beim ersten Einfügen in eine Wiki-Seite nicht angezeigt werden, müssen Sie die Vorlage im Vorlagen-Namensraum öffnen, eine Änderung vornehmen (z. B. Leerzeichen einfügen) und die Vorlage speichern. Danach sollten die Eingabefelder korrekt angezeigt werden.}}

{| class="contenttable-blue" style="width:950px;"
|+ style="box-sizing: inherit; padding-top: 8px; padding-bottom: 8px; color: rgb(119, 119, 119); text-align: left;" |
! style="background-color:rgb(239, 243, 249);text-align:inherit;box-sizing:inherit;padding:4px;border:1px solid rgb(177, 185, 207);color:rgb(62, 83, 137);" |Eingabefeld
! style="background-color:rgb(239, 243, 249);text-align:inherit;box-sizing:inherit;padding:4px;border:1px solid rgb(177, 185, 207);color:rgb(62, 83, 137);" |Beschreibung
|- style="box-sizing: inherit; border: 1px solid rgb(177, 185, 207); border-spacing: 0px; border-collapse: collapse; padding: 10px;"
| style="box-sizing:inherit;padding:10px;border:1px solid rgb(177, 185, 207);border-spacing:0px;border-collapse:collapse;" |Seite, die transkludiert werden soll
| style="box-sizing:inherit;padding:10px;border:1px solid rgb(177, 185, 207);border-spacing:0px;border-collapse:collapse;" |Voller Seitenname der Seite, die den zu transkludierenden Abschnitt beinhaltet (mit Namensraumpräfix falls zutreffend)
|- style="box-sizing: inherit; border: 1px solid rgb(177, 185, 207); border-spacing: 0px; border-collapse: collapse; padding: 10px;"
| style="box-sizing:inherit;padding:10px;border:1px solid rgb(177, 185, 207);border-spacing:0px;border-collapse:collapse;" |Seitenabschnitt
| style="box-sizing:inherit;padding:10px;border:1px solid rgb(177, 185, 207);border-spacing:0px;border-collapse:collapse;" |Überschrift des Abschnitts, der eingebunden werden soll. Enthält ein Abschnitt Unterüberschriften, werden diese bis zur nächsten Überschrift derselben Ebene des Abschnitts mit einbezogen.
|- style="box-sizing: inherit; border: 1px solid rgb(177, 185, 207); border-spacing: 0px; border-collapse: collapse; padding: 10px;"
| style="box-sizing:inherit;padding:10px;border:1px solid rgb(177, 185, 207);border-spacing:0px;border-collapse:collapse;" |Farbschema
| style="box-sizing:inherit;padding:10px;border:1px solid rgb(177, 185, 207);border-spacing:0px;border-collapse:collapse;" |Wenn Sie eine Hintergrundfarbe anwenden möchten, können Sie diese hier auswählen. Zur Verfügung stehen: blau, grün, grau, rot, gelb.
|- style="box-sizing: inherit; border: 1px solid rgb(177, 185, 207); border-spacing: 0px; border-collapse: collapse; padding: 10px;"
| style="box-sizing:inherit;padding:10px;border:1px solid rgb(177, 185, 207);border-spacing:0px;border-collapse:collapse;" |Hintergrundfarbe
| style="box-sizing:inherit;padding:10px;border:1px solid rgb(177, 185, 207);border-spacing:0px;border-collapse:collapse;" |Wenn Ihnen keine der Farbvarianten gefällt, können Sie [https://www.w3schools.com/colors/colors_picker.asp Ihre eigene Farbe im Hexadezimalformat eingeben] (z. B. #cce6ff).
|- style="box-sizing: inherit; border: 1px solid rgb(177, 185, 207); border-spacing: 0px; border-collapse: collapse; padding: 10px;"
| style="box-sizing:inherit;padding:10px;border:1px solid rgb(177, 185, 207);border-spacing:0px;border-collapse:collapse;" |Umrandung
| style="box-sizing:inherit;padding:10px;border:1px solid rgb(177, 185, 207);border-spacing:0px;border-collapse:collapse;" |Erstellt eine Rahmenfarbe. Nur verwenden, wenn Sie eine benutzerdefinierte Hintergrundfarbe nutzen, anstatt einer Farbvorlage (die bereits eine eigene Rahmenfarbe enthält).
|- style="box-sizing: inherit; border: 1px solid rgb(177, 185, 207); border-spacing: 0px; border-collapse: collapse; padding: 10px;"
| style="box-sizing:inherit;padding:10px;border:1px solid rgb(177, 185, 207);border-spacing:0px;border-collapse:collapse;" |Innenabstand
| style="box-sizing:inherit;padding:10px;border:1px solid rgb(177, 185, 207);border-spacing:0px;border-collapse:collapse;" |Abstand zwischen Rahmen und Inhalt der Box. Standardwert: 20px. Sie können hier jeden anderen Pixelwert angeben oder einfach 0 eintragen, wenn kein Innenabstand gewünscht ist.
|}