Zuletzt bearbeitet vor 2 Monaten
von Margit Link-Rodrigue

Handbuch:Erweiterung/ContentStabilization und Vorlagen Download/Seitenbanner: Unterschied zwischen den Seiten

(Unterschied zwischen Seiten)
Keine Bearbeitungszusammenfassung
 
Keine Bearbeitungszusammenfassung
Markierung: 2017-Quelltext-Bearbeitung
 
Zeile 1: Zeile 1:
{{DISPLAYTITLE:Seitenfreigaben}}
<div class="downloadarea">
{{BSVersion|bsvFrom=4.3|bsvTo=|bsvFeature=ContentStabilization|info=Bis Version 4.2 werden Freigaben über die Erweiterung [[Handbuch:Erweiterung/FlaggedRevs|FlaggedRevs]] realisiert.}}
<span class="getButton">[[Medium:HW-banner.zip|Download]]</span>


Die Erweiterung '''ContentStabilization'''{{Bsvs|bsvFrom=4.3|bsvTo=|bsvFeature=}} 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.
[[Datei:banner-beispiel.png|450x450px]]</div>
==Seitenfreigabe aktivieren==
Diese Vorlage erstellt einen Seitenbanner, den Sie zum Beispiel auf Portalseiten einbinden können. Ein Beispiel sehen Sie hier im Helpdesk auf der Seite [[Community]].
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''. Klicken Sie auf das Bearbeitungssymbol (Schraubenschlüssel) in der Spalte ''Aktionen''. Der Namensraumdialog öffnet sich. Wählen Sie Freigabe und klicken Sie auf ''Fertig''.
==Import der Vorlage==
[[Datei:Handbuch:freigabe-namensraum.png|zentriert|mini|450x450px|Freigabe für einen Namensraum aktivieren|alternativtext=Freigabe für einen Namensraum aktivieren]]
Die benötigte Import-Datei befindet sich im Archiv ''HW-banner.zip''. Sie enthält die Datei ''HW-banner.xml''. '''Entpacken''' Sie die zip-Datei.
===Bestehende Seiten===
Wenn die ''Freigabe'' für einen Namensraum aktiviert wurde, werden alle bereits bestehenden Seiten im Namensraum in den Entwurfsmodus versetzt. Die Seiten sind nun alle im Status ''Erstentwurf.''[[Datei:Handbuch:flaggedrevs-erstentwurf.png|zentriert|300x300px|mini|Erstentwurf|alternativtext=Erstentwurf]]Auf jeder Seite mit Freigabefunktion wird der Seitenstatus standardmäßig im Titelbereich angezeigt.


