2 Handbuch:Das Konzept der Namensräume und Handbuch:Erweiterung/MenuEditor: Unterschied zwischen den Seiten

Version vom 12. Oktober 2022, 11:11 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.

Hauptnavigation

Links im Quelltext hinzufügen[Bearbeiten | Quelltext bearbeiten]

So fügen Sie neue Links hinzu:

Öffnen Sie über die Browser-Adressleiste die Seite MediaWiki:Sidebar. Wenn die Seite noch nicht existiert, legen Sie sie an.
Wechseln Sie in den Quelltext-Bearbeitungsmodus.
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
```
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.

Visueller Bearbeitungsmodus[Bearbeiten | Quelltext bearbeiten]

Visuelle Bearbeitung der Navigation ist ab BlueSpice 4.2 enthalten.

So fügen Sie neue Links hinzu:

Öffnen Sie über die Browser-Adressleiste die Seite MediaWiki:Sidebar. Wenn die Seite noch nicht existiert, wird eine Meldung angezeigt.

Seite MediaWiki:Sidebar anlegen: (1) Meldung, (2) Bearbeiten-Schaltfläche
Klicken Sie auf die Bearbeiten-Schaltfläche.
Klicken Sie Neues Stammelement hinzufügen. Dies fügt eine Menü-Überschrift hinzu.

Neues Stammelement
Geben Sie im Feld Text oder Systemnachricht (messagekey) eine Bezeichnung für ide Überschrift ein.

Text eingeben

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

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

@@ Zeile 1: / Zeile 1: @@
-<bookshelf src="Buch:Benutzerhandbuch" />
+<bookshelf src="Buch:Adminhandbuch" />
-==Was ist ein Namensraum?==
+{{DISPLAYTITLE:Hauptnavigation anpassen}}__INHALTSVERZEICHNIS_ERZWINGEN__
-[[Datei:BlueSpice3-ev-Namensraum.png|300x300px|link=https://youtu.be/HzF1IcfNHzQ
-|Erklärvideo auf Youtube: Namensräume (Dauer: 4:41 Min.)|mini]]Ein '''Namensraum''' dient dazu, ein Wiki in verschiedene Bereiche einzuteilen. So entstehen unterschiedliche "Sammlungen" von Seiten, die einen ähnlichen oder gleichen Verwendungszweck haben.
-Wir nehmen oft das Beispiel von Schränken, um das Prinzip der Namensräume deutlich zu machen. Es gibt Regale, auf die alle Zugriff haben. Es gibt Glasschränke mit Schloss, in die jeder hineinschauen aber nicht jeder alles bearbeiten kann. Es gibt geschlossene Holzschränke mit Schloss, da können nur ausgewählte Personen hineinschauen und arbeiten. Und jeder Schrank kann anders aussehen.
+Benutzer mit Admin-Rechten (Berechtigung:''editinterface'') können die Navigationslinks in der Hauptnavigation anpassen.
-Machen Sie sich zuerst mit den wichtigsten Merkmalen von Namensräumen vertraut, bevor Sie neue Namensräume anlegen.
+==Wie funktioniert die Hauptnavigation?==
+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-hauptnavigation.png|alternativtext=Hauptnavigation|zentriert|mini|345x345px|Hauptnavigation]]
-===Merkmale von Namensräumen===
+== Links im Quelltext hinzufügen==
-*'''Rechteverwaltung''':  <br />Jedem Namensraum können unterschiedliche Benutzerrechte zugewiesen werden. In einem internen Wiki ist das ein häufiger Grund, einen Namensraum anzulegen.  <br />
-*'''Aktivierung von Funktionen:'''  <br />In jedem Namensraum können unterschiedliche Funktionen aktiviert werden (z.B., [[Handbuch:Erweiterung/FlaggedRevs|Freigabefunktion]] oder [[Handbuch:Erweiterung/BlueSpiceReadConfirmation|Lesebestätigung]]).  <br />
-*'''Suchfunktion''':  <br />In der Suche kann der Suchbereich auf einzelne Namensräume eingegrenzt werden (Namensraumfilter).  <br />
-*'''Ein Namensraum pro Seite''':  <br />Eine Seite kann nur einem einzigen Namensraum zugeordnet werden. Der gleiche Seitenname in einem anderen Namensraum erstellt eine neue Seite.  <br />
-*'''Flache Struktur''':  <br />Ein Namensraum kann keine untergeordneten Namensräume besitzen.  <br />
-*'''Verknüpfung mit Dateien''':  <br />Hochgeladene Dateien können einem Namensraum zugeordnet sein und werden somit entsprechend verrechtet.
-=== Das Namensraum-Präfix ===
-In welchem Namensraum eine Seite liegt, läßt sich daran erkennen, dass der Seitenname ein sogenanntes Namensraum-Präfix, abgeschlossen mit einem Doppelpunkt, enthält:<syntaxhighlight lang="text">
-QM:Einkaufsprozess
-</syntaxhighlight>Die Seite Einkaufsprozess liegt also im Namensraum QM, weil sie beim Erstellen oder nachträglichen Umbennen der Seite mit dem Präfix <code>QM:</code> erstellt wurde.
-==Standard-Namensräume==
+'''So fügen Sie neue Links hinzu:'''
-BlueSpice verwendet unter anderem die 15 Standard-Namensräume und zwei sogenannte Pseudo-Namensräume aus MediaWiki:
-<br />
-{| class="wikitable tablefullwidth" style=""
+#'''Öffnen''' Sie über die Browser-Adressleiste die Seite ''MediaWiki:Sidebar.'' Wenn die Seite noch nicht existiert, legen Sie sie an.
-|-
+#'''Wechseln''' Sie in den Quelltext-Bearbeitungsmodus.
-!ID
+#'''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">
-!|'''Namespace (deutsch)'''
+*Wichtige Infos
-!|'''Funktion'''
+**Firma|Unsere Firma
-|-
+**https//www.bluespice.com/de|Website
-|
+</syntaxhighlight>
-||Medium
+#'''Speichern''' Sie die Seite. Der Link wird nun in der Hauptnavigation angezeigt.
-||Pseudo-Namensraum für hochgeladene Bilder und Dateien. Wird durch Pfad der Dateien ersetzt.
-|-
-|
-||Spezial
-||Pseudo-Namensraum für Spezialseiten.
-|-
-|0
-||(Seiten)
-||Diese werden ohne Präfix angegeben.
-|-
-|1
-||Diskussion
-||Namensraum für die Diskussionsseite zu jedem Wiki-Artikel. Ein Diskussionsnamensraum wird immer automatisch mit einem Namensraum angelegt und wieder gelöscht.
-|-
-|2
-||Benutzer
-||Benutzerseite. Wird für jeden eingeloggten Nutzer angelegt.
-|-
-|4
-||[Wiki-Name]
-||Angaben über das Wiki oder über das laufende Projekt. Hier: BlueSpice.
-|-
-|6
-||Datei
-||Beschreibung eines Bildes und anderer Dateien. Wird automatisch mit Versionsangaben und Informationen über das Vorkommen der Datei ergänzt
-|-
-|8
-||MediaWiki
-||Systemmeldungen. Eine vollständige Liste ist unter Spezial:AllMessages zu finden. Können nur von angemeldeten Benutzern verändert werden.
-|-
-|10
-||Vorlage
-||Vorlagen können in andere Seiten eingebunden werden.
-|-
-|12
-||Hilfe
-||Hier können Hilfeseiten zur Benutzung des Wikis gesammelt werden. Dies soll allen Benutzern einen schnellen Einstieg in das Wiki verschaffen.
-|-
-|14
-||Kategorie
-||Seiten können Kategorien zugeordnet werden, die dann in diesem Namenspace zugänglich sind.
-|}
+{{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>
-'''Standard Namensraum:''' Eine neue Inhaltsseite wird dem "Seiten"-Namensraum zugeordnet,  wenn der Seitenname kein Namensraumpräfix hat.
+'''So fügen Sie eine Überschrift ein:'''
-'''Pseudo Namensräume:''' Die zwei Pseudo Namensräume (Medium, Spezial) werden zwar wie normale Namensräume verwendet, es können jedoch weder Seiten angelegt noch vorhandene Seiten verändert werden.
+#'''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):  <code>*Meine Überschrift</code>
+#'''Speichern''' Sie die Seite. Die Überschrift wird nun in der Hauptnavigation angezeigt.
-Die meisten Seiten in den Namensräumen werden automatisch erzeugt:
+==Visueller Bearbeitungsmodus==
+{{BSVersion|bsvFrom=4.2|bsvTo=|bsvFeature=Visuelle Bearbeitung der Navigation}}
+'''So fügen Sie neue Links hinzu:'''
-*Spezialseiten werden vom System bei der Installation generiert.
+# '''Öffnen''' Sie über die Browser-Adressleiste die Seite ''MediaWiki:Sidebar.'' Wenn die Seite noch nicht existiert, wird eine Meldung angezeigt.[[Datei:Handbuch:sidebar-anlegen.png|alternativtext=Seite MediaWiki:Sidebar anlegen|zentriert|mini|650x650px|Seite ''MediaWiki:Sidebar'' anlegen: (1) Meldung, (2) Bearbeiten-Schaltfläche]]
-*Media- und Bildseiten entstehen mit dem Hochladen einer Datei.
+# '''Klicken''' Sie auf die ''Bearbeiten''-Schaltfläche.
-*Benutzerseiten werden immer dann erzeugt, wenn ein Nutzer sich zum ersten Mal anmeldet.
+# '''Klicken''' Sie ''Neues Stammelement'' hinzufügen. Dies fügt eine Menü-Überschrift hinzu. [[Datei:Handbuch:sidebar-neues stammelement.png|alternativtext=Neues Stammelement|zentriert|mini|650x650px|Neues Stammelement]]
-*Diskussionsseiten werden beim Anlegen eines Diskussionsbeitrags zu einer Seite erstellt.<br />
+# Geben Sie im Feld Text oder Systemnachricht (messagekey) eine Bezeichnung für ide Überschrift ein.  [[Datei:Handbuch:sidebar-stammelement-dialog.png|alternativtext=Text eingeben|zentriert|mini|650x650px|Text eingeben]]
-Weitere Namensräume werden auch durch installierte Erweiterungen erstellt (z.B. der Namensraum ''Konzept'' durch die Erweiterung Semantic MediaWiki).
+#
-== Einen eigenen Namensraum erstellen ==
+==Standardlinks deaktivieren==
-Zusätzliche Namensräume können durch Administratoren in der Namensraumverwaltung unter ''Globale Aktionen > Namensräume'' erstellt werden.   [[Handbuch:Erweiterung/BlueSpiceNamespaceManager|Mehr Infos zur Namensraumverwaltung finden Sie hier]].
+Die Standardlinks können über die [[Handbuch:Erweiterung/BlueSpiceConfigManager|Konfigurationsverwaltung]] deaktiviert werden. Folgende Einstellungen sind hierbei unter dem Menüpunkt "Benutzeroberfläche" zu fnden:
-=== Wann brauche ich einen neuen Namensraum? ===
-Wenn Sie ein neues Wiki haben, stellen Sie sich natürlich die Frage, ob und wann Sie eigene Namensraum überhaupt brauchen.
-Oft ist es auch nicht klar, ob bestimmte Inhaltsbereiche besser über Namensräume, über Kategorien oder über Unterseiten organisiert werden sollen. Machen Sie sich hier erst einmal kein Kopfzerbrechen und gehen Sie intuitiv vor. Sie können Wikiseiten später immer noch "verschieben", falls Sie ihre Wikistruktur nachträglich ändern wollen. Haben sie schon hunderte von Wikiseiten, die verschoben werden müssen, geht dies allerdings über Server-Skripts am besten. Die Benutzeroberfläche erlaubt es nur, Seiten einzeln zu verschieben.
+BlueSpiceDiscovery:
+*Einstiegspunkt "Hauptseite" anzeigen
+* Einstiegspunkt "Alle Seiten" anzeigen
+*Einstiegspunkt "Letzte Änderungen" anzeigen
-Nachfolgend ein paar Überlegungen, wann neue Namensräume sinnvoll sind:
+BlueSpiceSocial:
-* Sie erstellen eine große Anzahl von Wikiseiten für einen bestimmten Informationstyp. Hier können Sie entsprechend Namensräume verwenden. Zum Beispiel:
+*Einstiegspunkt "Timeline" anzeigen
-** Protokoll:Marketing/2022-08-22
-** Richtlinie:Soziale Medien
-** TOM:Zutrittskontrolle
-** Kunde:PASML  <br />Sie können sich hierbei allerdings auch überlegen, diese Seiten als Unterseiten oder über Kategorien zu organisieren, wenn diese Seiten keine Sonderverrechtung benötigen.  <br />
-* Ihr Qualitätsmanagementbeauftragter fordert, dass die Freigabe von Prozessbeschreibungen auf eine bestimmte Benutzergruppe beschränkt wird. Da Benutzerrechte nur über Namensräume definierbar sind, werden Sie hierfür einen Namensraum benötigen.
-* Sie wollen ein größeres Buch anlegen. Die Seiten können entsprechend in einem Namensraum gesammelt werden (z..B. könnten Seiten für ein Mitarbeiterhandbuch in einem dafür erstellten Namensraum ''MHB'' abgelegt werden.
-=== Benennung der Namensräume ===
+BlueSpiceSocialBlog:
-Da die Namensraumbezeichnung stets als Präfix für eine Seite mit angegeben wird, ist es meist übersichtlicher, kurze Namensraumbezeichnungen zu erstellen  (z.B. ''MHB'' für Mitarbeiterhandbuch oder ''AA'' für Arbeitsanweisung). Dies macht es später auch übersichtlicher, Seiten in den Namensräumen wiederzufinden.
-[[Datei:Namensraum in der Suche.png|alternativtext=Namensraumpräfix und Suchfunktion|zentriert|mini|380x380px|Namensraumpräfix und Suchfunktion]]
+* Einstiegspunkt "Blog" anzeigen
-=== Namensraumpräfix und nicht-existierende Namensräume ===
+==Gruppenspezifische Navigation==
+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
+**somepage{{!}}Some page
+|}}
+</syntaxhighlight>
-* Wenn Sie beim Erstellen einer Seite ein Namensraum-Präfix angeben, obwohl dieser Namensraum nicht existiert, wird die Seite im Hauptnamensraum angelegt. Das Präfix wird dann einfach zum Bestandteil des Seitennamens.
+==Zusätzliche Anpassungen==
-{{Hinweisbox|boxtype=Wichtig|icon=|Note text=Sobald es eine Seite ''Protokoll:2022-10-12'' gibt, ist es nicht mehr möglich, den Namensraum Protokoll nachträglich im Wiki zu erstellen.
-Die Seite ''Protokoll:2022-10-12'' muss zuerst umbenannt werden, z.B. in ''Protokoll-2022-10-12''. Erst dann kann der Namensraum ''Protokoll'' erstellt werden.|bgcolor=}}
+*[[Handbuch:Erweiterung/BlueSpiceDiscovery/Hauptnavigation anpassen/Icons|Icons vor den Links anzeigen]]
+*[[Handbuch:Erweiterung/BlueSpiceDiscovery/Hauptnavigation anpassen/Sprachen|Navigation in mehrsprachigen Wikis]]
-==Alle Seiten eines Namensraums auflisten==
+<br />
-Um alle Seiten in einem Namensraum zu sehen:
-*'''Gehen''' Sie zur Spezialseite "Alle Seiten"
-*'''Wählen''' Sie einen Namensraum aus dem Auswahlmenü.
-*'''Klicken''' Sie "Anwenden".
-Zusätzliche können Seiten auf der Spezialseite [[Handbuch:Erweiterung/BlueSpiceWikiExplorer|WikiExplorer]] nach Namensraum gefiltert werden.
-== Namensraum "MediaWiki" ==
-Seiten im Namensraum MediaWiki können von Benutzern mit "editinterface"-Berechtigung erstellt und bearbeitet werden. Standardmäßig sind das Benutzer, deren Gruppe(n) die Rolle ''structuremanager'', ''admin'' oder ''maintenanceadmin'' zugewiesen ist.
-Wichtige Nutzungsmöglichkeiten sind:
-* '''Systemmitteilungen''': Jede Mitteilung besitzt eine Wikiseite mit dem Mitteilungsschlüssel als Name der Seite. Eine Liste aller Mitteilungsseiten ist auf ''Spezial:AlleMitteilungen'' zu finden.
-* '''Lokalisierungen über ''<nowiki>{{int:Mitteilungsname}}</nowiki>''''': Ein Element der Benutzeroberfläche oder innerhalb einer Wikiseite kann über in die Benutzersprache übersetzt werden. Syntax: ''Mediawiki:Mitteilungsname/ISO-Sprachcode''.
-* '''MediaWiki:Common.js''': Enthält JavaScript, das für alle Seiten und Benutzer geladen wird.
-* '''MediaWiki:Common.css''': Stylesheet, dass nach dem Stylesheet des aktiven Skin im Wiki geladen wird. Es wird auf alle Wikiseiten angewandt.
-{{Box_Links | Thema1 =[[Handbuch:Erweiterung/BlueSpiceNamespaceManager|Namensraumverwaltung]]| Thema2 = | Thema3 = | Thema4 = }}
+{{Box Links
+|Thema1=[[Vorlagen/Beispiel/Translate|Übersetzungen von Wikiseiten]]}}
 [[de:{{FULLPAGENAME}}]]
-[[en:Manual:The_concept_of_namespaces]]
+[[en:Manual:Extension/BlueSpiceDiscovery/Main_navigation]]
+[[Category:Administration]]
-[[Category:Konzept]]