Předłoha:Nawitabela2/Dokumentacija

z Kitakija

(rozdźěl mjez wersijomaj)
Dźi do: Nawigacija, Pytać
(Cele: dodawk)
(Stile: dodawk po jendźelskej wikipediji)
Rjadka 79: Rjadka 79:
====Stile====
====Stile====
-
:; ''stil_titula''
+
:; ''stil''<nowiki>*</nowiki>
 +
:: Definuje [[Cascading Style Sheets|CSS]] stile za kompletne ćěleso tabele.  Parameter ''stil_ćěleso'' tež čini samsny wěc a so móže město tutoho parametra ''stil'' wužiwać. <!--This option should be used sparingly as it can lead to visual inconsistencies.--> Přikłady:
 +
::: <code>stil = background:#''nnnnnn'';</code>
 +
::: <code>stil = width:''N''&nbsp;[em/%/px abo width:auto];</code>
 +
::: <code>stil = float:[''left/right/none''];</code>
 +
::: <code>stil = clear:[''right/left/both/none''];</code>
 +
 
 +
:; ''bazowy_stil''<nowiki>*</nowiki>
 +
:: CSS stile za cele, kotrychž wobsahi so z pomocu parametrow ''titul'', ''horjeka'', ''deleka'', a ''skupina'' definuja. Stil so njenałoža na cele po parametrje ''lisćina''.  To je přihódne zo by lochko změniło bazowu barbu nawitabele njedyrbjo wospjetować  stilowe definacije za rozdźěne dźěle nawitabele. Přikład:
 +
::: <code>bazowy_stil = background:lightskyblue;</code>
 +
 
 +
:; ''stil_titula''<nowiki>*</nowiki>
:: [[Kaskadna tabela stilow|CSS]]-stile, kotrež maja so za ''hłowny_titul'' wužiwać, zwjetša barba pozadka:
:: [[Kaskadna tabela stilow|CSS]]-stile, kotrež maja so za ''hłowny_titul'' wužiwać, zwjetša barba pozadka:
-
::: <code><nowiki>titlestyle = background:</nowiki>''#nnnnnn'';</code>
+
::: <code><nowiki>stil_titula = background:</nowiki>''#nnnnnn'';</code>
-
::: <code><nowiki>titlestyle = background:</nowiki>''name'';</code>
+
::: <code><nowiki>stil_titula = background:</nowiki>''name'';</code>
-
:; ''stil_ćělesa'' {{nobold|abo}} ''stil''
+
:; ''stil_ćělesa'' {{nobold|abo}} ''stil''<nowiki>*</nowiki>
:: [[Kaskadna tabela stilow|CSS]]-stile, kotrež maja so na ćěleso předłohi wužiwać. Jeli so někajke druhe stilowe parametry njepodawaja, hodźi so skrótšena forma ''stil'' wužiwać. Tuta opcija ma so w rědkich padach nałožić, dokelž móže k widźomnym wotchilenjam wjesć. Přikłady:
:: [[Kaskadna tabela stilow|CSS]]-stile, kotrež maja so na ćěleso předłohi wužiwać. Jeli so někajke druhe stilowe parametry njepodawaja, hodźi so skrótšena forma ''stil'' wužiwać. Tuta opcija ma so w rědkich padach nałožić, dokelž móže k widźomnym wotchilenjam wjesć. Přikłady:
::: <code>background:#''nnnnnn'';</code>
::: <code>background:#''nnnnnn'';</code>
Rjadka 92: Rjadka 103:
::: <code>clear:[''right/left/both/none''];</code>
::: <code>clear:[''right/left/both/none''];</code>
-
:; ''stil_skupinow''
+
:; ''stil_skupinow''<nowiki>*</nowiki>
-
:: CSS-stile, kotrež maja so na cele ''skupina<sub>n</sub>'' nałožić. Tutón parameter ma wyšu prioritu  porno stilam, kotraž buchu na tabelu dohromady nałožene. Přkłady:
+
:: CSS-stile, kotrež so maja na cele ''skupina<sub>n</sub>'' nałožić. Tutón parameter ma wyšu prioritu  porno stilam, kotraž buchu na tabelu dohromady nałožene. Přikłady:
::: <code>background:#''nnnnnn'';</code>
::: <code>background:#''nnnnnn'';</code>
::: <code>text-align:[''left/center/right''];</code>
::: <code>text-align:[''left/center/right''];</code>
Rjadka 99: Rjadka 110:
::: <code>white-space:nowrap;</code>
::: <code>white-space:nowrap;</code>
-
:; ''stil_lisćinow''
+
:; ''stil_skupiny<sub>n</sub>''<nowiki>*</nowiki>
 +
