Seitenfreigaben

Mit DynamicPageList3 können unter anderem Seitenlisten generiert werden.

Anwendungsbeispiele

Eine Dokumentation aller Auswahlkriterien und Formatierungsbeispiele sind auf Gamepedia (englisch) erhältlich. Im folgenden sehen Sie einige typische Anwendungsbeispiele sowie eine Tabelle mit einer Liste möglicher Parameter und deren Werte.

Unterseiten auflisten

Folgender Code zeigt die Unterseiten der aktuellen Seite in einem 3-spaltigen Layout an:

{{#dpl:
|titlematch={{PAGENAME}}/%
|shownamespace=false
|replaceintitle=/{{PAGENAME}}\//,
|columns=3
|mode=none
|rowcolformat=width=100%
}}

Beispiel: Darstellen der Unterseiten der Seite VisualEditor im im Hauptnamensraum. Es soll eine 1-spaltige Aufzählungsliste erzeugt werden:

{{#dpl:
|titlematch=VisualEditor/%  
|shownamespace=false
|namespace= 
|replaceintitle=/VisualEditor\//,
|columns=1
|mode=ubordered
|rowcolformat=width=100%
}}

Output:

• Bilder
• Dateien
• Shortcuts
• Tabellen
• Tabellen/Beispiele
• Versionsvergleich

Seiten in bestimmten Namensräumen auflisten

{{#dpl:
  |namespace=Handbuch
  |includesubpages=true
  |shownamespace=false
  |count=5
  |ordermethod=title
}}

Output:

• Adminhandbuch Einführung
• Andere Admin-Seiten
• Begutachtungsprozess
• Benutzerhandbuch Einführung
• Dokumentenlenkung

Seiten in bestimmten Kategorien auflisten

{{#dpl:
  |category=Qualität
  |addcategories  = true
  |includesubpages=true
  |shownamespace=false
  |count=5
  |ordermethod=title
  |mode=ordered  
}}

Output:

1. Begutachtungsprozess . . Kategorien: Qualität
2. Dokumentenlenkung . . Kategorien: Qualität
3. Erweiterung/BlueSpiceCategoryCheck . . Kategorien: Qualität
4. Erweiterung/BlueSpiceFlaggedRevsConnector . . Kategorien: Qualität
5. Erweiterung/BlueSpicePageAssignments . . Kategorien: Qualität

Zufällige Seite in einer Kategorie anzeigen

<div style="border:2px solid #f6f6f6; padding:10px; width:500px; height:500px; overflow:auto;">
{{#dpl:
|category=Qualität
|randomcount=1
|includepage=*
|includemaxlength=100
|format=,\n==[[%PAGE%]]==\n,,
}}
</div>

Output:

Handbuch:Erweiterung/FlaggedRevs

Die Erweiterung FlaggedRevs ist eine MediaWiki-Erweiterung, die einen Freigabemechanismus aktiviert. Neue Versionen einer Seite werden zunächst als Entwürfe markiert. Diese bleiben so lange bestehen, bis ein Benutzer mit Freigaberechten die Seite überprüft und genehmigt.

Was sind Seitenentwürfe?

In BlueSpice können Sie Entwurfsversionen einer Seite erstellen. Nachdem diese Seite bearbeitet und im Entwurfsmodus gespeichert wurde, wird den Lesern der Seite standardmäßig die zuletzt freigegebene Version der Seite angezeigt. Dies ermöglicht es den Bearbeitern, einen Entwurf so lange im Hintergrund zu bearbeiten, bis alle Änderungen "passen". Die Seite kann anschließend von Benutzern mit Freigaberechten freigegeben werden.

Alle Benutzer können die letzte Entwurfsversion einsehen, indem sie auf die Statusinformation einer Seite klicken oder zur Versionsgeschichte wechseln.

Seitenfreigabe aktivieren

Die Aktivierung von Entwürfen erfolgt über die Namensraumverwaltung. Ein Benutzer mit Administratorrechten überprüft, ob Freigabe für einen Namensraum aktiviert ist. Dies geschieht unter Globale Aktionen > Verwaltung > Namensraumverwaltung:

Freigabe aktivieren

Das Dialogfenster wird geöffnet, nachdem Sie auf das Bearbeitungssymbol (Schraubenschlüssel) in der Spalte Aktionen geklickt haben. Wählen Sie Freigabe und klicken Sie auf Fertig.

