FluentUI: referenca nastavitev

Ta stran opisuje vseh 18 nastavitev paketa wkfluentui: ključ, vrsto, privzeto vrednost, učinek in – kjer je to pomembno – kaj se zgodi pri neveljavni vrednosti.

Oznaka v upravljalniku nastavitev je ena vrstica. Pove lahko, kaj polje počne, ne pa tudi, kaj se zgodi ob tipkarski napaki, katere druge nastavitve sodelujejo in v kakšnem vrstnem redu. Prav to je zapisano tukaj.

Skrbništvo → Splošne nastavitve → razdelek Nastavitve vstavkov, tam blok wkfluentui. Vrednosti se shranijo v conf/local.php; te datoteke ne pišete ročno, za to poskrbi upravljalnik nastavitev.

Vsaka nastavitev tega paketa velja za celoten wiki. Tri so izrecno le začetna vrednost: lastna izbira prijavljenega uporabnika ima prednost. Katere so to, piše spodaj v razdelku Prednost privzetih vrednosti.

Vrsta število, spodnja meja 1 · Privzeto 20

Največje število zavihkov, ki so lahko za posameznega uporabnika hkrati odprti v vrstici nad vsebino skrbniških zaslonov.

Zgornja meja obstaja, ker se zavihki odpirajo sami: vsak skrbniški modul, ki ga uporabnik obišče, doda svojega. Brez meje bi po dolgi seji ostala vrstica, ki je širša od okna in v kateri nihče ničesar več ne najde.

Spodnja meja je 1, ne 0. Nič bi pomenilo »noben zavihek se nikoli ne sme odpreti« – to ni nastavitev vrstice, temveč njena odstranitev, do te pa pridete tako, da zapustite vmesnik delovne površine.

Vrsta besedilno polje v več vrsticah, vsebina JSON · Privzeto prazno

Začetna razporeditev delovne površine za uporabnike, ki še nimajo lastne: kateri dokumenti so odprti, v kakšnem vrstnem redu, kateri modul je ob njih, kje je pogled.

Kdor nikoli ničesar ne premakne, dobi to razporeditev – lastna razporeditev ima vedno prednost. Prav to naredi iz privzete vrednosti za celoten wiki izhodišče in ne predpis.

Prazno pomeni »brez začetne razporeditve«; tako je pri nedotaknjeni namestitvi. Napačen JSON se obravnava kot prazno, ne kot napaka: tipkarska napaka skrbnika ne sme vsakemu bralcu razbiti delovne površine. Povratne informacije o tem pa tudi ni – kdor nastavi privzeto razporeditev in ne vidi učinka, najprej preveri, ali je JSON veljaven.

To je nastavitev, ne nekaj, kar paket zapiše sam. Pisanje bi pomenilo, da koda na novo ustvari conf/local.php; to je tu prepovedano, bloki z utemeljitvami v tej datoteki pa tega ne bi preživeli.

Pet nastavitev sodeluje pri eni odločitvi. Pri tem je bistven podatek prav vrstni red:

Vrsta niz · Privzeto start

ID strani, ki sproži vstopna pravila. Prazno izklopi celotno vstopno preusmeritev – to stikalo je funkcija, ne posebni primer.

Preusmeritev se sproži samo ob natančnem ujemanju: z natanko tem ID-jem ali z <jezik>:<id> za jezik iz available_languages. Globlje ležeča stran, ki se po naključju konča enako, ostane nedotaknjena. To ni podrobnost: tudi cilj preusmeritve de:wiki:start se konča s start in bi mehanizem sicer sprožil znova.

Vrsta niz, ločen z vejicami · Privzeto de,en,hr,it,sl

Jezikovne kode, na katere se vstopna pravila smejo razrešiti. Presledki okoli vnosov se odstranijo, prazni vnosi odpadejo.

Seznam je hkrati filter za jezik brskalnika. Jezik, ki ga na seznamu ni, zato obiskovalca nikoli ne more poslati v imenski prostor, ki ne obstaja.

Vrsta niz · Privzeto de

Jezik, ki velja, kadar jezika brskalnika ni na zgornjem seznamu ali ga brskalnik sploh ne pošlje.

Pri določanju se Accept-Language ovrednoti z utežmi kakovosti, ne samo prvi vnos: glava de;q=0.3, it;q=0.9 da italijanščino, če je it na seznamu.

Vrsta besedilno polje v več vrsticah, vsebina XML · Privzeto dve pravili (glejte spodaj)

Vstopna pravila. Preverjajo se po vrsti; velja prvo pravilo, ki se ujema.

Vsako <rule> pozna tri atribute:

