Ta predloga se uporablja na 20,000+ straneh. Njeno urejanje lahko močno obremeni strežnike, zato vse spremembe, ki jih želite uvesti, pred uvedbo preizkusite v predlogini /peskovnik ali /testniprimeri podstrani, ali v svojih lastnih podstraneh. Preizkusite jih lahko tudi v posebnem peskovniku za predloge. Testirane spremembe se lahko dodajo z enim samim urejanjem v to predlogo. Razmislite tudi o diskusiji o nameravanih spremembah na pogovorni strani predno jih izvedete.
Predloga:LuaNapaka skripta: Modul »sidebar« ne obstaja.
Odstranite parametre, ki jih ne uporabite. Privzeta barva ozadja za naslovno vrstico (title) je #ccccff. Polja above, below in pa skupine (group) imajo privzeto barvo ozadja #ddddff.
{{{below}}} Oglejte si tudi druge oblike navpolja: Ureditev tabele
Navpolje uporablja imena parametrov napisane z malimi črkami kot je to prikazano v škatli. Obvezna parametra name in title bosta kreirala eno vrstično škatlo, če ni naveden noben drug parameter.
Parameter "group1" (itd.) je neobvezen, kot tudi polja imenovana "above/below".
Osnovni in najbolj uporabni parametri so tile (za poln seznam parametrov glej spodaj):
bodyclass - priredi HTML class atribut celemu navpolju.
name - ime predloge.
title - besedilo v naslovni vrstici (title bar), kot je na primer: [[Države sveta]].
listclass – CSS razred za sezname celic, običajno je to hlist za vodoravne sezname.
state - možne vrednosti so autocollapse, uncollapsed, collapsed. S tem parametrom določimo stanje odprtosti škatle, kjer "autocollapse" avtomatično skrije nakopičena navpolja.
titlestyle - CSS stil/iki se priredijo naslovni vrstici (titlebar), kot je na primer: background:gray;
groupstyle - a CSS stil skupino celic (group-cells), kot je na primer: background:#eee;
image - neobvezna slika na desni strani. Običajno je namenjena le okraševanju navpolja in se jo zapiše takole [[Slika:XX.jpg|90px|link=|alt=]].
imageleft - neobvezna slika na levi strani (zapis je enak kot za parameter "image").
above - besedilo, ki se prikaže nad group/list področjem.
groupn - besedilo na levi strani pred listn (če groupn ni opredeljen, se začne listn na levi strani škatle).
listn - seznam wikipovezav, običajno ločenih s sledečo predlogo: [[A]]{{·}} [[B]]
below - neobvezno besedilo, ki se prikaže pod group/list sekcijo.
Podrobnejši opisi in zapletenejše omejitve so razložene v poglavju Opisi parametrov. Oglej si tudi nekaj ureditev predlog v poglavju: Ureditev tabele.
Tukaj je popoln seznam parametrov za uporabo predloge Predloga:Navpolje (pogovor, povezave, uredi). V večini primerov so obvezni parametri name, title in list1, čeprav navpolje child ne zahteva teh nastavitev.
Ime predloge, ki je potrebno za "p · p · u" ("poglej · pogovor · uredi") povezave za pravilno delovanje na vseh straneh, ki uporabljajo to predlogo. Vneseš lahko {{subst:PAGENAME}} kot bližnjico. Ime parametra je neobvezno le, če je opredeljen tudi parameter title in ni postavljen border parameter.
Privzeta nastavitev je Predloga:Para. Navpolje z autocollapse bo imelo navpolja skrita, če obstaja dve ali več tabel na isti strani, ki uporabljajo druge zložljive tabele. Drugače pa bo navpolje razgrnjeno. Za bolj tehnično usmerjene, glej MediaWiki:Common.js.
Če je nastavljeno Predloga:Para, se bo navpolje v vsakem primeru startalo skrito.
Če je nastavljeno Predloga:Para, se bo navpolje v vsakem primeru startalo razgrnjeno s povezavo [zapri] na desni strani. Naslov bo ostal na sredini (z uporabo notranjega odmika do povezav p • p • u).
Če je nastavljeno Predloga:Para, se bo navpolje v vsakem primeru startalo razgrnjeno brez povezave [zapri] na desni strani, ne bo pa uporabljen notranji odmik za centriranje naslova. Ta opcija je za namenjena samo za naprednejšo uporabo; opcija "plain" za večino primero kjer morata biti gumba [odpri]/[zapri] skrita.
Če je nastavljeno na karkoli drugega kot autocollapse, collapsed, plain ali off (kot je "uncollapsed"), se bo navpolje vedno startalo v razprtem stanju in bo imelo viden gumb "zapri".
V primeru ko želimo prikazati škatlo samostojno (izven članka) razprto, v članku pa skrito - vključite "uncollapsed" znotraj tagov <noinclude>:
S to nastavitvijo bo škatla vidna ko jo uporabino samostojno, tudi kadar ji sledijo druge škatle, prikazan je gumb [zapri]; toda kadar jo uporabimo v članku bo škatla zaprta.
Včasih bodo urejevalci hoteli privzeto začetno vrednost za navpolje, ki se lahko znotraj članka prepiše. Tukaj je trik za to:
V vaši vmesni (posredovalni) predlogi, takole kreirajte parameter tudi imenovan "state":
<includeonly>| povzroči, da je predloga razprta, kadar gledamo predlogo samostojno (izven članka).
Example: Predloga:peso (pogovor, povezave, uredi) with autocollapse as the default initial state. Catalan peseta transcludes it and has only one navbox. So the peso navbox shows. Chilean peso has two navboxes. So the peso navbox collapses.
Example: Predloga:Historical currencies of Hungary (pogovor, povezave, uredi) with expanded as the default initial state. All transcluding articles shows the content by default, unless there were an hypothetical article that specifies state = collapsed when transcluding.
navbar*
Če je nastavljeno Predloga:Para, p • p • u povezave na levi strani naslovne vrstice ne bodo prikazane. Naslov bo ostal na sredini (z uporabo notranjega odmika). Uporabi Predloga:Para za odstranitev p • p • u povezav, brez uporabe notranjega odmika. Ta opcija je za namenjena samo za naprednejšo uporabo; opcija "plain" zadostuje za večino navpolj kjer navbar ni zaželjen. Priporočeno je, da se navbar ne skrije - tako je omogočeno uporabnikom lažje urejanje.
border*
Za primer in podrobnejši opis poglej poglavje spodaj z uporabo navpolj enega znotraj drugega. Če je nastavljeno Predloga:Para ali Predloga:Para. s to opcijo je navpolje child brez okvirja (border) in je ustrezno nameščen znotraj starševskega navpolja. Okvir je skrit, ni notranjega odmika (padding) ob straneh tabele, tako da ustreza področju list starševsega navpolja. Če je nastavljeno Predloga:Para, je okvir skrit, notranji odmik pa je odstranjen; navpolje se lahko uporabi kot child v drugi embalaži (ne uporabi opcije none znotraj drugega navpolja; podobno tudi, uporabi opciji child/subgroup samo znotraj drugega navpolja. Če je nastavljeno na karkoli drugega (privzeta vrednost), potem se prikaže običajno navpolje z 1px okvirjem. Drugi način za opredelitev okvirja je slog podskupine (t.j. uporabi prvi parameter neimenovan namesto prametra border):
Besedilo, ki se pojavi na sredini v zgornji vrsti tabele. Običajno je to téma predloge, t.j. jedrnat opis vsebine predloge. Opis naj bi bil v eni vrstici; uporabi {{-}} za zagotovitev centriranja, če potrebuješ dvovrstični naslov. Ta parameter sicer ni obvezen, toda uporaba predloge Predloga:Navpolje (pogovor, povezave, uredi) je brez naslova nesmiselna.
groupn*
(t.j. group1, group2, itd.) Če je paramater opredeljen, se besedilo pojavi v naslovni celici, ki je prikazana na levi strani listn. Če ni določen, listn uporabi polno širino tabele.
listn*
(t.j. list1, list2, itd.) Jedro predloge, običajno je to seznam wikilinkov. Besedilo je lahko zapiano v ločenih vrsticah, če je celoten seznam obdan z <div> </div>. Obvezen je vsaj en list parameter; vsak dodaten list se prikaže v ločeni vrstici tabele. Vsak listn je lahko postavljen za ustreznim groupn parameter, če je če-ta zagotovljen (glej spodaj).
image*
Slika, ki se prikaže v celici pod naslovom (title) in na desni strani jedra (groups/lists). Da se slika prikaže pravilno, mora biti opredeljen parameter list1. Parameter image naj vsebuje standardno wikikodo za prikaz slike, t.j.:
Slika, ki se prikaže v celici pod naslovom (title) in na levi strani jedra (lists). Da se slika prikaže pravilno, mora biti opredeljen parameter list1, poleg tega ne sme biti opredeljen noben group parameter. Vsebuje naj podobono wikikodo kot je to pri parametru image.
above*
Celica, ki ima polno širino tabele, se prikaže med naslovno vrstico (titlebar) in prvim group/list, t.j. nad jedrom predloge (skupine, seznami in slika). Če je predloga brez slike, se above obnaša podobno kot parameter list1 brez parametra group1.
below*
Celica, ki ima polno širino tabele, se prikaže pod jedrom predloge (skupine, seznami in slika). Če je predloga brez slike, se below obnaša podobno kot predlogin zadnji parameter listn brez parametra groupn.
Uporabo parametrov za stil ne priporočamo zaradi vzdrževanja konsistentnosti med predlogami in članki v Wikpediji. Kakorkoli, dana je možnost spreminjanja le-teh.
style*
Določa CSS stil, ki se priredi telesu predlogi. Parameter bodystyle naredi isto in se lahko uporabi namesto tega style parametra. Varčujte s to opcijo, ker lahko vodi v vizualno neskladnost. Primeri:
CSS stil/i, ki se priredijo title, above, below in group celicam skupaj. Stili niso prirejeni list celicam. To je priročno za lažje spreminjanje osnovnih barv navpolja brez ponavljanja stilov prej omenjenim celicam. Primer:
CSS stil/i, ki se dodatno priredijo določeni group, poleg opredeljenega parametra groupstyle. Ta parameter naj bo uporabljen le, ko je to resnično nujno - zaradi ohranjanja standardizacije in enostavnosti. Primer:
Širina, določena po možnosti s sorazmernostno enoto kot je 'em', za skupino celic (group). Včasih ko imajo celice malo vsebine je širina skupine celic lahko preširoka. Privzete vrednosti ni. Kakorkoli, lahko je prepisana s parametrom group(n)style. Primer:
CSS stil/i, ki se priredijo vsem seznamom (lists). Prepisan je lahko s parametroma oddstyle in evenstyle (če sta opredeljena). Ko v navpolju uporabljate barve ozadja, glejte opombo spodaj.
listnstyle*
CSS stil/i, ki se dodatno priredijo določenem seznamu (list), poleg opredeljenega parametra liststyle. Ta parameter naj bo uporabljen le, ko je to resnično nujno - zaradi ohranjanja standardizacije in enostavnosti. Primer:
Notranji odmik (padding), določen s sorazmernostno enoto em, za vsako list celico. Celice list imaja privzeto vrednost notranjega odmika 0.25em na levi in desni, in 0em zgoraj in spodaj. Zaradi zapletenih tehničnih razlogov, nastavitev "Predloga:Para" (ali katerokoli druga vrednost) ne bo delovala. Primeri:
Predloga:Para (nastavi notranji odmik 0.5em za levo/desno, in 0em za zgoraj/spodaj.)
Priredi se liho/sodo oštevilčenim seznamom (list). Ta dva parametra razveljavita stil, ki ga določa parameter liststyle. Privzeta vrednost doda črtasti vzorec (bel in siv) liho/sodim vrsticam z namenom izboljšanja preglednosti. Ta nastavitev naj se ne spreminja razen v izjemnih primerih.
evenodd[swap, even, odd, off]
Če je nastavljeno Predloga:Para, se obrne vrstni red črtastega vzorca. Običajno, je ozadje sodih vrstic svetlosive barve; če uporabite to nastavitev bodo to barvo prevzele lihe vrstice. Nastavitev na Predloga:Para ali Predloga:Para obarva vse vrtice določene barve črtastega vzorca enako. Nastavitev na Predloga:Para onemogoči črtasti vzorec. To je parameter za naprednejšo uporabo in naj se uporablja le za popravljanje vzorca, kadar je navpolje uporabljen kot child v drugem navpolju in se črtast vzorec ne ujema. Primere in podrobnejši opis najdete v poglavju o child navpoljih spodaj.
abovestyle*
belowstyle*
CSS stil/i, ki se priredijo vrhnji celici (določeni z above parametrom) in spodnji celici (določeni z below parametrom). Običajno se uporablja za barvo ozadja ali poravnavo besedila:
CSS stil/i, ki se priredijo celicam, ki vsebujejo sliko (image/imageleft). Ti stili naj bodo uporabljeni le izjemoma, običajno za odstranjevanje problemov s širino, če je širina skupin (groups) nastavljena, celica s sliko pa je prevelika. Primeri:
Nastavitve stilov, ki so naštete spodaj, so tiste, ki jih urejevalci najpogosteje spreminjajo. Ostale zahtevnejše nastavitve so izpuščene zaradi enostavnosti seznama. Večino stilov si lahko ogledate na MediaWiki:Common.css.
Ker imata liststyle in oddstyle prozorno ozadje, prevzamejo lihi seznami barvo bodystyle, ki ima privzeto nastavitev #fdfdfd (bela z malo sive). List ima privzeto vrednost text-align:left;, če je del skupine (group); če ni del skupine ima privzeto vrednost text-align:center;. Ker ima le bodystyle navpično poravnavo (vertical-align), vsi ostali podedujejo nastavitev vertical-align:middle;.
V naslovno področje (title) doda celico z istimi privzetimi vrednostimi stilov kot jih imajo groupn. Uporabi naj se izjemoma (napredne meta-predloge), ker zahteva nekaj znanja o kodiranju Predloga:Navpolje (pogovor, povezave, uredi); ročno nastavi CSS stile za pravilno delovanje. Primer:
Zelo napreden parameter, ki naj se uporabi le za napredne meta-predloge, ki uporabljajo navpolja. Navznoter navpolje uporablja zunanjo tabelo za risanje okvirja, in notranjo tabelo za vse drugo (title/above/groups/lists/below/images, itd.). Parametra style/bodystyle nastavita stil za zunanjo tabelo, kar podeduje notranja tabela; ampak v naprednejših primerih (meta-predloge) je morda potrebno direktno nastaviti stil za notranjo tabelo. Ta parameter zagotavlja dostop do te notranje tabele, tako da je stil lahko prirejen. Uporaba na lastno odgovornost.
Ta parameter je vrinjen v "class" atribut za celotno infopolje.
titleclass
Ta parameter je vrinjen v "class" atribut naslov infopolja.
Ta predloga podpira dodajanje mikroformat informacij. To je izvedeno z dodajanjem "class" atributov različnim podatkovnim celicam, ki označujejo kakšna informacija je vsebovana. Da označite navpolje kot navpolje, ki uporablja hCard informacije o osebi, npr. dodaj sledeči parameter:
Tabela, ki jo zgenerirjo parametri predloge Predloga:Navpolje (pogovor, povezave, uredi) brezimage, above in below (siva barva ozadja seznamov (list) je dodana le za namene prikaza):
Tabela, ki jo zgenerirjo parametri predloge Predloga:Navpolje (pogovor, povezave, uredi) zimage, above in below (siva barva ozadja seznamov (list) je dodana le za namene prikaza):
Tabela, ki jo zgenerirjo parametri predloge Predloga:Navpolje (pogovor, povezave, uredi) zimage, imageleft, lists, in brezgroups, above, below (siva barva ozadja seznamov (list) je dodana le za namene prikaza):
{{Navpolje
| name = Trije elementi
| title = Trije elementi
| image = [[Slika:TartiniSquare-Piran-6.jpg|60px]]
| list1 = [[element1]]{{·}} [[element2]]{{·}} [[element3]]
}}
Z uporabo parametra border je omogočena namestitev večjega števila navpolj znotraj enega okvirja, to lahko dosežete tudi z uporabo nepoimenovanega prvega parametra "child". Osnovni zapis za uporabo slednjega je takšen (doda podskupino za prvo group/list področje):
Predloga:Glavni
Ta primer ponazarja uporabo podskupin. Priporočeno je da se uporablja Predloga:Navpolje podskupina (pogovor, povezave, uredi), toda isti rezultat dosežete tudi z uporabo Predloga:Navpolje (pogovor, povezave, uredi) z Predloga:Para ali z uporabo nepoimenovanega prvega parametra "child". Parameter evenodd je uporabljen za zamenjavo vrstnega reda barv črtastega vzorca v nekaterih navpoljih - tako so črte pravilno razporejene. Če želiš črtasti vzorec popolnoma odstraniti, lahko nastaviš Predloga:Para za vsako navpolje posebej.
Predloga:Glavni
Spodnji primer uporablja predlogo navpolje za glavni okvir, njeni parametri list1, list2 in list3 vsebujejo vsak drugo navpolje z nastavljenim Predloga:Para. Vsako navpolje child ima svoj lasten P(poglej) P(pogovor) U(uredi) menu (navbar); le-te lahko skrijete z uporabo Predloga:Para za posamezno navpolje ali pa izpustite parameter name (navpolja child ne zahtevajo parametra name za razliko od običajnega navpolja.
Predloga navpolje je narejena tako, da deluje v skladu z drugima dvema sestrskima predlogama: Predloga:Navpolje stolpci (pogovor, povezave, uredi) in Predloga:Navpolje zložljive skupine (pogovor, povezave, uredi). Vse tri predloge si delujejo skupne parametre zaradi konsistence in lažjo uporabo (ti parametri so označeni z † v popolnem seznamu opisanim zgoraj). Najbolj pomembno je to, da se vse tri predloge lahko uporabljajo kot child predloge v vsaki izmed predlog (z uporabo parametra Predloga:Para ali z opredelitvijo prvega nepoimenovanega parametra child - {{Navpolje|child, {{Navpolje stolpci|child ali {{Navpolje zložljive skupine|child). Za primere kako se to naredi si oglejte stran naprednejših primerov navpolja.
en:Wikipedia:Line break handling – Vodič kako pravilno delati s presledki med besedami oz. word wraps (prelom vrstice) v Wikipediji, zaradi preloma vrstice linkanih povezav v seznamih navpolj.