Wikipédia:Ábrázoló

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

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

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

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

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

Sávdiagram

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

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

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

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

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

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

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

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

Az Ábrázolóhoz tartozó sablonok kategóriája
Az eszközt jelenleg használó lapok listája (Csak a szócikkek)
Sablon:Diagram (egy másik lehetséges megoldás diagramok megjelenítésére)
A MediaWiki EasyTimeline kiegészítője (szintén használható grafikonkészítésre is)