• group – zapis ACL po pravilih DokuWikija (@skupina, golo uporabniško ime, @ALL, ločeno z vejicami). Če atributa ni ali je prazen, se pravilo ujema z vsemi.
• lang – se mora ujemati z jezikom, določenim v 3. koraku. Če ga ni, jezik ni pomemben.
• target – ID cilja. {{lang}} v njem se nadomesti z določenim jezikom.

Privzeta vrednost:

<routing>
    <rule group="@user" target="{{lang}}:wiki:start"/>
    <rule target="{{lang}}:site"/>
</routing>

Prijavljeni uporabniki iz skupine user torej pristanejo v območju wikija v svojem jeziku, vsi drugi v območju spletnega mesta.

Napačen XML pomeni »ni pravil«, ne prekinitve. Stran se naloži običajno, le preusmerja ne več – in to brez kakršnega koli sporočila. Kdor spremeni pravilo in nato ne vidi več preusmeritve, najprej preveri, ali je XML pravilno oblikovan.

Iz varnostnih razlogov je XML z <!DOCTYPE> ali <!ENTITY> zavrnjen v celoti, dostop do omrežja je izklopljen in nalagalnik zunanjih entitet odklopljen. Ti trije ukrepi skupaj izključijo znane napade prek vdelanih entitet.

Če cilj ne kaže na stran, ampak na imenski prostor, katerega začetna stran obstaja, se uporabi ta. Cilj, ki je enak izhodiščni strani, se zavrže – tako ne nastane zanka preusmeritev.

Vrsta stikalo · Privzeto vklopljeno

Odprtje imenskega prostora brez končnega dvopičja (de:site) preusmeri na njegovo začetno stran. DokuWiki sam to naredi samo za obliko z dvopičjem (de:site:); ta nastavitev pravilo posploši.

Ta preusmeritev ni del zgornje verige pravil. Je samostojna kljuka z lastnimi pogoji in se sproži samo, kadar je zahteva običajen prikaz, odprti ID ne poimenuje obstoječe strani in pod njim obstaja začetna stran.

Obstoječa stran se nikoli ne preskoči. Imenski prostor brez začetne strani obdrži DokuWikijev poziv, naj stran ustvarite.

Dve neodvisni samodejni preusmeritvi delujeta izključno pri $ACT === 'show' – torej ob običajnem odprtju strani, ne pri urejanju, primerjanju ali skrbništvu. Obe morata biti koda paketa: DokuWiki aktivno predlogo vključi šele potem, ko act_dispatch() razreši dejanje, takrat pa je za preusmeritev prepozno. Dovolj zgodaj pride le akcijski paket na DOKUWIKI_STARTED.

Dve vlogi, ki ju je lahko zamenjati:

• landing_page ni cilj, temveč ime strani, ki sproži preusmeritev: golo ime strani (npr. start), s katerim se ID odprte strani primerja nespremenjen, brez zamenjave nadomestnih oznak. Preusmeritev se sproži ob natančnem ujemanju s samim landing_page ali z <jezik>:landing_page za vsak jezik iz available_languages. Vrednost, kot je {{lang}}:site:start, tu ne deluje: {{lang}} se na tem mestu nikoli ne zamenja, pogoj ne more nikoli veljati in preusmeritev se ne sproži pri nobenem odprtju strani – tiho, brez sporočila o napaki.
• routing_rules določa dejanske cilje, za vsako pravilo z atributom target – in tam se {{lang}} nadomesti z razrešenim jezikom.

Potek, ko pogoj za sprožitev velja:

1. Določitev jezika: če ID odprte strani že ima jezikovno predpono (de:start), velja ta jezik; sicer se glava brskalnika Accept-Language primerja z available_languages (najprej najvišja utež kakovosti); če tudi to ne da rezultata, velja default_language.
2. routing_rules (XML) se pregleda po vrsti, velja prvo ujemajoče se pravilo. <rule> ima tri atribute: group (prazno = ujema se z vsakim obiskovalcem, sicer zapis ACL DokuWikija kot v conf/acl.auth.php: @skupina, uporabniško ime ali @ALL, preverjeno z auth_isMember()), lang (prazno = vsak jezik) in target (ID ciljne strani, {{lang}} se nadomesti).
3. Če razrešeni target ni obstoječa stran, obstaja pa <target>:<ime začetne strani> ($conf['start'], običajno start), se cilj samodejno podaljša tja – cilj, ki je imenski prostor, kot de:site, tako postane de:site:start, ne da bi ga moralo pravilo izpisati.
4. Neveljaven XML v routing_rules → ni pravil, ni preusmeritve, ni napake.

