XWiki Syntax 2.1 » Bearbeiten » Bilder

2.1 Images

Funktion	XWiki Syntax 2.1	Ergebnis
Bild von Anhang auf aktueller Seite	image:img.png
Bild von Anhang auf anderer Seite	image:Bereich.Seite@img.png
Bild mit Parametern	[[image:img.png||width="25" height="25"]]
Bild mit Bildunterschrift	[[~[~[XWiki~>~>https://www.xwiki.org~]~] unterstützt Bildunterschriften.>>image:img.png]]	(( ()))
Bild befindlich an URL	image:http://eine/url/img.png
Vordefiniertes Piktogramm	image:icon:accept

XWiki Syntax 2.1 Bild-Spezifikation

Das vollständige Format eines Bilder ist entweder image: (Verweis) oder [[{caption>>}image: (Verweis) {||Parameter}]]

• caption: Eine optionale Beschriftung. Kann beliebige XWiki 2.1-Syntax enthalten, aber verschachtelte Link-Syntax muss mit ~ maskiert werden. Die Beschriftung wird nur unterstützt, wenn die Bildsyntax der einzige Inhalt eines Absatzes ist.
• image: Ein erforderlicher Text, welches die folgenden Angaben als Bild kennzeichnet.
• Verweis: Der Verweis auf das anzuzeigende Bild. Der Verweis kann in folgenden Formaten angegeben werden:
  • URL: Eine URL zu einem externen Bild in dem Format http://pfad/BildName. Beispiel: http://example.org/pfad/bild.png
  • Anhang: Ein Verweis auf einen Anhang eines XWiki-Dokuments im Format {{{wikiName:} Bereich.} Seite@} (BildName)
    • wikiName: Ein optionaler Text, welcher den Namen eines Subwikis enthält. Das Bild wird dann in dem entsprechenden Subwiki nachgeschlagen. Beispiel: mywiki
    • Bereich: Der Name eines Bereiches, in dem das Bild nachgeschlagen wird (optional). Wenn kein Bereich angegeben, wird der aktuelle Bereich verwendet. Beispiel: Main
    • Seite: Der Namen einer Seite, an der das Bild angehangen ist (optional). Wird keine Seite angegeben, wird die aktuelle Seite verwendet. Beispiel: WebHome
    • BildName: Ein erforderlicher Text, welcher den Dateinamen des anzuzeigenden Bildes enthält, wie er im Wiki gespeichert ist.
  • Seiten-Anhang: Ein Verweis in der Form pageAttach:{{{(wikiName):}(seitenNamenListe)/}(anhangName)
    • pageAttach: Eine erforderliche Zeichenfolge, die die Referenz als Anhang einer XWiki-Seite identifiziert.
    • wikiName: Ein optionaler Text, welcher den Namen eines Subwikis enthält. Das Bild wird dann in dem entsprechenden Subwiki nachgeschlagen. Beispiel: mywiki
    • seitenNamenListe: Eine optionale, durch Punkte getrennte Liste von Wiki-Seitennamen. Wenn keine Seite angegeben ist, wird die aktuelle Seite verwendet. Beispiele: Main, A/B, A/B/C
    • anhangName: Eine erforderliche Zeichenfolge, die den Namen des an eine Seite angehängten Bildes enthält, wie es im Wiki gespeichert ist. Beispiel: myImage.png
  • Piktogramme Ein Verweis mittels des Textes (icon:) (iconName). Beispiel: icon:accept
    • icon: Ein erforderlicher Text, welcher die folgende Angabe als Piktogramm kennzeichnet. Piktogramme können nur aus der vorinstallierten Liste der XWiki Icons ausgewählt werden.
    • iconName: Ein erforderlicher Text mit dem (englischen) Namen des anzuzeigenden Piktogramms. Beispiel: accept
  • Data URIs in der Form (data:) (bilddaten). Beispiel: data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAUAAAAFCAYAAACNbyblAAAAHElEQVQI12P4//8/w38GIAXDIBKE0DHxgljNBAAO9TXL0Y4OHwAAAABJRU5ErkJggg==
    • data: Ein erforderlicher Text, welcher die folgende Angabe als Binärdaten zu interpretieren erlaubt, enstprechend dem 'data' URI Schema.
    • bilddaten: Angabe zu Dateiformat und Codierung, etwa für PNG-Bilder in Base64-codierung image/png;base64, gefolgt von den Binärdaten des Bildes in der angegebenen textuellen Codierung
• Parameter: Eine optionale Liste von durch Leerzeichen getrennten Parametern, die an das Bild durchgereicht werden. Beispiel: width="800" height="600" alt="Ein beispielhaftes Bild" title="Dies ist ein schönes Bild"
  • HTML Attribute: Alle Attribute, welche im HTML Standard vorgesehen sind, werden zu dem erzeugten <img> Element hinzugefügt.
    • style: CSS-Stil Anweisungen, welche auf das Bild angewendet werden. Beispiele: style="float:right;height:50px" (d.h. das Bild wird rechtsbündig eingebettet mit einer Höhe von 50 Pixeln),
      style="style="display:block;margin-left:auto;margin-right:auto;width:80%" (Bild wird zentriert dargestellt in einer Breite von 80% des zur Verfügung stehenden Platzes),
      style="vertical-align:bottom" (Der folgende Text startet direkt an unteren Ende des Bildes).
    • height: Die vertikale Grösse des angezeigten Bildes. Der Parameterwert sollte entweder in Bildschirmpixeln angeben werden (Beispiel height="80") oder in prozentualen Anteilen des Anzeigebereichs (Beispiel height="40%")
    • width: Die horizontale Grösse des angezeigten Bildes. Der Parameterwert sollte entweder in Bildschirmpixeln angeben werden (Beispiel width="120") oder in prozentualen Anteilen des Anzeigebereichs (Beispiel width="80%")
    • title: Der Text, der beim Überfahren den Bildes mit dem Mauszeiger angezeigt wird. Beispiel: title="Dies ist ein schönes Bild"
    • alt: Der Text, welcher alternativ angezeigt wird, wenn der Browser das Bild nicht darstellen kann. Da dies im HTML eine Pflichtangabe ist, verwendet XWiki den Dateinamen, wenn kein Wert für alt angegeben wurde. Beispiel: alt="Ein beispielhaftes Bild"
    • ... und mehr: Die offizielle Liste aller unterstützten Attribute kann auf der offiziellen Seite des HTML-Standards (in Englisch) eingesehen werden.
  • queryString: Ein optionaler Text, welcher als Abfrageparameter an die URL angehangen wird, unter der das Bild vom Server abgeholt wird. Beispiel: queryString="width=100&height=800&keepAspectRatio=true" (keepAspectRatio=true soll den Server veranlassen, die Seitenverhältnisse des Bildes beizubehalten, wird aber ignoriert, wenn sowohl width als auch height angegeben werden)