Wikipédia:Ábrázoló

A Wikipédiából, a szabad enciklopédiából
Ugrás a navigációhoz Ugrás a kereséshez

Az Ábrázoló (Visualizer) táblázatok diagramon és térképen történő megjelenítésére való eszköz, amelyet Al Maghi francia wikipédista készített, és az angol és francia Wikipédia után harmadikként a Magyar Wikipédiában honosított 2010 júliusában. A kívánt sablont a táblázatok fejlécébe építve a táblázat felett megjelenik egy link, amelyre kattintva egy külső alkalmazás diagramon vagy térképen jeleníti meg az adatokat. (Jelenleg nincs mód a diagram közvetlen beépítésére a cikkbe.) Az Ábrázoló teljes tudását egyelőre a saját honlapján próbálhatjuk ki. Az ott felsorolt alkalmazások közül a„geomap” és a „motion chart” Flash bővítményt igényel.

Az Ábrázoló a MediaWiki API-t és a Google Visualization API-t használja, és a Toolserveren fut. Központi oldala a Metában, a Visualizer for Wikimedia projects lapon található. Itt látható a felhasználása más Wikimedia projektekben is.

Használata[szerkesztés]

Az Ábrázolót a wikitáblázatok fejlécébe épített sablonok segítségével használhatjuk. Az alapja a {{Metaábrázoló}} metasablon, amely elvileg használható közvetlenül is, de nem erre készült. A szerkesztők számára legkényelmesebb az alkalmazói sablonok használata, amelyek közül egyelőre az alapsablon, a {{Ábrázoló}}(?) készült el. Ennek három másolata is van ({{Ábrázoló1}}(?), {{Ábrázoló2}}(?), {{Ábrázoló3}}(?)), amelyeket akkor használhatunk, ha egy szócikken belül több (jelenleg maximum négy) táblázatot szeretnénk diagrammal ellátni. Egy táblázathoz is csatolhatunk több különféle diagramot. (Lásd lent a példáknál.)

Az Angol Wikipédiában több sablon is látható, melyek egy része az Ábrázoló ottani megfelelőjének (Template:Visualizer) speciális alkalmazása (eleve rögzített diagramtípus, amelynek kevesebb paramétert kell adni), más része demonstrációs célokat szolgál.

Paraméterek[szerkesztés]

Paraméter Leírás Alapérték
1 (az első paraméter) A táblázat címe (és ha nincs megadva a cím paraméter, akkor a diagram címe is) nincs
szöveg A link szövege Mutasd diagramon
cím A diagram címe Megegyezik a táblázat címével (ha az sincs, akkor üres)
típus A diagram típusa (részletesen lásd lent) kör
oszlopok száma A diagramon megjelenítendő oszlopok száma (kizárólag összefüggően, a bal széltől) Az összes oszlop
szélesség A diagram szélessége 1000
magasság A diagram magassága 500
forrás A táblázatot tartalmazó oldal A linket tartalmazó oldal

A szélesség és a magasság akkor válik fontossá, ha a táblázat első oszlopában szereplő nevek nem férnek ki teljes terjedelmükben (vagy nem mind férnek ki). Egyébként mellőzhető.

A forrás paramétert akkor kell használnunk, ha a táblázatot sablonként illesztjük be a szócikkbe. A minta a Sablon:Ábrázoló lapon látható, ahol a mintatáblázatot a sablondoc tartalmazza, ezért a sablon lapján a paraméter használata nélkül hibaüzenetet kapnánk. (Kaptunk is, ennek hatására vezette be Al Maghi ezt a paramétert. :-)) A szócikkek többségében tehát elhagyható.

A lenti példák valamennyi paraméter használatát bemutatják.

A felsorolásban nem szerepel a tpl paraméter, amelyre felhasználói szinten nincs szükség, csak új sablon készítésekor, vagy ha közvetlenül hivatkozunk a {{Metaábrázoló}} sablonra.

Diagramtípusok[szerkesztés]

  • kör (alapértelmezett)
  • oszlop
  • sáv
  • vonal
  • scatter*
  • area*
  • sparkline*
  • geomap*
  • intensitymap*

(A csillaggal jelölteket le kéne fordítani itt is és beírni a Sablon:Metaábrázoló forrásában a megfelelő sorba a "case" helyére, aztán törölni ezt a megjegyzést.)

Különleges típus a mozgó diagram (motion chart). Az ehhez szükséges sablon pillanatnyilag még nincs implementálva, leírása példával a m:Visualizer for Wikimedia projects#Motion chart usage címen látható.

Az összes típus működése itt látszik.

A táblázat előkészítése az Ábrázoló használatára[szerkesztés]