Primer (dejanska nastavitev te namestitve):

landing_page = start
routing_rules = <routing>
    <rule group="@user" target="{{lang}}:wiki:start"/>
    <rule target="{{lang}}:site"/>
</routing>

Odprtje start ali de:start:

• Član skupine @user (prijavljen) → ujema se prvo pravilo → cilj de:wiki:start.
• Vsak drug obiskovalec (drugo pravilo nima atributa group, zato se ujema vedno) → cilj de:site → kot stran ne obstaja → podaljšan v de:site:start.

Zato sta de:site:start in de:wiki:start dve povsem različni strani, čeprav sta dosegljivi prek istega sprožilca: kdo pristane kje, odločata vrstni red pravil in atribut group, ne ime strani.

Znani primer napake (odpravljen 9. 7. 2026): prav ta zamenjava – landing_page je bil pomotoma nastavljen na cilj namesto na ime sprožilca – je povzročila, da je klik na »Home« pristal na nespremenjeni nadomestni strani sprožilca namesto na želeni strani.

Preusmeritev na kazalo imenskega prostora odprtje, ki kaže na imenski prostor brez lastne strani, podaljša na njegovo začetno stran. Izklopite jo z namespace_index_redirect – to je stikalo, brez katerega preusmeritev ne bi izpolnila hišnega pravila »vklopljivo, nikoli obvezno«.

Vrsta besedilno polje v več vrsticah · Privzeto prazno

Stran, ki je ni več, s kodo 301 preusmeri tja, kjer je po preimenovanju svojega imenskega prostora. Eno pravilo na vrstico, staro = novo. * pomeni natanko en segment in se prenese v istem vrstnem redu: *:pub = *:site preusmeri en:pub:contact na en:site:contact, z eno vrstico za vse jezike.

• Velja prvo pravilo, katerega leva stran je predpona ID-ja odprte strani. Zamenja se samo ta predpona, preostanek ID-ja se pripne nespremenjen. Če so se spremenili tudi segmenti pod njo, pravilo zgreši.
• Preusmeri se samo stran, ki ne obstaja, in samo na stran, ki obstaja – če te ni, na njeno začetno stran (<cilj>:<ime začetne strani>), sicer sploh ne. Obstoječa stran se nikoli ne preskoči.
• Kot obe zgornji preusmeritvi deluje samo pri $ACT === 'show', kot samostojna kljuka na DOKUWIKI_STARTED – torej pred preverjanjem ACL in preden DokuWiki za manjkajočo stran pošlje kodo 404 ($conf['send404']).
• Prazne vrstice in komentarji z # se preskočijo. Napačna vrstica – ne natanko en =, prazen segment, na levi in desni različno število * – se preskoči sama, druga pravila veljajo naprej. Prazno polje preusmeritev izklopi.

Povezav v besedilu strani pravilo ne spremeni. Povezava na stari ID še naprej kaže na manjkajočo stran in je prikazana rdeče, dokler je ne preusmerite na novi ID. Pravila prestrežejo, kar pride od zunaj: zaznamke, iskalnike, povezave z drugih spletnih mest.

Štiri osi in ena tema. Osi so med seboj neodvisne: veljavna je vsaka kombinacija in nobena ne potrebuje lastnih pravil za komponente – os pomeni le drugačno dodelitev oblikovalskih vrednosti.

Vse štiri so dobavljene z vrednostjo template, template pa ni videz. Pomeni »karkoli aktivna predloga ponuja za to os« – in lastno paleto paketa, če predloga ne ponuja ničesar ali če nobena predloga nima česa ponuditi. Videz zagotavlja predloga; če svojo paleto prepusti temu paketu, mora znati povedati, katera koža in katera shema stopita na njeno mesto.

Če vpišete pravo vrednost, predlogi os trajno odvzamete:

Srednja vrstica je razlog, da je template samostojna beseda in ne preprosto »ni nastavljeno«: z le dvema stanjema bi bila default in »nič vpisanega« isti niz, upravljavec, ki pod predlogo s ponudbo želi paleto paketa, pa ne bi imel načina, da to zahteva.

template namenoma ni vrednost osi. Sicer bi bila sprejeta tudi iz ?skin=template in iz oznake <theme> na strani, kjer ne poimenuje ničesar, kar bi se dalo izrisati.

Kako predloga odgovori: priloži inc/wk-axes.php s funkcijo <ime_mape>_wk_axis_defaults(), ki vrne os ⇒ vrednost. Paket datoteko vključi sam, po poti, sestavljeni iz imena aktivne predloge. Predloga brez te datoteke je običajen primer in ne prispeva ničesar.

