Description of the TEI-Encoding for the Psalmcatenae Project

Header
Macrostructure
1. Divisions
2. Notes
3. Anonymous Blocks
4. Segments
5. Quotes
6. Anchors
7. Examples
Microstructure
Hints

Defining Glyphs


<charDecl>
    <glyph xml:id="linking-sign-1">
        <glyphName>LINKING SIGN ONE</glyphName>
        <charProp>
            <localName>entity</localName>
            <value>linking-sign-1</value>
        </charProp>
        <figure>
            <graphic url="./images/linking-sign-1.png"/>
        </figure>
    </glyph>
</charDecl>

Notes

The xml:id is used to link a glyph in the text to entity in the character declaration:


<g ref="#linking-sign-1"/>

The # sign is used to mark the value as a reference. The graphic element contains the path to the image of the glyph (url).

Defining the Layout


<layoutDesc>
    <layout n="layout of the pages">
        <p xml:id="middle-of-the-page">middle of the page</p>
        <p xml:id="main-text">main text</p>
        <p xml:id="left-margin">left margin</p>
        <p xml:id="top-margin">top margin</p>
        <p xml:id="right-margin">right margin</p>
        <p xml:id="bottom-margin">bottom margin</p>
        <p xml:id="on-the-line">on the line</p>
        <p xml:id="above-the-line">above the line</p>
        <p xml:id="margin-top-right-side">margin top right side</p>
        <p xml:id="margin-top-left-side">margin top left side</p>
    </layout>
</layoutDesc>

Notes

The content between the <p> tags can be more verbose. It should provide a description of the layout position.

Important is the xml:id attribute because it is used as reference in other elements in the document body. For example a division in the middle of the page should carry a rendition attribute with a reference to the corresponding layout element:


<div rendition="#middle-of-the-page"> ... </div>

References start with the # sign.

List of Authors


<listPerson>
    <head>Authors</head>
    <person xml:id="person-1" role="author">
        <persName>Asterius</persName>
        <bibl corresp="#bibliography-title-1">Asterius, fr.</bibl>
    </person>
...
</listPerson>

Notes

At the moment not physical persons are distinguished but authors of specific editions. This seems to be appropriate because it is necessary for example to identify Anonymous as author of so far unknown fragments and Anonymous as author of the fragments published by Dorival.

Macrostructure

Divisions


<div xml:id="vat-gr-1422-1-2" type="bibletext" subtype="commented" rend="red ink" rendition="#middle-of-the-page"> ... </div>

Notes

The xml:id is used to identify an entity in the transcription. The value can be freely choosen, however, it should be somehow consistent, e.g. name of the manuscript / manuscript identifier + number of the psalm the entity belongs to + counting upwards. The identifier must be unique within a document.

The values of the type attribute are restricted to the following values:

header - For headers of psalms
bibletext - Section of bibletext
transcription - Contains the transcription of a text in a manuscript. Should appear only once at the beginning of the transcription.
hypopsalmos - Short invocation in manuscripts of the Psalms
hypothesis - Short introduction to a Psalm in manuscripts of the Psalms
perioche - Short summary of a Psalm (by Eusebius of Caesarea) in manuscripts of the Psalms
note - Extended notes in the margins
glossai - Glosses in the text
hexaplaric - Hexaplaric variants
commentary - Commentary of a bibletext

Divisions are terminated by a page break. Every section on a page like the different colums builds a division on its own.

Notes


<note place="right margin" rend="red ink" xml:id="vat-gr-1422-1-6" xml:lang="grc" corresp="#vat-gr-1422-fr-1-1"> ... </note>

Notes

The place attribute contains the position of the note on the page. Possible values are:

main text - in the main textflow
top of the page - on top of page
bottom of the page - on bottom of page
left margin - on the left margin
right margin - on the right margin
left margin of left column - on the left margin of the left column
left margin of middle column - in the left margin of the middle column
left margin of right column - on the left margin of right column
right margin of left column - on the right margin of the left column
right margin of middle column - in the right margin of the middle column
right margin of right column - on the right margin of right column

The corresp attribute gives a reference to the entity the note belongs to. Here the note is associated with a commentaryfragment with the id vat-gr-1422-fr-1-1

Anonymous Blocks


<ab xml:id="vat-gr-1422-1-2" xml:lang="grc"> ... </ab>