A legtöbb táblázat semmiféle külön előkészítést nem igényel. A következőkre figyeljünk oda:

  • A megjelenítendő cellákban ne legyen  -vel tagolt szám, mivel azt nem ismeri fel az eszköz. A nagy számokat közönséges szóközökkel vagy a formatnum beépített függvénnyel tagolhatjuk. (A nem törhető szóköz a táblázatcellákban amúgy is ritkán szükséges, mivel a számot tartalmazó cellák jellemzően kiférnek egy sorba.) Egyebekben a számírási útmutatót kövessük.
  • A táblázat celláit, sorait határoló | karakterek a sor elején kezdődjenek, szóköz nélkül. Van, aki szereti egy szóközzel beljebb húzni ezeket, de ezt az Ábrázoló jelenleg nem ismeri fel. (Természetesen továbbra is írhatunk egy sorba több cellát.)
  • Egyes esetekben problémát okozhatnak a fejlécben elhelyezett sablonok.
  • Ha csak a táblázat néhány oszlopát szeretnénk megjeleníteni, akkor ezeknek kell a bal oldalon lenniük.

Példák[szerkesztés]

Sávdiagram[szerkesztés]

A táblázat fejlécében használjuk az Ábrázolót. Megadtuk a táblázat címét az első paraméterben (és mivel a cím paramétert nem adtuk meg, a kész diagramnak is ugyanez lesz a címe), valamint a link szövegét és a diagram típusát. Az alapértelmezett 1000-es szélességnél igen böszmének tűnt ez a három sávból álló, erőteljes diagram, 700-nál viszont még nem jelent meg teljesen a bal szélen a projektek neve, ezért lett 800 a szélesség, arányos magassággal. A mintakódban a megjelenítés kedvéért sortörést alkalmaztunk, amit a valóságban nem kell.

Kód   Megjelenés
{| {{széptáblázat-r}}
|+ {{Ábrázoló| Az Ábrázolót használó 
szócikkek száma 2010. július 22-én|típus=sáv
 |szöveg=Diagram|szélesség=800|magasság=400}}
! Projekt
! Cikkek száma
|-
|[[Angol Wikipédia]]
|1
|-
|[[Francia Wikipédia]]
|2
|-
|[[Magyar Wikipédia]]
|2
|-
|}
Az Ábrázolót használó szócikkek száma 2010. július 22-én (Diagram)
Projekt Cikkek száma
Angol Wikipédia 1
Francia Wikipédia 2
Magyar Wikipédia 2

Egy minimalista diagram[szerkesztés]

Bemutatjuk a lehető legegyszerűbb használatot: semmilyen paramétert nem adunk meg, csak magát a sablont helyezzük el a fenti táblázat fejlécében. Most sem a táblázatnak, sem a diagramnak nincs címe, a link szövege is az alapérték, és mivel a diagramtípust sem mondtuk meg, az alapértelmezett kördiagramon mutatja meg az Ábrázolót használó szócikkek megoszlását a projektek között. Egyetlen dologra kell figyelnünk: mivel ugyanezen a lapon, az előző példában már használtuk az Ábrázoló sablont, most az Ábrázoló1-et kell használnunk (amely annak másolata).

Kód   Megjelenés
{| {{széptáblázat}}
|+ {{Ábrázoló1}}
! Projekt
! Cikkek száma
|-
|[[Angol Wikipédia]]
|1
|-
|[[Francia Wikipédia]]
|2
|-
|[[Magyar Wikipédia]]
|2
|-
|}
 (Mutasd diagramon)
Projekt Cikkek száma
Angol Wikipédia 1
Francia Wikipédia 2
Magyar Wikipédia 2

Négy kördiagram egy cikkben[szerkesztés]

A 2008-as romániai önkormányzati választás szócikk Általános adatok szakasza volt az első, amelyben alkalmaztuk az új eszközt (permalink). Itt négy egyszerű táblázat van egymás alatt, ezért mind a négy sablont használnunk kell (rendre Ábrázoló, Ábrázoló1, Ábrázoló2, Ábrázoló3). Mivel minden táblázat saját szakaszcímmel rendelkezik, külön táblázatcímet nem adtunk meg, ezért indokolt volt a cím paramétert használni a diagram címéhez. A típus=kör redundáns. A második táblázathoz az eredetinél nagyobb magasságot adtunk meg, hogy a diagramon kiférjen a pártok neve, a negyedikhez azonban nem, mert ott úgyis reménytelen. :-)

Több diagram egy cikkben eltérő típusú sablonnal[szerkesztés]

Az Angol Wikipédia Demographics of Singapore (permalink) cikkének Ethnic groups és Languages szakaszaiban összesen három táblázathoz tartozik diagram. Ezt úgy oldotta meg Al Maghi, hogy az elsőhöz az általános sablont, a másodikhoz a külön oszlopdiagram-sablont, a harmadikhoz a sávdiagramsablont használta. (Ne feledjük, egy lapon belül különböző táblázatokhoz nem használhatjuk többször ugyanazt a sablont.)

Két diagram egy táblázathoz / csak az első két oszlop használata[szerkesztés]