Bestehende Seiten

Nachdem Sie Freigabe für einen Namensraum aktiviert haben, werden alle bereits bestehenden Seiten im Namensraum in den Entwurfsmodus versetzt. Die Seiten sind nun alle im Status Erstentwurf.

Seite mit Freigabefunktion

Auf jeder Seite mit Freigabefunktion wird am Seitenanfang ein Banner mit dem Freigabestatus (1) sowie der Seitenstatus (2) angezeigt.

Neue Seiten

Wenn eine neue Seite erstellt und zum ersten Mal gespeichert wird, wird sie als Erstentwurf allen Benutzern angezeigt. Wenn Sie zuerst keine Informationen auf der Seite anzeigen möchten, speichern Sie die neue Seite einfach leer oder mit einer kurzen Benachrichtigung, z. B. In Bearbeitung, und veröffentlichen Sie den Erstentwurf. Arbeiten Sie anschließend im Hintergrund an der Entwurfsseite.

Nachfolgende Seitenänderungen werden in der Entwurfsversion der Seite erfasst. Wenn eine Seite im Entwurfsmodus mehrmals bearbeitet und gespeichert wird, wird jede Bearbeitung im Versionsverlauf protokolliert:

Entwurfsversionen

Entwürfe sind in der Versionsgeschichte umrahmt und orange hervorgehoben. Darüber hinaus werden sie mit "Freigabe ausstehend" kommentiert. Die einzelnen Bearbeitungen können verglichen werden, bevor die ausstehenden Änderungen der Seite akzeptiert werden.

Akzeptieren einer Seite

Benutzer mit Freigaberechten können Seitenentwürfe automatisch akzeptieren, wenn sie eine Seite speichern. Im Dialogfenster zum Speichern gibt es hierfür das Kontrollkästchen Diese Version akzeptieren:

Seitenfreigabe beim Speichern

Wenn die Seite beim Speichern nicht akzeptiert wird, kann sie später unabhängig vom Bearbeitungsprozess akzeptiert werden.

Ein Benutzer mit Freigaberechten kann die Seite mit der Freigabefunktion im Titelbereich der Seite schnell akzeptieren. Der Entwurfshinweis zeigt die Option Freigeben an:

Seitenfreigabe über den Titelbereich

Alternativ kann die Seite auch über die Freigabeseite in den Seitenwerkzeugen freigegeben werden:

Freigabe über die Qualitätswerkzeuge

In beiden Fällen können Sie einen Kommentar hinterlassen. Dieser Kommentar wird dann im Versionsverlauf der Seite angezeigt. Nachdem die Seite freigegeben wurde, wird dies entsprechend im Titelbereich angezeigt.

Freigegebene Seite

Leserechte für Entwürfe

Standardmäßig können alle Benutzer die Entwürfe einer Seite sehen, also auch Benutzer mit Leserechten.

Um Entwürfe vor Lesern zu verbergen, muss die Gruppe user aus der Konfiguration entfernt werden. Ein Administrator löscht die Gruppe aus der Konfiguration unter "Entwurfsversionen für die folgenden Gruppen anzeigen" unter Globale Aktionen > Verwaltung > Konfigurationsverwaltung:

Benutzergruppen für Entwürfe festlegen

Achtung: Wenn die Gruppe user aus der Konfiguration BlueSpiceFlaggedRevs entfernt wird, können Benutzer in dieser Gruppe Entwurfsversionen auch dann nicht sehen, wenn sie als Begutachter in einem Begutachtungsprozess bestimmt werden.

Wenn die Gruppe Benutzer entfernt wird, können nur Benutzer mit der Berechtigung sysop und reviewer auf Entwürfe zugreifen. Wenn Sie möchten, dass andere Gruppen, z. B. Editoren, Entwurfsversionen anzeigt bekommen, müssen Sie diese zur Konfiguration hinzufügen und speichern.

Die beiden Kontrollkästchen Seite automatisch als freigegeben markieren... (bis Version 3.1.) und Begutachtung einer Seite löschen ....legen fest, wie ein Begutachtungsprozess für eine Seite mit Entwurfsversionen beendet wird. Eine Seite kann dann automatisch von einem Begutachtungsprozess freigegeben und der Workflow automatisch gelöscht werden.

