Vorlage:Mehrere Bilder/X/Doku

Diese Vorlage steht unter der folgenden Lizenz und darf unter den Bedingungen dieser Lizenz weiterverbreitet werden (Benutzer:Kobold 21.02.2011):

Diese Vorlage wurde unter der Lizenz „Creative Commons Namensnennung–Weitergabe unter gleichen Bedingungen“ (abgekürzt „cc-by-sa“) in der Version 3.0 veröffentlicht. Rechtsverbindlicher Lizenzvertrag: http://creativecommons.org/licenses/by-sa/3.0/legalcode Kurzfassung in deutscher Sprache: http://creativecommons.org/licenses/by-sa/3.0/deed.de

Kurzform (Die wichtigsten Parameter)

{{Mehrere Bilder
 | align       = left/{right}/center/none
 | Richtung    = {horizontal}/h2/h3/h4/h5/h6
                    /vertical/v2/v3/v4/v5/v6
 | Kopfzeile   = 
 | Breite      = 
 | Bild1       = 
 | Breite1     = 
 | Untertitel1 = 
 | Bild2       = 
 | Breite2     = 
 | Untertitel2 = 
 | Bild3       = 
 | Breite3     = 
 | Untertitel3 = 
 | Bild4       = 
 | Breite4     = 
 | Untertitel4 = 
 | Bild5       = 
 | Breite5     = 
 | Untertitel5 = 
 | Bild6       = 
 | Breite6     = 
 | Untertitel6 = 
 | Fußzeile    = 
}}

Langform (Alle Parameter)

{{Mehrere Bilder
 | align        = left/{right}/center/none
 | Richtung     = {horizontal}/h2/h3/h4/h5/h6
                     /vertical/v2/v3/v4/v5/v6
 | Rand         = {1}
 | Hintergrund  = #FARBE
 | Kopfzeile    = 
 | Kopfzeile_align = left/right/{center}
 | Kopfzeile_Hintergrund = #FARBE
 | Breite       = 
 | Bild1        = 
 | Breite1      = 
 | Untertitel1  = 
 | Alt1         =
 | Link1        =
 | Bild2        = 
 | Breite2      = 
 | Untertitel2  = 
 | Alt2         =
 | Link2        =
 | Bild3        = 
 | Breite3      = 
 | Untertitel3  = 
 | Alt3         =
 | Link3        =
 | Bild4        = 
 | Breite4      = 
 | Untertitel4  = 
 | Alt4         =
 | Link4        =
 | Bild5        = 
 | Breite5      = 
 | Untertitel5  = 
 | Alt5         =
 | Link5        =
 | Bild6        = 
 | Breite6      = 
 | Untertitel6  = 
 | Alt6         =
 | Link6        =
 | Bild7        = 
 | Breite7      = 
 | Untertitel7  = 
 | Alt7         =
 | Link7        =
 | Bild8        = 
 | Breite8      = 
 | Untertitel8  = 
 | Alt8         =
 | Link8        =
 | Bild9        = 
 | Breite9      = 
 | Untertitel9  = 
 | Alt9         =
 | Link9        =
 | Bild10       = 
 | Breite10     = 
 | Untertitel10 = 
 | Alt10        =
 | Link10       =
 | Bild11       = 
 | Breite11     = 
 | Untertitel11 = 
 | Alt11        =
 | Link11       =
 | Bild12       = 
 | Breite12     = 
 | Untertitel12 = 
 | Alt12        =
 | Link12       =
 | Fußzeile    = 
 | Fußzeile_align = {left}/right/center
 | Fußzeile_Hintergrund = #FARBE
}}

Benutzung:

1. Den Text im obenstehenden Kasten kopieren und an der gewünschten Stelle einfügen (〈Strg-C〉+〈Strg-V〉, unter Linux alternativ linke/mittlere Maustaste, usw.),
2. die Zeilen mit den nicht benötigten Parametern löschen (alle Parameter sind optional und können weggelassen werden),
3. die verbleibenden Parameterwerte (Dateinamen usw.) ausfüllen.