Über die [[Handbuch:Erweiterung/BlueSpiceConfigManager#Positionierung von Skin-Elementen|Konfigurationsverwaltung]] läßt sich die Ansicht alternativ unterhalb des Seiteninhalts verschieben.


===Erstentwurf===
Führen Sie auf der Seite Spezial:Import in Ihrem Wiki folgende Schritte durch:
Wenn eine neue Seite erstellt und zum ersten Mal gespeichert wird,  wird sie als '''Erstentwurf''' 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 weiter. Benutzern wird dann zuerst die freigegebene Version angezeigt.  
#'''Klicken''' Sie ''Browse...'' und wählen Sie die Datei ''HW-banner.xml''.
#'''Geben''' Sie ein Interwiki-Präfix '''an'''. Da dieses Feld erforderlich ist, geben Sie hier einfach ''hw'' (für hallowelt) ein.
#Belassen Sie die Vorauswahl ''Zu den Standard-Speicherorten'' importieren.
#'''Klicken''' Sie ''Datei hochladen...'' .
Die Vorlage ist nun in Ihrem Wiki verfügbar.
==Enthaltene Importdateien==
Der xml-Import erstellt folgende Dateien in Ihrem Wiki:


*Vorlage:Banner
*Vorlage:Banner/styles.css


Ein Wechsel zur Entwurfsversion ist jedoch allen Benutzern möglich (Ausnahme: In der Konfigurationsverwaltung wurden die [[Handbuch:Erweiterung/FlaggedRevs#Leserechte für Entwürfe|Benutzergruppen eingeschränkt]], die Entwürfe sehen können. In diesem Fall können auch die Erstentwürfe nur von den berechtigten Gruppen gelesen werden).
==Verwendung==


Wenn eine Seite im Entwurfsmodus mehrmals bearbeitet und gespeichert wird, wird jede Bearbeitung im Versionsverlauf protokolliert:<br />[[Datei:Handbuch:flaggedrevs-revisions.png|zentriert|650x650px|mini|Entwurfsversionen in der Versionsgeschichte|alternativtext=Entwurfsversionen in der Versionsgeschichte]]
#Fügen Sie die Vorlage "Banner" über den Einfügen-Dialog von [[Handbuch:VisualEditor|VisualEditor]] auf einer Wiki-Seite ein.[[Datei:step4.png|zentriert|mini|519x519px|verweis=Special:FilePath/step4.png]]Füllen Sie das Eingabeformular aus.


[[Datei:step5.png|zentriert|mini|450x450px|verweis=Special:FilePath/step5.png]]
{{Hinweisbox|boxtype=Wichtig|Note text=Die Einstellung der Eingabefelder werden erst beim Speichern der Seite übernommen}}


Entwürfe sind in der Versionsgeschichte umrahmt und gelb hervorgehoben. Zusätzlich sind sie mit "Freigabe ausstehend" markiert.  
Alle Einstellungen der Bannerbox sind optional. Das heißt, die Box kann auch ohne Bild, Überschrift oder Text generiert werden.


==Akzeptieren einer Seite==
==Beispielwerte==
<!--<br />
[[Datei:hw-banner-vorlage.png|zentriert|mini|650x650px|Einstellungen|verweis=Special:FilePath/hw-banner-vorlage.png]]
[[Datei:Handbuch:fff.png|zentriert|650x650px|mini|Seitenfreigabe beim Speichern]]
{| class="wikitable" style="width:100%;"
|+
!
! style="width:200px;" |Element
! style="width:180px;" |Wert
!Beschreibung
|-
| rowspan="3" |1
| style="width:200px;" |Bannergrafik
| style="width:180px;" |QM:Flower_white.jpg
|Bildname (mit Namensraum-Präfix, falls vorhanden, aber ohne Datei: Präfix). Der Banner kann auch ohne ein Bild generiert werden.
|-
| style="width:200px;" |Bildbreite
| style="width:180px;" |200
|Zahl, die Breite wird automatisch in Pixeln dargestellt. Standardwert: ''200''
|-
| style="width:200px;" |Bildposition
| style="width:180px;" |left, right
|Fügt das Bild links- oder rechtsbündig ein. Standardwert ist ''left''.
|-
| rowspan="3" |2
| style="width:200px;" |Überschrift
| style="width:180px;" |Meine Überschrift
|Text der Überschrift.
|-
| style="width:200px;" |Größe der Überschrift
| style="width:180px;" |1.6em
|Größe kann auch als 16px oder andere gültige css-Werte angegeben werden. Standardwert ist ''1.6em''.
|-
| style="width:200px;" |Farbe der Überschrift
| style="width:180px;" |#444444
|Angabe als [https://www.w3schools.com/colors/colors_picker.asp Hex-Wert].
|-
| rowspan="3" |3
| style="width:200px;" |Text
| style="width:180px;" |Das ist der Inhalt.
|Text der Box.
|-
| style="width:200px;" |Textgröße
| style="width:180px;" |1.2em
|''siehe Größe der Überschrift''
|-
| style="width:200px;" |Textfarbe
| style="width:180px;" |#444444
|''siehe Farbe der Überschrift''
|-
|4
| style="width:200px;" |Textabstand
| style="width:180px;" |10px
|Innerer Abstand von Titel und Text zur Box und zum Bild. Standardwert ist ''10px.''
|-
|5
| style="width:200px;" |Abstand des Inhalts zur Box
| style="width:180px;" |20px
|Äußerer Abstand der Inhalte zur Box. Standardwert ist ''0.''
|-
|6
| style="width:200px;" |Hintergrundfarbe der Box
| style="width:180px;" |#efefef
|Angabe als [https://www.w3schools.com/colors/colors_picker.asp Hex-Wert.] Standardwert ist ''#efefef''    (=hellgrau)
|-
|7
|Hintergrundicon
|bgicon1, bgicon2, bgicon3, swoosh
|Fügt einen [[Vorlagen Download/Seitenbanner#Hintergrundeffekt|Hintergrundeffekt]] hinzu.
|}


===Hintergrundeffect===
The following background effects are available by default, here shown in different banner color variations:
{| class="contenttable" style="width: 100%;"
! style="width:150px;" |Bgicon
! style="width:680px;" |Result
!Settings
|-
| style="width:150px;" |bgicon1{{Bsvs|bsvFrom=4.3|bsvTo=|bsvFeature=}}
| style="width:680px;" |[[File:banner-bgicon1-de.png|650x650px]]
|Heading color: #2e6096
Textfarbe: #2e6096


Hintergrundfarbe:#e9e9ee


Wenn die Seite beim Speichern nicht akzeptiert wird, kann sie später unabhängig vom Bearbeitungsprozess freigegeben werden.-->
Hintergrundicon:: bgicon1
|-
| style="width:150px;" |bgicon2
| style="width:680px;" |[[File:banner-bgicon2-de.png|650x650pxalt=Banner mit Hintergrundicon bgicon1]]
|Heading color: #2e6096


Ein Benutzer mit [[Handbuch:Erweiterung/BlueSpicePermissionManager|Freigaberechten]] kann die Seite mit der Freigabefunktion im Titelbereich der Seite  freigeben. Der Freigabekommentar wird in der Versionsgeschichte der Seite protokolliert.<br />
Textfarbe: #2e6096
[[Datei:Handbuch:Seite freigeben.png|zentriert|277x277px|mini|Seitenfreigabe über den Titelbereich]]


Hintergrundfarbe:#e9e9ee


Der neue Freigabestatus wird entsprechend im Titelbereich angezeigt.<br />[[Datei:Handbuch:a2.png|zentriert|350x350px|mini|Anzeige des Freigabestatus|alternativtext=Anzeige des Freigabestatus]]
Hintergrundicon:: bgicon2
|-
| style="width:150px;" |bgicon3{{Bsvs|bsvFrom=4.3|bsvTo=|bsvFeature=}}
| style="width:680px;" |[[File:banner-bgicon3-de.png|650x650pxalt=Banner mit Hintergrundicon bgicon2]]
|Heading color: #ffffff


==Einstellungen für Entwürfe==
Textfarbe: #ffffff
Einige Einstellungen können in der [[Handbuch:Erweiterung/BlueSpiceConfigManager#ContentStabilization|Konfigurationsverwaltung]] angepasst werden.
{{Transklusion|transcludedpage=Handbuch:Erweiterung/BlueSpiceConfigManager|section=ContentStabilization|tcstyle=|tcbackground=|tcborder=|tcpadding=}}


===Leserechte für Entwürfe===
Hintergrundfarbe:#747474
Standardmäßig können alle Benutzer die Entwürfe einer Seite sehen, also auch Benutzer mit Leserechten.


Um Entwürfe vor Benutzern zu verbergen, muss die Gruppe ''user'' aus der Konfiguration entfernt werden.  Diese Einstellung gilt dann für das gesamte Wiki und kann nicht weiter auf bestimmte Namensräume eingeschränkt werden.
Hintergrundicon:: bgicon3
 
|-
Ein Administrator ändert die Gruppen, die Entwürfe sehen können im Feld  ''Entwurfsversionen für die folgenden Gruppen anzeigen.''<br /><!-- DE screenshot: Übersetzung im GUI fehlt -->
| style="width:150px;" |swoosh
<br />{{Hinweisbox|boxtype=warning|icon=|Note text=Wenn die Gruppe ''user'' aus der Konfiguration  entfernt wird, können Benutzer in dieser Gruppe Entwurfsversionen auch dann nicht sehen, wenn sie eine Workflow-Aufgabe zugewiesen bekommen.|bgcolor=}}
| style="width:680px;" |[[File:banner-swoosh-de.png|650x650px|alt=Banner mit Hintergrundicon bgicon3]]
 
|Heading color: #2e6096
Nach dem Entfernen der Gruppe ''user'' müssen  nun die gewünschte(n) Gruppe(n), z. B. die Gruppe ''editor'',  zur Konfiguration hinzugefügt und gespeichert werden.
 
{{Hinweisbox|boxtype=note|icon=|Note text=Wenn im Konfigurationsfeld keine Benutzergruppen angegeben sind, sehen nicht einmal Benutzer mit Freigaberechten und Sysop-Benutzer eine visuelle Statusanzeige der Seite. Sie haben stattdessen Zugriff auf Entwürfe über die Versionsgeschichte der  Seite.
 
 
Damit Administratoren den Status direkt auf der Seite angezeigt bekommen, müssen Sie einer hier in der Konfiguration aufgeführten Gruppe hinzugefügt werden.|bgcolor=}}
 
=== Leserechte für Erstentwürfe ===
Standardmäßig sind Erstentwürfe für alle Benutzer sichtbar, die in einem Namensraum leseberechtigt sind. Sollten Erstentwürfe jedoch nur für diejenigen Benutzer sichtbar sein, die generell Seitenentwürfe einsehen können, so kann dies in der Konfigurationsverwaltung über die Auswahl ''<span class="col-red">Allow viewing of first draft version</span>'' deaktiviert werden.


===Zusammenfassung: Leseberechtigungen für Entwurfsseiten===
Textfarbe: #2e6096
'''Gruppen definieren:'''
*'''Gruppe ''user''''':  Es können nur die Benutzergruppen Erstentwürfe und weitere Entwürfe sehen, welche in der Konfigurationsverwaltung dieses Recht erhalten. Standardmäßig ist das die Gruppe user (=alle im Wiki eingeloggten Benutzer, die in einem Namensraum entsprechende Leserechte haben)'''.'''
*'''Gruppen anpassen:'''  In der Konfigurationsverwaltung können die Leserechte für (Erst-)Entwürfe auf andere Gruppen eingeschränkt werden.
*'''Gruppe ''sysop'':'''  Benutzer in der Gruppe ''sysop'' können Entwürfe immer über die Versionsgeschichte einsehen. Die Gruppe sysop kann in der Konfiguration daher nicht explizit gesetzt werden. Sollten ''sysop''-Benutzer direkt den Freigabestatus auf der Seite einsehen können, müssen sie einer Gruppe mit Leserechten für Entwürfe hinzugefügt werden.


Hintergrundfarbe:#e9e9ee


'''Export von Entwurfsseiten:'''
Hintergrundicon:: bgicon1
*'''Einzelseitenexport:'''  Benutzer mit Leserechten auf einer Entwurfsseite können diese direkt als PDF ausdrucken.
*'''Buchexport:'''  Es werden immer nur freigegebene Seiten exportiert.  Existiert nur ein Erstentwurf einer Seite, so wird dieser exportiert. '''Ausnahme:''' Wird das Buch von einem Anwender gedruckt, der auf Erstentwürfe keinen Zugriff hat, so wird der Erstentwurf nicht im Buch mit ausgedruckt. Statt dessen zeigt das PDF folgende Nachricht:[[Datei:Buch-Erstentwurf.png|alternativtext=Berechtigungsfehler PDF Export|zentriert|mini|550x550px|Berechtigungsfehler PDF Export]]
===Ä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, müssen auch diese Änderungen freigegeben werden. Es gibt zwei Möglichkeiten, die Freigabe durchzuführen:
 
#'''Die eingebettete Ressource befindet sich in einem Namensraum ohne Freigabemechanismus:''' 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 jeder Seite freigegeben werden''', auf der sie eingebunden ist.<br />[[Handbuch:Erweiterung/FlaggedRevs/Server-Skript|Infos zur automatischen Massenfreigabe über Server-Skript.]]
#'''Die eingebettete Ressource befindet sich in einem Namensraum mit Freigabemechanismus:''' Die Seite, auf der die geänderte Ressource eingebunden bekommt keinen Hinweis, dass die Ressource geändert wurde. Welche Version der eingebunden Ressource angezeigt wird, hängt von der Freigabeeinstellung im Wiki ab:
 
{| class="wikitable" style="width:100%;"
|+
! style="width:220px;" |Einstellung
!Verhalten
|-
| style="width:220px;" |<span class="col-red">Stable versions of included pages</span>
|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).
|-
| style="width:220px;" |<span class="col-red">Versions that were current at the time of approval</span>
| Zeigt die Version der Ressource an, die zum Zeitpunkt der letzten Freigabe der Seite, auf der die Ressource eingebunden ist, aktuell war (gilt nur, wenn die Ressource in einem Namensraum mit Freigabefunktion ist).
|}
===Auswirkungen auf semantische Attribute===
Wenn in einem Namensraum gleichzeitig  mit der Seitenfreigabe auch [[Handbuch:Semantic MediaWiki|Semantic MediaWiki]] aktiviert ist,  sind je nach Freigabestatus der Seite folgende Attribute für SMW-Abfragen verfügbar:
{| class="wikitable" style="width:100%;"
!Seitenstatus
!Verfügbare Attribute
|-
|Erstentwurf
|Aktuelle Werte
|-
| Freigegeben
|Aktuelle Werte
|-
|Entwurf
|Werte der freigegebenen Version (Standardeinstellung)
|-
|Impliziter Entwurf
(Änderungen an eingebunden Ressourcen)
|Werte der freigegebenen Version
|}
|}


__NOTOC__


 
[[en:Templates download/Banner]]
<span class="col-red">Die Darstellung der semantischen Attribute wird über folgende Einstellung bestimmt:</span><syntaxhighlight lang="text">
[[de:{{FULLPAGENAME}}]]
$bsgFlaggedRevsConnectorStabilizeSMWPropertyValues = true;
</syntaxhighlight><span class="col-red">Über ''LocalSettings.php'' im Serverdateisystem kann  dieser Wert auf ''false'' gesetzt werden. Dies bewirkt, dass bei Entwurfsseiten die Attributswerte der Entwurfsversion abgefragt werden.</span>
 
==Qualitätsmanagement Überblick ==
Die Spezialseite ''Spezial:Qualitätsmanagement_Überblick'' ermöglicht es allen Benutzern, den Freigabestatus aller Wikiseiten zu sehen und entsprechend zu filtern. Es werden nur Seiten angezeigt, auf die Benutzer Lesezugriff haben.
<br />[[Datei:Handbuch:qm-overview-DE.png|zentriert|mini|650x650px|Spezialseite Qualitätsmanagement Überblick]]
{{Box Links
|Thema2=[[Handbuch:Erweiterung/BlueSpiceBookshelf|Bücher]]
|Thema1=[[Handbuch:Erweiterung/BlueSpiceUniversalExport|Seiten exportieren]]
|Thema3=}}
{{translation}}
[[Category:Qualität]]
<references />

Version vom 2. Mai 2023, 13:18 Uhr

Diese Vorlage erstellt einen Seitenbanner, den Sie zum Beispiel auf Portalseiten einbinden können. Ein Beispiel sehen Sie hier im Helpdesk auf der Seite Community.

Import der Vorlage[Bearbeiten | Quelltext bearbeiten]

Die benötigte Import-Datei befindet sich im Archiv HW-banner.zip. Sie enthält die Datei HW-banner.xml. Entpacken Sie die zip-Datei.


Führen Sie auf der Seite Spezial:Import in Ihrem Wiki folgende Schritte durch:

  1. Klicken Sie Browse... und wählen Sie die Datei HW-banner.xml.
  2. Geben Sie ein Interwiki-Präfix an. Da dieses Feld erforderlich ist, geben Sie hier einfach hw (für hallowelt) ein.
  3. Belassen Sie die Vorauswahl Zu den Standard-Speicherorten importieren.
  4. Klicken Sie Datei hochladen... .

Die Vorlage ist nun in Ihrem Wiki verfügbar.

Enthaltene Importdateien[Bearbeiten | Quelltext bearbeiten]

Der xml-Import erstellt folgende Dateien in Ihrem Wiki:

  • Vorlage:Banner
  • Vorlage:Banner/styles.css

Verwendung[Bearbeiten | Quelltext bearbeiten]

  1. Fügen Sie die Vorlage "Banner" über den Einfügen-Dialog von VisualEditor auf einer Wiki-Seite ein.
    step4.png
    Füllen Sie das Eingabeformular aus.
step5.png
Wichtig!Die Einstellung der Eingabefelder werden erst beim Speichern der Seite übernommen


Alle Einstellungen der Bannerbox sind optional. Das heißt, die Box kann auch ohne Bild, Überschrift oder Text generiert werden.

Beispielwerte[Bearbeiten | Quelltext bearbeiten]

Einstellungen
Element Wert Beschreibung
1 Bannergrafik QM:Flower_white.jpg Bildname (mit Namensraum-Präfix, falls vorhanden, aber ohne Datei: Präfix). Der Banner kann auch ohne ein Bild generiert werden.
Bildbreite 200 Zahl, die Breite wird automatisch in Pixeln dargestellt. Standardwert: 200
Bildposition left, right Fügt das Bild links- oder rechtsbündig ein. Standardwert ist left.
2 Überschrift Meine Überschrift Text der Überschrift.
Größe der Überschrift 1.6em Größe kann auch als 16px oder andere gültige css-Werte angegeben werden. Standardwert ist 1.6em.
Farbe der Überschrift #444444 Angabe als Hex-Wert.
3 Text Das ist der Inhalt. Text der Box.
Textgröße 1.2em siehe Größe der Überschrift
Textfarbe #444444 siehe Farbe der Überschrift
4 Textabstand 10px Innerer Abstand von Titel und Text zur Box und zum Bild. Standardwert ist 10px.
5 Abstand des Inhalts zur Box 20px Äußerer Abstand der Inhalte zur Box. Standardwert ist 0.
6 Hintergrundfarbe der Box #efefef Angabe als Hex-Wert. Standardwert ist #efefef (=hellgrau)
7 Hintergrundicon bgicon1, bgicon2, bgicon3, swoosh Fügt einen Hintergrundeffekt hinzu.

Hintergrundeffect[Bearbeiten | Quelltext bearbeiten]

The following background effects are available by default, here shown in different banner color variations:

Bgicon Result Settings
bgicon1  v4.3+ banner-bgicon1-de.png Heading color: #2e6096

Textfarbe: #2e6096

Hintergrundfarbe:#e9e9ee

Hintergrundicon:: bgicon1

bgicon2 650x650pxalt=Banner mit Hintergrundicon bgicon1 Heading color: #2e6096

Textfarbe: #2e6096

Hintergrundfarbe:#e9e9ee

Hintergrundicon:: bgicon2

bgicon3  v4.3+ 650x650pxalt=Banner mit Hintergrundicon bgicon2 Heading color: #ffffff

Textfarbe: #ffffff

Hintergrundfarbe:#747474

Hintergrundicon:: bgicon3

swoosh Banner mit Hintergrundicon bgicon3 Heading color: #2e6096

Textfarbe: #2e6096

Hintergrundfarbe:#e9e9ee

Hintergrundicon:: bgicon1




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

Keine Kategorien vergebenBearbeiten

Diskussionen