2 Handbuch:Erweiterung/MenuEditor: Unterschied zwischen den Versionen

Keine Bearbeitungszusammenfassung
Markierung: 2017-Quelltext-Bearbeitung
Keine Bearbeitungszusammenfassung
 
(27 dazwischenliegende Versionen desselben Benutzers werden nicht angezeigt)
Zeile 1: Zeile 1:
<bookshelf src="Buch:Adminhandbuch" />
{{DISPLAYTITLE:Hauptnavigation anpassen}}__INHALTSVERZEICHNIS_ERZWINGEN__
{{DISPLAYTITLE:Hauptnavigation anpassen}}__INHALTSVERZEICHNIS_ERZWINGEN__


Benutzer mit Admin-Rechten (Berechtigung:''editinterface'') können die Navigationslinks in der Hauptnavigation anpassen.
==Einführung==
Die Hauptnavigation ist in der Desktop-Ansicht des Wikis die linke Seitenleiste. Die Inhalte dieser Navigationsleiste gelten für das gesamte Wiki und können nicht für bestimmte [[Namensraum|Namensräume]] angelegt werden. <gallery widths="250" heights="350">
Datei:skin-discovery-hautpnavigation4-4.png|Hauptnavigation ab BlueSpice 4.4
Datei:Handbuch:skin-discovery-hauptnavigation.png|Hauptnavigation BlueSpice -4.3
</gallery>In einem neuen Wiki werden unter der Überschrift ''Einstieg'' einige Standardlinks angezeigt:


==Standardlinks deaktivieren==
* Hauptseite: Link zurück zur Haupseite, wie standardmäßig auch das Wiki-Logo.
Die Standardlinks können über die Konfigurationsverwaltung deaktiviert werden. Folgende Einstellungen sind hierbei unter dem Menüpunkt "Benutzeroberfläche" zu fnden:
* [[Handbuch:Erweiterung/BlueSpiceBookshelf|Bücherregal]]: Hier werden alle Bücher, die im Wiki angelegt sind angezeigt. Wenn keine Bücher existieren, sollte dieser Link deaktiviert werden.
* Alle Seiten: Link zur Spezialseite ''Alle Seiten''. Über diese Seite werden alle Seiten nach Namensraum geordnet aufgelistet. Die Auflistung der Namensräume erfolgt nach Namensraum-ID.  Namensräume, die von Administratoren manuell angelegt wurden, werden am Ende der Auswahl angezeigt (nach dem Namensraum "Gadget").
* [[Handbuch:Erweiterung/BlueSpiceSocialBlog|Blog]]: Link zur Spezialseite Blog. Wird im Wiki kein Blog geführt, sollte dieser Link deaktiviert werden.
* Timeline: Link zur Spezialseite ''Timeline''. Diese Seite listet alle "sozialen" Einheiten (Beiträge mit Kommentarfunktion) des Wikis auf (z.B. Blogeinträge,  Diskussionsbeiträge oder neue Benutzerprofile)
* Letzte Änderungen: Link zur Spezialseite ''Letzte Änderungen''. Hier können die täglichen Seitenbearbeitungen und Seitenerstellungen nachverfolgt werden. Diese Seite ist hilfreich, um einen Überblick über die Inhalte und deren Pflege zu behalten. Es ist meistens sinnvoll, diesen Link anzubieten.


Zusätzlich können  in dieser Leiste Links hinzugefügt werden.  Damit die Hauptnavigation nicht zu umfangreich wird, ist es sinnvoll, hier Links zu den wichtigsten Themen sowie zu weiterführenden[[Handbuch:Startseitenvorlagen|Portalseiten]] einzurichten.
== 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 finden:<span><br /></span>


BlueSpiceDiscovery:
BlueSpiceDiscovery:
Zeile 19: Zeile 32:
BlueSpiceSocialBlog:
BlueSpiceSocialBlog:


*Einstiegspunkt "Blog" anzeigen
* Einstiegspunkt "Blog" anzeigen
 
== Hauptnavigationstyp einstellen ==
In der Konfigurationsverwaltung kann zwischen vier Menü-Einstellungen ausgewählt werden:
[[Datei:MenuEditor konfig.png|alternativtext=Formular mit Anzeige der vier Menütypen|zentriert|mini|650x650px|Menüeinstellung in der Konfigurationsverwaltung]]
 
