Handbuch:Erweiterung/MenuEditor: Unterschied zwischen den Versionen

Version vom 10. Dezember 2021, 08:52 Uhr

Benutzer mit Admin-Rechten (Berechtigung:editinterface) können die Navigationslinks in der Hauptnavigation anpassen.

Wie funktioniert die Hauptnavigation?[Bearbeiten | Quelltext bearbeiten]

Standardmäßig werden in der Hauptnavigation einige Einstiegslinks angezeigt. Wiki-Administratoren können diese Links bei Bedarf deaktivieren und zusätzliche Links anlegen. Es können keine hierarchischen Links angelegt werden. Damit die Hauptnavigation nicht zu umfangreich wird, ist es sinnvoll, hier hauptsächlich Links zu den wichtigsten Themen sowie zu weiterführenden Portalseiten einzurichten.

Datei:Handbuch:skin-discovery-hauptseitenleiste.png

Hauptnavigation

Links hinzufügen[Bearbeiten | Quelltext bearbeiten]

So fügen Sie neue Links hinzu:

Öffnen Sie über die Browser-Adressleiste die Seite MediaWiki:Sidebar.
Wechseln Sie in den Bearbeitungsmodus.
Erstellen Sie einen Navigationslink mit folgender Syntax: *Zielseite|Beschriftung Im folgenden Beispiel erstellen wir einen Link zur Wikiseite "Firma" mit der Beschriftung "Unsere Firma" und einen externen link zur BlueSpice Website mit der Bezeichung "Website". Die Links sind unter der Überschrift "Wichtige Infos" gruppiert:
```
*Wichtige Infos
**Firma|Unsere Firma
**https//www.bluespice.com/de|Website
```
Speichern Sie die Seite. Der Link wird nun in der Hauptnavigation angezeigt.

Hinweis:Sobald Sie mindestens einen Zusatzlink angelegt haben, wird Ihnen ein direkter Bearbeitungslink zur Seite MediaWiki:Sidebar angezeigt, wenn Sie mit der Maus über einen Zusatzlink fahren (siehe vorhergehender Screenshot),.

Unter Umständen kann es zu Kollisionen von Linkbezeichnungen mit Systemnachrichten kommen. Ist dies der Fall, so hängen Sie der Bezeichnung einfach den HTML-Code für ein Leerzeichen an:

**Portal|Portal&#160;

So fügen Sie eine Überschrift ein:

Wechseln Sie in den Bearbeitungsmodus der Seite MediaWiki:Sidebar.
Erstellen Sie über einer Gruppe von Zusatzlinks eine Überschrift mit folgender Syntax (eine Verlinkung der Überschrift ist nicht möglich): *Meine Überschrift
Speichern Sie die Seite. Die Überschrift wird nun in der Hauptnavigation angezeigt.

Standardlinks deaktivieren[Bearbeiten | Quelltext bearbeiten]

Die Standardlinks können über die Konfigurationsverwaltung deaktiviert werden. Folgende Einstellungen sind hierbei unter dem Menüpunkt "Benutzeroberfläche" zu fnden:

BlueSpiceDiscovery:

Einstiegspunkt "Hauptseite" anzeigen
Einstiegspunkt "Alle Seiten" anzeigen
Einstiegspunkt "Letzte Änderungen" anzeigen

BlueSpiceSocial:

Einstiegspunkt "Timeline" anzeigen

BlueSpiceSocialBlog:

Einstiegspunkt "Blog" anzeigen

Gruppenspezifische Navigation[Bearbeiten | Quelltext bearbeiten]

Mithilfe von UserFunctions ist es möglich, Navigationselemente nur für bestimmte Benutzergruppen anzuzeigen. Beachten Sie, dass innerhalb dieser Funktion der Trennstrich (|) zwischen Seitenname und Bezeichnung als {{!}} maskiert werden muss.

{#ifingroup:sysop,widgeteditor |
*Test2                       
**somepage{{!}}Some page
|}}

Zusätzliche Anpassungen[Bearbeiten | Quelltext bearbeiten]

Weiterführende Links

Technische Referenz: MenuEditor

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

@@ Zeile 3: / Zeile 3: @@
 Benutzer mit Admin-Rechten (Berechtigung:''editinterface'') können die Navigationslinks in der Hauptnavigation anpassen.