:: CSS stile, kotrež so maja na specifisku skupina nałožić, přidaty do někajkich stilow definowane z pomocu parametra ''stil_skupinow''.  Tutón parameter so by jenož wužiwać měł, jeli je absolutnje nuzne<!-- in order to maintain standardization and simplicity-->.  Přikład:
 +
::: <code>stil_skupiny3 = background:red;color:white;</code>
 +
 
 +
:; ''stil_lisćinow''<nowiki>*</nowiki>
:: CSS-stile, kotrež maja so na wšě lisćiny nałožić. Ma nišu prioritu porno parametram  ''stil_njerunych'' a ''stil_runych'' (jeli su podate).
:: CSS-stile, kotrež maja so na wšě lisćiny nałožić. Ma nišu prioritu porno parametram  ''stil_njerunych'' a ''stil_runych'' (jeli su podate).
-
:; ''stil_njerunych''
+
:; ''stil_lisćiny<sub>n</sub>''<nowiki>*</nowiki>
-
:; ''stil_runych''
+
:: CSS stile, kotrež so maja na specifisku lisćinu nałožić, přidaty do někajkich stilow definowane z pomocu parametra ''stil_lisćinow''. Tutón parameter so by jenož wužiwać měł, jeli je absolutnje nuzne<!-- in order to maintain standardization and simplicity-->.  Přikład:
 +
::: <code>stil_lisćiny5 = background:#ddddff;</code>
 +
 
 +
:; ''lisćina-mjezota''<nowiki>*</nowiki>
 +
:: Čisło a jednota, kotraž definuje mjezotu w kóždej celi ''lisćina''.  Cele  z parametrom ''lisćina'' normalnje maja mjezotu 0.25em na prawym a lěwym boku, a 0em horjeka a deleka.  Dla kompleksnych techniskich přičinow jednore definowanje "stil_lisćinow=padding:0.5em;" (abo někajki hinaše definowanje za mjezotu) njefunguje.  Přikładaj:
 +
::: <code>lisćina-mjezota = 0.5em 0em; </code> (definuje mjezotu wot 0.5em za lěwy/prawy, a mjezotu wot 0em za horjeka/deleka.)
 +
::: <code>lisćina-mjezota = 0em; </code> (wotstronuje wšě mjezoty lisćinow.)
 +
 
 +
:; ''stil_njerunych''<nowiki>*</nowiki>
 +