Parameter

Alle von der Vorlage unterstützten Parameter sind rechts in der Kopiervorlage aufgeführt.

• Alle Parameter bis auf die Breiten der eingebundenen Bilder sind optional und können prinzipiell weggelassen werden. (Natürlich macht die Benutzung der Vorlage wenig Sinn, wenn keine Bilddateien angegeben werden.)
• Die Standardwerte für die Ausrichtung sind mit Klammern hervorgehoben (z.B. {center}).
• Die Breiten sind als "nackte" Zahlen anzugeben (ohne "px"). Die Breiten der eingebundenen Bilder müssen immer angegeben werden, entweder global oder individuell.
• Der Parameter Breite wird (nur) für die Bilder verwendet, für die keine individuelle Breite (Breite1, Breite2 usw.) angegeben ist. (Achtung: In der ursprünglichen Version der Vorlage hatte Breite Vorrang vor Breite1, Breite2 usw., ebenso in der gleichnamigen Vorlage in der Wikipedia.)
• Der Parameter align bestimmt die Position bzw. Ausrichtung der Bilder-Box auf der Seite. Die Werte für align haben dieselbe Bedeutung wie beim Einbinden von Einzelbildern, das heißt:
  • left (links) und right (rechts): Darstellung am Rand, umflossen vom Text, die Bilder können ggf. nach unten rutschen;
  • center (zentriert) und none (keine, bzw. linksbündig an Ort und Stelle): der Textfluss wird unterbrochen, d.h. links und rechts vom Bild steht kein Text, der Text geht erst nach dem Bild weiter.
• Der Parameter Richtung bestimmt die Anordnung der Einzelbilder innerhalb der Box. (In der aktuellen Version wäre "Anordnung" treffender, der Name "Richtung" wird aus historischen Gründen beibehalten.)
  • horizontal bzw. h: Alle Bilder werden in einer Zeile von links nach rechts angeordnet.
  • h2, h3, h4, h5, h6: Zeilenweise Anordnung von links nach rechts; zwei, drei, vier, fünf bzw. sechs Bilder pro Zeile; Zeilen untereinander.
  • v2, v3, v4, v5, v6: Spaltenweise Anordnung von oben nach unten; zwei, drei, vier, fünf bzw. sechs Bilder pro Spalte; Spalten von links nach rechts.
  • vertical bzw. v: Alle Bilder werden in einer Spalte untereinander angeordnet.
• Mit den Parametern Link1...Link12 können Links auf die Bilder gesetzt werden. (Standardmäßig sind Bilder auf ihre Bildbeschreibungsseite verlinkt. Hiervon soll nur in Ausnahmefällen abgewichen werden.)
• Die Parameter Alt1...Alt12 setzten Alt-Texte, die in der MosaPedia kaum verwendet werden.

Beispiele

Horizontale Anordnung

{{Mehrere Bilder
 | Fußzeile = Spieler erhalten…
 | Breite   = 60
 | Bild1    = Yellow card.svg
 | Bild2    = Red card.svg
}}

Vertikale Anordnung

Laudanum

Ein Schluck…

…zeigt Wirkung

{{Mehrere Bilder
 | align       = left
 | Richtung    = vertical
 | Kopfzeile   = [[Laudanum]]
 | Breite      = 200
 | Bild1       = Huygens Laudanum1.jpg
 | Untertitel1 = Ein Schluck…
 | Bild2       = Huygens Laudanum2.jpg
 | Untertitel2 = …zeigt Wirkung
}}

Beispiel mit Hintergrundfarbe

Anna

Bella

Caramella

Die drei Hauptfiguren aus dem Mädchen-Mosaik