Hinweis: Wenn im Konfigurationsfeld keine Benutzergruppen angegeben sind, sehen nicht einmal Überprüfer und Sysop-Benutzer eine visuelle Statusanzeige einer Seite. Sie haben stattdessen Zugriff auf Entwürfe über den Revisionsverlauf einer Seite.

Benutzer mit Bearbeitungsrechten erhalten eine Benachrichtigung, dass Seitenänderungen für die Seite ausstehen, wenn sie die Seite bearbeiten.

Änderungen an Vorlagen und eingebetteten Dateien

Wenn eine Seite Vorlagen verwendet oder andere Dateien wie Bilder und eingebettete PDFs enthält und diese nach der Seitenfreigabe verändert wurden, wird dies entsprechend im Freigabestatus des Seitenbanners (1) sowie in der Statusleiste (2) angezeigt.

Geänderte Ressourcen

Liegen die eingebetteten Ressourcen in einem Namensraum ohne eigene Freigabefunktion, so wird in der freigegebenen Version der Seite die Ressourcenversion zum Zeitpunkt der Seitenfreigabe angezeigt. Die Entwurfsversion zeigt entsprechend die aktuellste Version der eingebetteten Ressource. Um die Ressourcenänderung freizugeben, muss diese auf der Seite freigegeben werden. Dies erzeugt eine neue freigegebene Seitenversion.

Ressource freigeben

Bevor Sie die geänderten Ressource(n) freigeben, sollten Sie sich ansehen, welche Ressourcen hierbei betroffen sind.

1. Öffnen Sie die Qualitätsmanagement-Werkzeuge (1). Hier wird Ihnen unter Freigabe angezeigt, dass es Änderungen an Ressourcen gibt (2).
2. Klicken Sie auf eine geänderte Ressource (3), um sich die Änderungen der letzten beiden Versionen der Ressource anzeigen zu lassen.
3. Klicken Sie "Jetzt begutachten" (4) unter Unfreigegebene Änderungen. Dies führt Sie zur Entwurfsversion der Seite. Von dort können Sie die Seite im Titelbereich freigeben. Hinweis: Wenn es mehrere geänderte Ressourcen gibt, können diese nur gesammelt freigegeben werden.

Änderungen an Ressourcen

Anzeigeeinstellungen für Ressourcen auf freigegebenen Seiten

Es ist über Serverkonfiguration möglich, eingebettete Ressourcen (also Dateien, Vorlagen, oder transkludierte Inhalte), die nach der Seitenfreigabe geändert werden, in einer bestimmten Version darzustellen. Folgende Möglichkeiten existieren:

Einstellung	Verhalten
FR_INCLUDES_FREEZE	Zeigt die Ressource in der Version an, die zum Zeitpunkt der Seitenfreigabe aktuell war. Achtung: Diese Einstellung wird von MediaWiki langfristig nicht mehr unterstützt und sollte daher nicht mehr in einem Wiki eingeführt werden
FR_INCLUDES_STABLE	Zeigt immer die letzte freigegebene Version der Ressource an, auch wenn diese nach der Seitenfreigabe entstanden ist (gilt nur, wenn die Ressource in einem Namensraum mit Freigabefunktion ist).
FR_INCLUDES_CURRENT	Zeigt in jedem Fall die aktuellste Version der Ressource an.

Wichtig! Ergebnisse einer semantischen Abfrage können im Gegensatz zu Attributswerten nicht eingefroren werden, selbst wenn INCLUDES_FREEZE gesetzt wurde. Die Abfrageergebnisse persistieren nicht im Quelltext einer Seite, sondern werden dynamisch zum Zeitpunkt der Abfrage generiert.

Auswirkungen auf semantische Attribute

Wenn in einem Namensraum gleichzeitig mit der Seitenfreigabe auch Semantic MediaWiki aktiviert ist, sind je nach Freigabestatus der Seite folgende Attribute für SMW-Abfragen verfügbar:

Seitenstatus	Verfügbare Attribute
Erstentwurf	Aktuelle Werte
Freigegeben	Aktuelle Werte
Entwurf	Werte der freigegebenen Version (Standardeinstellung)
Impliziter Entwurf	Werte der freigegebenen Version

Die Darstellung der semantischen Attribute wird über folgende Einstellung bestimmt:

$bsgFlaggedRevsConnectorStabilizeSMWPropertyValues = true;

