Vorlage:Mehrere Bilder/6/Doku

Aus MosaPedia

Diese Seite ist die Dokumentations-Unterseite der Vorlage:Mehrere Bilder/6.

Diese Vorlage dient zum Anzeigen von zwei bis sechs Bildern in einem Kasten, wobei die Bilder nebeneinander oder übereinander platziert werden können. Die Verwendung der Vorlage bietet sich insbesondere bei inhaltlich zusammengehörenden Bildern an.

Die Benutzung der Vorlage gestaltet sich recht übersichtlich, die technischen Details (deren Kenntnis zur Benutzung nicht erforderlich ist) sind um einiges komplizierter.

[Bearbeiten] Benutzung

[Bearbeiten] Kopiervorlage

{{Mehrere Bilder
 | align       = left/{right}/center/none
 | Richtung    = {horizontal}/vertical
 | Breite      = 
 | Bild1       = 
 | Breite1     = 
 | Untertitel1 = 
 | Bild2       = 
 | Breite2     = 
 | Untertitel2 = 
 | Bild3       = 
 | Breite3     = 
 | Untertitel3 = 
 | Bild4       = 
 | Breite4     = 
 | Untertitel4 = 
 | Bild5       = 
 | Breite5     = 
 | Untertitel5 = 
 | Bild6       = 
 | Breite6     = 
 | Untertitel6 = 
 | Hintergrund = #FARBE
 | Kopfzeile   = 
 | Kopfzeile_align = left/right/{center}
 | Kopfzeile_Hintergrund = #FARBE
 | 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 (bis auf Bild1, Bild2 und Breite bzw. Breite1/2 kann alles weggelassen werden, siehe unten),
3. die verbleibenden Parameterwerte (Dateinamen usw.) ausfüllen.

[Bearbeiten] Parameter

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

• Alle Parameter bis auf Bild1, Bild2 und die zugehörigen Breiten sind optional.
• Die Standardwerte für die Ausrichtung sind oben 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 überschreibt die Parameter Breite1, Breite2, Breite3, Breite4, Breite5 und Breite6. Wenn die Bilder unterschiedliche Breiten haben (sollen), muss der Parameter Breite weggelassen werden.

Die Werte für den Parameter align (Ausrichtung) 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.

[Bearbeiten] Beispiele

[Bearbeiten] Horizontale Anordnung

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

[Bearbeiten] 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
}}

[Bearbeiten] 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
}}

[Bearbeiten] Technische Details

[Bearbeiten] 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.

[Bearbeiten] 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).

[Bearbeiten] Grenzen, Nachteile

• Bilder können nur entweder horizontal oder vertikal in einer Reihe angeordnet werden, aber nicht als Matrix.
• Die Anzahl der Bilder ist auf fünf beschränkt. (Diese Grenze läßt sich bei Bedarf leicht nach oben verschieben; die Version in der englischen Wikipedia unterstützt bis zu zehn Bilder.)
• Die englische Version unterstützt zusätzlich Bild-Links und Alt-Texte. (Nachrüstbar.)
• 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.