Predogled ob deljenju — tehnična referenca

Ta stran opisuje označevanje, izvor vrednosti, izhod, upravljalno ploščo in razširitveno točko. Za uvod glejte Pregled.

Blok na strani

Skladenjska sestavina prepozna dva enakovredna zapisa istega bloka; oba tolmači isti bralnik. Blok ne ustvari nobenega vidnega izhoda — prebere se pri gradnji metapodatkov strani in učinkuje izključno v glavi strani.

<og>
title = ...
description = ...
image = :wiki:logo.png
type = article
</og>

%%{{wk:og>title=...|description=...|image=:wiki:logo.png}}%%

Druga oblika je hišni zapis iz wkcore in pare loči z | namesto s prelomi vrstic. Registrira se le, če je wkcore nameščen; brez njega velja samo prva oblika.

Prepoznani ključi

Ključ	Postane	Privzeto, kadar stran ničesar ne pove
`title`	`og:title, twitter:title`	naslov strani, kot ga določi DokuWiki
`description`	`og:description, twitter:description`	veriga iz povzetka strani, privzetega besedila in gesla
`image`	`og:image, twitter:image`	nastavitev defaultImage
`url`	`og:url`	absolutni naslov strani
`type`	`og:type`	nastavitev defaultType
`site_name`	`og:site_name`	nastavitev siteName, sicer naslov wikija

Ključ, ki ni na tem seznamu, se prebere in shrani v metapodatke strani, vendar se ne dostavi. Nič ne stane in nič ne stori — zato tipkarska napaka v imenu ključa ne ustvari sporočila o napaki: blok je veljaven, vrednost le pristane tam, kjer je nihče ne bere.

type je poseben primer: označevanje sprejme vsako vrednost, torej tudi profile ali book; nastavitev za privzeto vrsto pozna le article in website.

Večjezične vrednosti

Vsaka vrednost lahko nosi več jezikov v enem polju, ločenih z |, vsak kot dvočrkovna oznaka in dvopičje. Enako velja za nastavitve defaultDescription, defaultImage in siteName.

<og>
title = de:Kryptographie|en:Cryptography|sl:Kriptografija
</og>

Izvor vsake vrednosti

Stopnja	Vir	Kaj prispeva
1	Privzeto	nastavitve paketa, naslov wikija, naslov strani, naslov, povzetek
2	Stran	blok te strani
3	Paketi, ki prispevajo	dogodek WKOPENGRAPH_VALUES

Pozneje nastavljene vrednosti zmagajo, prazne nikoli ne prepišejo. Dostavi se tisto, kar ni prazno. Prazna vrednost ne ustvari oznake — in to namerno: dostavljeno prazno oznako bralnik razume kot zagotovilo, da stran nima opisa, namesto da bi ga sam poiskal.

Veriga opisa

Opis je edina vrednost, katere privzeta vrednost je sama veriga: najprej povzetek strani, sicer nastavitev defaultDescription, sicer geslo wikija.

Vrstni red je bistvo. Povzetek je prvi, ker edini opisuje stran, ki se deli; privzeto besedilo in geslo opisujeta wiki in sta na vsaki strani enaka. Brez te prve stopnje najpogostejši primer — stran brez lastnega bloka — ne bi dostavil nobenega opisa.

Povzetek se skrajša na 200 znakov na meji besede. Vrednost namenoma stoji med približno 160 znaki, ki jih prikažejo iskalniki, in približno 300, ki jih sprejmejo bralniki Open Grapha — tako eno besedilo služi obojemu, ne da bi bilo treba vzdrževati dve.

Oznake slik se razrešijo

Vrednost slike, ki se začne z :, je oznaka predstavne datoteke DokuWiki, ne dokončen naslov. Pred dostavo se prevede v absolutni naslov — omrežje, ki pobira predogled, nima wiki konteksta in oznake ne bi moglo razrešiti.

Ustvarjene meta oznake

Dostavijo se og:title, og:description, og:image, og:url, og:type in og:site_name, poleg tega ustreznice twitter: za naslov, opis in sliko. Vsaka oznaka le, če njena vrednost ni prazna.

Upravljalni zaslon

Zaslon je na ?do=admin&page=wkopengraph. Prikazuje privzete vrednosti z njihovim učinkom, ponuja blok strani kot obrazec in preverja slike predogleda.

Kaj shranjevanje stori z nastavitvami

Privzete vrednosti so v nastavitvah wikija. Obrazec jih zapiše po običajni poti upravitelja nastavitev — drugega mesta hrambe in datoteke, ki bi jo poznal le ta paket, ni.

Privzete vrednosti

Nastavitve urejajo privzeto besedilo, privzeto sliko, privzeto vrsto, ime spletišča in pragove preverjanja slik. Neveljavna vrednost se ne prevzame; tedaj velja privzeta.

Preverjanje slik predogleda

Preverjanje javi slike predogleda, ki so premajhne ali imajo neugodno razmerje. To je javljanje, ne zapora: slika se nikoli ne zadrži, le poimenuje.

Razširitvena točka

Drugi paketi prispevajo lastne vrednosti prek dogodka WKOPENGRAPH_VALUES. To je tretja stopnja izvora. Prispevatelj dostavi le vrednosti; besedišče, ubežanje in odločitev, katere oznake obstajajo, ostanejo temu paketu — dva paketa, ki pišeta v isto glavo, bi ustvarila podvojene lastnosti, ki jih bralniki razrešujejo neenotno. Tako denimo Blog napaja vsak prispevek z lastnimi vrednostmi.

Vedenje v posebnih primerih

Stran brez bloka vseeno dobi vseh šest vrednosti — iz privzetih.
Prazna vrednost v bloku ne prepiše; pusti privzeto.
Neznan ključ je veljaven in brez učinka.
Brez wkcore drugega zapisa ni; prvi ostane.

Priporočila za slike predogleda

Slika predogleda naj ima vsaj 1200 × 630 točk in razmerje blizu 1,91:1 — to je oblika, ki jo razširjena omrežja prikažejo brez obrezovanja. Manjše slike se dostavijo, a se pogosto povečajo ali izpustijo.