TEI Documentation

Note that, as is mentioned in Section 2.2.3 below, these @rend attributes can be used within <name> elements to refer to decoration that persists across an occurrence of a name.

Decoration Type (@rend Value)	Example Image	Example Code
“init_lombard”		<hi rend="init_lombard"> <hi rend="rubr">M</hi> </hi> aria Here, we have two embedded <hi> tags. The first indicates that the initial letter is a Lombardic capital. The second is used to indicate a further type of decoration, because this letter in the source manuscript is red (rubricated), though this is not evident from the scan.
“rubr”		<hi rend="rubr">H</hi>oc
“underline”		<hi rend="underline">engelen</hi>
“decor”		<hi rend="decor">J</hi>herusalem
“rubr_underline”		<hi rend="rubr_underline">hÿmelscher</hi>

2.2.3 Proper Names

All proper names found in each witness are tagged with the <name> element. Using these <name> elements allows for standardized reference to and disambiguation between proper names like Mary Magdalene and the Virgin Mary in the XML code, though these references are not visible in the online text edition.

Every <name> contains at least the @type and the @nymRef attribute; the @role, @subtype, and @rend attributes are also used where relevant. These attributes have the following functions.

• @type declares the type of entity indicated by the name. Values used in this edition are “person”, “org” and “place”.
• @subtype further specifies the entity indicated by the name beyond the characterization given by @type.
• @nymRef points to the canonical form of the name in question.  This tag serves as a standardized reference that links all occurrences of a particular individual or group’s name across the different manuscript witnesses.  However, it should be noted that these @nymRef tags are not visibly represented in the online text editions and can only be accessed from the XML files themselves.
• @role further specifies the entity indicated by the name beyond the form denoted in @nymRef.
• @rend characterizes special visual features of the name in question. The possible values are the ones indicated in Section 2.2.2.

If a name is split across two lines, the <lb/> tag is contained between the opening <name> and closing </name> tags.

Below is a list of all proper names tagged with <name>. (Click the arrow buttons at the bottom of the table to view more.)

In the code, these attributes all appear within the name tag, with all non-empty attribute values occurring in quotation marks and with those attributes listed left-to-right in accordance with the table.

<name type="person" nymRef="Mary_Magdalene">
    <choice>
        <orig>m</orig>
        <reg resp="editor" type="capit">M</reg>
    </choice>
    aria
</name>

<name type="person" role="emperor" nymRef="Tiberius">
    <choice>
        <orig>t</orig>
        <reg resp="editor" type="capit">T</reg>
    </choice>
    yberius
</name>

2.2.4 Punctuation

All punctuation, either original or supplied, is tagged with the <pc> element. Between manuscript and edition, four punctuation scenarios are possible:

1. Punctuation occurs in the witness, and the editor accepts that punctuation into the edition. In this case, the <pc> element contains a @source attribute with the value “manuscript”.
2. No punctuation occurs in the witness, and the editor supplies the punctuation. In this case, the <pc> element contains a @resp attribute with the value “editor”.
3. Punctuation occurs in the witness, but the editor emends the punctuation. In this case, the <pc> element contains a <choice></choice> element which itself contains the original punctuation tagged with the <orig> element and the editor’s emended punctuation tagged with the <reg> element; the reg element contains a @resp attribute with the value “editor” as well as a @type attribute with the value “punct”.
4. Punctuation occurs in the witness, but the editor does not accept it into the edition. In this case, the <pc> element contains a <choice> element which itself contains the original punctuation tagged with the <orig> element and an empty <reg> element; the reg element contains a @resp attribute with the value “editor” as well as a @type attribute with the value “punct”.

libro
<pc source="manuscript">,</pc>
 de

sorores
<pc resp="editor">,</pc>
 scilicet

religiosam
<pc>
    <choice>
        <orig>:</orig>
        <reg resp="editor" type="punct">,</reg>
    </choice>
</pc>
 sed

filium
<pc>
    <choice>
        <orig>.</orig>
        <reg resp="editor" type="punct"></reg>
    </choice>
</pc>
 et

Note that no space is used between the word preceding the punctuation and the <pc> element, though a space is used between the </pc> tag and the following word.