{{Mehrere Bilder
 | Hintergrund = #FFCAD8
 | Bild1=Anna ABC001.jpg      | Breite1=166 | Untertitel1=[[Anna]]
 | Bild2=Bella ABC001.jpg     | Breite2=171 | Untertitel2=[[Bella]]
 | Bild3=Caramella ABC001.jpg | Breite3=150 | Untertitel3=[[Caramella]]
 | Fußzeile       = Die drei Hauptfiguren aus dem [[Mädchen-Mosaik]]
 | Fußzeile_align = center
}}

Beispiel mit variabler Anordnung

Einzeilig

h = horizontal

{{Mehrere Bilder | Breite=70 | Richtung=h
 | Bild1=Tb_385.jpg | Untertitel1=[[385]] | Bild7 =Tb_391.jpg | Untertitel7 =[[391]]
 | Bild2=Tb_386.jpg | Untertitel2=[[386]] | Bild8 =Tb_392.jpg | Untertitel8 =[[392]]
 | Bild3=Tb_387.jpg | Untertitel3=[[387]] | Bild9 =Tb_393.jpg | Untertitel9 =[[393]]
 | Bild4=Tb_388.jpg | Untertitel4=[[388]] | Bild10=Tb_394.jpg | Untertitel10=[[394]]
 | Bild5=Tb_389.jpg | Untertitel5=[[389]] | Bild11=Tb_395.jpg | Untertitel11=[[395]]
 | Bild6=Tb_390.jpg | Untertitel6=[[390]] | Bild12=Tb_396.jpg | Untertitel12=[[396]]
}}

385

386

387

388

389

390

391

392

393

394

395

396

Zweizeilig

h6 = horizontal, 6 Bilder pro Zeile

{{Mehrere Bilder | Breite=70 | Richtung=h6
 | Bild1=Tb_385.jpg | Untertitel1=[[385]] | Bild7 =Tb_391.jpg | Untertitel7 =[[391]]
 | Bild2=Tb_386.jpg | Untertitel2=[[386]] | Bild8 =Tb_392.jpg | Untertitel8 =[[392]]
 | Bild3=Tb_387.jpg | Untertitel3=[[387]] | Bild9 =Tb_393.jpg | Untertitel9 =[[393]]
 | Bild4=Tb_388.jpg | Untertitel4=[[388]] | Bild10=Tb_394.jpg | Untertitel10=[[394]]
 | Bild5=Tb_389.jpg | Untertitel5=[[389]] | Bild11=Tb_395.jpg | Untertitel11=[[395]]
 | Bild6=Tb_390.jpg | Untertitel6=[[390]] | Bild12=Tb_396.jpg | Untertitel12=[[396]]
}}

385

386

387

388

389

390

391

392

393

394

395

396

Dreizeilig

h4 = horizontal, 4 Bilder pro Zeile

{{Mehrere Bilder | Breite=70 | Richtung=h4
 | Bild1=Tb_385.jpg | Untertitel1=[[385]] | Bild7 =Tb_391.jpg | Untertitel7 =[[391]]
 | Bild2=Tb_386.jpg | Untertitel2=[[386]] | Bild8 =Tb_392.jpg | Untertitel8 =[[392]]
 | Bild3=Tb_387.jpg | Untertitel3=[[387]] | Bild9 =Tb_393.jpg | Untertitel9 =[[393]]
 | Bild4=Tb_388.jpg | Untertitel4=[[388]] | Bild10=Tb_394.jpg | Untertitel10=[[394]]
 | Bild5=Tb_389.jpg | Untertitel5=[[389]] | Bild11=Tb_395.jpg | Untertitel11=[[395]]
 | Bild6=Tb_390.jpg | Untertitel6=[[390]] | Bild12=Tb_396.jpg | Untertitel12=[[396]]
}}

385

386

387

388

389

390

391

392

393

394

395

396

Dito, anders angeordnet

v3 = vertikal, 3 Bilder pro Spalte

