Blog — tehnična referenca

Ta stran opisuje označevanje, hrambo podatkov, upravljalne plošče in vmesnike paketa. Za uvod glejte Pregled, za prvi prispevek Hitri začetek.

Stran postane prispevek tako, da nosi blok <wk:blog>. Blok ničesar ne izriše; opisuje stran, na kateri stoji, in potuje z njo, ko se stran kopira.

Dve vrednosti stojita kot podelement in ne kot lastnost, ker redno segata čez več vrstic: <excerpt> za napovednik in oba opisa za iskalnike in družbena omrežja.

Označevanje zahteva zaključno oznako; nastavitve stojijo v njej, po ena v vrstici. Enovrstična oblika ne prime in ostane besedilo na strani.

<blog list>
blog wk
limit 10
tpl wk
</blog>

Nabor predlog določa videz seznama. Priloženi so default, wk, wkbizway in wkbizwayteaser. Nastavitev tpl v seznamu izbere nabor; brez nje velja default.

Prispevek s status=„scheduled“ in časom publish v prihodnosti ostane neviden, dokler ta čas ne nastopi. Preklop opravi vzdrževalna naloga wikija: stanje zapiše v blok strani in pri tem ustvari običajno različico. Ni posebne storitve načrtovanja in ne procesa, ki bi tekel trajno — brez prometa na wikiju tudi razpored ne napreduje.

Blogi se razlikujejo le po imenu v nastavitvi blog. Drugi blog nastane tako, da prispevki nosijo drugo ime in seznam vpraša po tem imenu. Ni upravljanja blogov, ni ustvarjanja ne brisanja; blog obstaja natanko toliko časa, kolikor ga kakšna stran imenuje.

Stran je resnica, zbirka podatkov je iz nje izpeljano kazalo. Nahaja se v datoteki data/meta/wkblog.sqlite3 in vodi tabele entries, comments, tags, subscriptions, optin in opts.

Ponovno indeksiranje znova zgradi projekcijo iz strani. Obnovi se vse, kar stoji v bloku: naslov, stanje, razpored, blog, oznake, napovednik. Nedotaknjeno ostane vse, kar nima ustreznika na strani: komentarji, naročnine, zapisi potrditve in stanje razširjanja. To so dejstva o dogodkih zunaj wikija; ponovno indeksiranje jih ne more ne izpeljati ne uničiti.

Kopiranje strani v drug wiki je drug primer: tja potuje le stran, torej le blok. Komentarji, naročnine in stanje razširjanja ostanejo.

Šest ničelnih stolpcev v entries beleži, da in kdaj je bil prispevek deljen na družbenem omrežju. Uredništvo to vpiše ročno; ni samodejne objave na omrežje. Namerno ni del bloka: stanje razširjanja ni avtorska navedba strani, temveč ugotovitev o nečem, kar se je zgodilo zunaj wikija.

Osem rutin filtrira javne sezname po ravni dostopa do strani. Če to filtriranje odpove — denimo zato, ker funkcije zbirke po selitvi niso prijavljene — ni sporočila o napaki. Pojavi se preveč prispevkov.

To je najneprijetnejša oblika izpada: v obratovanju se ne loči od pravilnosti. Prevzem, ki čaka na izjemo, čaka zaman.

Namestitev naj zato trajno hrani:

• vsaj en objavljen prispevek, ki anonimno ni berljiv,
• pričakovano število anonimno vidnih prispevkov, določeno vnaprej.

Preverja se javni seznam, ne upravljalni: slednji je tako ali tako za preverjanjem dovoljenj, izpad pa se pokaže le tam, kjer šteje anonimni obiskovalec. Zapora sama sodi v nadzor dostopa wikija in se s paketom nikoli ne dostavlja.

Ves dostop do zbirke poteka prek imenovanih rutin z vezanimi parametri. Vsaka rutina je par datoteke .sql in manifesta; ime tabele je tam zapisano v čistem besedilu, ne v kodi PHP. Kdor želi spremeniti poizvedbo, spremeni datoteko rutine. Glejte SQLite Data Studio.

• enabled — komentarji so mogoči
• closed — obstoječi komentarji ostanejo vidni, novi niso mogoči
• disabled — na tej strani ni komentarjev

Ko je pregled vklopljen, se nov komentar najprej pokaže skrit in postane viden šele po odobritvi. Upravljalni zaslon vodi čakajoče komentarje in njihovo število prikaže kot značko na delovni plošči.

Privzeto se avatarji ne pobirajo s tujih strežnikov. Če se vklopi zunanja storitev, za vsak prikazan komentar hišo zapusti zahteva s kontrolno vsoto naslova. To je zavestna odločitev in ne privzeta nastavitev.

Zaslon je na ?do=admin&page=wkblog.

Šest številk: objavljeno, osnutki, čaka na pregled, načrtovano, komentarji za pregled in stanje nege SEO. Vsaka številka vodi v ustrezno filtriran seznam.

Poleg naslova in bloga seznam filtrira tudi po stanju objave. Filter se ohrani pri listanju.

Stanje, blog in stanje komentarjev stojijo v bloku strani. Skupinsko dejanje nad njimi zato zapiše stran po običajni poti shranjevanja: preveri dovoljenja, upošteva zaklep urejanja in ustvari pravo različico. Šele nato se osveži kazalo. Ko je prispevek preskočen, sporočilo navede razlog ločeno — se pravkar ureja, ni dovoljenja, strani ni več — ker šele razlog pove, kaj storiti.

Oznaka „izpostavljeno“ je izvzeta: je obratovalno stanje zbirke in dosledno ne ustvari različice.

Paket ne riše lastne delovne plošče. Svoje dele odda tisti, ki že obstaja: navigacijo kot prikaz v primarni stranski vrstici, zaostanek pregleda in trenutno mesto kot podatka statusne vrstice, značko s številom čakajočih komentarjev in dva ukaza. Glejte wkfluentui.

Nastavitve so v upravitelju nastavitev wikija pod imenom paketa. Urejajo privzeto stanje novih komentarjev, privzeti blog, privzete oznake, obveznost pregleda komentarjev, nastavljanje datuma v obrazcu za urejanje in sprejemanje povratnih povezav. Neveljavna vrednost se ne prevzame; tedaj velja privzeta.

Paket ponuja ploščo za oddaljeni klic wikija. Ustvarja prispevke, jih bere, spreminja stanje in vzdržuje oznake. Vsak klic gre skozi isto preverjanje dovoljenj kot uporabniški vmesnik in pri pisanju ustvari isto različico; poti, ki bi obšla stran, ni.

• Stran brez bloka ni prispevek, tudi če v zbirki obstaja vrstica.
• Izbrisana stran izgubi svojo vrstico ob naslednjem dostopu do zapisa.
• Neznana vrsta v seznamu pade nazaj na list in to javi.
• Če zbirke ni, se plošče izklopijo, namesto da bi stran propadla.

Paket je razvejitev BlogTNG. Razvejitev je bila mehanska, nadaljnji razvoj ni: prenosljivi blok metapodatkov, druga oblika besedila, upravljalni zaslon, časovno načrtovanje in plošča za oddaljeni klic so hišni dodatki. Stari naslov vira ostaja dosegljiv zaradi združljivosti.