:; ''stil_runych''<nowiki>*</nowiki>
:: CSS-stilej, kotrejž maja na njerune (''lisćina1'', ''lisćina3'' atd.) abo rune (''lisćina2'', ''lisćiny4'' atd.) lisćiny nałožić. Zwjetša so za podaće barby pozadka (<code>background:#''nnnnnn'';</code>) wužiwa, zo bychu rjadki tabele wotměnjacu barbu dóstali. <!-- Tu by derje było přikład přidać -->
:: CSS-stilej, kotrejž maja na njerune (''lisćina1'', ''lisćina3'' atd.) abo rune (''lisćina2'', ''lisćiny4'' atd.) lisćiny nałožić. Zwjetša so za podaće barby pozadka (<code>background:#''nnnnnn'';</code>) wužiwa, zo bychu rjadki tabele wotměnjacu barbu dóstali. <!-- Tu by derje było přikład přidać -->
-
:; ''stil_horjeka''
+
:; ''stil_horjeka''<nowiki>*</nowiki>
-
:; ''stil_deleka''
+
:; ''stil_deleka''<nowiki>*</nowiki>
:: CSS-stile, kotrež so maja na hornju (z parametrom ''horjeka'' podatu) a deljnu (z parametrom ''deleka'' podatu) celu nałožić. Zwjetša so za podaće barby pozadka abo wusměrjenja teksta wužiwa:
:: CSS-stile, kotrež so maja na hornju (z parametrom ''horjeka'' podatu) a deljnu (z parametrom ''deleka'' podatu) celu nałožić. Zwjetša so za podaće barby pozadka abo wusměrjenja teksta wužiwa:
::: <code>background:#''nnnnnn'';</code>
::: <code>background:#''nnnnnn'';</code>

Wersija z 15:40, 20. meje 2009

Tuta předłoha dowola spěšnje nawigaciske lajsty wutworić, podawajo, lišćiny wotkazow jako parametry.

Wobsah

Prózdna předłoha

{{Nawitabela2
|mjeno          = {{subst:PAGENAME}}
|navbar         = 
|staw           = 
|stil_titula    = 
|titul          = 
|wobraz         = 
|stil_ćělesa    = <!-- (abo "stil =" jeli so někajke druhe atributy njewužiwaja) -->
|stil_titulow   = 
|stil_lisćinow  = 
|stil_njerunych = 
|stil_runych    = 

|stil_horjeka   = 
|horjeka        = 

|skupina1       = 
|stil_skupiny1  =
|lisćina1       = 
|stil_lisćiny1  =

|skupina2       = 
|stil_skupiny2  =
|lisćina2       = 
|stil_lisćiny2  =
 ...

|skupina20      = 
|stil_skupiny20 =
|lisćina20      = 
|stil_lisćiny20 =

|stil_deleka    = 
|deleka         = 
}}

Parametry

Trěbne

mjeno
Mjeno předłohi, trěbne za korektne fungowanje wotkazow "pok. disk. wobdź." ("pokazać diskusija wobdźěłać") na wšěch stronach, hdźěz so předłoha wužiwa. Za prózdnotu hodźi so {{subst:PAGENAME}} wužiwać.
titul
Tekst, kotryž so w najwyšej rjadce tabele jewi. Zwjetša je to tema předłohi, krótke wopisanje jeje wobsaha. To je zwjetša jedna rjadka, ale jeli stej dwě rjadce trěbnej, wužij prošu {{-}} za korektne centrowanje.
Standardna barba pozadka je #ccf (skrótšena forma wot #ccccff), hodźi so přez parameter stil_titula (hlej deleka) změnić.
lisćinan
(t.j. lisćina1, lisćina2 atd.) Ćěleso předłohi je zwjetša sadźba wotkazow. Elementy lišćiny dyrbja na jednej rjadce podate być, ale jeli je z <div> </div> wobdawaš, hodźi so dźělenje rjadkow wužiwać (hlej #Přikład ze žórłowym kodom). Dyrbi so znajmjeńša jedyn parameter lišćina; kóždy přidatny parameter lisćina so we wosebitej rjadce tabele jewi. Kóždy parameter lisćinan móže z parametrom skupinan wuhotowane być(hlej deleka).
Standardna barba pozadka (a cyłeje tabele) je #f9f9f9. Pozadk hodźi so přez parametry stil_ćělesa, stil_njerunych a/abo stil_runych změnić (hlej deleka).

Opcionalne

Cele

skupinan*
(t.j. skupina1, skupina2 atd.) Jeli ke tutón parameter podaty, budźe so nalěwo wot lisćinyn zapodaty tekst jewić. Jeli tutón parameter njeje podaty, lisćinan cyłu šěrokosć tabele wobsadźi.
Standardna barba pozadka je #ddf (skrótšena forma wot #ddddff), hodźi so přez parameter stil_titulow změnić (hlej deleka).
wobraz*
Wobraz, kotryž so pod hłownym titulom w prawym dźělu tabele (prawšo titulow/lisćinow) zwobraznja. Za korektne zwobraznjenje wobraza je trjeba parameter lisćina1 podać. Parameter wobraz dopušća standardny wikikod za wobrazy, t.j.
[[Wobraz:přikład.jpg|100px]]
W předłoze, kotraž so na cyłu šěrokosć strony wupřestěwa, budźe so wobraz ze zasunjenjom wot praweje kromy předłoha zwobraznjeć. Jeli chceš tomu zadźěwać, wužij parameter right we wikodźe, t.j.
[[Wobraz:Přikład.jpg|80px|right]]
wobraz-nalěwo*
Wobraz, kotryž so pod hłownym titulom w lěwym dźělu tabele zwobraznja. Za korektne zwobraznjenje wobraza je trjeba parameter lisćina1 podać. Parameter wobraz-nalěwo dopušća standardny wikikod za wobrazy, t.j.
[[Wobraz:přikład.jpg|100px]]
horjeka*
Cela w cyłej šěrokosći tabele, kotraž je njeposrědnje pod hłownym titulom (t.j. nad titulemi/lisćinami ćělesa předłohi). W předłoze bjez wobraza horjeka podaću parametra lisćina1 bjez přisłušneho parametra titul1 wotpowěduje.
deleka*
Cela po cyłej šěrokosći tabele, kotraž je niže ćělesa předłohi (t.j. pod titulemi/lisćinami a wobrazom). W předłoze bjez wobraza deleka podaću poslednjeho parametra lisćinan bjez přisłušneho parametra tituln wotpowěduje.

Stile

stil*
Definuje CSS stile za kompletne ćěleso tabele. Parameter stil_ćěleso tež čini samsny wěc a so móže město tutoho parametra stil wužiwać. Přikłady:
stil = background:#nnnnnn;
stil = width:N [em/%/px abo width:auto];
stil = float:[left/right/none];
stil = clear:[right/left/both/none];
bazowy_stil*
CSS stile za cele, kotrychž wobsahi so z pomocu parametrow titul, horjeka, deleka, a skupina definuja. Stil so njenałoža na cele po parametrje lisćina. To je přihódne zo by lochko změniło bazowu barbu nawitabele njedyrbjo wospjetować stilowe definacije za rozdźěne dźěle nawitabele. Přikład:
bazowy_stil = background:lightskyblue;
stil_titula*
CSS-stile, kotrež maja so za hłowny_titul wužiwać, zwjetša barba pozadka:
stil_titula = background:#nnnnnn;
stil_titula = background:name;
stil_ćělesa abo stil*
CSS-stile, kotrež maja so na ćěleso předłohi wužiwać. Jeli so někajke druhe stilowe parametry njepodawaja, hodźi so skrótšena forma stil wužiwać. Tuta opcija ma so w rědkich padach nałožić, dokelž móže k widźomnym wotchilenjam wjesć. Přikłady:
background:#nnnnnn;
text-align:[right/center/left/justified];
width:N [em/%/px];
float:[left/right/none];
clear:[right/left/both/none];
stil_skupinow*
CSS-stile, kotrež so maja na cele skupinan nałožić. Tutón parameter ma wyšu prioritu porno stilam, kotraž buchu na tabelu dohromady nałožene. Přikłady:
background:#nnnnnn;
text-align:[left/center/right];
vertical-align:[top/middle/bottom];
white-space:nowrap;
stil_skupinyn*
CSS stile, kotrež so maja na specifisku skupina nałožić, přidaty do někajkich stilow definowane z pomocu parametra stil_skupinow. Tutón parameter so by jenož wužiwać měł, jeli je absolutnje nuzne. Přikład:
stil_skupiny3 = background:red;color:white;
stil_lisćinow*
CSS-stile, kotrež maja so na wšě lisćiny nałožić. Ma nišu prioritu porno parametram stil_njerunych a stil_runych (jeli su podate).
stil_lisćinyn*
CSS stile, kotrež so maja na specifisku lisćinu nałožić, přidaty do někajkich stilow definowane z pomocu parametra stil_lisćinow. Tutón parameter so by jenož wužiwać měł, jeli je absolutnje nuzne. Přikład:
stil_lisćiny5 = background:#ddddff;
lisćina-mjezota*
Čisło a jednota, kotraž definuje mjezotu w kóždej celi lisćina. Cele z parametrom lisćina normalnje maja mjezotu 0.25em na prawym a lěwym boku, a 0em horjeka a deleka. Dla kompleksnych techniskich přičinow jednore definowanje "stil_lisćinow=padding:0.5em;" (abo někajki hinaše definowanje za mjezotu) njefunguje. Přikładaj:
lisćina-mjezota = 0.5em 0em; (definuje mjezotu wot 0.5em za lěwy/prawy, a mjezotu wot 0em za horjeka/deleka.)
lisćina-mjezota = 0em; (wotstronuje wšě mjezoty lisćinow.)
stil_njerunych*
stil_runych*
CSS-stilej, kotrejž maja na njerune (lisćina1, lisćina3 atd.) abo rune (lisćina2, lisćiny4 atd.) lisćiny nałožić. Zwjetša so za podaće barby pozadka (background:#nnnnnn;) wužiwa, zo bychu rjadki tabele wotměnjacu barbu dóstali.
stil_horjeka*
stil_deleka*
CSS-stile, kotrež so maja na hornju (z parametrom horjeka podatu) a deljnu (z parametrom deleka podatu) celu nałožić. Zwjetša so za podaće barby pozadka abo wusměrjenja teksta wužiwa:
background:#nnnnnn;
text-align:[left/center/right];

Druhe

staw*
Standard je autocollapse. Jeli je hódnota collapsed podata, budźe so nawitabela přeco w schowanym stawje jewić. Jeli je prózdna hódnota abo wšelaka hódnota nimo autocollapse a collapsed podata, budźe so nawitabela přeco we wotwrjenym stawje jewić. Nawitabela z parametrom autocollapse budźe so w schowanym stawje jewić, jeli je na stronje dwě abo wjace tabelow z atributom collapsible. Za technisce wersěrowanych hlej tu: MediaWiki:Common.js.
Druhdy trjebaja wobdźěłowarjo nawigacisku předłohu ze standardnym stawom, kotryž da so w nastawku předefinować. Wutwor za to w swojej mjezypředłoze parameter z jenakim mjenom "state", kotryž prosće hódnotu zakłodneje předłoze přepodawa:
| staw = {{{staw<includeonly>|standardny staw</includeonly>}}}


Předłoha budźe so přeco při wobhladanju strony předłohi, jeli so | podawa.
navbar*
Standardna hódnota je Tnavbar. Jeli je hódnota plain podata, njebudu so wotkazy
p  d  w
w lěwym dźělu titula pokazować.
kroma*
Jeli to ma hódnosć dźěćo abo podskupina, da nawitabela so móže wužiwać jako bjezkromowe dźěćo, kotrež derje hodźi do druheje nawitabele. Kroma so schowa a tež njeje mjezota na bokomaj tabele, tak hodźi do lisćina area jeje nadrjadowaneje nawitabele.
Alternatiwnje so móže hódnota žana wužiwać, jeli kroma so schowa a mjezota so wotstroni, a nawitabela so móže wužiwać jako dźělo druheho kašćika (njewužiwaj hódnotu žana znutřka druheje nawitabele; tuž, jenož wužiwaj hódnoće dźělo/podskupina znutřka druheje nawitabele). Jeli ma někajku hódnotu (jendźelsce default), jeli regularna nawitabela so z kromu wot 1px jewi. Alternatiwne wašnje definować kromu za podskupinowy stil, je (t.j. wužiwaj prěni njemjenowany parameter město mjenowaneho parametra kroma):
{{Nawitabela2|dźělo
...
}}

Wonkowny bok

Tabela, kotraž z wužiwanja předłohi {{Nawitabela2}} bjez parametrow wobraz, horjeka a deleka nasta (mjezy so jenož nazornosće dla pokazuja):

Tabela, kotraž z wužiwanja předłohi {{Nawitabela2}} z parametrami wobraz, horjeka a deleka nasta (mjezy so jenož nazornosće dla pokazuja):

Přikład ze žórłowym kodom

{{Nawitabela2
|mjeno        = {{subst:PAGENAME}}
|staw      = {{{staw|uncollapsed}}}
|titul  = [[Wikipedija:Nawigaciske předłohi|Nawigaciske předłohi]]
|stil_ćělesa = width:50%;

|skupina1 = Fyzika
|lisćina1    = [[Předłoha:Kosmologija|Kosmologija]]{{!}}
[[Předłoha:Powšitkowna teorija relatiwnosće|Powšitkowna teorija relatiwnosće]]{{!}}
[[Předłoha:Teorija trunow|Teorija trunow]]

|skupina2 = Kontinenty
|lisćina2    = <div>
[[Předłoha:Afrika|Afrika]]{{!}}
[[Předłoha:Azija|Аzija]]{{!}}
[[Předłoha:Europa|Europa]]
</div>

|lisćina3    = [[Předłoha:PŠK Kazachstana|Přirodoškitowe kónčiny Kazachstana]]
}}

Přidatne přikłady

Bjez wobraza

Z wobrazom

Z wobrazom a stilemi

Z dwěmaj wobrazomaj

Hlej tež

Nawigaciske předłohi
p  d  w
schowajomny Barba
hornjeje
linki
Wobraz(y) Skupiny Stilowe
parametry
za hłowu
Stilowe
parametry
za ćěselo
Přikłady
{{Nawigacija}} NavFrame NavHead Nalěwo a naprawo (2) jenož na stronje předłohi
{{Nawigaciska lajsta}}
{{Nawigaciska lajsta/spočatk}}
{{Nawigaciska lajsta/kónc}}
NavFrame NavHead2 Nalěwo a naprawo (2) Haj Haj {{Europa}},
{{Słowjanske rěče}}
Skupina předłohi {{Nawitabela}}
{{Nawitabela}} collapsible navbox1 Nalěwo (1) Haj Haj Haj {{Browsery}},
{{Nawigaciska lajsta Unixowe komanda}}
{{Nawitabela ze špaltami}} collapsible navbox Nalěwo (1) Haj Haj Haj
{{Nawitabela z podskupinami}}3 N/A Nalěwo (1) Haj Haj Haj {{Romaniske rěče}}
Skupina předłohi {{Nawitabela2}}
{{Nawitabela2}} collapsible navbox1 Nalěwo a naprawo (2) Haj Haj Haj
{{Nawitabela2 ze špaltami}} collapsible navbox Nalěwo a naprawo (2) Haj Haj Haj
{{Nawitabela2 z podskupinami}}4 N/A Nalěwo a naprawo (2) Haj Haj Haj
1 To so hodźi změnić přez CSS-formatach w parametrje stil_hłowneho_titula.

2 To so hodźi přez direktnu definaciju po CSS-formatach w parametrje PozadkBarbaT (na př. #cfc za swětłu zelenu barbu) změnić

3 Jenož so móže znutřka předłohi {{Nawitabela}} wužiwać

4 Jenož so móže znutřka předłohi {{Nawitabela2}} wužiwać

Atributy za schowajomnosć
Typ CSS klasy Javaskript Wona so schowa, jeli Custom
initial state
Nesting
Schowajomne tabele collapsible Definowana w Common.js wjace hač 1 so schowaca je na stronje. Haj Haj
Schowajomne wobłuki NavFrame


Wosobinske nastroje