Hilfe:Galerien

Diese Seite erklärt, wie du Bilder, Grafiken und Karten als übersichtliche Galerie in Artikel einfügst und platzierst. Ob und welche Bilder sinnvoll sind, wird an anderer Stelle beschrieben (z. B. im Leitfaden für Autoren). Die Galerie eignet sich, um mehrere Bilder tabellarisch anzuordnen oder eine Bilderfolge anzubieten, die per Mausklick durchgeblättert werden kann. Auf einen separaten Abschnitt Bilder, Fotos oder Galerie sollte in den meisten Fällen verzichtet werden. Der Leser erkennt auch ohne die Überschrift, dass es sich um eine Galerie von Bildern handelt.

Grundsätzliches

Bilder sollen einen Eindruck von einem Reiseziel vermitteln. Trotzdem bleibt Text der wichtigste Inhalt eines Wikivoyage-Artikels. Setze daher Bilder mit Bedacht ein und wähle nur repräsentative Bilder aus. Auf Smartphones kann eine zu große Anzahl von Bildern schnell zu großen Textlücken und langem Scrollen führen. Speziell Bildergalerien sollten daher nur an ausgewählten Stellen platziert werden. Bitte prüfe auch bei Gelegenheit, wie dein Artikel auf einem Smartphone präsentiert wird und nimm gegebenenfalls ein paar Anpassungen vor.

Benutze für Bildergaleriern nie Tabellen und ähnliche manuelle Konstruktionen, sondern nur die beiden hier vorgestellten Hilfsmittel. Tabellen haben den großen Nachteil, keine responsive Darstellung auf Mobilegeräten zu erzeugen.

Das Tag <gallery>...</gallery> ist Bestandteil der Wikisoftware und bietet eine Vielzahl von Optionen
Die {{Scroll Gallery}} erzeugt eine Box mit Bildern, durch die man sich hindurchklicken kann.

`<gallery>...</gallery>`

Es werden automatisch so viele Bilder in der Größe eines Wikivoyage-Vorschaubildes (mit 220px Bildbreite für nicht angemeldete Benutzer) dynamisch nebeneinandergesetzt, wie es die horizontale Bildschirmbreite zulässt. Die Anweisung jedes Bildes muss jeweils in einer eigenen Zeile stehen:

<gallery>
 Rotkehlchen gr.jpg|Rotkehlchen
 Gaense2004.jpg|Gänse
 Waran.jpg|Komodowaran
 Cat outside.jpg|Hauskatze
 Turtle mazunte oaxaca mexico claudio giovenzana 2010.jpg|Schildkröte
 Carcharhinus melanopterus Luc Viatour.jpg|Hai
</gallery>

Rotkehlchen
Gänse
Komodowaran
Hauskatze
Schildkröte
Hai

Syntax

Die grundsätzliche Syntax des Galerie-Elements lautet:

<gallery>
    Bildseitentitel.ext|Bildlegende
    Bildseitentitel anders.ext|Andere Bildlegende
</gallery>

Sowohl das umschließende <gallery>-Tag wie auch jede Zeile, die ein einzelnes Bild beschreibt, haben eine spezifische Syntax mit weiteren Möglichkeiten.

gallery-Tag

Wie die meisten Tags akzeptiert auch <gallery> Attribute. Sie haben die Form

attributname="Wertangabe"

Unterstützt werden:

caption=

Überschrift, die zentriert über der Galerie angeordnet wird; siehe Überschrift.

Einfache Wiki-Syntax wie ein Wikilink ist möglich, nicht aber eigene Elemente.

widths=

Zahlenwert in Pixeln, der eine abweichende Bildbreite angibt; siehe Skalierung.

heights=

Zahlenwert in Pixeln, der die maximale Bildhöhe angibt; siehe Skalierung.

perrow=

Anzahl der Bilder pro Zeile; siehe Bilder pro Reihe.

perrow="0" ist die Vorgabe und nutzt die momentane Bildschirmbreite aus.

Die Bezeichnung perrow kommt von englisch per-row, pro Zeile.

showfilename

showfilename="1" oder einfach nur showfilename – zeigt in der Bildlegende den jeweiligen Medienbezeichner an; siehe unten.