In the Latin text editions, the punctus elevatus is represented using the Unicode symbol “modifier letter high end tone” (decimal 762, hexadecimal 02FA). With this exception, all other punctuation is represented using modernized punctuation marks. That is to say, for instance, that the modern question mark “?” is used when a punctus interrogativus occurs in the manuscript.

2.2.5 Metamarks

Two special kinds of metamarks appear in the manuscripts: line fillers and hyphens used for syllabification and words spanning line breaks. Both are tagged with the <metamark> element. Each <metamark> element contains the @type, @function, and @source attributes. For line fillers, the value of @function is “line_filler”, for syllabification, the value for @function is “word_division”. For line fillers, the value of @type may vary in accordance to the specific rendition of the line filler; for syllabification, the value for @type is “hyphen” or “double_hyphen”. The value for @source is “manuscript”.

gebor
<metamark type="hyphen" source="manuscript" function="word_division">
    -
</metamark>

byd
<add place="rmargin">
    <metamark type="double_hyphen" source="manuscript" function="word_division">
        =
    </metamark>
</add>

2.2.6 Uncertain Readings

To represent uncertain readings of the original, the element <unclear> is used, containing the most likely reading. The reason for the uncertainty may be expressed with the @reason attribute. Possible values may include “illegible”, “rubbing” etc. The degree of certitude may be expressed with the @cert attribute which may carry the values “low”, “medium”, and “high”.  Because it reflects an instance in which the editor must supply a reading, the entire <unclear> element is embedded within a <supplied> element.

The <unclear> element only surrounds the portion of the text for which the reading is uncertain.  If, for instance, the last two letters of a word are unclear but the first five are unambiguously readable, the <unclear> tag should only contain the last two letters.

<supplied>
    <unclear reason="illegible" cert="medium">
        Z
    </unclear>
</supplied>
en

2.2.7 Modifications of the Text

Any modification of the text in a witness is tagged as a specific element in each TEI document. Such modifications include both those that are found in the witness itself, be it through a third party, damage, etc., and those that are based on editorial choices.

2.2.7.1 Original

The following instances of scribal corrections in the witness itself have been encountered in the course of this project and are tagged accordingly.

• rend=”rubr_strikethrough”
• rend=”strikethrough”
• rend=”adapted”

2.2.7.1.2 Additions

Additions in the original by a scribal hand are tagged with the <add> element. Each <add> element contains a @place attribute, indicating the specific placement of the deletion. Possible values are:

• place=”above”
• place=”below”
• place=”lmargin”
• place=”rmargin”
• place=”interlinear”

2.2.7.1.3 Hand

In the case that several hands con be identified, the <add> element may also include a @hand attribute, identifying the hand responsible for the addition.

2.2.7.2 Editor

Each TEI document reflects a number of editorial interventions that were deemed necessary by the respective editor in the course of transcribing and encoding the respective witness.  These various editorial interventions, including emendations and supplied omissions, are detailed below.

2.2.7.2.1 Editorial Emendations

Systematic emendations are tagged with the <reg> element. The original reading is tagged with <orig>. Both are embedded in a <choice> element. Each <reg> element contains a @type attribute, indicating the specific type of emendation, and a @resp attribute with the value “editor”. The most common instance of this is normalization of capitalization; the @type attribute then has the value “capit”.

<choice>
    <orig>l</orig>
    <reg type="capit" resp="editor">L</reg>
</choice>
azarus

<choice>
    <abbr>
        <choice>
            <orig>m</orig>
            <reg resp="editor" type="capit">M</reg>
        <choice>
        arth
        <am>a&#x304;<am>
    </abbr>
    <expan>
        <choice>
            <orig>m</orig>
            <reg resp="editor" type="capit">M</reg>
        <choice>
        arth
        <ex>am<am>
    </abbr>
</choice>

2.2.7.2.2 Corrections

