Hilfe:Handbuch

Hier entsteht nach und nach eine Anleitung dafür, wie das Wiki strukturiert ist sowie technische Hilfen.

Struktur

Wir gliedern hauptsächlich nach Projekten, Themen, Hubs, Netzwerke und Info rund ums Wiki.
Für die Projekte gibt es einen eigenen Menüreiter.
Für die Themen Portalseiten - ein Einstieg ist über die Startseite möglich. ZKH bearbeitet und gestaltet die Portalseiten ebenfalls mit. Die Netzwerke-Seite ist teilweise noch ein "Sammelort": Übersicht über internationale Netzwerke, Nachhaltigkeitsstrategien an deutschen Hochschulen und ein paar Listen einzelner Bundesländer. Außerdem Ankerpunkt für Community-Seiten (die meisten noch im entstehen, Stand April 2024).

Handlungsfelder

nach Whole Institution Approach

Betrieb
Transfer
Forschung
Lehre
Governance

ZKH ergänzt noch um

studentisches Engagement
Partizipation und Transparenz
Finanzen

Themenfelder

z.B.

Mobilität
Biodiversität
Kultur/Kreatives

Kategorien

Handlungsfeld
- Betrieb
- Transfer
- Forschung
- Lehre
- Governance

Themenfeld
- Mobilität
- Biodiversität
- Kultur/Kreatives
- ...

Projekte
Hubs (mehr dazu s.u.): Verknüpfung mit Kategorien, insbesondere bei Community Hubs zur thematischen Einordnung
- Unterkategorien je nach Hub-Reihe (z.B. Community-Hubs, Hub -Biodiversitätsmanagement, Hub - Chancengerechtigkeit...) bzw. Unterkategorie Community-Hub

Projekte

Gliederung über Menüreiter projektbezogen

Die Projektseiten und dazugehörige Seiten sollen alle in die Kategorie:Projekt und die jeweilige eigene Projektkategorie einsortiert werden. Zusätzlich sind auf thematischen Seiten auch Kategorien der Handlungsfelder oder Themenfelder sinnvoll (s.o.)

Hubs

Für die Hubs der DG HochN gibt es eine separate Seite hier: Hubs der DG HochN.
Hub-Reihen haben jeweils eine eigene Kategorie, Einzel-Hubs werden unter "Community-Hubs" einsortiert. Dies geschieht automatisch über das Formular.

Dokumentation:
Grundsätzlich sollen so viele Hubs wie möglich dokumentiert werden. Aber eine leere Hub-Seite, auf der nur Titel und Datum für die Sichtbarkeit stehen, sind nicht zielführend --> dann lieber weglassen. Denn dies hilft den User:innen nicht für einen Informationsgewinn. Termine werden auf der Website angekündigt. Das Wiki dient primär als Wissensspeicher und nicht als Ankündigungsplattform.

Bezeichnungen:
Für die Bezeichnung von Hubs nach folgendem Schema vorgehen:

allgemeines Schema: Hub [Titel], [optional Thema], Datum

Hub Chancengerechtigkeit [ – Thema], Datum
Hub Nachhaltigkeitsberichterstattung [ – Thema], Datum
Hub Innovative Lehrformate [ – Thema], Datum
...

Besonderheiten:

Community Hub – [Thema], Datum
Transformationspfade-Hub – [Thema], Datum

→ hinter den Hub-Namen kann zusätzlich das Thema optional genannt werden. Z. B.
Hub Innovative Lehrformate – OER in der Wissenschaft, 05.03.2023
Community Hub – Nachhaltige Websitegestaltung, 22.04.2023
→ also generell wichtig: Hub-Seiten im Wiki mit "Hub" bennen, da sonst Seiten "belegt" sein könnten, wenn man also einen Hub-Termin nur "Innovative Lehrformate" nennen würde. Daher immer mit "Hub" davor kennzeichnen und mit Datum versehen.

Hinweis zum Formular: In der Kurzbeschreibung sollte nur ein kurzer Satz stehen, da dieser in die Tabellenansicht übernommen wird (sonst wird es zu lang).

Namespaces

Das Wiki hat verschiedene Namespaces/Namensräume, von denen einige automatisch von Mediawiki eingerichtet sind (z.B. Vorlagen, Kategorien, Dateien, etc.) und einige speziell für unser Wiki (z.B. HOCH-N). Die extra Namespaces sind eingerichtet worden, um Schreibrechte für bestimmte Seiten einzuschränken. Eine Übersicht über alle bestehenden Namespaces findet man hier: Spezial:Präfixindex.
Dort kann man auch sehen, wie viele Seiten in welchem Namespace liegen.

Hilfestellungen und Erste Schritte für neue User:innen

Unter dem Menüreiter "Mitmachen" sind Informationen zum Einstieg festgehalten. Darunter die Punkte:

Erste Schritte
Account beantragen
Beiträge verfassen

Technisches

Menüreiter anpassen