Vorgesehen für Wartungsseiten und Diskussionen über eine Zusammenstellung, nicht für enzyklopädische Artikel.

mode=

Experimenteller Parameter für zusätzliche Darstellungsmethoden.

Einer von:

"traditional" – Vorgabe; entspricht keiner Angabe
"nolines" – siehe unten
"packed" – siehe unten
"packed-hover"
"packed-overlay"

style=: Universalattribut für dekorative Eigenschaften
class=: Universalattribut – Projektorganisation und projektweite dekorative Eigenschaften

Definitionszeilen

Für den Block aus Definitionszeilen gilt:

Jede Zeile beschreibt genau ein Einzelbild.
Ein Zeilenumbruch darf also nicht in der Einzeldefinition vorkommen (Ausnahme: innerhalb einer abgeschlossenen Vorlageneinbindung).
Die Zeilen können um einige Leerzeichen eingerückt werden, um die Übersichtlichkeit des Quelltextes zu verbessern. Insbesondere wenn lange Einträge bei der Darstellung auf mehrere Zeilen verteilt werden, lässt sich so der Beginn neuer Einträge gut erkennen.
Zeilen mit anderen Inhalten sollten in diesem Block nicht auftreten.

Für jeden Eintrag gilt eine der nachstehenden Syntaxvarianten:

   Bildseitentitel.ext
   Bildseitentitel.ext|Bildlegende
   Bildseitentitel.ext|Zusatzparameter|Bildlegende
   Bildseitentitel.ext|Bildlegende|alt=Alternative Bildbeschreibung

Zu den einzelnen Komponenten:

Bildseitentitel.ext
- Das ist der Bezeichner der Mediendatei, etwa: Beispiel.jpg
- Früher war es erforderlich gewesen, den Namensraumbezeichner voranzustellen (also Datei: oder auch Bild: oder File: oder Image:).
- Heutzutage ist das nicht mehr üblich.
- Damit lässt sich der Eintrag auch problemlos in fremdsprachliche Wikis kopieren oder aus diesen stiebitzen.
- Für die Suche im Quelltext ist das nicht erforderlich, weil Bildtitel.ext bereits weitgehend eindeutig ist.
Bildlegende
- Sie sollte möglichst kurz sein.
- Pipe-Symbole | sind nur innerhalb geschlossener Wikilinks oder Vorlageneinbindungen erlaubt.
Zusatzparameter
- Sie kommen nur in Sonderfällen bei bestimmten Medientypen vor.
- Vorstellbar sind:
  - Mydoc.pdf|page=5|Bildlegende
  - MyTiff.tif|lossy|Bildlegende
alt=
- Ausführliche Bildbeschreibung für Anwender, die die Grafik nicht sehen können; insbesondere für Screenreader.
- Siehe entsprechend zur Bildeinbindung.

Darstellungsvarianten von Galerien

Es ist weiterhin möglich, die Darstellung einer Galerie über vier zusätzliche Schlüsselwörter zu verändern. Bei den folgenden Varianten wird zudem der Beschreibungstext unter dem Bild zentriert ausgerichtet.

mode="nolines" stellt die Galerie so ein, dass keine sichtbare Begrenzungslinie um die einzelnen Bilder herum angezeigt werden. Hiermit wird die Breite der Galerie stark reduziert. Dadurch, dass keine Begrenzung mehr um die Bilder der Galerie angezeigt wird, können unschöne Abstände am unteren Rand entstehen.
mode="packed" zentriert die Galerie und füllt die Bilder dynamisch auf die zur Verfügung stehende Seitenbreite bei einheitlicher Bildhöhe aus. Die Höhe der gesamten Galerie richtet sich dabei nach dem größten Bild. Somit werden sowohl hochkant wie auch quer fotografierte Bilder am oberen und unteren Bildrand bündig dargestellt.
mode="packed-overlay" und mode="packed-hover" modifizieren die Anzeige der Beschriftung, die sich standardmäßig unter den Bildern befindet: Die Beschriftung wird dadurch entweder mit einem leicht durchsichtigen Hintergrund über das Bild gelegt oder sie wird nur dann angezeigt, wenn sich der Mauszeiger auf dem jeweiligen Bild der Galerie befindet. Diese Darstellungsvarianten sollten nicht in Artikeln, sondern allenfalls auf Benutzerseiten verwendet werden: Bei Verwendung der Overlay-Option werden mit großer Wahrscheinlichkeit durch eine permanent sichtbare Beschriftung wichtige Bildteile abgedeckt. Es kann vorkommen, dass sich die Beschriftung weit außerhalb des Bildrahmens ausdehnt, beispielsweise bei der mobilen Darstellung auf Handys. Bei der zweiten Variante sind und enzyklopädischer Wert der Galerie durch den nicht permanent sichtbaren Text eingeschränkt, und der Text wird möglicherweise auch gar nicht angezeigt (beispielsweise im Falle von deaktiviertem JavaScript).
mode="slideshow" zeigt immer nur ein Bild großformatig an, wobei man über Kontrollelemente zum nächsten oder vorigen Bild in der Galerie blättern kann.