# '''Mediawiki Sidebar:''' Eine einfache Auflistung von Links zu Wiki-Seiten (oft zu Portalseiten). Eine hierarchische Navigationsstruktur wird nicht unterstützt.
# '''Namensraum Hauptseiten:''' Erzeugt automatisch zu allen Seiten im Wiki mit der Syntax ''Namensraum-Präfix:Hauptseite'' (z.B. ''QM:Hauptseite'')
# '''Unterseitenbaum:''' Sinnvoll in einem Wiki, das die Seiten haupsächlich über [[Unterseiten erstellen|Unterseiten]] strukturiert.
# '''Erweiterte MediaWiki Sidebar:''' Eine Auflistung von Links zu Wikiseiten. Eine hierarchische Navigationsstruktur wird unterstützt. Seiten können mit ihrer Unterseitenstruktur aufklappbar angezeigt werden.


==Neue Menüs hinzufügen==
==Hauptnavigation bearbeiten==
Um den Bearbeitungslink zu aktivieren, fahren Sie mit der Maus über einen existierenden Navigationslink.Der Link ''Seitenleiste bearbeiten'' lädt die Seite ''MediaWiki:Sidebar.''
'''So öffnen Sie den Menü-Editor:'''


Die Menüs werden als Listen formatiert. Menütiteln wird ein Stern vorangestellt (*), den eigentlichen Links entsprechend zwei Sternchen (**).
# '''Klicken Sie''' <span>''Seitenleiste bearbeiten''. Dieser Link wird sichtbar, wenn Sie über bestehende Links hovern. Falls die Seite noch nicht existiert, wird anschließend eine entsprechende Notiz angezeigt und die Seite kann angelegt werden.</span>[[Datei:Handbuch:sidebar-anlegen.png|alternativtext=Seite MediaWiki:Sidebar anlegen|zentriert|mini|650x650px|Seite ''MediaWiki:Sidebar'' anlegen: (1) Meldung, (2) Bearbeiten-Schaltfläche]]


Das folgend Beispiel erstellt zwei Menüs (Unternehmen, Externe Links) mit verschiedenen Links:<pre>* Unternehmen
=== Mediawiki Sidebar ===
** Firma|Unsere Firma
Wenn Sie als Konfiguration "MediaWiki Sidebar" eingestellt haben, gehen Sie wie folgt vor.
** 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'' .
'''So fügen Sie eine neue Überschrift hinzu:'''
{{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:
# '''Klicken''' Sie auf ''Seitenleiste bearbeiten''. Dieser Link wird sichtbar, wenn Sie mit der Maus über den letzten Navigationslink fahren. Wenn die Seite noch nicht existiert, wird eine Meldung angezeigt.<section begin="menulinks" />
# '''Klicken''' Sie ''Neues Element hinzufügen''. [[Datei:Hauptnavigation anpassen 1667832227810.png|alternativtext=Menü-Überschrift hinzufügen|zentriert|mini|Menü-Überschrift hinzufügen|650x650px]]
# '''Geben''' Sie den Text für die Überschrift '''ein'''. Hinweis: In einem mehrsprachigen Wiki, geben Sie hier eine [[mediawikiwiki:Help:System_message/de|Systemnachricht]] ein.[[Datei:Hauptnavigation anpassen 1667832471587.png|alternativtext=Text für Menü-Überschrift|zentriert|mini|Text für Menü-Überschrift |550x550px]]


#'''Öffnen''' Sie die Seite ''MediaWiki:Common.css'' im Bearbeitungsmodus.
'''Links hinzufügen:'''
#'''Fügen''' Sie folgende Zeilen am Ende der Seite '''hinzu''' und speichern Sie sie ab.
<syntaxhighlight lang="css">
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]]


