Sablon:CCitLib/doc

A sablon használata

A CitLib sablon a Cite book sablon címleírási esetlegességein felülkerekedni kívánó, ugyanakkor szándékai szerint egyszerűbb kezelhetőséget biztosító alternatív címleírási sablon. A CitLib sablon teljes könyvek, illetve azok részegységeinek (fejezeteinek, tanulmányainak, szócikkeinek stb.) címleírására használható; a további lehetőségekhez lásd a jobb oldali menütáblát.

A sablon által produkált címleírás, az egyes elemek algoritmizálása, egymáshoz való viszonya, formátuma stb. az MSZ 3424-1:1978 könyvtári címleírási szabványból, az Irodalomtörténeti Közlemények szerkesztőségi útmutatójából, Gyurgyák János Szerkesztők és szerzők kézikönyve című alapvetéséből, valamint az Akadémiai Kiadó kurrens reprezentatív sorozatából, az Akadémiai Kézikönyvekből kibontakozó címleírási gyakorlatok áttekintésén alapul, s szándéka szerint az egységesen érvényesíthető elvek egyfajta szintézise. Ez a megoldás nem mondatszerűen értelmezi a címleírást, azaz nem vesszővel tagolja az egyes elemeket, hanem funkcionális egységekre osztja őket, s az egyes elemek közötti viszonyt a könyvtári leírásban is alkalmazott jelekkel határozza meg (pont, kettőspont, pontosvessző, egyenlőségjel).

A sablon használata kibővült a Context Object in Spam (COinS) szolgáltatással. Ez olyan böngészőkben hasznosulhat, amelyekhez a megfelelő kiegészítő szoftvert (addons) illesztettük. Helyes illesztést követően a sablon által adott szöveg végén apró betűs link jelenik meg, mely az egér kurzor rávezetése után buborék-súgót ad fekete alapon fehér betűkkel. Azok a könyvtárak, amelyek szervere az un. linkresolver szolgáltatást is nyújtják a COinS adatainak feldolgozásával az állományukban lévő könyvre mutató linkkel válaszolnak, vagy e-book esetén magával a szöveggel. Részletek a jelen dokumentáció végén vannak.

Másolható változat (a szócikkbe illesztés után az üresen hagyott paraméterek törlendők)

Alapparaméterek: {{CitLib|aut= |tit= |subtit= |loc= |red= |ann= |pag= |isbn= }} {{CitLib|szerző= |cím= |alcím= |hely= |kiadó= |év= |oldal=|isbn= }} Összes paraméter: {{CitLib|aut= |aut2= |aut3= |tit= |subtit= |ass= |edi= |loc= |loc2= |red= |red2= |ann= |ser= |sernr= |isbn= |url= |capaut= |capaut2= |capaut3= |cap= |pag= |isbn= |aurl=| archd= |accd= |misc= }} {{CitLib|szerző= |szerző2= |szerző3= |cím= |alcím= |közreműködők= |kiadás= |hely= |hely2= |kiadó= |kiadó2= |év= |sorozat= |sorozatszám= |isbn= |url= |fejezetszerző= |fejezetszerző2= |fejezetszerző3= |fejezetcím= |oldal= |isbn=|aurl=| archd= |accd= |egyéb= }}

A sablon paraméterei

A paraméterek a bibliográfiai címleírásra és forráshivatkozásra jellemző latinos hagyományok (et al., p., col., op. cit. stb.) jegyében a latin kifejezések alapján képzett rövidítések. Emellett az egyes paraméterek magyar megfelelői is használhatóak, egyazon CitLib-hivatkozás elhelyezésekor akár vegyesen is lehet használni a latinos, illetve magyar paraméterneveket.

Általános tudnivaló, hogy az egyes elemeket formázatlanul, azaz álló (és nem dőlt vagy kapitális) betűkkel és elemlezáró pont nélkül kell a paraméterbe illeszteni. A paramétereket és értéküket bármely sorrendben elhelyezhetjük a kódban, a sablon végül a megfelelő sorrendbe és algoritmusba fogja tenni őket.

A sablon paraméterei a következők:

Paraméter	Alternatív paraméter	Leírás
aut aut2 aut3	szerző szerző2 szerző3	Szerzőségi közlés. Nem kötelező paraméter(ek). Álló betűtípusú, a címbeni névsorrendet megtartja. Mindig a címl előtt áll, attól ":" választja el. A könyv egyéb közreműködőinek (szerkesztő, fordító, illusztrátor) megadásához használd az ass/közreműködők paramétert. Ha pl. aut2-t nem adod meg, aut3-ból csinálja meg a sablon. Bővebb tudnivalók a szerzőségi közlésről. Példa Eredmény {{CitLib|cím=Vmi|aut=[[Mocsáry Lajos]]}} Mocsáry Lajos: Vmi.   {{CitLib|aut=Béatrice Sauvageot|aut2=Jean Métellus|cím=Vmi}} Béatrice Sauvageot – Jean Métellus: Vmi.   {{CitLib|cím=Vmi|aut=Bertényi Iván et al.}} Bertényi Iván et al: Vmi.
tit subtit	cím alcím	A címközlés két eleme: a főcím és az alcím. "(cím?)" helyettesíti, ha nem adod meg.Hibajelzés :"(nincs elsődleges cím)" a cikkben. Ha van url, aláfekteti a sablon. Bővebb tudnivalók a címközlésről.
ser nyelvkód	lan	A könyv nyelve. Valamennyi a huwikin ismert nyelvkódot megadhatod. Hibajelzés nincs. A "krixkrax" például marad a cikkben is "krixkrax". Példa Eredmény {{CitLib|cím=Vmi|ser=Tiszatáj Könyvek|lan=hu}} Vmi. (magyarul) = Tiszatáj Könyvek,   {{CitLib|cím=Vmi|aut=Béatrice Sauvageot|aut2=Jean Métellus|nyelvkód=fr}} Béatrice Sauvageot – Jean Métellus: Vmi. (franciául)   Példa Eredmény {{CitLib|tit=Cserépkályhák építése}} Cserépkályhák építése.   {{CitLib|tit=Köz-beszéd|subtit=A vita művészete}} Köz-beszéd: A vita művészete.
ass ass2 ass3	közreműködők közreműködők2 közreműködők3	Közreműködők felsorolása. A szerzőkön kívül a címleírásban jelölni kívánt közreműködő: a főszerkesztő, szerkesztő,..., illusztrátor stb. A közreműködői minőség jelzése (főszerk., szerk., összeáll., ford., ill. stb.) a te dolgod. A sablon az egyes közreműködői csoportokat pontosvesszővel tagolja el egymástól. Csak az első tag lesz nagybetűs. Ha valamelyik elmarad, a sablon működése a szerzők paramétereihez hasonló. Példa Eredmény {{CitLib|cím=Vmi|ass=főszerk. Ferenczy Ágnes}} Vmi. Főszerk. Ferenczy Ágnes.   {{CitLib|cím=Vmi|ass=szerk. Simon Éva – Tóth István|ass2=Ill. Veres László|ass3=Fotó Csabai István}} Vmi. Szerk. Simon Éva – Tóth István–Ill. Veres László–Fotó Csabai István.
edi	kiadás	Kiadásjelzés. Az adott kiadásra vonatkozó információk. Ha egyáltalán jelöljük őket, célszerű rövidített formában. Példa Eredmény {{CitLib|cím=Vmi|edi=2. átd. és bőv. kiadás}} Vmi. 2. átd. és bőv. kiadás.   {{CitLib|url=http://mek.niif.hu/00300/00355/html/ABC11587/12167.htm|edi=3. jav. és röv. kiadás}} (cím?). 3. jav. és röv. kiadás.
loc loc2 red red2	hely hely2 kiadó kiadó2	A megjelenési hely és a kiadó jelölése. Szorosan összefüggő címleírási elemek, kapcsolatukat kettőspontos tagolás jelöli, az egyenértékű elemeket pontosvessző választja el egymástól. A kiadó nevének Kiadó, Könyvkiadó stb. elemeit nem kell jelölni. Több kiadó esetén használhatóak a második szintű paraméterek. Ha csak kiadókat jelölsz, helyet nem, a sablon a kiadó(k) neve elé beszúrja: "(Hely nélkül)"."(kiadó?)" karakterek pótolják a hiányzó kiadót. Hibajelzes: 'Hely kiadó nélkül'. Példa Eredmény {{CitLib|cím=Vmi|loc=Pápa|red=Jókai Mór Városi Könyvtár}} Vmi. Pápa: Jókai Mór Városi Könyvtár.   {{CitLib|cím=Vmi|loc=Budapest|red=Magvető|red2=Ciceró}} Vmi. Budapest: Magvető; (hely nélkül): Ciceró.   {{CitLib|cím=Vmi|loc=Pozsony|red=Kalligram|loc2=Budapest|red2=Pesti Kalligram}} Vmi. Pozsony: Kalligram; Budapest: Pesti Kalligram.   {{CitLib|cím=Vmi|red=Könyvmíves}} Vmi. (hely nélkül): Könyvmíves.
ann	év	A megjelenés időszaka. Példa Eredmény {{CitLib|cím=Vmi|ann=2008}} Vmi. 2008.   {{CitLib|cím=Vmi|ann=2005–2008}} Vmi. 2005–2008.
ser sernr	sorozat sorozatszám	A "(sorozatszám?)" karakterek jelzik a hiányzót. Hibajelzes: "sorozatszám sorozat nélkül", illetve ha elírtad a számot: "helytelen sorozatszám ". Példa Eredmény {{CitLib|cím=Vmi|ser=Tiszatáj Könyvek}} Vmi. = Tiszatáj Könyvek,   {{CitLib|cím=Vmi|ser=Gömöri Múlt és Jelen|sernr=2}} Vmi. = Gömöri Múlt és Jelen, 2.
isbn	isbn	ISBN szám. Az ISBN előtag nélkül jelöld csupán a számsort. Példa Eredmény {{CitLib|cím=Vmi|isbn=978-963-87066-4-5}} Vmi. ISBN 978-963-87066-4-5
url	url	A dokumentum vagy releváns fejezetének esetleges internetes elérési címe. Példa Eredmény {{CitLib|cím=Vmi|url=http://mek.niif.hu/00300/00355/html/ABC11587/12167.htm}} Vmi.
capaut capaut2 capaut3	fejezetszerző fejezetszerző2 fejezetszerző3	A könyv meghivatkozott részegységének (fejezetének, tanulmányának szócikkének stb.) szerzőségi közlése, amennyiben eltér a könyv szerzői információitól. Ugyanúgy használandó, mint az AUT/Szerző paraméter.
cap	fejezetcím	A részegység (fejezet, tanulmány, szócikk stb.) címe. Ugyanúgy használandó, mint a tit/cím paraméter.
misc	egyéb	Egyéb információk. Tetszőleges olyan információ, amihez nincs paraméter. A sor végére, vagy ha van url paraméter, akkor az „online” szöveg elé kerül. Példa Eredmény {{CitLib|cím=Vmi|misc=(PDF)}} Vmi. (PDF)   {{CitLib|cím=Vmi|egyéb=„Kiszera méra bávatag.”}} Vmi. „Kiszera méra bávatag.”
pag	oldal	Oldalszám. A könyvből felhasznált oldalak vagy a teljes fejezet, tanulmány, szócikk stb. tól-ig oldalszámának megadása. Több oldalszám esetén használjunk nagykötőjelet, de ezt se zárjuk le ponttal, a sablon automatikusan kiteszi a pontot. Példa Eredmény {{CitLib|cím=Vmi|pag=328–345}} Vmi. 328–345. o.   {{CitLib|cím=Vmi|pag=312–315., 328–345}} Vmi. 312–315., 328–345. o.
isbn	isbn	Egymástól veszővel elválasztott ISBN kódok listája (ha beleírod, hogy ISBN, azt a sablon átlépi). A sablon ezeket sorban, önállóan leellenőrzi (ne használd tehát a CheckISBN sablont, mert itt felesleges, kettős ellenőrzésre vezetne), helyes-e az ellenőrző szám bennük. A kimeneten előbb a helyes kódok listáját kapod, utána a hibás kódok listáját. Keress rá a helyes kódokra és javítsd a hibákat! Példa Eredmény {{CitLib|cím=Vmi|isbn=973-8267-10-2, ISBN 973-8045-37-1,963-05-8416-6, ISBN 978-963-05-8416-6}} Vmi. ISBN 973-8267-10-2, ISBN 973-8045-37-1, ISBN 963-05-8416-6, ISBN 978-963-05-8416-6   {{CitLib|cím=Vmi|isbn=973-8267-10-X, ISBN 973-8045-37-1,963-05-8416-7, ISBN 978-963-05-8416-6}} Vmi. ISBN 973-8045-37-1, ISBN 978-963-05-8416-6   : 973-8267-10-X, : 963-05-8416-7
archívurl archívdátum	aurl archd	Az archiválás adatai: url, dátuma Példa Eredmény {{CitLib|tit=Merengések |aurl=http://archive.org/details/erdeishegyicser00budegoog |archd=2006-05-17 }} Merengések. arch   {{CitLib|tit=Merengések |aurl= |archd=2013-03-11}} Merengések. 2013-03-11
elér	accd	Az oldal utolsó ismert elérésének a dátuma. Példa Eredmény {{CitLib |aut=Anon Béla|cím=Merengések |accd=2013-03-28| date= 2012-03-28}} Anon Béla: Merengések. Hozzáférés: 2013. március 28.

Példák teljes címleírásra

Az alábbiakban néhány teljes címleíráson mutatjuk be a sablon használati módját.

• {{CitLib|capaut=[[Vikár Béla]] |cap=Gabelsberger élete |aut=Markovits Iván |tit=Gyorsirás Gabelsberger rendszere szerint |subtit=Vitairás |ass=Szerk. Belházy Ernő |edi=2. jav. kiadás |loc=Budapest |red=Országos Magyar Gyorsíró-Egyesület |ann=1894 |pag=82–84 |isbn=973-8267-10-2, ISBN 973-8045-37-1|ser=Gyorsirászati Füzetek |sernr=3|url=http://mek.niif.hu/00300/00355/html/ABC11587/12167.htm|aurl=http://archive.org/details/erdeishegyicser00budegoog |archd=2006-05-17|accd=2013-03-28}}
• Vikár Béla: Gabelsberger élete. In Markovits Iván: Gyorsirás Gabelsberger rendszere szerint: Vitairás. Szerk. Belházy Ernő. 2. jav. kiadás. Budapest: Országos Magyar Gyorsíró-Egyesület. 1894. 82–84. o. = Gyorsirászati Füzetek, 3. ISBN 973-8267-10-2, ISBN 973-8045-37-1 arch Hozzáférés: 2013. március 28.  

A paramétereket és értéküket bármely sorrendben elhelyezhetjük a kódban, a sablon a megfelelő sorrendbe fogja tenni őket.

• {{CitLib|tit=Csigavonalban a Parnasszusra |aut=Valachi Anna |red=Argumentum |loc=Budapest |ann=2009 |subtit=Rákos Sándor földi poklai és táguló költői világa |isbn=978-963-446-546-1|url=http://mek.niif.hu/00300/00355/html/ABC11587/12167.htm}}
• Valachi Anna: Csigavonalban a Parnasszusra: Rákos Sándor földi poklai és táguló költői világa. Budapest: Argumentum. 2009. ISBN 978-963-446-546-1  

A sablon paraméterenkénti jellemzői

szerző(k):

ha valamely szerző hiányzik a társszerzők közül, akkor az nem hiba, előre lépteti a megadott szerzőket a szerzők sorában

cím:

Hibajel:

-"(nincs elsődleges cím)"

nyelvkód:

A szokásos hu,en,de,fr,it,... kódok egyike. Zárójelek közt jelenik meg pl "(német nyelven)".

Hibajel nincs.

Közreműködők:

kisbetűs kezdőbetűből nagybetűset csinál

év:

Elfogad el két évadatot kötőjelesen.

kiadó és hely:

nem baj, ha kimarad a kiadó, ekkor a "(Hely nélkül)" helyettesíti őt .

Hibajel: "Hely kiadó nélkül"

oldal

akár ".," "," van a bemeneten, helyes lesz a kimenet

a bemeneten nem hiba a kiskötőjel , vagy a hetvenkvirtes, úgy veszi, mintha azokat :jól adtuk volna meg

COinS

Context Object in Spam. Meta adatokkal írja le ez a sablonban megadott paraméterek egy részét, a szabványnak megfelelően kiegészítve más elemekkel. Ezeket a HTML egy speciális osztályú spam elemében rejti el.

Könyvtáraknak lehetősége van az adatok feldolgozása után válaszként link, vagy szöveg visszaadására.

Az átadott paraméterek (ezeket a COinS kódolt formában tartalmazza a buborék-súgóban)

• rft.atitle = fejezet
• rft.au = szerző, szerző2, szerző3 , az au paraméter ismétlésével
• rft.btitle = cím és alcím
• rft.edition = kiadás
• rft.pub = kiadó
• rft.place = kiadás helye
• rft.date = kiadás éve
• rft.pages = oldal
• rft.series = sorozat
• rft.issue = sorozat-szám
• rft.isbn = ISBN lista
• rft_id = URL