Bevezetés

A <teiHeader> a metaadatok gyűjtőeleme, a <text> pedig a tartalomé. A <text> három fő alágat, vagy gyermekelemet tartalmaz:

1. <front>: (front matter) a főszöveget megelőző járulékos részeket tartalmazza (fejléc, absztrakt, címlap, előszó, ajánlás, stb.)
2. <body>: (text body) a teljes, egységes szöveget tartalmazza, kivéve a járulékos részeket
3. <back>: (back matter) a főszöveget követő járulékos részeket tartalmazza, például függeléket, mutatót stb.

A <front> elem

A kiadott szövegeknél jellemző, hogy a főszöveget megelőzi valamilyen bevezető anyag, különösen a címlapon, vagy régebbi nyomtatott könyvek bevezetőinél. Ezeket a <front> elemben kódoljuk, ahogy az 1. ábrán látható:

1
2
3
4
5
6
7
8
9
10

<front>
    <docTitle>
        <titlePart>
            A hobbit,  vagy oda és vissza                    
         </titlePart>
     </docTitle>
     <byline>Írta <docAuthor>J. R. R. Tolkien</docAuthor>
      A szerző illusztrációival</byline>
     <docImprint>Boston and New York <title>Houghton Mifflin Company</title> 1938</docImprint>
</front>

Ezeknek a részeknek a kódolása a TEI Útmutató 4.6 Title Pages című szakaszában található. A <front> elem számos gyermekelemet tartalmaz, többek között:

• titlePage: (címlap) egy szöveg címlapját tartalmazza, amely a bevezető vagy lezáró részen belül jelenik meg.
• docTitle: (dokumentum címe) a dokumentum címét tartalmazza, beleértve az összes alkotóelemét is, a címlapon megadott módon.
• titlePart: egy mű címének alosztályát, vagy alfejezetét tartalmazza, a címlapon jelzett módon.
• argument: a szöveg egy részében említett témák formális listáját, vagy prózai leírását tartalmazza.
• byline: felelősségvállalási nyilatkozatot tartalmaz, amely egy mű címlapján, elején vagy végén van megadva.
• docAuthor: (a dokumentum szerzője) a dokumentum szerzőjének nevét tartalmazza, a címlapon megadott módon (nem mindig, de gyakran a „byline”-ban szerepel).
• epigraph: egy idézetet tartalmaz, amely egy szakasz elején vagy végén, esetleg a címlapon jelenik meg.
• imprimatur: egy mű megjelenését engedélyező hivatalos nyilatkozatát tartalmazza, amelynek esetenként kötelező megjelennie a címlapon vagy a mű hátoldalán.
• docEdition: (dokumentum kiadás) egy kiadási nyilatkozatot tartalmaz a dokumentum címlapján.
• docImprint: (dokumentum impresszum) az impresszumot tartalmazza (a kiadás helye, ideje, a kiadó neve), általában a címlap alján található.
• docDate: (dokumentum dátuma) a dokumentum dátumát tartalmazza a címlapon vagy a keltezésben.
• graphic: egy grafika vagy illusztráció helyét jelöli, amely vagy a szöveg egy részét jelöli, vagy egy képet biztosít hozzá.

A <body> elem

A <body> elem – számtalan gyermekelemével együtt – magát a szöveget tartalmazza, legyen az egy novella, versek gyűjteménye, egy színdarab, levél, stb., ahogy azt az Útmutató 4. fejezetében, Default Text Structure, le van írva. Ezeknek a szövegeknek a szerkezetét nemcsak kódolni lehet, hanem egyéb szöveges információval, vagy jellemzőkkel is kiegészíthetjük, például megjegyzésekkel, illusztrációk helyével, a kéziratban lévő módosításokkal vagy a különböző szerzők jelölésével.