# '''Klicken''' Sie auf das Dropdown-Menu neben der Überschrift. Wählen Sie ''Neuen Unterpunkt hinzufügen.''[[Datei:Hauptnavigation anpassen 1667832120562.png|alternativtext=Link als Unterpunkt hinzufügen|zentriert|mini|250x250px|Link als Unterpunkt hinzufügen]]
# '''Geben''' Sie das Linkziel (Seitenname) und die Link-Bezeichnung (Label) '''ein'''.[[Datei:Hauptnavigation anpassen 1667832059786.png|alternativtext=Link erstellen|zentriert|mini|450x450px|Link erstellen]]
#'''Klicken''' Sie auf ''Fertig''.
#'''Wiederholen''' Sie die Schritte 1-3.
#'''Klicken''' Sie ''Änderungen speichern''.
<section end="menulinks" />


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]].
==== Quelltextbearbeitung ====
Alternativ können Sie die Seitenleiste auch in der Quelltextbearbeitung (Wikitext) anpassen.


===Navigationslinks mit Sonderzeichen===
'''So fügen Sie neue Links hinzu:'''
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">
# '''Klicken''' Sie auf ''Seitenleiste bearbeiten''. Dieser Link wird sichtbar, wenn Sie auf einen bereits existierenden Link mit der Maus fahren.
a#n-Softwarekatalog::before,a[id="n-Einf.C3.BChrung-Semantic-MediaWiki"]::before  {content: '\e970';
# '''Wechseln''' Sie in den Quelltext-Bearbeitungsmodus.
    font-family: 'entypo';margin-left: -20px;
# '''Erstellen''' Sie einen oder mehrere Navigationslinks (mit oder ohne Überschrift). 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">
    padding-right: 4px;vertical-align:middle;
*Wichtige Infos
}
**Firma|Unsere Firma
**https//www.bluespice.com/de|Website
</syntaxhighlight>
</syntaxhighlight>
# '''Speichern''' Sie die Seite. Die Links werden nun in der Hauptnavigation angezeigt.


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