Achtung!

mode="packed", mode="packed-overlay" und mode="packed-hover" führen in Verbindung mit heights="…" und/oder perrow="…" häufig zu unerwarteten und fehlerhaften Ergebnissen, denn Höhe und Anzahl der Bilder werden mit den packed-Optionen dynamisch berechnet. Sie können dann nicht sinnvoll fest vorgegeben werden. Außerdem kann (nur hier) mit caption="Überschrift" kein Zeilenumbruch eingefügt werden, lange Überschriften sind unter Umständen breiter als die Bildergalerie.

In den folgenden Beispielen sind die Optionen unterteilt nach Code und Ausgabe dargestellt:

mode="nolines"

<gallery mode="nolines">
 Rotkehlchen gr.jpg|Rotkehlchen
 Gaense2004.jpg|Gänse
 Waran.jpg|Komodowaran
 Cat outside.jpg|Hauskatze
 Turtle mazunte oaxaca mexico claudio giovenzana 2010.jpg|Schildkröte
 Carcharhinus melanopterus Luc Viatour.jpg|Hai
</gallery>

Rotkehlchen
Gänse
Komodowaran
Hauskatze
Schildkröte
Hai

mode="packed"

<gallery mode="packed">
 Rotkehlchen gr.jpg|Rotkehlchen
 Gaense2004.jpg|Gänse
 Waran.jpg|Komodowaran
 Cat outside.jpg|Hauskatze
 Turtle mazunte oaxaca mexico claudio giovenzana 2010.jpg|Schildkröte
 Carcharhinus melanopterus Luc Viatour.jpg|Hai
</gallery>

Rotkehlchen
Gänse
Komodowaran
Hauskatze
Schildkröte
Hai

mode="packed-overlay"

<gallery mode="packed-overlay">
 Rotkehlchen gr.jpg|Rotkehlchen
 Gaense2004.jpg|Gänse
 Waran.jpg|Komodowaran
 Cat outside.jpg|Hauskatze
 Turtle mazunte oaxaca mexico claudio giovenzana 2010.jpg|Schildkröte
 Carcharhinus melanopterus Luc Viatour.jpg|Hai
</gallery>

Rotkehlchen
Gänse
Komodowaran
Hauskatze
Schildkröte
Hai

mode="packed-hover"

Die Bildlegende erscheint erst, wenn der Mauszeiger über dem Bild steht. Aktiviertes JavaScript ist Voraussetzung.

Leser mit einem Touchscreen können die Bildlegende niemals sehen, da diese keinen Mauszeiger haben und in der Regel auch keinen gleichartigen Effekt bewirken können. Eine Auswahl des Bildes zeigt hier nicht die Bildlegende, sondern öffnet die Dateibeschreibungsseite.

Die Verwendung dieses Modus ist deshalb nicht für enzyklopädische Artikel, sondern höchstens für persönliche Benutzerseiten geeignet.

<gallery mode="packed-hover">
 Rotkehlchen gr.jpg|Rotkehlchen
 Gaense2004.jpg|Gänse
 Waran.jpg|Komodowaran
 Cat outside.jpg|Hauskatze
 Turtle mazunte oaxaca mexico claudio giovenzana 2010.jpg|Schildkröte
 Carcharhinus melanopterus Luc Viatour.jpg|Hai
</gallery>

Rotkehlchen
Gänse
Komodowaran
Hauskatze
Schildkröte
Hai