Notes

The anonymous blocks are only used because TEI requires them

Segments


<seg type="commentaryfragment" source="Basilius of Kappadokia" xml:id="vat-gr-1422-fr-1-1" corresp="#vat-gr-1422-ps-1-1a" rendition="#main-text"> ... </seg>

Notes

The type attribute can take on of the six values:

commentaryfragment - Segment containing a commentaryfragment
hexaplaric - Segment containing a hexaplaric variant
glosse - Segment containing a glosse
hypopsalmos - Short invocation in manuscripts of the Psalms
hypothesis - Short introduction to a Psalm in manuscripts of the Psalms
perioche - Short summary of a Psalm (by Eusebius of Caesarea) in manuscripts of the Psalms

The corresp attribute contains a reference to a psalm text (or another text) the segment belongs to. In almost all cases this is by convention an identifier of an anchor.

The source attribute has the name of the author as mentioned in the text of the manuscript. Often the value is Anonymous.

When a commentaryfragment runs over a pagebreak it is necessary to set the prev and next attributes with the xml:ids to indicate that the texts belong together.

Quotes


<quote type="patristic" corresp="#person-9" xml:id="vat-gr-1422-quot-1-5" source="fons ignotus (ed. Dorival IV 367)"> ... </quote>

Notes

The value of the type attribute must be one of:

bibletext - Quotation of a psalmtext
patristic - Quotation of a patristic author
biblical - Quotation of a bible text
heading - Heading of bible text, e.g. Halleluja

The value of the corresp attribute is a pointer to a element of a list of authors given in the document header.

When a quote runs over a pagebreak it is necessary to set the prev and next attributes to indicate that the texts belong together.

Anchors


<anchor xml:id="vat-gr-1422-ps-1-1a" type="psalmtext" n="Ps (LXX) 1,1a" corresp="../psalms-LXX/psalms.xml#Ps-LXX-1-1"/>

Notes

The anchor element is only used for the markup of subdivisions in verses of the psalmtext.

The corresp attribute is a pointer to the text of the psalm in another file which contains the LXX text according to Rahlfs.

The value of the n attribute appears in the list of commentaryfragments at the end of the diplomatic html version.

Examples

Commentaryfragments


<seg type="commentaryfragment" xml:id="vat-gr-754-fr-9-83" rendition="#right-column" 
        source="(Athanasius)" corresp="#vat-gr-754-ps-9-26c">
   <quote type="patristic" subtype="quotation" xml:id="vat-gr-754-quot-9-86" 
             source="Athanasius, schol. in Ps 9,26c" corresp="#person-2">Ὅμοιον ... νοσσιάν:</quote>
</seg>

The value of the corresp attribute on the seg element is a pointer to an anchor element of the bibletext.

The subtype attribute on the quote element designates the relation of the text of the manuscript to the text of available editions.

Suggested values are:

quotation
quotation-abbreviated
paraphrase
paraphrase-abbreviated
unknown

Hexaplaric Variants


<seg type="hexaplaric" xml:id="vat-gr-754-hexaplaric-10-13" rendition="#right-column" 
        source="Aquila, Theodotion (Ps 11,1)" corresp="#vat-gr-754-ps-11-1a">A Θ τῷ νικοποιῷ·</seg>

Please note that the seg of hexaplaric variants does not contain a quote.

Glosses


<seg type="glosse" xml:id="vat-gr-754-glosse-10-4" rendition="#right-column" 
        source="Anonymous" corresp="#vat-gr-754-ps-10-3a">
    <quote type="patristic" subtype="unknown" xml:id="vat-gr-754-quot-10-13" 
	          source="fons ignotus; in Ps 10,3a?" corresp="#person-18">κατέβαλεν·</quote>
</seg>

Microstructure

Page Breaks


<pb n="25r"/>

Notes

Since divisions start and end with pagebreaks the pagebreak element stands below the div with attribute type="transcription".

Pagebreaks mark the beginning of a page.

Line Breaks


<lb n="2" break="no"/>

Notes

Linebreaks mark the beginning of a line.

Linebreaks can have an attribute break with the value no which indicates that the linebreak appears in a word.

Ekthesis


<hi rend="ekthesis">Μ</hi>ακάριος