{{Mehrere Bilder | Breite=70 | Richtung=v3
 | Bild1=Tb_385.jpg | Untertitel1=[[385]] | Bild7 =Tb_391.jpg | Untertitel7 =[[391]]
 | Bild2=Tb_386.jpg | Untertitel2=[[386]] | Bild8 =Tb_392.jpg | Untertitel8 =[[392]]
 | Bild3=Tb_387.jpg | Untertitel3=[[387]] | Bild9 =Tb_393.jpg | Untertitel9 =[[393]]
 | Bild4=Tb_388.jpg | Untertitel4=[[388]] | Bild10=Tb_394.jpg | Untertitel10=[[394]]
 | Bild5=Tb_389.jpg | Untertitel5=[[389]] | Bild11=Tb_395.jpg | Untertitel11=[[395]]
 | Bild6=Tb_390.jpg | Untertitel6=[[390]] | Bild12=Tb_396.jpg | Untertitel12=[[396]]
}}

385

386

387

388

389

390

391

392

393

394

395

396

Technische Details

Herkunft

Der Code der Vorlage wurde von http://de.wikipedia.org/wiki/Vorlage:Mehrere_Bilder übernommen und geringfügig überarbeitet (korrigiertes Layout für den Fall align=center, Unterstützung von align=none). Die Dokumentation wurde ebenfalls überarbeitet und an die MosaPedia angepasst.

In der deutschsprachigen Wikipedia wird die Vorlage Mehrere_Bilder derzeit (nur) ca. 200mal eingebunden, sie dürfte damit hinreichend(?) getestet sein(?). In der englischsprachigen Wikipedia gibt es eine ähnliche Vorlage, die ca. 4500mal verwendet wird.

Eine komplett neu geschriebene Version (Kobold 21.02.2011) unterstützt bis zu 12 Bilder, Bild-Links und Alt-Texte sowie die mehrzeilige/mehrspaltige Anordnung von Bildern.

Interna

• Zur Positionierung der Bilder wird HTML-Code erzeugt. Die Einbindung der Einzelbilder wird dabei in entsprechend verschachtelte

  <div class="thumb tleft">
  <div class="thumb tnone">
  <div class="thumb tright">
  <div class="thumbinner">
  <div class="thumbimage">
  <div class="thumbcaption">

  eingebettet. Diese Bausteine sind dieselben, die von der Wikimedia-Software auch für gerahmte Bilder und Miniaturbilder (framed, thumbnail images) verwendet werden: darum sieht {{Mehrere Bilder|...}} genauso aus wie diese.
  Die zu diesen Classes gehörenden Style-Attribute sind in den CSS-Files des jeweiligen Skins definiert, d.h. das Aussehen von {{Mehrere Bilder|...}} wird ebenso wie das der Thumbnails ggf. von dem unter Benutzereinstellungen eingestellten Skin beeinflusst.

• Die Vorlage benutzt die Parser-Funktionen

  #if #ifeq #switch #expr

  d.h. die ParserFunctions-Extension muss auf dem Server installiert sein (unter Spezial:Version#Installierte Erweiterungen kann man sich davon überzeugen, dass das der Fall ist).

Grenzen, Nachteile

• Bilder können nur entweder zeilen- oder spaltenweise angeordnet werden, aber nicht als echte Matrix: So werden bei der zeilenweisen Anordnung übereinander stehende Bilder nicht aufeinander ausgerichtet. In diesem Sinne wird die Tabellenformatierung durch diese Vorlage nicht ersetzt, sondern ergänzt.
• Die Anzahl der Bilder ist derzeit auf zwölf beschränkt. Diese Grenze läßt sich bei Bedarf leicht nach oben verschieben.
• Auch wenn Bilder nicht skaliert werden sollen, müssen immer die Breiten angegeben werden. Die Angabe der Bildhöhe ist nicht möglich.
  Gerade bei der horizontalen Anordnung wäre letzteres wünschenswert, um alle Bilder auf eine Höhe zu bringen. In der englischen Version wird in dieser Situation empfohlen, die für die gewünschte Höhe benötigte Breite mit dem Ausdruck {{#expr: (<Höhe Soll> * <Breite Ist> / <Höhe Ist>) round 0}} durch den Wiki-Parser ausrechnen zu lassen.