Bilder pro Reihe – Ausrichtung

Mit dem Schlüsselwort perrow="…" kann fest angegeben werden, wie viele Bilder maximal^[1] pro Bilderzeile gezeigt werden sollen. Im Normalfall sollte diese Option vermieden werden, da das Kommando die Standardeinstellungen überschreibt und so beispielsweise das automatische Ausnutzen der zur Verfügung stehenden Bildschirmbreite verhindert.

Der Zusatz class="float-right" (oder selten: class="float-left") setzt die Ausrichtung der Galerie relativ zum Text fest; also am rechten Rand und vom Fließtext umflossen.

Beispiel für Ausrichtung einer Galerie an der rechten Textseite

<gallery perrow="2" class="float-right">
 Rotkehlchen gr.jpg|[[Rotkehlchen]]
 Gaense2004.jpg|[[Gänse]]
 Waran.jpg|[[Komodowaran]]
 Cat outside.jpg|[[Hauskatze]]
</gallery>

Lorem ipsum dolor sit amet, consectetur adipisici elit, sed eiusmod tempor incidunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquid ex ea commodi consequat. Quis aute iure reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint obcaecat cupiditat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum. Duis autem vel eum iriure dolor in hendrerit in vulputate velit esse molestie consequat, vel illum dolore eu feugiat nulla facilisis at vero eros et accumsan et iusto odio dignissim qui blandit praesent luptatum zzril delenit augue duis dolore te feugait nulla facilisi. Lorem ipsum dolor sit amet, consectetuer adipiscing elit, sed diam nonummy nibh euismod tincidunt ut laoreet dolore magna aliquam erat volutpat. Ut wisi enim ad minim veniam, quis nostrud exerci tation ullamcorper suscipit lobortis nisl ut aliquip ex ea commodo consequat. Duis autem vel eum iriure dolor in hendrerit in vulputate velit esse molestie consequat, vel illum dolore eu feugiat nulla facilisis at vero eros et accumsan et iusto odio dignissim qui blandit praesent luptatum zzril delenit augue duis dolore te feugait nulla facilisi. Nam liber tempor cum soluta nobis eleifend option congue nihil imperdiet doming id quod mazim placerat facer possim assum. Lorem ipsum dolor sit amet, consectetuer adipiscing elit, sed diam nonummy nibh euismod tincidunt ut laoreet dolore magna aliquam erat volutpat. Ut wisi enim ad minim veniam, quis nostrud exerci tation ullamcorper suscipit lobortis nisl ut aliquip ex ea commodo consequat. Duis autem vel eum iriure dolor in hendrerit in vulputate velit esse molestie consequat, vel illum dolore eu feugiat nulla facilisis.At vero eos et accusam et justo duo dolores et ea rebum. Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor sit amet. Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam voluptua. At vero eos et accusam et justo duo dolores et ea rebum. Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor sit amet. [= beliebiges Textbeispiel (Lorem ipsum)]

Das Attribut perrow verträgt sich nicht mit der Angabe class="center", die Klasse wird dann ignoriert.
Soll einer Galerie, die in der Mitte der Seite angezeigt werden soll, eine feste Anzahl Bilder über perrow zugewiesen werden, so kann man entweder class="centered" perrow="2" verwenden, wenn der Bildtext linksbündig ausgerichtet sein soll, oder die Klasse auf class="center centered" perrow="2" erweitern, was sowohl die Galerie als auch den Text der Bildbeschreibung zentriert.

Beispiele für eine zentrierte Ausrichtung dieser Galerie
Je zwei Bilder untereinander in der Seitenmitte, Text linksbündig.

<gallery class="centered" perrow="2">
 Rotkehlchen gr.jpg|[[Rotkehlchen]]
 Gaense2004.jpg|[[Gänse]]
 Waran.jpg|[[Komodowaran]]
 Cat outside.jpg|[[Hauskatze]]
</gallery>

Je zwei Bilder untereinander in der Seitenmitte, Text zentriert.

<gallery class="center centered" perrow="2">
 Rotkehlchen gr.jpg|[[Rotkehlchen]]
 Gaense2004.jpg|[[Gänse]]
 Waran.jpg|[[Komodowaran]]
 Cat outside.jpg|[[Hauskatze]]
</gallery>