Der Menüreiter kann unter einer separaten Seite bearbeitet werden: MediaWiki:Sidebar
Entweder auf den Link klicken oder die Seite über Mediawiki:Sidebar über das Suchfeld aufrufen. Der Menüreiter funktioniert mit Verlinkungen der Seiten. Die Ebenen werden dabei über Bulletpoints gegliedert. Es sind 2 Ebenen möglich. Den Link der Seite, die im Menüreiter auftauchen soll, unter der entsprechenden Rubrik einfügen.
Ein neuer Menüreiter kann mit einem Bulletpoint auf Ebene 1 hinzugefügt werden. Achtung: besser nicht zu viele Menüreiter, dann wird es je nach Bildschirmgröße der User:innen umgebrochen.
Speichern und danach erscheint die Seite sofort unter dem entsprechenden Menüreiter.

Design

Zu den angelegten Design-Vorlagen und Formatierungshilfen gibt es eine separate Seite hier.

Zum css gelangt man hier: MediaWiki:Common.css --> am besten nur etwas in Absicherung mit IdeaSketch ändern oder wenn ihr euch ganz sicher seid :) Wenn in der css etwas geändert wird, gilt das fast immer für alle Seiten

Weiterleitungen/Seiten verschieben

Weiterleitungen können auf der jeweiligen Seite eingerichtet werden über die drei Punkte und "Verschieben". Dort muss dann der neue Seitentitel eingegeben werden und dadurch wird dann die Weiterleitung automatisch erstellt.

Systemnachrichten anpassen

Die automatisch im Wiki hinterlegten Texte (=Systemnachrichten) kann man auf dieser Seite anpassen: Spezial:MediaWiki-Systemnachrichten

Z. B. auch die Nachrichten in den Bestätigungsmails, dazu in der Suche confirmaccount und requestaccount eingeben, dann findet man schneller alle dazugehörigen Systemtexte.

Vorlagen erstellen

Um Design-Vorlagen zu erstellen, ist es am einfachsten, bestehende Vorlagen zu kopieren und auf die eigenen Bedarfe anzupassen. Dazu unter Hilfe:Vorlagen Design schauen, was es schon gibt.
Vorlage kopieren:

Um eine Vorlage zu erstellen (Kopieren), die entsprechende Vorlage aufrufen: im Suchfeld den Namen der Vorlage eingeben. (Vorlagen liegen im Namespace "Vorlagen", daher sind Vorlagen abgespeichert nach dem Schema Vorlage:Beispiel).
Den Quelltext der ausgewählten Vorlage kopieren.
eine neue Seite anlegen (über das Suchfeld den gewünschten Namen angeben nach dem Schema Vorlage:Name der Vorlage
Quelltext in die Seite kopieren
Vorlage nach eigenen Wünschen anpassen (Farben, Schrift, Ausrichtung, etc.) und im Quelltext überall den Namen der Vorlage austauschen
Speichern
neue Vorlage auf der Seite Hilfe:Vorlagen Design ergänzen

Vorlage neu erstellen:

mit HTML Kenntnissen oder Bootstrap :)
z.B. Cards erstellen mit Bootstrap: https://getbootstrap.com/docs/4.0/components/card/
z.B. Hilfe für HTML: https://www.w3schools.com/html/default.asp
Videos zur Einführung von Vorlagen von Thilo: Media:5TutVideoVorlagen1.mp4 und Media:6TutVideoVorlagen2.mp4

Formulare

Formulare werden am einfachsten erstellt über: Werkzeuge -> Spezialseiten -> Klasse erstellen (all inclusive-Paket mit gleichzeitiger Erstellung von Kategorien, Attributen, Vorlage, Formular)

Bei der Erstellung sollten Formulare und Vorlagen dokumentiert werden: auf welchen Seiten werden sie eingebunden, welche Attribute sind damit verknüpft? Dazu am besten eine bestehende Vorlage anschauen und ähnlich dokumentieren.

Bestehende Formulare

Es gibt folgende Formulare im Wiki:

Für Dokumentation der Hubs der DG HochN: Formular:Hubs der DG HochN
Für Beispielsammlung für innovative Lehrformate (BNE): Formular:Sammlung Innovative Lehrformate
Für Beispielsammlung Interdisziplinäre Lehre (kein DG HochN-Projekt, entstanden in Zusammenarbeit mit INNO4BNE): Formular:Sammlung Interdisziplinäre Lehre
Für Profilseiten der User: Formular:Wiki user
Für Nachhaltigkeitsstrategien deutscher Hochschulen und Landkarte: Formular:NH-Strategien
Für Dokumentation der Workshops auf dem BMBF-Symposium: Formular:Dokumentation Workshop und Formular:Dokumentation Workshop Infobox --> Erklärungen/Attribute fehlen dort noch

Auf den Formularseiten finden sich die Infos dazu, welche Vorlagen, Attribute und Kategorien miteinander verknüpft sind.

VisualEditor oder Formular-Editor

