Pretpregled pri dijeljenju — tehnička referenca

Ova stranica opisuje označavanje, podrijetlo vrijednosti, izlaz, upravljačku plohu i točku proširenja. Za uvod vidi Pregled.

Blok na stranici

Sintaksna sastavnica prepoznaje dva ravnopravna zapisa istoga bloka; oba tumači isti čitač. Blok ne stvara nikakav vidljivi izlaz — čita se pri izgradnji metapodataka stranice i djeluje isključivo u zaglavlju.

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

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

Drugi je oblik kućni zapis iz wkcore i parove odvaja znakom | umjesto prijelomom retka. Registrira se samo ako je wkcore instaliran; bez njega vrijedi samo prvi oblik.

Prepoznati ključevi

Ključ	Postaje	Zadano kad stranica ništa ne kaže
`title`	`og:title, twitter:title`	naslov stranice kako ga odredi DokuWiki
`description`	`og:description, twitter:description`	lanac od sažetka stranice, zadanog teksta i gesla
`image`	`og:image, twitter:image`	postavka defaultImage
`url`	`og:url`	apsolutna adresa stranice
`type`	`og:type`	postavka defaultType
`site_name`	`og:site_name`	postavka siteName, inače naslov wikija

Ključ koji nije na ovom popisu čita se i pohranjuje u metapodatke stranice, ali se ne isporučuje. Ništa ne stoji i ništa ne čini — zato pogreška u nazivu ključa ne stvara poruku o pogrešci: blok je valjan, vrijednost samo završi ondje gdje je nitko ne čita.

type je poseban slučaj: označavanje prima svaku vrijednost, dakle i profile ili book; postavka za zadanu vrstu poznaje samo article i website.

Višejezične vrijednosti

Svaka vrijednost može nositi više jezika u jednom polju, odvojenih znakom |, svaki kao dvoslovna oznaka i dvotočje. Isto vrijedi za postavke defaultDescription, defaultImage i siteName.

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

Podrijetlo svake vrijednosti

Stupanj	Izvor	Što doprinosi
1	Zadano	postavke paketa, naslov wikija, naslov stranice, adresa, sažetak
2	Stranica	blok ove stranice
3	Paketi koji doprinose	događaj WKOPENGRAPH_VALUES

Kasnije postavljene vrijednosti pobjeđuju, prazne nikada ne prepisuju. Isporučuje se ono što nije prazno. Prazna vrijednost ne stvara oznaku — i to namjerno: isporučenu praznu oznaku čitatelj razumije kao tvrdnju da stranica nema opis, umjesto da ga sam potraži.

Lanac opisa

Opis je jedina vrijednost čija je zadana vrijednost sama lanac: najprije sažetak stranice, inače postavka defaultDescription, inače geslo wikija.

Redoslijed je ovdje bit. Sažetak je prvi jer jedini opisuje stranicu koja se dijeli; zadani tekst i geslo opisuju wiki i jednaki su na svakoj stranici. Bez tog prvog stupnja najčešći slučaj — stranica bez vlastitog bloka — ne bi isporučio nikakav opis.

Sažetak se skraćuje na 200 znakova na granici riječi. Vrijednost namjerno stoji između otprilike 160 znakova koje prikazuju tražilice i otprilike 300 koje primaju čitači Open Grapha — tako jedan tekst služi objema svrhama, a ne moraju se održavati dva.

Oznake slika se razrješuju

Vrijednost slike koja počinje znakom : oznaka je DokuWiki medija, a ne gotova adresa. Prije isporuke prevodi se u apsolutnu adresu — mreža koja dohvaća pretpregled nema wiki kontekst i oznaku ne bi mogla razriješiti.

Stvorene meta oznake

Isporučuju se og:title, og:description, og:image, og:url, og:type i og:site_name, uz twitter: istoznačnice za naslov, opis i sliku. Svaka oznaka samo ako njezina vrijednost nije prazna.

Zaslon za upravljanje

Zaslon se nalazi na ?do=admin&page=wkopengraph. Prikazuje zadane vrijednosti s njihovim učinkom, nudi blok stranice kao obrazac i provjerava slike pretpregleda.

Što spremanje čini s postavkama

Zadane vrijednosti nalaze se u postavkama wikija. Obrazac ih zapisuje uobičajenim putem upravitelja postavki — nema drugoga mjesta pohrane ni datoteke koju poznaje samo ovaj paket.

Zadane vrijednosti

Postavke uređuju zadani tekst, zadanu sliku, zadanu vrstu, naziv stranice i pragove provjere slika. Neispravna vrijednost ne preuzima se; tada vrijedi zadana.

Provjera slika pretpregleda

Provjera prijavljuje slike pretpregleda koje su premale ili imaju nepovoljan omjer. To je prijava, a ne zapreka: slika se nikada ne zadržava, samo se imenuje.

Točka proširenja

Drugi paketi doprinose vlastite vrijednosti kroz događaj WKOPENGRAPH_VALUES. To je treći stupanj podrijetla. Doprinositelj daje samo vrijednosti; rječnik, maskiranje i odluka koje oznake postoje ostaju ovom paketu — dva paketa koja pišu u isto zaglavlje stvorila bi dvostruka svojstva, koja čitači razrješuju neujednačeno. Tako primjerice Blog napaja svaku objavu vlastitim vrijednostima.

Ponašanje u posebnim slučajevima

Stranica bez bloka ipak dobiva svih šest vrijednosti — iz zadanih.
Prazna vrijednost u bloku ne prepisuje; ostavlja zadanu.
Nepoznat ključ je valjan i bez učinka.
Bez wkcore nema drugoga zapisa; prvi ostaje.

Preporuke za slike pretpregleda

Slika pretpregleda trebala bi imati najmanje 1200 × 630 točaka i omjer blizu 1,91:1 — to je format koji uobičajene mreže prikazuju bez rezanja. Manje se slike isporučuju, ali se često povećavaju ili izostavljaju.