Schnelleinstieg: Ein Bild in der gewünschten Größe einbinden

Der kürzeste Weg von „Plugin ist installiert“ zu „der Browser bekommt ein serverseitig verkleinertes Bild statt der vollen Datei“. Drei Schritte, etwa fünf Minuten.

• wkimage ist installiert und im Erweiterungsmanager aktiviert.
• PHP hat eine Bildbibliothek für die verwendeten Formate (GD oder Imagick).
• Eine Bilddatei liegt im Medienarchiv, und Sie dürfen eine Seite bearbeiten.

Öffnen Sie den Medienmanager (/doku.php?do=media), wählen oder legen Sie einen Namensraum an und laden Sie eine Datei hoch, zum Beispiel wiki:foto.jpg.

Notieren Sie die Medien-Kennung — Namensraum und Dateiname mit Doppelpunkt verbunden.

Bearbeiten Sie eine Seite und schreiben Sie:

{{wk:image>wiki:foto.jpg?width=800}}

Die Angaben nach dem ? folgen der Form einer Abfragezeichenkette; mehrere werden mit & verbunden.

{{wk:image>wiki:foto.jpg?width=800&alt=Ansicht der Montagehalle}}

alt ist der Text, den eine Vorleseanwendung ansagt und den der Browser zeigt, wenn das Bild ausbleibt. Ein Bild, das Bedeutung trägt, braucht ihn.

• Das Bild steht auf der Seite. Der entscheidende Unterschied ist im HTML-Quelltext sichtbar: Ausgeliefert wird eine 800 Pixel breite Fassung, nicht die Originaldatei, die per CSS kleingerechnet wird.
• Das Attribut loading=„lazy“ steht am Element — Nachladen ist die Vorgabe. Für ein Bild, das ohne Blättern sichtbar ist, schalten Sie es mit &lazy=0 ab; sonst wartet die lesende Person auf etwas, das schon auf dem Bildschirm steht.
• Laden Sie die Seite erneut. Das Bild kommt aus dem Zwischenspeicher, es wird nicht noch einmal gerechnet. Fordern Sie eine andere Breite an, entsteht ein zweites zwischengespeichertes Ergebnis; das erste bleibt.

• wkimage — Referenz: alle Optionen (maxwidth, quality, format, inline), die Einstellungen und der Helfer für den Aufruf aus PHP.
• wkopengraph — wenn dasselbe Bild als Vorschaukarte beim Teilen dienen soll.