Vrsta izbira · Vrednosti template, default, wxi, bizway · Privzeto template

Privzeta koža za celoten wiki. Koža določa nevtralni značaj vmesnika (toplo slonokoščeno belino papirja ali hladno pisarniško sivino), in to za vsak svet svetlosti posebej. Ne določa poudarka (ta je svoja os), ne barv stanja in ne glavne vrstice (ti pripadata svetu svetlosti) in nikoli mer.

bizway je nevtralna družina hišne predloge, sprejeta 9. avgusta 2026: tako je na voljo kot vrednost osi, ne le kot preglasitev na korenskem elementu, skozi katero nobena koža ne more prodreti. Ime je ime predloge, a ni odvisnost od nje – lestvica vrednosti je samostojna in se izriše tudi brez nameščene predloge.

wxi-darkness in wxi-clearness sta 9. avgusta 2026 odpadli: prva je bila svet svetlosti z imenom kože in je zdaj wxi pod shemo dark, druge pa po selitvi poudarka ni bilo več mogoče ločiti od wxi. Shranjene vrednosti se prevedejo, ne zavržejo, in wxi-darkness s seboj prinese temno shemo.

default ni ime palete, temveč »lastna paleta paketa« – vrednosti osnovnega bloka. Preobleka je izključno nastavitev wikija: uporabnik je zase ne more preglasiti.

Vrsta izbira · Vrednosti template, default, atlantic, riviera, graphit · Privzeto template

Barva poudarka znotraj izbrane kože.

Tri družine so 5. avgusta 2026 nadomestile štiri imena barv. Ime barve je lahko držalo samo v eni shemi: »modra« je imela eno šestnajstiško vrednost, ta pa je bila berljiva povezava bodisi na papirju bodisi na skoraj črni podlagi, nikoli na obeh. Družina poimenuje barvni ton, shema pa ga premakne.

default pomeni »poudarek, ki ga prinese koža«. Zato ni ime barve: če bi bila tu vpisana barva, »poudarka kože« sploh ne bi bilo več mogoče izraziti. Tako kot kože tudi poudarka uporabnik ne more preglasiti zase.

Vrsta izbira · Vrednosti template, auto, light, heritage, dark · Privzeto template

Svet svetlosti. Lastna izbira uporabnika ima prednost pred to privzeto vrednostjo.

heritage ni svetlost med svetlim in temnim: za brskalnik je to svetel svet, kar slogovna datoteka pove s color-scheme. Shema je zato, ker na novo dodeli površine in pisavo – material strani – in nič drugega.

auto pomeni »ne povej ničesar«: atribut se ne nastavi, odloči sistemska nastavitev bralca. To je edini pošten odgovor, ki ga strežnik lahko da na vprašanje, katerega odgovora ne vidi.

Velja pa tudi obratno: poimenovana shema izklopi sistemsko nastavitev. Medijska poizvedba slogovne datoteke deluje na :root:not([data-wk-scheme]) – specifičnost (0,2,0), torej močneje od korenskega elementa predloge pri (0,1,0). Izmerjeno 9. avgusta 2026 na strani wikija z vsiljenim temnim načinom: ozadje je ostalo belo, pisava pa je prešla na rgb(243,242,241) – 1,12 : 1, kjer merilo uspeha 1.4.3 WCAG 2.2 zahteva 4,5 : 1; bralna podlaga je dosegla 1,08 : 1, pas glave 1,03 : 1. Bralec s temno nastavljenim operacijskim sistemom je to dobil na vsaki strani, ne da bi karkoli izbral.

Vrsta izbira · Vrednosti template, normal, compact · Privzeto template

Gostota kontrolnikov. Lastna izbira uporabnika ima prednost pred to privzeto vrednostjo.

normal je gostota, ki jo slogovna datoteka izriše brez atributa; žig zanjo bi ustvaril oznake, ki ničesar ne spremenijo.

Vrsta niz · Privzeto prazno

Ime teme, sestavljene v urejevalniku tem, ki se uporabi za celoten wiki. Prazno pomeni privzete vrednosti paketa – to prikaže nedotaknjena namestitev.

Polje je namenoma prost niz in ne izbirni seznam: upravljalnik nastavitev sestavi možnosti izbire ob deklaraciji, takrat pa je seznam tem vsebina mape, o kateri še nihče ni odločil. Pravo izbiro ponuja zaslon urejevalnika tem; to polje je ročna pot do iste vrednosti.

Ime, ki ne obstaja več, se obravnava kot prazno, ne kot napaka: brisanje teme ne sme moči pokvariti vsake strani wikija.