A Sablon:Ábrázoló leírólapján Szingapúr etnikai összetételének táblázatát látjuk az előző cikkből. A számok egy részében a tizedesjelet vesszőre javítottuk, az alsó két sorban pedig – kellőképpen el nem ítélhető módon – meghagytuk a pontot, kizárólag a bemutató kedvéért (mind a kettőt értelmezi az eszköz). Mivel a táblázat nem a sablonban, hanem a sablondokumentációban van, amelyet az allapról illesztünk be sablonként, ezért itt a forrás paramétert is használnunk kell! Ez a paraméter viszont lehetővé teszi, hogy a táblázatot akár ebbe az útmutatóba is beilleszthessük sablonként egy kinyitható dobozban.

A táblázat fejlécében két diagram linkje látszik. Az első az összes adatot mutatja oszlopdiagramon, és tartalmazza a táblázat címét is (ezért nem kell neki grafikoncím). A másodiknál nem adtuk meg ismét a táblázatcímet, helyette a diagram címét írtuk be. A forrás viszont mind a kettőhöz kell, és a linkek eltérő szövegét is célszerű volt megadni. A második diagram mutatja be, hogyan használjuk a táblázat első két oszlopát. Nincs rá lehetőség, hogy például az utolsó, 2009-es oszlop adataiból készítsük el ugyanezt a kördiagramot.

Vegyük észre, hogy mind a két diagramhoz ugyanazt a sablont használjuk, egy lapon belül! Ezt azért tehetjük meg, mert ugyanahhoz a táblázathoz tartoznak.

Egy egyszerű és látványos oszlopdiagram[szerkesztés]

A Szénbányászat Nógrád megyében cikk Termelési adatok szakaszában (permalink) több mint egy évszázad szénkitermelését láthatjuk. A diagram jobban érzékelteti a változást, mint a táblázat. Ha sűrűbben lennének megadva az adatok, gondolhatnánk vonaldiagramra is, de a tízévenkénti mintavételezéshez jobban illenek a különálló oszlopok. A diagramot előállító kód:

|+ {{Ábrázoló|típus=oszlop|cím=Szénkitermelés Nógrád megyében}}

Kombinált megjelenítés több eszközzel[szerkesztés]

A Francia Wikipédia Population mondiale szócikkében (permalink) ugyanazon táblázat alapján oszlop- és kördiagramon is összehasonlíthatjuk a kontinensek lakosságát, alatta pedig a timeline kiegészítést használó diagramon látszik néhány népesebb ország lakossága a kontinensekével együtt. Ennek a módszernek az az előnye, hogy a timeline-hoz nem kell még egy táblázat, csak maga a grafikon látszik, a cikkbe beépítve (azonban sokkal több munka elkészíteni).

Korlátok[szerkesztés]

Jelenleg (2010 júliusában) a következő korlátokkal használható az eszköz:

Több diagram egy lapon

Egyelőre minden táblázathoz más sablont kell használni, és egy szócikkben maximum négyet lehet (ennyi sablon készült el).

Nem törhető szóközzel tagolt számok

Nem ismeri fel az  -vel tagolt számokat. A nagy számokat szóközzel vagy formatnummal lehet tagolni. (Megjegyzés: táblázatcellák belsejében általában nem okoz problémát a közönséges szóközzel való tagolás.)

A megjelenítendő oszlopok elhelyezkedése és tartalma

Nem lehet ábrázolni a Jelenkori magyarországi országgyűlési választások#Az 1990-es választás alatti táblázatból a szervezetek nevét az elnyert mandátumok számával vagy arányával, két okból sem: egyrészt a mandátumok oszlopa nem közvetlenül a szervezetek neve mellett van, hanem közbeékelődnek a két forduló részeredményei, másrészt a be nem jutott pártok mandátumánál számadat helyett kihúzás van. Tehát csak egy kitöltött táblázat első n oszlopa használható.

Nem szabályos táblázat

Nem sikerült beépíteni az eszközt a Kerékpározás a 2004. évi nyári olimpiai játékokon szócikk éremtáblázatába, mivel az nem szabályos wikitáblázat, hanem az {{éremtáblázat}} sablonból nyeri a fejlécét.

Fapados módosítási lehetőség

Technikai okból egyelőre több példány kell az alkalmazói sablonból, ha egy cikkben több táblázathoz akarjuk használni az eszközt. Ha az Ábrázoló sablon módosul, az összes másolatban (jelenleg: Ábrázoló1–Ábrázoló3) azonos módon kell átvezetni a módosítást, de az első sorban a tpl= paraméterhez minden sablonnak a saját nevét kell írni.

Bekezdéses táblázatkód

Nem működik az eszköz, ha a táblázat határait jelző vonalak a kódban nem a sor elején kezdődnek. Lásd ezt a javítást a Szingapúr szócikkben, melynek hatására a diagram megjelent.

Lásd még[szerkesztés]