===Verfügbare Symbole===
==== Gruppenspezifische Navigation ====
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
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 |
==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">
{#ifingroup:sysop,widgeteditor |
*Test2                       
*Test2                       
**somepage{{!}}Some page
**somepage{{!}}Some page
Zeile 91: Zeile 93:
</syntaxhighlight>
</syntaxhighlight>


==Navigation in mehrsprachigen Wikis==
{{Hinweisbox|boxtype=Hinweis|icon=|Note text=Wenn Sie im Quelltext über die Parserfunktion <code><nowiki>{{#ifingroup:...</nowiki> </code> Navigationselemente gruppenspezifisch anzeigen, dann müssen Sie die Hauptnavigation stets im Quelltext bearbeiten. Im visuellen Bearbeitungsmodus werden beim Speichern alle Parserfunktionen oder semantische Abfragen entfernt.|bgcolor=}}
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:'''
=== Erweiterte MediaWiki Sidebar ===
Wenn Sie in der Konfigurationsverwaltung "Erweiterte MediaWiki Sidebar" eingestellt haben, können Sie ein hierarchisches Menü erstellen. Hier bearbeiten Sie die Seite ''MediaWiki:Sidebar.json''. Es verfügt über die Grundfunktionalität der Standard-MediaWiki-Seitenleiste. Darüber hinaus unterscheidet es zwischen folgenden Unterelementen (=Knotentypen):


#'''Erstellen oder bearbeiten''' Sie die Seite ''MediaWiki:QA'' und '''fügen''' Sie die englische Beschriftung '''hinzu''' (''Quality assurance''). '''Speichern''' Sie die Seite.
==== Interner Link ====
#'''Erstellen oder bearbeiten''' Sie die Seite ''MediaWiki:QA''/''de'' und '''fügen''' Sie die deutsche Beschriftung '''hinzu''' (''Qualitätssicherung''). '''Speichern''' Sie die Seite.
Geben Sie einfach einen Link zu einer Wiki-Seite mit einem zusätzlichen Link-Label an. Sowohl der Seitenname als auch die Beschriftung können mithilfe einer Parser-Funktion erstellt werden.
#'''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==
Interner Link mit einer Variable.
{{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:'''
Interner Link mit einer Variable.


#'''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.
==== Externer Link ====
#'''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.
Identisch mit internem Link, Sie müssen jedoch eine vollständige URL zu einer externen Website angeben.
#'''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
=== Unterseitenbaum ===
Sie können den Namen einer Seite angeben, die über eine oder mehrere Unterseitenebenen verfügt. Sie können die Tiefe auf 6 Ebenen einstellen, wobei die übergeordnete Seite die erste Ebene ist. Das heißt, wenn Sie die erste Ebene der Unterseiten anzeigen möchten, würden Sie eine Tiefe von 2 wählen.


<code>** About_quality_assurance | QA</code>
Screenshot des Bearbeitungsfensters für ein Unterseitenbaumelement.


zu
Erstellen eines Unterseitenbaums mit dem Enhanced MenuEditor.


<code>** QA-url | QA</code>
Es ist nicht möglich, den Knotentyp (=Elementtyp) nach der Erstellung zu ändern. Erstellen Sie stattdessen nach Bedarf ein neues Element und löschen Sie das unerwünschte Element.


Dadurch wird der Sprachwechsel für die Zielseiten (QA-url) und für die Bezeichnung des Menüpunkts erreicht.
==== Für Gruppen anzeigen ====
Darüber hinaus kann die Sichtbarkeit eines Menüpunkts auf bestimmte Wiki-Gruppen eingeschränkt werden. Geben Sie im Feld „Für Gruppen anzeigen“ eine durch Kommas getrennte Liste von vorhandenen Wiki-Gruppen ein.


Abhängig von den Spracheinstellungen des Benutzers wird der Benutzer jetzt direkt zur richtigen Sprachversion geleitet.
==== CSS-Klassen ====
Sie können CSS-Klassen auch auf jedes Element anwenden, um benutzerdefinierte Stiloptionen zu erhalten. Die Stile müssen auf der Seite ''MediaWiki:Common.css'' definiert werden ([https://wiki.selfhtml.org/wiki/CSS/Tutorials/Einstieg/Stylesheets_einbinden CSS]-Kenntnisse erforderlich).


<br />
==Zusätzliche Anpassungen==
*[[Handbuch:Erweiterung/MenuEditor/Lange Bezeichnungen|Anzeige langer Link-Bezeichnungen]]
*[[Handbuch:Erweiterung/BlueSpiceDiscovery/Hauptnavigation anpassen/Icons|Icons vor den Links anzeigen]]
*[[Handbuch:Erweiterung/BlueSpiceDiscovery/Hauptnavigation anpassen/Sprachen|Navigation in mehrsprachigen Wikis]]


{{Box Links
{{Box Links
|Thema1=[[Vorlagen/Beispiel/Translate|Übersetzungen von Wikiseiten]]}}
|Thema1=[[Handbuch:Erweiterung/BlueSpiceDiscovery/Hauptnavigation_anpassen|Hauptnavigation anpassen]]|Thema2=[[Handbuch:Erweiterung/BlueSpiceCustomMenu|Zusatzmenü erstellen]]|Thema3=[[Handbuch:Erweiterung/BlueSpiceDiscovery/Fußleiste|Fußleistenlinks anpassen]]}}
[[de:{{FULLPAGENAME}}]]
[[de:{{FULLPAGENAME}}]]
[[en:Navigation]]
[[en:Manual:Extension/BlueSpiceDiscovery/Main_navigation]]
[[Category:Administration]]
[[Category:Administration]]
[[Category:Anpassung]]

Aktuelle Version vom 6. Dezember 2023, 16:14 Uhr


Einführung[Bearbeiten | Quelltext bearbeiten]

Die Hauptnavigation ist in der Desktop-Ansicht des Wikis die linke Seitenleiste. Die Inhalte dieser Navigationsleiste gelten für das gesamte Wiki und können nicht für bestimmte Namensräume angelegt werden.

In einem neuen Wiki werden unter der Überschrift Einstieg einige Standardlinks angezeigt:

  • Hauptseite: Link zurück zur Haupseite, wie standardmäßig auch das Wiki-Logo.
  • Bücherregal: Hier werden alle Bücher, die im Wiki angelegt sind angezeigt. Wenn keine Bücher existieren, sollte dieser Link deaktiviert werden.
  • Alle Seiten: Link zur Spezialseite Alle Seiten. Über diese Seite werden alle Seiten nach Namensraum geordnet aufgelistet. Die Auflistung der Namensräume erfolgt nach Namensraum-ID. Namensräume, die von Administratoren manuell angelegt wurden, werden am Ende der Auswahl angezeigt (nach dem Namensraum "Gadget").
  • Blog: Link zur Spezialseite Blog. Wird im Wiki kein Blog geführt, sollte dieser Link deaktiviert werden.
  • Timeline: Link zur Spezialseite Timeline. Diese Seite listet alle "sozialen" Einheiten (Beiträge mit Kommentarfunktion) des Wikis auf (z.B. Blogeinträge, Diskussionsbeiträge oder neue Benutzerprofile)
  • Letzte Änderungen: Link zur Spezialseite Letzte Änderungen. Hier können die täglichen Seitenbearbeitungen und Seitenerstellungen nachverfolgt werden. Diese Seite ist hilfreich, um einen Überblick über die Inhalte und deren Pflege zu behalten. Es ist meistens sinnvoll, diesen Link anzubieten.

Zusätzlich können in dieser Leiste Links hinzugefügt werden. Damit die Hauptnavigation nicht zu umfangreich wird, ist es sinnvoll, hier Links zu den wichtigsten Themen sowie zu weiterführendenPortalseiten einzurichten.

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 finden:

BlueSpiceDiscovery:

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

BlueSpiceSocial:

  • Einstiegspunkt "Timeline" anzeigen

BlueSpiceSocialBlog:

  • Einstiegspunkt "Blog" anzeigen

Hauptnavigationstyp einstellen[Bearbeiten | Quelltext bearbeiten]

In der Konfigurationsverwaltung kann zwischen vier Menü-Einstellungen ausgewählt werden:

Formular mit Anzeige der vier Menütypen
Menüeinstellung in der Konfigurationsverwaltung
  1. Mediawiki Sidebar: Eine einfache Auflistung von Links zu Wiki-Seiten (oft zu Portalseiten). Eine hierarchische Navigationsstruktur wird nicht unterstützt.
  2. Namensraum Hauptseiten: Erzeugt automatisch zu allen Seiten im Wiki mit der Syntax Namensraum-Präfix:Hauptseite (z.B. QM:Hauptseite)
  3. Unterseitenbaum: Sinnvoll in einem Wiki, das die Seiten haupsächlich über Unterseiten strukturiert.
  4. Erweiterte MediaWiki Sidebar: Eine Auflistung von Links zu Wikiseiten. Eine hierarchische Navigationsstruktur wird unterstützt. Seiten können mit ihrer Unterseitenstruktur aufklappbar angezeigt werden.

Hauptnavigation bearbeiten[Bearbeiten | Quelltext bearbeiten]

So öffnen Sie den Menü-Editor:

  1. Klicken Sie Seitenleiste bearbeiten. Dieser Link wird sichtbar, wenn Sie über bestehende Links hovern. Falls die Seite noch nicht existiert, wird anschließend eine entsprechende Notiz angezeigt und die Seite kann angelegt werden.
    Seite MediaWiki:Sidebar anlegen
    Seite MediaWiki:Sidebar anlegen: (1) Meldung, (2) Bearbeiten-Schaltfläche

Mediawiki Sidebar[Bearbeiten | Quelltext bearbeiten]

Wenn Sie als Konfiguration "MediaWiki Sidebar" eingestellt haben, gehen Sie wie folgt vor.

So fügen Sie eine neue Überschrift hinzu:

  1. Klicken Sie auf Seitenleiste bearbeiten. Dieser Link wird sichtbar, wenn Sie mit der Maus über den letzten Navigationslink fahren. Wenn die Seite noch nicht existiert, wird eine Meldung angezeigt.
  2. Klicken Sie Neues Element hinzufügen.
    Menü-Überschrift hinzufügen
    Menü-Überschrift hinzufügen
  3. Geben Sie den Text für die Überschrift ein. Hinweis: In einem mehrsprachigen Wiki, geben Sie hier eine Systemnachricht ein.
    Text für Menü-Überschrift
    Text für Menü-Überschrift

Links hinzufügen:

  1. Klicken Sie auf das Dropdown-Menu neben der Überschrift. Wählen Sie Neuen Unterpunkt hinzufügen.
    Link als Unterpunkt hinzufügen
    Link als Unterpunkt hinzufügen
  2. Geben Sie das Linkziel (Seitenname) und die Link-Bezeichnung (Label) ein.
    Link erstellen
    Link erstellen
  3. Klicken Sie auf Fertig.
  4. Wiederholen Sie die Schritte 1-3.
  5. Klicken Sie Änderungen speichern.

Quelltextbearbeitung[Bearbeiten | Quelltext bearbeiten]

Alternativ können Sie die Seitenleiste auch in der Quelltextbearbeitung (Wikitext) anpassen.

So fügen Sie neue Links hinzu:

  1. Klicken Sie auf Seitenleiste bearbeiten. Dieser Link wird sichtbar, wenn Sie auf einen bereits existierenden Link mit der Maus fahren.
  2. Wechseln Sie in den Quelltext-Bearbeitungsmodus.
  3. Erstellen Sie einen oder mehrere Navigationslinks (mit oder ohne Überschrift). 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
    
  4. Speichern Sie die Seite. Die Links werden nun in der Hauptnavigation angezeigt.

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;

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
|}}
Hinweis:Wenn Sie im Quelltext über die Parserfunktion {{#ifingroup:... Navigationselemente gruppenspezifisch anzeigen, dann müssen Sie die Hauptnavigation stets im Quelltext bearbeiten. Im visuellen Bearbeitungsmodus werden beim Speichern alle Parserfunktionen oder semantische Abfragen entfernt.


Erweiterte MediaWiki Sidebar[Bearbeiten | Quelltext bearbeiten]

Wenn Sie in der Konfigurationsverwaltung "Erweiterte MediaWiki Sidebar" eingestellt haben, können Sie ein hierarchisches Menü erstellen. Hier bearbeiten Sie die Seite MediaWiki:Sidebar.json. Es verfügt über die Grundfunktionalität der Standard-MediaWiki-Seitenleiste. Darüber hinaus unterscheidet es zwischen folgenden Unterelementen (=Knotentypen):

Interner Link[Bearbeiten | Quelltext bearbeiten]

Geben Sie einfach einen Link zu einer Wiki-Seite mit einem zusätzlichen Link-Label an. Sowohl der Seitenname als auch die Beschriftung können mithilfe einer Parser-Funktion erstellt werden.

Interner Link mit einer Variable.

Interner Link mit einer Variable.

Externer Link[Bearbeiten | Quelltext bearbeiten]

Identisch mit internem Link, Sie müssen jedoch eine vollständige URL zu einer externen Website angeben.

Unterseitenbaum[Bearbeiten | Quelltext bearbeiten]

Sie können den Namen einer Seite angeben, die über eine oder mehrere Unterseitenebenen verfügt. Sie können die Tiefe auf 6 Ebenen einstellen, wobei die übergeordnete Seite die erste Ebene ist. Das heißt, wenn Sie die erste Ebene der Unterseiten anzeigen möchten, würden Sie eine Tiefe von 2 wählen.

Screenshot des Bearbeitungsfensters für ein Unterseitenbaumelement.

Erstellen eines Unterseitenbaums mit dem Enhanced MenuEditor.

Es ist nicht möglich, den Knotentyp (=Elementtyp) nach der Erstellung zu ändern. Erstellen Sie stattdessen nach Bedarf ein neues Element und löschen Sie das unerwünschte Element.

Für Gruppen anzeigen[Bearbeiten | Quelltext bearbeiten]

Darüber hinaus kann die Sichtbarkeit eines Menüpunkts auf bestimmte Wiki-Gruppen eingeschränkt werden. Geben Sie im Feld „Für Gruppen anzeigen“ eine durch Kommas getrennte Liste von vorhandenen Wiki-Gruppen ein.

CSS-Klassen[Bearbeiten | Quelltext bearbeiten]

Sie können CSS-Klassen auch auf jedes Element anwenden, um benutzerdefinierte Stiloptionen zu erhalten. Die Stile müssen auf der Seite MediaWiki:Common.css definiert werden (CSS-Kenntnisse erforderlich).

Zusätzliche Anpassungen[Bearbeiten | Quelltext bearbeiten]

Weiterführende Links




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

Diskussionen