A TEI inkább olyan, kevésbé leíró címkéket ajánl, amelyek különböző helyzetekben használhatók, de szemantikailag hasonló szerkezeteket írnak le. Nem találhatunk például olyan címkét egy költeményhez, amelynek „vers”, „strófa”, „kuplé”, vagy „oktáv” lesz a neve. Ehelyett a TEI egy <lg>, vagy „sorok csoportja” (line group) elemet biztosít, amely szemantikailag kevésbé specifikus gyűjtőelemként működik egy költemény minden lehetséges típusához. Ha egy adott projekthez az <lg> elemet jobban meg kell határozni, akkor ezt a „type” attribútumon keresztül lehet megtenni: pl. <lg type=”couplet”>

Ugyanez az elv érvényes a könyvek kódolására. Egy könyvet több fejezetből lehet felépíteni. A TEI-ben ez a szerkezet a <div> (szakasz) elemmel fejezhető ki. Ezzel az elemmel tetszőleges számú fejezetre/szakaszra osztható a szöveg. A felosztás pontos jellegét ebben az esetben is a @type attribútummal lehet meghatározni, ahogy a következő példa mutatja:

1
2
3
4
5
6
7
8

<body>
    <div n="1" type="chapter">
                <!-- A hobbit első fejezete jön ide --></div>
     <div n="2" type="chapter">
                <!-- A hobbit második fejezete jön ide --></div>
     <div n="3" type="chapter">
                <!-- A hobbit harmadik fejezete jön ide --></div>
</body>

A <back> elem

A <text> harmadik és egyben utolsó része a <back> elem, amelyben a szöveg után elhelyezett anyagot kódoljuk. Ez a kiadott szövegekre jellemző, például függelékek, mutatók, stb. További részletek az Útmutató 4.7 fejezetében, a Back Matter című részben találhatók.

A <back> elem gyermekelemei:

• appendix (függelék): egy önálló mellékrész, amely gyakran kiegészítő, de bizonyos értelemben extra-kanonikus szöveget nyújt.
• glossary (szószedet): kifejezések listája („glosses”), amit a következő módon kódolunk: <list type=”gloss”> (lsd. 3.7 fejezet, Lists című szakaszt).
• notes (jegyzetek): egy olyan szakasz, amelyben szöveges, vagy más típusú jegyzetek vannak összegyűjtve.
• bibliogr: bibliográfiai idézetek listája, amit listBibl-ként kell kódolni.
• index: egy könyvben lévő mutató bármely formában.
• colophon (kolofón): a könyv végén szereplő szöveg, amely a könyv fizikai előállításának adatai írja le.

A 3. ábra egy példa arra, hogyan kell kódolni a főszöveg utáni részeket:

1
2
3
4
5
6
7
8
9
10
11
12
13

<back>
     <div>
        <head>Függelék</head>
            <p>Ide jön a függelék szövege...</p>
     </div>
     <div>
       <head>Tárgymutató</head>
       <list type="index">
           <item>Első bejegyzés</item>
           <item>Második bejegyzés</item>
       </list>
    </div>
</back>

Alapvető elemek

Számos elem létezik, amely hasznos lehet a különböző típusú szövegek kódolásához, ezért hasznosak több TEI modul számára. Ezek a TEI alapvető elemei (Core Elements), amelyeket a TEI Útmutató külön fejezetben tárgyal (lsd. 3. fejezet, Elements Available in All TEI Documents). Ezek az elemek különböző funkciókkal rendelkeznek. Néhányuk strukturális elem, mint a <p> (a bekezdések kódolásához), mások a szöveg kiemelt részeinek (<hi>), vagy idézeteinek (<q>) kódolására szolgálnak. És vannak, amelyek szerkesztési változtatásokat (<reg> és <abbr> elemek), illetve jegyzeteket vagy megjegyzéseket (<note>) jeleznek. A 4. ábrán erre látunk példát:

1
2
3
4
5
6
7

<body>
     <head>A hobbit</head>
     <p>Egy földbevájt üregben<note>Ez egy jegyzet.</note> 
        élt egy hobbit. Nem valami mocskos, koszos, nedves üregben, 
        ami férgek maradványaival és nyirkos bűzzel van tele, és nem is afféle…
     </p>
</body>

További olvasnivaló

Module 3: Prose. TEI by Example. <http://teibyexample.org/modules/TBED03v00.htm>