Hitri začetek: vstavljanje slike v želeni velikosti
Najkrajša pot od »vtičnik je nameščen« do »brskalnik dobi sliko, pomanjšano na strežniku, namesto cele datoteke«. Trije koraki, približno pet minut.
Predpogoji
wkimageje nameščen in vklopljen v upravitelju razširitev.- PHP ima knjižnico za slike v oblikah zapisa, ki jih uporabljate (GD ali Imagick).
- Slikovna datoteka v predstavnostnem arhivu in pravica za urejanje strani.
Korak 1: naložite sliko
Odprite upravitelja predstavnosti (/doku.php?do=media), izberite ali ustvarite imenski prostor in naložite datoteko, na primer wiki:foto.jpg.
Zapišite si oznako predstavnosti – imenski prostor in ime datoteke, povezana z dvopičjem.
Korak 2: vstavite sliko
Uredite stran in vpišite:
{{wk:image>wiki:foto.jpg|width=800}}
Vsaka navedba sledi navpični črti |; več navedb si sledi, vsaka s svojo črto.
Korak 3: dodajte dostopno besedilo
{{wk:image>wiki:foto.jpg|width=800|alt=Pogled na montažno halo}}
alt je besedilo, ki ga bralnik zaslona izgovori in ki ga brskalnik pokaže, kadar slike ni. Slika, ki nosi pomen, ga potrebuje.
Preverjanje rezultata
- Slika je na strani. Odločilna razlika je vidna v izvorni kodi HTML: dostavljena je različica, široka 800 slikovnih točk, in ne izvirnik, pomanjšan s CSS.
- Element ima atribut
loading=„lazy“– zakasnjeno nalaganje je privzeto. Za sliko, ki je vidna brez drsenja, ga izklopite z|lazy=0; sicer bralec čaka na nekaj, kar je že na zaslonu. - Znova naložite stran. Slika pride iz predpomnilnika, ne izračuna se znova. Če zahtevate drugo širino, nastane drugi predpomnjeni rezultat; prvi ostane.
Na tej namestitvi je
defaultMaxWidth nastavljen na 800. Brez lastne navedbe širine je slika torej omejena na največ 800 slikovnih točk.
Naslednji korak
- wkimage – referenca: vse možnosti (
maxwidth,quality,format,inline), nastavitve in pomočnik za uporabo iz PHP. - wkopengraph – če naj bo ista slika tudi na kartici predogleda pri deljenju.
sl/wiki/dwe/wkimage/quickstart.txt · Zadnja sprememba: uporabnika Wolfgang van der Stille