Damit PageForms (die Erweiterung, mit der Formulare erstellt werden) weiß, mit welchem Formular eine Seite bearbeitet werden soll (der Klick auf das Sternchen auf jeder Seite), muss dieser Seite am Besten über das Ausgabetemplate (--> die Vorlage)) eine Kategorie zugewiesen sein, auf deren zugehöriger Kategorien-Seite das Formular mittels {{#default_form: Beispiel}} angegeben ist. Wenn dies dort nicht angegeben ist, werden die Seiten mit dem VisualEditor geöffnet (über das Sternchen zur Bearbeitung).
Also die Infos in Formular, Vorlage, Kategorie folgendermaßen angeben:

Im Formular: {{{for template|Beispiel}}}
In der Vorlage: [[Kategorie:Beispiel]]
In der Kategorie: {{#default_form: Beispiel}}

Weitere Infos und Links

https://www.mediawiki.org/wiki/Extension:Page_Forms/Page_Forms_and_templates https://www.mediawiki.org/wiki/Extension:Page_Forms/Defining_forms https://www.mediawiki.org/wiki/Extension:Page_Forms/Input_types

Abfragen mit SMW

Für "ask query-Abfragen" mit SemanticMediaWiki müssen strukturierte Daten mithilfe von Attributen auf den Seiten hinterlegt sein. Diese können dann in Kategorien, Koordinaten, etc. ausgespielt werden.

Einfache Abfragen: Kategorien und Attribute

Für das Anzeigen von Tabellen, Landkarten oder Listen - gefiltert nach SMW Attributen und Kategorien - kann man eine "ask query-Abfrage" durchführen.

Beispiel für die Seite Hubs der DG HochN:

 {{#ask: [[Category:Hubs der DG HochN]]
 |?Hat Datum#GR-F[D d.m.Y H:i]
 |?Hat Themenschwerpunkt=Schwerpunkte
 |?Kurzbeschreibung=Beschreibung des Hubs
 |?Thematisch verbunden mit=Wiki-Themen
 |mainlabel = Hub-Termin
 |sort=Hat Datum
 |order=descending
 |limit=10
}}

In der Abfrage wird dann z.B. die Kategorie "Hubs der DG HochN" durchsucht und alle Seiten in einer Tabelle angezeigt, die in diese Kategorie fallen. In der Tabelle werden dann die Werte angezeigt, die den Attributen "Hat Datum", "Hat Themenschwerpunkt", "Kurzbeschreibung" und "Thematisch verbunden mit" zugeordnet sind.
Mit "|sort" kann man die Sortierung angeben, mit "|order" eine aufsteigende oder absteigende Reihenfolge. Mit "|limit" wird eingeschränkt, wie viele Ergebnisse angezeigt werden, die restlichen Ergebnisse werden unter "...weitere Ergebnisse" in der Tabelle angezeigt, damit die Seite nicht zu lang wird.

Filtern

Mit Abfragen kann auch eine Filtersuche angeboten werden, bspw. wie auf der Seite HOCH-N Wiki Recherche. Dazu muss hinter den Abfrage-Attributen auch angegeben werden, wie gefiltert. Bspw. mit

|+filter=value |+value filter switches=and or |+value filter collapsible=collapsed |+hide=yes

Landkarten

Abfragen können mit SMW auch auf Landkarten dargestellt werden, wie bspw. die Verortung der User auf der Startseite

{{#ask:[[Category:Wiki user]]
 | format=map
 | height=280px
 | ?Coordinates
 | fullscreen=yes
 | zoom=5
 | ?Foaf:name
 | ?Hat HS Position
 | ?Arbeitet an Institut
 | ?Gehört zu Hochschule
 | ?Hat Motivation
 | ?Hat Expertise
 | template=PopupWikiUser
 | showtitle=off
 | cluster=on
 | center =Europe
}}

Dazu muss das Ausgabeformat auf "|format=map" gesetzt werden. Weitere Einstellungen wie Größe der Karte in Pixel, Fullscreen, Zoom und Kartenzentrierung können angegeben werden.

Landkarte ohne SMW
Landkarten können auch ohne SMW (also Attribute) manuell angelegt werden. Wir haben dafür die notwendige Erweiterung "Maps" im Wiki installiert. Karten ohne SMW anzulegen empfiehlt sich aber nur für statische Seiten, wenn wenig Änderungen vorgenommen werden müssen. (Z.B. beim traNHSform-Projekt die Landkarte der Projekte, da die Projekte feststehen). Eine Anleitung und Erklärung verschiedener Optionen findet sich bei hier: https://maps.extension.wiki/wiki/Maps_for_MediaWiki Ein ergänzendes Videotutorial bei youtube für verschiedene Karten- und Pin-Optionen: Tutorial:https://www.youtube.com/watch?v=TictndP793M

Weitere Optionen zu SMW

Mehr zu Abfragen und Filteroptionen mit SMW finden sich hier: