Allgemeine Aktionen:
Anmelden
Registrieren
Start ▼: Wiki Verzeichnis
»
Bereich: XWiki
»
Seite: XWikiSyntax
default
Aktionen:
Exportieren ▼: Als PDF exportieren Als RTF exportieren Als HTML exportieren
Weitere Aktionen ▼: Druckvorschau Zeige den Quellcode
Willkommen bei bytebang » XWiki Syntax Hilfe

# XWiki Syntax Hilfe

Zuletzt geändert von Administrator am 2014/06/29 19:30
Anhänge (0) · Information

XWiki Syntax 2.1 » Bearbeiten » Bilder

## XWiki Syntax 2.1: 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 befindlich an URL | `image:http://eine/url/img.png` |
Vordefiniertes Piktogramm | `image:icon:accept` |

## XWiki Syntax 2.1 Bild-Spezifikation

Der Teil in `( )` ist erforderlich, während die Teile in `{ }` optional sind.

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

- `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 im Wiki 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.
  - Piktogramme Ein Verweis mittels des Textes ``(icon:)` (iconName)`. Beispiel: `icon:accept`
    - `icon:` Ein erforderlicher Text, welcher die folgende Angabe als Piktogram 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 w3.org Seite (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)

Tags:
Erstellt von Administrator am 2014/06/29 19:30

- Anhänge (0)
- Information

(c) 2025, by bytebang e.U. - Impressum - Datenschutz / Nutzungsbedingungen
-