Avvio rapido: inserire un'immagine nella dimensione voluta

Il percorso più breve da «il plugin è installato» a «il browser riceve un'immagine ridimensionata sul server invece del file intero». Tre passi, circa cinque minuti.

• wkimage è installato e attivato nel gestore delle estensioni.
• PHP dispone di una libreria per le immagini nei formati usati (GD o Imagick).
• Un file immagine nell'archivio dei media e il permesso di modificare una pagina.

Aprire il gestore dei media (/doku.php?do=media), scegliere o creare un namespace e caricare un file, per esempio wiki:foto.jpg.

Annotare l'identificatore del media — namespace e nome del file uniti da due punti.

Modificare una pagina e scrivere:

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

Le opzioni dopo il ? seguono la forma di una stringa di query; più opzioni si uniscono con &.

{{wk:image>wiki:foto.jpg?width=800&alt=Veduta del capannone di montaggio}}

alt è il testo che uno screen reader annuncia e che il browser mostra quando l'immagine non arriva. Un'immagine che porta significato ne ha bisogno.

• L'immagine è sulla pagina. La differenza decisiva è visibile nel sorgente HTML: viene consegnata una versione larga 800 pixel, non l'originale rimpicciolito via CSS.
• L'attributo loading=“lazy” è sull'elemento — il caricamento differito è il comportamento predefinito. Per un'immagine visibile senza scorrere, disattivarlo con &lazy=0; altrimenti chi legge aspetta qualcosa che è già a schermo.
• Ricaricare la pagina. L'immagine arriva dalla cache, non viene ricalcolata. Richiedendo un'altra larghezza nasce un secondo risultato in cache; il primo resta.

• wkopengraph — se la stessa immagine deve fare da scheda di anteprima nella condivisione.
• wkimage (in tedesco) — la pagina del pacchetto: tutte le opzioni (maxwidth, quality, format, inline), le impostazioni e l'helper PHP.