Other possible values for the rend attribute on hi are:

initial
tall - for large letters
majuscule - for uppercase letters / capitals
ekthesis-majuscule - ekthesis in majuscule letters
rubricated
overline - line over a letter or a word
underline - line under a letter or a word
subscript
superscript
red ink
red ink bold

Uncertain Readability


... το<unclear reason="damage">ῖς</unclear> ...

Gaps


... <gap unit="character" quantity="2" reason="erased"/> ...

Regularization

There are two types of regularization: One for normal regularization without attribute type on reg and one with value correction for little errors.


<choice>
    <orig>βουλῆι</orig>
    <reg type="correction">βουλῇ</reg>
</choice>

Abbreviations

Simple abbreviations for authors of the Septuagint:


<abbr source="Aquila" type="bibleversion"><hi rend="overline">Α</hi></abbr>

Nomina Sacra


<choice>
    <abbr type="nomSac">χυ</abbr>
    <expan>Χριστοῦ</expan>
</choice>

Tachygraphy: The am Tag stands for abbreviation marker


<choice>
    <orig>
        <abbr type="tachygraphic">γ<am>ῆς</am></abbr>
    </orig>
    <reg>γῆς</reg>
</choice>

Suspension


<choice>
    <orig>
        <abbr type="suspension">ἀλεξαν<hi rend="superscript">δ<am>ρείας</am></hi></abbr>
    </orig>
    <reg>ἀλεξανδρείας</reg>
</choice>

Common abbreviations


<choice>
    <abbr type="common"><g ref="#abbreviation-1"/></abbr>
    <expan>καὶ</expan>
</choice>

Compression


<choice>
    <abbr type="compression">Ὡρ<am>ι</am>γ<am>ένους</am></abbr>
    <expan>Ὡριγένους</expan>
</choice>

Compression and suspension


<choice>
    <orig>
	    <abbr type="compression-suspension">Εὐσ<am>ε</am><hi rend="superscript">β<am>ίου</am></hi></abbr>
    </orig>
    <reg>Εὐσεβίου</reg>
</choice>

Compression and tachygraphy


<choice>
    <orig>
        <abbr type="compression-tachygraphic">κ<am>α</am><am>τὰ</am></abbr>
    </orig>
    <reg>κατὰ</reg>
</choice>

To sum up, the possible values for the type attribute on abbr are:

siglum - classifies abbreviation as siglum
nomSac - classifies an abbreviation as nomen sacrum
ligature - classifies an abbreviation as ligature
tachygraphic - classifies an abbreviation as tachygraphic
suspension - classifies an abbreviation as suspension
bibleversion - for abbreviations of translators in the hexapla
common - for common abbreviations like καὶ
compression - classifies an abbreviation as compression
compression-suspension - combination of compression and suspension
compression-tachygraphic - classifies an abbreviation as compression and tachygraphic

Hints

For easier understanding and work the values of the xml:id attributes should follow this rules:

Divisions, notes, anonymous blocks are named without further qualification: vat-gr-1422-1-1
Quotes of psalmtexts contain the abbreviation ps after the manuscript identifier. This is also true for subsections of psalmverses, i.e. anchors: vat-gr-1422-ps-1-1a
Quotes of patristic authors should be identified with quot in the name: vat-gr-1422-quot-1-1
Quotes of bibletexts other than psalms have an identifier with quot-bibl in it: vat-gr-1422-quot-bibl-1-1
Commentaryfragments contain the abbreviation fr after the abbreviation for the manuscript: vat-gr-1422-fr-1-1
The first number is the number of the psalms. The second number is a running count.

The flow of work should go from outside to inside: divisions then anonoymous blocks then segments and quotes with anchors. In the next step the markup of the microlevel elements follows.

Description of the TEI-Encoding for the Psalmcatenae Project

Table of Contents

Header

Defining Glyphs

Notes

Defining the Layout

Notes

List of Authors

Notes

Macrostructure

Divisions

Notes

Notes

Notes

Anonymous Blocks

Notes

Segments

Notes

Quotes

Notes

Anchors

Notes

Examples

Commentaryfragments

Hexaplaric Variants

Glosses

Microstructure

Page Breaks

Notes

Line Breaks

Notes

Ekthesis

Uncertain Readability

Gaps

Regularization

Abbreviations

Hints