Wikipédia:Searchboxsablonok
 |
Ezen az oldalon egy technikai leírást olvashatsz a Wikipédia szerkesztéséről. Tartsd szem előtt, hogy nem minden ajánlott, ami technikailag megvalósítható! |
A searchboxok olyan sablonok amelyek segítségével hasonló témájú szócikkeket elején egységes szerkezetben és megjelenéssel tudunk kölönleges adatokat összegyűjteni, hogy ezeket ne kelljen az olvasónak a szócikk szövegében keresgélnie.
Kötelező paraméterek[szerkesztés]
Fejléc
A {{Searchbox/Fejléc}} sablonnal készíthető el a searchbox fejléce. Ezt a sablon használatakor nem kell feltűntetnünk.
<!--
FEJLÉC
-->{{Searchbox/Fejléc<!--
-->|elsődleges cím<!--
-->|másodlagos cím<!--
-->|a fejléc háttérszíne<!--
-->|a fejléc szövegének színe<!--
-->|CSS-oszály<!--
-->}}
- Az elsődleges cím és a másodlagos cím az a szöveg, ami meg fog jelenni a fejlécben. Ha az elsődleges és a másodlagos cím is meg van adva, akkor a másodlagos cím zárójelben fog szerepelni az elsődleges után. Ha az elsődleges cím nincs megadva, akkor a másodlagos cím kerül a helyére.
- A fejléc háttérszíne és a fejléc szövegének színe vagy egy szín neve (pl. blue, skyblue, red stb.), vagy egy hex-hármas (pl.
- 0000FF).
Használata
Tegyük fel, hogy filmek számára készítünk searchboxot. Ilyenkor ugye szerepeltethetjük a fejlécben az angol, és a magyar címet is, a magyart elsődlegesen. Ezeket a sablonoknak megadható paraméterek tartalmazzák, melyeket három kapcsos zárójel közé rakunk ({{{ és }}}, pl. {{{magyar név}}}). Ahhoz, hogy a paraméter ne jelenjen meg, ha nincs megadva, a paraméter neve után, a záró kapcsos zárójelek elé egy pipe (|) jelet kell rakni, pl. így: ). A fejléc színe tengerzöld (seagreen, #2E8B57) lesz, a szöveg pedig fehér (white, #FFFFFF), mert éppen ez tetszik. Ikont nem akarunk, így nincs szükségünk CSS-osztályra. Ekkor az alábbi kódot kell elhelyeznünk a sablonba
{Infobox/Fejléc<!--
-->|{{{magyar cím}}}<!--
-->|{{{angol cím}}}<!--
-->|seagreen<!--
-->|white<!--
-->|<!--
-->}}{{Infobox/Lábléc}}
<pre>
<!--
FEJLÉC
-->{{Infobox/Fejléc<!--
-->|{{{magyar cím|}}}<!--
-->|{{{angol cím|}}}<!--
-->|seagreen<!--
-->|white<!--
-->|<!--
-->}}
Ez már majdnem tökéletes, azonban tegyük fel, hogy a használó szerkesztő elfelejtette megadni az angol és a magyar címet is, és csak néz, hogy miért nem jelent meg semmi. Kötelezővé tehetjük a magyar címet, így azt mindenképpen meg kell adnia, és ha nem jelenik meg, akkor egy üzenet fog megjelenni számára: Sablon:Searchbox/FejlécSablon:Searchbox/Lábléc
<!--
FEJLÉC
-->{{Searchbox/Fejléc<!--
-->|{{{magyar cím|Add meg a magyar címet!}}}<!--
-->|{{{angol cím|}}}<!--
-->|seagreen<!--
-->|white<!--
-->|<!--
-->}}
További módosításokat is végezhetünk, például ha csak a magyar címet akarjuk szerepeltetni: Sablon:Searchbox/FejlécSablon:Searchbox/Lábléc
<!--
FEJLÉC
-->{{Searchbox/Fejléc<!--
-->|{{{magyar cím|Add meg a magyar címet!}}}<!--
-->|<!--
-->|seagreen<!--
-->|white<!--
-->|<!--
-->}}<!--
Lábléc
Az {{Searchbox/Lábléc}} sablonnal zárhatjuk le az infoboxot. Használata kötelező, hiszen nélküle az egész szócikk az infoboxba kerül. Használata a következő:
<!--
LÁBLÉC
-->{{Infobox/Lábléc}}
Adatmezők
Az adatmezők az searchboxsablonok leglényegesebb elemei, ugyanis ezek tartalmazzák a konkrét adatokat az adott témáról.
Általános Az általános adatmezőt akkor kell használni, mikor a szerkesztő által a paraméterben megadott értéket változás nélkül akarjuk megjeleníteni. Használata a következő:
a mező címkéjea mező értéke
- A mező értéke lehet állandó érték (ilyenkor a mező mindig megjelenik), vagy változó ({{{ és }}} között, a | pipe jelet ki kell rakni, hogy ha a változó nincs megadva, akkor ne legyen semmilyen értéket, pl. .
- A mező címkéje az a szöveg, ami az érték előtt áll, azonosítja azt. Ez lehet állandó, vagy akár változó is.
A mező címkéjének linjke az az oldal, amire a címke fog hivatkozni, pl. terület megadása esetén belinkeljük az azonos nevű oldalt. A forrásos változat egy negyedik paraméterrel egészül ki:
a mező címkéjea mező értéke[1]
A forrásnál megadott szöveg automatikusan [2] tagek közé kerül. Megadhatunk változót is, ilyenkor a sablont használó szerkesztő adja meg a forrás szövegét. Példák az általános adatmező használatáraSzerkesztés Az első példában egy olyan adatmezőt készítünk, ahol meg lehet adni egy film műfaját. A mintában a sci-fit adtuk meg a műfaj paraméter értékének:
| Műfaj | sci-fi |
Lásd még[szerkesztés]
(lapok, útmutatók, irányelvek, dokumentációk)