We have begun to tag non-systematic corrections using the <corr> element. This editorial intervention is still in progress and at this point only occurs in some vernacular text editions. These non-systematic corrections include, for instance, misspelled names (e.g. enttkaria rather than Euckaria) and misused names (e.g. Maria in a place where clearly Martha is meant to be referenced); they are non-systematic insofar as they cannot be predicted from a word’s status as, say, a proper noun or sentence-initial word.  The original reading is tagged with <orig>, and both <corr> and <orig> are embedded within a <choice> element. A <corr> element may optionally contain a @type attribute that indicates the reason for the correction.

If the correction is merely based on a non-standard spelling in the original, the <sic> element is used instead of <orig>.

<choice>
    <sic>Marthi</sic>
    <corr>Martha</corr>
</choice>

2.2.7.2.3 Supplied Omissions

If the editor identifies an obvious (erroneous) omission of text, the corresponding text is supplied using the <supplied> element.  This element contains a @resp attribute with the value “editor” and a @source element that clarifies the source of where the supplied text comes from.  If the supplied text comes from other witnesses the value of @source indicates the shorthand labels of those witnesses.  In the case of multiple source witnesses, the abbreviated labels are separated by spaces in the value of @source.

As in previous cases, the <supplied> element is embedded in a <choice> element.  An <orig> element is also used, but as the text in this case is omitted in the witness, this <orig> will be empty.

das 
<choice>
    <orig></orig>
    <corr>
        <supplied resp="editor" source="B1">
            yr
        </supplied>
    </corr>
</choice>
 duchte

3 Comparisons and Collation

As a portion of this project, we have begun to encode into the manuscript files a dynamic collation aspect that resembles in spirit a critical apparatus but, as with much of our editions, leverages the power of the digital medium in letting us offer comparisons and connections even across texts in different languages or which contain separate additions and portions. The encoding of this portion of the project is currently in its initial stages; therefore, we give only a basic outline of the tagging conventions here. The collation embeds information connecting and comparing the manuscript witnesses. For this reason, these tags only appear in the XML files where applicable.

We are also currently introducing into the text editions a <note> function. This enables the encoding of notes pertaining to the critical comparison of witnesses, translator’s notes, and editorial explanation. This function is still very much in development, and we will offer details of its encoding in future versions of this documentation.

3.1 Variants

A critical apparatus tag has the following basic structure:

<app>
    <rdg wit=”#ms id”>reading from other ms</rdg>
</app>

Each <rdg> element contains exactly one reading from another witness, with @wit pointing to its respective ID. Additionally, the <app> element may contain a <note> element providing additional comments by the editor.

3.2 Missing in other witnesses

In a typical <app> element, the <rdg> element indicates a reading that exists in a different manuscript and differs from the current manuscript under discussion. However, it is entirely possible that a different manuscript might entirely lack a passage that the current manuscript contains. In this case, the <app> element in the current manuscript cannot contain the other manuscript’s reading of this passage (since the other manuscript lacks the passage altogether). This holds also true on the level of TEI syntax, because the <rdg> element should not be empty. In this case, a <note> element is embedded within the relevant <app> element stating that text is missing.

3.3 Associating the Critical Apparatus to the Text

In order to give a precise location reference for a critical apparatus entry within a text, different methods may be used. In the case of a single word reference, the <app> element is placed around it. The word in question is then tagged with the <lem> element. The <rdg> elements follow after the <lem> element.

<app>
    <lem>this</lem>
    <rdg wit="#X">that</rdg>
</app>
 word

Alternatively, the range of an <app> element may be defined using the attributes @from and @to. If an apparatus entry concerns a single word, only the @from attribute is used, since it automatically only extends to the one entity pointed at within it. If an apparatus entry concerns a (uninterrupted) sequence of words, both @from and @to are used.

Both attributes @from and @to fetch unique xml IDs that have to be defined for that purpose. Typically, these IDs are defined within a <w> element which is used to tag single words. The IDs follow the established logic already mentioned above: manuscript number_folio number_column number_line number_word number.

<w xml:id="S_350r_a_14_05”>word5</w>
word6
word7
<w xml:id="S_350r_a_14_08">word8</w>
<app from="#S_350r_a_14_05" to="#S_350r_a_14_08">
    <rdg wit="X">wordy wordz</rdg>
</app>

As we further develop this portion of the project, we hope that it will provide a powerful way to relate the various text witnesses to each other.