Vorlage:Scroll Gallery/Doku

Shortcuts: {{Galerie}} {{Gallery}}

Dies ist eine nachgeordnete Seite der Dokumentation von Vorlage:Scroll Gallery.
Sie enthält Informationen zur Verwendung, Kategorisierung und zu anderem Inhalt, der nicht Bestandteil der originalen Vorlage-Seite ist.

Diese Vorlage benutzt Modul:Scroll Gallery, Skripte geschrieben in der Programmiersprache Lua. Bitte informiere dich dort, wenn du mehr über die Sprache und ihren Einsatz erfahren willst. Diese Vorlagen sollte im Regelfall nicht ersetzt werden.

Diese Vorlage verwendet TemplateStyles. Die Stilvorlagen sind in der Datei Vorlage:Scroll Gallery/styles.css notiert.

Aufruf

Funktion: Die Vorlage dient zur Präsentation einer Bilderfolge. Es können beliebig viele Bilder präsentiert werden.
Verwendung:

{{Scroll Gallery
| title =
| align =
| width =
| height =
| background =
| border =
| loop =
| Datei | Unterschrift
| Datei | Unterschrift
| ...
| ...
| ...
| Datei | Unterschrift
}}

Es genügt in den allermeisten Fällen, nur den Titel sowie die Paare Dateiname und Bildunterschrift anzugeben.

Optionale Parameter:
- |title= Titel der Bildergalerie
  - |Titel= Alias für title.
- |align= Lage am linken Rand (left, links), am rechten Rand (right, rechts) oder mittig (center, Mitte, zentriert). Standard ist rechts (right).
  - |Ausrichtung= Alias für align.
- |width= Breite der Bilder mit oder ohne „px“. Standard ist die von den Nutzern in den Einstellungen vorgegebene Breite, meist 250px. Die Breiten- und Höhenangaben sind nicht zwingend notwendig, und man sollte sie ähnlich wie im Fall der Bild-MediaWiki-Syntax vermeiden.
  - |Breite=, |Größe= Aliase für width.
- |height= Maximale Höhe der Bilder in Pixel mit oder ohne die Angabe „px“.
  - |maxHeight=, |Höhe= Aliase für height.
- |background= Hintergrundfarbe wie #123456 oder englische Begriffe wie cyan. Standard ist helles Grau (#f8f9fa).
  - |Hintergrund= Alias für background.
- |border= Rahmenfarbe wie #123456 oder englische Begriffe wie black. Standard ist Grau, #c8ccd1. Rahmenlinie kann z. B. mit border=transparent unterdrückt werden.
  - |Rahmen= Alias für border.
- |styles= Zusätzliche Stilangaben für den Container.
- |headerStyle= Zusätzliche Stilangaben für die Überschrift.
- |imageGrStyle= Zusätzliche Stilangaben für den Bildcontainer.
- |loop=no oder nein unterdrücken die Weiterschaltung beim ersten oder letzten Bild.
  - |Schleife= Alias für loop.

Die anzuzeigenden Abbildungen bestehen immer aus paarweisen Angaben: Dateiname und Bildunterschrift. Der Dateiname kann den Namensraumbezeichner enthalten, muss es aber nicht. Im Dateinamen und in der Bildunterschrift dürfen keine senkrechten Striche (pipe) und Gleichheitszeichen enthalten sein. Sollten diese Zeichen nötig sein, so schreibe man für das Gleichheitszeichen = und für den senkrechten Strich |.

Wenn weitere Bildparameter wie der Skalierungsfaktor hochkant gebraucht werden, so muss man sie wie folgt vor der Bildunterschrift notieren:

| Dateiname | hochkant{{==}}0.5{{!}}Bildunterschrift (man achte auf das doppelte Gleichheitszeichen)
| Dateiname | {{hochkant|0.5}}Bildunterschrift

Der Parameter hochkant kann nicht zusammen mit einer festen Größenangabe verwendet werden.

Beispiel:

Kamelmarkt in Birqasch

Qasr el-Bawiti

Zum Vergleich das allein stehende Bild: Qasr el-Bawiti, Bild 1

{{Scroll Gallery
| title = Kamelmarkt in Birqasch
| timeDependent = yes
| loop = no
| BirqashCamelMarket1.jpg | Kamelmarkt, Bild 1
| BirqashCamelMarket2.jpg | Kamelmarkt, Bild 2
| BirqashCamelMarket3.jpg | Kamelmarkt, Bild 3
| BirqashCamelMarket4.jpg | Kamelmarkt, Bild 4
| BirqashCamelMarket5.jpg | Kamelmarkt, Bild 5
| BirqashCamelMarket6.jpg | Kamelmarkt, Bild 6
| BirqashCamelMarket7.jpg | Kamelmarkt, Bild 7
| BirqashCamelMarket8.jpg | Kamelmarkt, Bild 8
}}

Auf einer Seite lassen sich mehrere Galerien platzieren.

Für zeitabhängige Galerien stehen zwei weitere Parameter zur Verfügung:

|timeDependent=yes
|hideUnitHeader=yes

Die erste Option bewirkt, dass das Startbild im Laufe des Tages so gewechselt wird, dass jedes Bild gleichlang angezeigt würde. Im Falle dieser Option (und nur dieser) könnte es sinnvoll erscheinen, den Zähler und die Pfeile auszublenden. Dies geschieht mit der zweiten Option. Was hinter dem Gleichheitszeichen steht, ist egal. Man könnte auch „ja“ oder „yes“ schreiben.

Für Administratoren

Das zugehörige Skript befindet sich in MediaWiki:Gadget-ScrollGallery.js.

Die Vorlage verwendet mehrere Stilklassen, über die sich weitere Eigenschaften vereinbaren lassen:

.voy-ImageGroup {
}
.voy-ImageGroup .voy-ImageGroupHeader {
	font-size: 110%;
	font-weight: bold;
}
.voy-ImageGroup .voy-ImageGrUnitHeader {
}

.voy-ImageGroup betrifft den äußeren div-Container, .voy-ImageGroupHeader steht für den Titel, .voy-ImageGrUnitHeader für die Zeile mit dem Zähler und den Pfeilen.

Wartungskategorien

Stilvorlagen

Vorlage:Scroll Gallery/styles.css

Bekannte Probleme

Die gängigen Browser (Chrome, Edge, Mozilla, Opera, Safari) haben bei der Bildschirmdarstellung kaum Probleme. Im Fall von deaktiviertem JavaSript wird nur das erste Bild ohne Rollen-Werkzeug dargestellt. Beim Drucken können Fehler auftreten.