Vrsta stikalo · Privzeto vklopljeno

Ali lastni zasloni tega kompleta nadomestijo obrazce jedra DokuWikija za prijavo, registracijo in obnovitev gesla.

To je nastavitev spletnega mesta in izrecno ne nastavitev uporabnika – v tem je vsa razlika od delovne površine, katere način vmesnika si sistem zapomni za vsakega uporabnika. Obiskovalec pred zaslonom za prijavo je po definiciji še nihče, ki bi si ga ta wiki lahko zapomnil.

Izklopljeno pomeni: natanko obrazce jedra. Zahtevo v obeh primerih obdela jedro – nastavitev odloča o prikazu, ne o logiki prijave.

Vrsta ID medija · Privzeto prazno

Znak izdelka v pasu na vrhu kartice za prijavo.

Prazno ne pomeni »brez znaka«. Preverijo se štirje kandidati v tem vrstnem redu, uporabi se prvi, ki obstaja:

1. tu vpisana vrednost
2. wk:logo.png
3. wk:banner.png – tam je znak tega kompleta že shranjen
4. wiki:logo.png – DokuWikijev lastni dogovor

Šele če ne obstaja noben, pas prikaže naslov wikija kot besedilo. Oba hišna kandidata sta v verigi namenoma: nastavitev, ki mora biti izpolnjena, preden se pokaže prava slika, je nastavitev, ki je večina namestitev nikoli ne najde.

Vpiše se ID medija, ne pot. Razreševanje poteka prek DokuWikijevega upravljanja medijev, zato ID, ki ne obstaja, preda na naslednjega kandidata, namesto da bi prikazal pokvarjeno sliko.

Vrsta niz · Privzeto The White Knight Labs

Ime proizvajalca pod kartico. Prazno vrstico v celoti skrije, skupaj z znakom in povezavo.

Vrsta ID medija · Privzeto prazno

Majhen znak proizvajalca ob imenu.

Prazno ne prikaže samo imena, temveč hišni znak kot vdelano vektorsko grafiko – isto risbo kot v pasu nad njim, v velikosti, ob kateri stoji ime. Ne potrebuje dodatne zahteve. Vpisana slika ima prednost: namestitev, ki ni naša, ima svojega proizvajalca in mora to lahko povedati. Tudi ID brez pripadajoče datoteke se vrne na vdelani znak.

Vrsta URL · Privzeto prazno

Cilj povezave na imenu proizvajalca. Prazno prikaže ime kot navadno besedilo, brez povezave.

Uporabnik ne more preglasiti vsake nastavitve tega paketa, in razlika ni samovoljna: preglasiti je mogoče, kar je udobje branja; za celoten wiki ostane, kar je celostna podoba.

Ponudba predloge je čisto na dnu: parametri zahteve, zapomnjena izbira bralca, vnos za imenski prostor, oznaka <theme> na strani in vsaka nastavitev s pravo vrednostjo imajo prednost pred njo. Zapolni vrzel in nikoli ne preglasi odločitve.

Lastno izbiro neprijavljenega bralca hrani piškotek z nastavitvami; strežnik jo vidi že ob izrisu in jo takoj vtisne v stran. Zato ob nalaganju nikoli za trenutek ne utripne napačen prikaz.

Štiri nastavitve neuporabno vrednost namenoma obravnavajo kot prazno, namesto da bi sprožile napako. To je premišljena odločitev, ne malomarnost – pomeni pa tudi, da tipkarska napaka ostane tiha:

Štiri izbirna polja (default_skin, default_accent, default_scheme, default_density) neveljavne vrednosti sploh ne morejo sprejeti – upravljalnik nastavitev ponuja samo nabor dovoljenih vrednosti. Koda jih kljub temu preveri znova, ker nastavitev ni edina pot, po kateri vrednost pride.

Za predlogo, ki da ponudbo, velja isto v strožji obliki: ponudba z neznano osjo ali neznano vrednostjo se zavrže, predloga, katere ponudba vrže izjemo, pa izgubi svojo ponudbo in nič drugega. Napaka se zabeleži v dnevnik, ne prikaže – pokvarjena datoteka predloge ne sme na vsako stran postaviti sklada klicev in ne sme izgledati kot predloga, ki preprosto ni imela česa povedati.

• Pregled paketa – vloga, območja, preusmeritve v povezavi
• Oblikovalski žetoni – kaj koža, poudarek in shema dejansko na novo dodelijo
• Zgradba skrbniških zaslonov – kje je vrstica z zavihki, ki jo omejuje workspace_tabs_max
• Vadnica – najkrajša pot do lastnega zaslona