Die Zuweisung class="center" wirkt sich hier nur auf die Ausrichtung der Bildbeschreibungen aus, die zentriert unter den Bildern stehen. Die Zuweisung perrow="2" setzt jeweils zwei Bilder untereinander.

<gallery class="center" perrow="2">
 Rotkehlchen gr.jpg|[[Rotkehlchen]]
 Gaense2004.jpg|[[Gänse]]
 Waran.jpg|[[Komodowaran]]
 Cat outside.jpg|[[Hauskatze]]
</gallery>

Überschrift

Mit dem optionalen Schlüsselwort caption lässt sich eine Überschrift einfügen: <gallery caption="Vögel mit Dateinamen">

Wird keine Anzahl der Bilder pro Seite festgelegt (siehe oben), wird die Überschrift in der Mitte der Seite platziert und nicht mittig über den Bildern (wie im folgenden Beispiel „Vögel mit Dateinamen“). (Siehe phab:T29540 (Bugzilla:27540))

Mit dem Schlüsselwort showfilename wird der Dateiname vor der optionalen Bild-Legende angezeigt:

<gallery caption="Vögel mit Dateinamen" showfilename>
 Rotkehlchen gr.jpg|[[Rotkehlchen]]
 Gaense2004.jpg|[[Gänse]]
 Carcharhinus melanopterus Luc Viatour.jpg|… eher kein Vogel
</gallery>

Vögel mit Dateinamen
Rotkehlchen gr.jpg Rotkehlchen
Gaense2004.jpg Gänse
Carcharhinus melanopterus Luc Viatour.jpg … eher kein Vogel

Mit perrow="x" (x = Anzahl der Bilder) kann hingegen die Überschrift über der Mitte der Bildfolge platziert werden.

<gallery caption="Vögel mit Dateinamen" perrow="3" showfilename>
 Rotkehlchen gr.jpg|[[Rotkehlchen]]
 Gaense2004.jpg|[[Gänse]]
 Carcharhinus melanopterus Luc Viatour.jpg|… eher kein Vogel
</gallery>

Vögel mit Dateinamen
Rotkehlchen gr.jpg Rotkehlchen
Gaense2004.jpg Gänse
Carcharhinus melanopterus Luc Viatour.jpg … eher kein Vogel

Soll eine Galerie mit nur wenigen Bildern unter der seitenmittig stehenden Überschrift platziert werden, kann class="center" verwendet werden:

<gallery class="center" caption="Vögel ohne Dateinamen">
 Rotkehlchen gr.jpg|[[Rotkehlchen]]
 Gaense2004.jpg|[[Gänse]]
 Carcharhinus melanopterus Luc Viatour.jpg|… eher kein Vogel
</gallery>

Vögel ohne Dateinamen
Rotkehlchen
Gänse
… eher kein Vogel

Skalierung in Galerien

Mit dem Schlüsselwort widths="…" wird die Breite, mit heights="…" die Höhe der Bilder festgelegt. Das jeweils breiteste bzw. höchste Bild wird für die Galerie als Maßstab genommen und die kleineren Bilder entsprechend angepasst. Es ist sinnvoll, sowohl einen Wert für heights als auch für widths anzugeben, da die Software ansonsten für den jeweils anderen Wert die Größe eines Vorschaubildes (220 px Breite) beibehält. Im packed-Modus ist der Parameter widths wirkungslos.

<gallery widths="120" heights="300" perrow="4" caption="Hochhäuser">
 Eureka Tower 0944a.jpg|Eureka Tower, Melbourne
 Shun Hing Square.jpg|Shun Hing Square, Shenzhen
 JinMaoBuilding.jpg|Jin Mao Building, Pudong, Shanghai
 Post Tower Bonn.jpg|Post Tower, Bonn
</gallery>

Hochhäuser
Eureka Tower, Melbourne
Shun Hing Square, Shenzhen
Jin Mao Building, Pudong, Shanghai
Post Tower, Bonn

Bilderfolge zum Durchblättern per Mausklick – mode="slideshow"

Bilderfolgen sollten nur verwendet werden, wenn unbedingt nötig, denn:

In der Druckversion und der PDF-Version des Artikels sowie in der Buchfunktion können Bilder nicht gestapelt wiedergegeben werden. Die Bilder werden stattdessen neben- oder untereinander dargestellt und beeinträchtigen so das Layout.
Manche Browser (darunter der Internet Explorer) haben Schwierigkeiten mit der korrekten Wiedergabe einer solchen Scrollgalerie.
Die Funktion ist insgesamt noch nicht ausgereift, so dass auch in den neuesten und ansonsten kompatiblen Browsern die Bilder unter Umständen unter- oder nebeneinander sowie größer oder kleiner als erwartet dargestellt werden.

Diese Funktion ist in seltenen Fällen sinnvoll, um z. B. Abläufe schrittweise zu visualisieren. Sie sollte nicht dazu benutzt werden, zusätzliche Bilder im Artikel unterzubringen, die nicht relevant genug sind, um sie direkt im Artikel abzubilden. Bilder mit zentraler Relevanz zum Verstehen des Artikels sollten direkt eingebunden werden.

Die Bilder in einer Bilderfolge werden nicht in Thumbnail-Größe dargestellt, sondern so groß, wie Platz zur Verfügung steht. Da auch die üblichen Angaben heights und widths von diesem Modus nicht unterstützt werden, sollte die Bildergröße mit dem Parameter style="max-width:…px beschränkt werden:

<gallery mode="slideshow" caption="Zu Luft, zu Lande und im Wasser" style="max-width:300px">
 Rotkehlchen gr.jpg|Rotkehlchen
 Gaense2004.jpg|Gänse
 Waran.jpg|Komodowaran
 Cat outside.jpg|Hauskatze
 Turtle mazunte oaxaca mexico claudio giovenzana 2010.jpg|Schildkröte
 Carcharhinus melanopterus Luc Viatour.jpg|Hai
</gallery>

Zu Luft, zu Lande und im Wasser
Rotkehlchen
Gänse
Komodowaran
Hauskatze
Schildkröte
Hai

Zu beachten ist:

Die Angabe einer maximalen Bildgröße mit style="max-width:…px kann bewirken, dass die Bilder am rechten Rand beschnitten dargestellt werden. Die Angabe sollte dann weggelassen werden. Alternativ kann die Vorlage {{Scroll Gallery}} verwendet werden, bei welcher eine Angabe der Bildbreite möglich ist.
Die Darstellung der Galerie kann bei der Nutzung der Vorschau-Funktion des Editors von der endgültigen Darstellung nach dem Abspeichern abweichen. (Dies gilt ebenso für Slideshow-Galerien, die mit der Vorlage {{Scroll Gallery}} eingefügt werden.)

Zum Vergleich eine mithilfe der Vorlage {{Scroll Gallery}} (siehe nächster Abschnitt) und derselben Größenvorgabe von 300 px eingefügte Bilderfolge:

Zu Luft, zu Lande und im Wasser

Formatierung der Beschriftung

Wie die meisten Elemente lässt sich ein gallery-Element mit Textformatierungen ausstatten. Beispiele (mit heights="40" gesetzt):

Beschriftung zentriert: `<gallery style="text-align:center">`	Eine Forelle	statt alle einzeln mit dem obendrein veralteten `<center>…</center>`
alle kursiv: `<gallery style="font-style:italic">`	Salmo trutta	Ersatz für die `''`-Syntax für alle Bildlegenden, die dann auch nicht mehr wirkt
groß: `<gallery style="font-size:150%">`	1	Nur bei Bildernummerierungen

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

{{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 220px. 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

Beispiel:

Kamelmarkt in Birqasch

Zum Vergleich das allein stehende Bild: Kamelmarkt, 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.

Visual Editor

Auf Galerien/VisualEditor findest du eine Beschreibung wie Galerien mit der Bearbeitungsumgebung VisualEditor im Seitentext erstellt oder bearbeitet werden können.

Weitere Informationen

MediaWiki: Help:Images – Technische Informationen (englisch)

Anmerkungen

↑ So zumindest das aktuelle Verhalten der Software; vor Februar 2011 wurde die Angabe dagegen als fixe Angabe interpretiert.

[Anmerkung_zu_maximal-1] So zumindest das aktuelle Verhalten der Software; vor Februar 2011 wurde die Angabe dagegen als fixe Angabe interpretiert.

[1]