Vorlage:Mehrere Bilder/Doku

Aus MosaPedia

Version vom 01:05, 18. Feb. 2011

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

Diese Vorlage dient zum Anzeigen von zwei bis fünf 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 sehr einfach, die technischen Details (deren Kenntnis zur Benutzung nicht erforderlich ist) sind um einiges komplizierter.

Benutzung

Kopiervorlage

{{Mehrere Bilder
 | align       = left/{right}/center
 | Richtung    = {horizontal}/vertical
 | Breite      = 
 | Bild1       = 
 | Breite1     = 
 | Untertitel1 = 
 | Bild2       = 
 | Breite2     = 
 | Untertitel2 = 
 | Bild3       = 
 | Breite3     = 
 | Untertitel3 = 
 | Bild4       = 
 | Breite4     = 
 | Untertitel4 = 
 | Bild5       = 
 | Breite5     = 
 | Untertitel5 = 
 | 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.

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 und Breite5. Wenn die Bilder unterschiedliche Breiten haben (sollen), muss der Parameter Breite weggelassen werden.

Beispiele

Horizontale Ausrichtung

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

Vertikale Ausrichtung

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
}}

Technische Details

Herkunft

Der Code der Vorlage ist unmodifiziert von http://de.wikipedia.org/wiki/Vorlage:Mehrere_Bilder übernommen, die Dokumentation wurde ü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.

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 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.

Bekannte Probleme

• Die Option align = none, die bei einzelnen als thumb eingebundenen Bildern angegeben werden kann, wird von Mehrere Bilder nicht unterstützt.
• Die Option align = center funktioniert nicht korrekt: Wenn eine zentrierte Mehrere Bilder-Box mit einem anderen float-Objekt kollidiert, wird das Layout der ersteren beeinträchtigt.
  Es handelt sich um eine Inkonsistenz mit der aktuellen Version der Mediawiki-Stylesheets. Das Problem besteht auch in der Wikipedia, wurde dort aber vermutlich noch nicht entdeckt, da dort wegen der Stil-Richtlinien die Option align = center selten verwendet wird.