-==Standardlinks deaktivieren==
+==Wie funktioniert die Hauptnavigation?==
-Die Standardlinks können über die Konfigurationsverwaltung deaktiviert werden. Folgende Einstellungen sind hierbei unter dem Menüpunkt "Benutzeroberfläche" zu fnden:
+Standardmäßig werden in der Hauptnavigation einige Einstiegslinks angezeigt. Wiki-Administratoren können diese Links bei Bedarf deaktivieren und zusätzliche Links anlegen. Es können keine hierarchischen Links angelegt werden. Damit die Hauptnavigation nicht zu umfangreich wird, ist es sinnvoll, hier hauptsächlich Links zu den wichtigsten Themen sowie zu weiterführenden [[Handbuch:Portalseiten|Portalseiten]] einzurichten.
+[[Datei:Handbuch:skin-discovery-hauptseitenleiste.png|alternativtext=Hauptnavigation|zentriert|mini|345x345px|Hauptnavigation]]
+== Links hinzufügen ==
-BlueSpiceDiscovery:
-*Einstiegspunkt "Hauptseite" anzeigen
+'''So fügen Sie neue Links hinzu:'''
-*Einstiegspunkt "Alle Seiten" anzeigen
-*Einstiegspunkt "Letzte Änderungen" anzeigen
-BlueSpiceSocial:
+# '''Öffnen''' Sie über die Browser-Adressleiste die Seite ''MediaWiki:Sidebar.''
+# '''Wechseln''' Sie in den Bearbeitungsmodus.
+# Erstellen Sie einen Navigationslink mit folgender Syntax:  <code>*Zielseite|Beschriftung</code>  Im folgenden Beispiel erstellen wir einen Link zur Wikiseite "Firma" mit der Beschriftung "Unsere Firma" und einen externen link zur BlueSpice Website mit der Bezeichung "Website". Die Links sind unter der Überschrift "Wichtige Infos" gruppiert:<syntaxhighlight lang="text">
+*Wichtige Infos
+**Firma|Unsere Firma
+**https//www.bluespice.com/de|Website
+</syntaxhighlight>
+# '''Speichern''' Sie die Seite. Der Link wird nun in der Hauptnavigation angezeigt.
-*Einstiegspunkt "Timeline" anzeigen
+{{Hinweisbox|boxtype=Hinweis|icon=|Note text=Sobald Sie mindestens einen Zusatzlink angelegt haben, wird Ihnen ein direkter Bearbeitungslink zur Seite MediaWiki:Sidebar angezeigt, wenn Sie mit der Maus über einen Zusatzlink fahren  (siehe vorhergehender Screenshot),.|bgcolor=}}
+Unter Umständen kann es zu Kollisionen von Linkbezeichnungen mit Systemnachrichten kommen. Ist dies der Fall, so hängen Sie der Bezeichnung einfach den HTML-Code für ein Leerzeichen an:<syntaxhighlight lang="text">
+**Portal|Portal&#160;
+</syntaxhighlight>
-BlueSpiceSocialBlog:
-*Einstiegspunkt "Blog" anzeigen
+'''So fügen Sie eine Überschrift ein:'''
-==Neue Menüs hinzufügen==
+# '''Wechseln''' Sie in den Bearbeitungsmodus der Seite ''MediaWiki:Sidebar''.
-Um den Bearbeitungslink zu aktivieren, fahren Sie mit der Maus über einen existierenden Navigationslink.Der Link ''Seitenleiste bearbeiten'' lädt die Seite ''MediaWiki:Sidebar.''
+# '''Erstellen''' Sie über einer Gruppe von Zusatzlinks  eine Überschrift mit folgender Syntax (eine Verlinkung der Überschrift ist nicht möglich):  <code>*Meine Überschrift</code>
+# '''Speichern''' Sie die Seite. Die Überschrift wird nun in der Hauptnavigation angezeigt.
-Die Menüs werden als Listen formatiert. Menütiteln wird ein Stern vorangestellt (*), den eigentlichen Links entsprechend zwei Sternchen (**).
+==Standardlinks deaktivieren==
+Die Standardlinks können über die [[Handbuch:Erweiterung/BlueSpiceConfigManager|Konfigurationsverwaltung]] deaktiviert werden. Folgende Einstellungen sind hierbei unter dem Menüpunkt "Benutzeroberfläche" zu fnden:
-Das folgend Beispiel erstellt zwei Menüs (Unternehmen, Externe Links) mit verschiedenen Links:<pre>* Unternehmen
-** Firma|Unsere Firma
-** Portal Technik|Technik
-** Vertrieb und Marketing|Vertrieb, Marketing, Projektmangement
-** Produkte und Dienstleistungen|Produkte und Dienstleistungen
-** Kategorie:Organisation|Kunden und Organisationen
-* Externe Links
-** https://www.wikipedia.org|Wikipedia
-</pre><div class="training maintainer">
-Die Syntax für Navigationslinks ist  <code style="box-sizing: inherit; font-family: monospace, Courier; font-size: 13.5px; padding: 1px 4px; color: black; background-color: rgb(249, 249, 249); border-radius: 2px; border: 1px solid rgb(221, 221, 221);">Seitenname|Beschriftung</code>
-</div><section end="training-maintainer" />
-Im Beispiel oben verlinkt die Beschriftung  ''Technik'' <span>zur Seite</span> ''Portal Technik'' .
-{{Hinweisbox|boxtype=note|Note text=Es ist nicht möglich, Unterpunkte zu den Navigationslinks zu erstellen (hierarchische Navigation).}}Unter Umständen kann es zu Kollisionen von Linkbezeichnungen mit Systemnachrichten kommen. Ist dies der Fall, so hängen Sie der Bezeichnung einfach den HTML-Code für ein Leerzeichen an:<syntaxhighlight lang="text">
-**Portal|Portal&#160;
-</syntaxhighlight>
-==Symbole anpassen==
-Sie können den Navigationslinks individuelle Symbole zuweisen, indem Sie das Styling mittels CSS anpassen. Nehmen wir an, Sie haben einen Link ''Softwarekatalog''.
-Um ein Buch-Symbol hinzuzufügen:
+BlueSpiceDiscovery:
-#'''Öffnen''' Sie die Seite ''MediaWiki:Common.css'' im Bearbeitungsmodus.
+*Einstiegspunkt "Hauptseite" anzeigen
-#'''Fügen''' Sie folgende Zeilen am Ende der Seite '''hinzu''' und speichern Sie sie ab.
+*Einstiegspunkt "Alle Seiten" anzeigen
-<syntaxhighlight lang="css">
+*Einstiegspunkt "Letzte Änderungen" anzeigen
-a#n-Softwarekatalog::before {
-    content: '\e970';
-    font-family: 'entypo';
-    margin-left: -20px;
-    padding-right: 4px;
-    vertical-align:middle;
-}
-</syntaxhighlight>Der Navigationslink hat nun ein Buchsymbol.
-[[Datei:Handbuch:nav-icons.png|alternativtext=Navigations-Icon|zentriert|mini|250x250px|Navigations-Icon]]
+BlueSpiceSocial:
-Damit die Änderung sichtbar wird, ist in der Regel ein Leeren des Browser-Caches (F5-Taste) notwendig. Sollte das angepasste Symbol nicht angezeigt werden, nachdem Sie den Browser-Cache geleert haben, folgen Sie der Anleitung [[Handbuch:Erweiterung/BlueSpiceDiscovery/Hauptnavigation anpassen#Navigationslinks mit Sonderzeichen|Navigationslinks mit Sonderzeichen]].
+*Einstiegspunkt "Timeline" anzeigen
-===Navigationslinks mit Sonderzeichen===
+BlueSpiceSocialBlog:
-Bei der Verwendung von Sonderzeichen kann es zu Schwierigkeiten kommen, da diese im HTML-Code der Browser-Seite umgewandelt werden. In diesem Fall klicken Sie mit der rechten Maustaste auf den entsprechenden Eintrag und wählen Sie, abhängig vom verwendeten Browser, "Untersuchen"  aus, um die Developer Toolbar zu öffnen.
-Dort wird Ihnen die ID des Links angezeigt.
-[[Datei:Handbuch:nav-inspector.png|alternativtext=Developer Toolbar|zentriert|mini|650x650px|Developer Toolbar]]
-Wenn Sie zum Beispiel die Linkbeschreibung Einführung in Semantic MediaWiki mit dem Buchsymbol darstellen wollen, kopieren Sie den Wert aus der ID des Links und fügen Sie folgende Formatierungsanweisung in ''MediaWiki:Common.css'' ein:
-<syntaxhighlight lang="css">
+*Einstiegspunkt "Blog" anzeigen
-a#n-Softwarekatalog::before,a[id="n-Einf.C3.BChrung-Semantic-MediaWiki"]::before  {content: '\e970';
-    font-family: 'entypo';margin-left: -20px;
-    padding-right: 4px;vertical-align:middle;
-}
-</syntaxhighlight>
-Nach dem Speichern von ''Common.css'' und dem erneuten Laden der Seite (über Tastaturtaste <code>F5</code>) wird Ihnen nun das gewünschte Symbol angezeigt.
-===Verfügbare Symbole===
-Alle verfügbaren Symbole können Sie auf einer [https://de.wiki.bluespice.com/w/extensions/BlueSpiceFoundation/resources/bs.icons.php Übersichtsseite] hier einsehen.
-In der oberen Zeile können Sie sich durch verschiedene Schriftarten klicken, darunter finden Sie die Icons mit den zugehörigen Zeichenschlüsseln. In <code>MediaWiki:Common.css</code> müssen Sie die Einträge <code>font-family</code> (Schriftart) und <code>content</code> (Zeichenschlüssel) entsprechend anpassen. Alternativ können Sie auch die BlueSpice
-==Gruppenspezifische Navigation==
+== Gruppenspezifische Navigation ==
-Es ist möglich, Navigationselemente nur für bestimmte Benutzergruppen anzuzeigen. Beachten Sie, dass innerhalb dieser Funktion der Trennstrich (|) zwischen Seitenname und Bezeichnung als <code><nowiki>{{!}}</nowiki></code> maskiert werden muss.<syntaxhighlight lang="text">
+Mithilfe von ''[[Referenz:UserFunctions|UserFunctions]]'' ist es möglich, Navigationselemente nur für bestimmte Benutzergruppen anzuzeigen. Beachten Sie, dass innerhalb dieser Funktion der Trennstrich (|) zwischen Seitenname und Bezeichnung als <code><nowiki>{{!}}</nowiki></code> maskiert werden muss.<syntaxhighlight lang="text">
 {#ifingroup:sysop,widgeteditor |
 *Test2
@@ Zeile 91: / Zeile 60: @@
 </syntaxhighlight>
-==Navigation in mehrsprachigen Wikis==
+== Zusätzliche Anpassungen ==
-In mehrsprachigen Wikis sollen natürlich nicht nur die Inhalte, sondern auch die Navigation in unterschiedlichen Sprachen verfügbar sein. Um einen neuen Navigationspunkt in MediaWiki anzulegen, benötigen Sie deshalb immer zwei Seiten, auf die die Navigation zurückgreift:
-*Zum einen eine Seite, die den Link auf die Zielseite enthält
-*Zum anderen eine Seite, die den Alias Namen, der in der Navigation auftauschen soll enthält
-==Spracheinstellungen unterstützen==
-Wenn Sie sicherstellen möchten, dass Ihre Menüpunkte in der Sprache angezeigt werden, die ein Benutzer unter ''Einstellungen'' festgelegt hat, müssen Sie für jeden Menüpunkt eine separate Nachrichtenseite bereitstellen. Diese Nachrichtenseiten müssen sich im Namensraum ''MediaWiki'' befinden. Da BlueSpice Englisch und Deutsch (sowohl de als auch de-formal) unterstützt, benötigen Sie drei Sprachseiten für jeden Menüpunkt in der Seitenleiste.
-Im folgenden Beispiel erstellen wir einen Menüpunkt namens Quality assurance für ein Wiki mit Hauptsprache Englisch. Ein Benutzer, der in seinen Einstellungen Deutsch (de) oder formales Deutsch (de-formal) angegeben hat, sollte stattdessen die Beschriftung ''Qualitätssicherung'' sehen.
-'''Um die Beschriftungen in den Sprachversionen EN, DE und DE-formal zu erstellen:'''
-#'''Erstellen oder bearbeiten''' Sie die Seite ''MediaWiki:QA'' und '''fügen''' Sie die englische Beschriftung '''hinzu''' (''Quality assurance''). '''Speichern''' Sie die Seite.
-#'''Erstellen oder bearbeiten''' Sie die Seite  ''MediaWiki:QA''/''de'' und '''fügen''' Sie die deutsche Beschriftung '''hinzu''' (''Qualitätssicherung''). '''Speichern''' Sie die Seite.
-#'''Erstellen oder bearbeiten''' Sie die Seite  ''MediaWiki:QA''/''de-formal'' und fügen Sie die deutsche Beschriftung (''Qualitätssicherung''). '''Speichern''' Sie die Seite.
-#Erstellen Sie den Link auf der Seite ''MediaWiki:Sidebar'': <code>**About_quality_assurance|QA</code> Hiermit wird in der Hauptnavigation ein Link zur Seite ''About Quality Assurance'' erstellt und die Beschriftung angezeigt, die sich auf den Nachrichtenseiten in verschiedenen Sprachen befindet. Um die Sprachen zu testen, gehen Sie in Ihrem Benutzerprofilmenü zu ''Einstellungen> Benutzerdaten''. Stellen Sie im Abschnitt ''Sprache'' die Sprache von Englisch auf Deutsch oder umgekehrt ein und speichern Sie die Einstellung. Die Sprache des Navigationslinks wird jetzt in der entsprechenden Sprache angezeigt.
-==Navigation in mehrsprachigen Wikis==
-{{Hinweisbox|boxtype=important|Note text=Diese Anleitung gilt nicht in einer Farmumgebung bzw. in getrennten Sprachwikis. Diese Anleitung benutzen Sie nur, wenn Sie Sprachen über Unterseiten pflegen.}}
-Wenn Sie Inhalte über Unterseiten in mehreren Sprachen pflegen, möchten Sie, dass Benutzer mit einer englischen Spracheinstellung  nicht nur die entsprechenden Menübezeichnungen sehen. Sie sollten auch auf die englische Seite geleitet werden, wenn sie auf den Menüpunkt klicken. Benutzer mit deutschen Spracheinstellungen sollten den deutschen Inhalt sehen, nachdem sie auf den deutschen Menülink geklickt haben. In diesem Fall müssen Sie zusätzlich zu den Sprachbezeichnungen separate Linkziele erstellen.{{Hinweisbox|boxtype=note|Note text=Um zu vermeiden, dass unterschiedliche Navigationsseiten für formales (de-formal) und informales Deutsch (de) eingerichtet werden müssen, können Sie eine Richtlinie erstellen, welche Spracheinstellung von Ihren Benutzern verwendet werden soll.}}
-Im vorherigen Abschnitt haben wir die Beschriftungen bereits erstellt, wenn ein Benutzer die Sprache wechselt. Jetzt müssen wir auch verschiedene Linkziele für diese Seiten erstellen. Wenn die Hauptsprache Englisch ist und die Seite ''About quality assurance'' heißt, können die Übersetzungen auf Unterseiten gefunden werden. Die deutsche Version befindet sich beispielsweise unter  ''About quality assurance/de''.
-'''So erstellen Sie die Linkziele zu den Sprachversionen der Seite:'''
-#'''Erstellen oder bearbeiten''' Sie die Seite ''MediaWiki:QA-url'' und '''fügen''' Sie den Link zur englischen Seite  ''About quality assurance'' '''hinzu'''. Der Link wird ohne Klammern im Klartext eingegeben. '''Speichern''' Sie die Seite.
-#'''Erstellen oder bearbeiten''' Sie die Seite ''MediaWiki:QA-url/de'' und '''fügen''' Sie den Text für die deutsche Seite '''hinzu''' (''About quality assurance''/''de''). Der Link wird ohne Klammern im Klartext eingegeben. '''Speichern''' Sie die Seite.
-#'''Erstellen oder bearbeiten''' Sie die Seite ''MediaWiki:QA-url/de-formal'' und '''fügen''' Sie den Text für die deutsche Seite '''hinzu''' ( ''About quality assurance''/''de-formal).'' Der Link wird ohne Klammern im Klartext eingegeben. '''Speichern''' Sie die Seite.
-Ändern Sie im Link zur Seite ''Quality Assurance'' von
-<code>** About_quality_assurance | QA</code>
-zu
-<code>** QA-url | QA</code>
-Dadurch wird der Sprachwechsel für die Zielseiten (QA-url) und für die Bezeichnung des Menüpunkts erreicht.
-Abhängig von den Spracheinstellungen des Benutzers wird der Benutzer jetzt direkt zur richtigen Sprachversion geleitet.
+* [[Handbuch:Erweiterung/BlueSpiceDiscovery/Hauptnavigation anpassen/Icons|Icons vor den Links anzeigen]]
+* [[Handbuch:Erweiterung/BlueSpiceDiscovery/Hauptnavigation anpassen/Sprachen|Navigation in mehrsprachigen Wikis]]
 <br />