Über LocalSettings.php im Serverdateisystem kann dieser Wert auf false gesetzt werden. Dies bewirkt, dass bei Entwurfsseiten die Attributswerte der Entwurfsversion abgefragt werden.

Qualitätsmanagement Überblick

Die Spezialseite Spezial:Qualitätsmanagement_Überblick ermöglicht es Benutzern mit Admin- oder Reviewer-Rechten, den Freigabestatus aller Wikiseiten zu sehen und entsprechend zu filtern.

Spezialseite Qualitätsmanagement Überblick

Verwandte Themen

• Qualitätsmanagementwerkzeuge
• Referenz:FlaggedRevs
• Referenz:BlueSpiceFlaggedRevsConnector

Seiten mit bestimmten Namensmustern

{{#dpl:
 |namespace=Datei
 |titlematch=A%
 |count=5
 }}

Output:

• Datei:AdminDashboards1.png
• Datei:AdminDashboards2.png
• Datei:Anmeldedaten eingeben.png
• Datei:Anzeige des Suchergebnisses.PNG
• Datei:Arbeitsanweisung-Beispiel.docx

Liste typischer Parameter

Kriterien zur Seitenauswahl

Parameter	Syntax	Beschreibung
category	|category=QM|Setup...	Seiten aus den Kategorien QM ODER Setup
	|category=QM&Setup&...	Seiten aus den Kategorien QM UND Setup
	|category=QM|Setup...|category=Admin	Seiten aus den Kategorien QM ODER Setup und Seiten aus der Kategorie Admin
notcategory	|notcategory=QM	Seiten, die nicht in der Kategorie QM sind
categoriesminmax	|category=QM|categoriesminmax=2	Seiten, die in der Kategorie QM und mindestens 2 weiteren Kategorien sind
	|category=QM|categoriesminmax=,1	Seiten, die nur in der Kategorie QM und in keiner anderen Kategorie sind
namespace	|namespace=	Seiten im Namensraum (Main)
	|namespace=Help|Handbuch	Seiten im Namensraum Help ODER Handbuch
namespacenot	|namespacenot=Help	Seiten, die nicht im Namensraum Help sind
	|namespacenot={{NAMESPACE}}	Seiten, die nicht im Namenraum der aktuellen Wikiseite sind

Output-Format

Parameter	Syntax	Beschreibung
mode	|mode=ordered	Numerierte Liste
	|mode=unordered	Aufzählungsliste
	|mode=none	Zeilenumbrüche
	|mode=category	Seiten werden alphabetisch in A-Z Gruppen formatiert (ähnlicher einer Kategorienseite)
	|mode=inline|inlinetext=  •  	Seitennamen werden aneinandergereiht mit einem Aufzählungspunkt als Separator

Sortierung

Parameter	Syntax	Beschreibung
ordermethod	|ordermethod=title	Sortiert nach Seiten(-Präfix+)Titel
	|ordermethod=titlewithoutnamespace	Sortiert nach Seitenname unabhängig vom Namensraum
	|ordermethod=counter	Sortiert nach Anzahl der Seitenansichten (Popularität)
	|ordermethod=size	Sortiert nach Seitengröße
	|ordermethod=firstedit	Sortiert nach Erstellungsdatum
	|ordermethod=lastedit	Sortiert nach letztem Bearbeitungdatum
	|ordermethod=user,firstedit	Sortiert nach Bearbeiter, dann nach Erstellungsdatum durch den Bearbeiter
	|ordermethod=user,lastedit	Sortiert nach Bearbeiter, dann nach letztem Bearbeitungsdatum durch den Bearbeiter
order	|order=ascending	Aufsteigend sortiert
	|order=descending	Absteigend sortiert

Anzeige von Metadaten

Parameter	Syntax	Beschreibung
addcategories	|addcategories=true	Zeigt alle Kategorien der Seite nach dem Seitennamen an
addpagecounter	|category:QM|ordermethod=counter|order=descending |addpagecounter=true|count=5	Zeigt die 5 populärsten Seiten aus der Kategorie QM
adduser	|category=QM|ordermethod=lastedit|adduser=true	Stellt den Seiten den Namen des letzten Bearbeiters voran.
addauthor	|category=QM|addauthor=true	Stellt den Seiten den Namen des Seitenerstellers voran.

Verwandte Themen

• Referenz:DynamicPageList3