S532: Week 2

Catapult/Scholar’s Commons TEI Workshop II

John Walsh, Department of Information and Library Science, School of Informatics and Computing

Michelle Dalmau, Digital Collection Services, IU Libraries

`<teiHeader>`

File Description <fileDesc> includes Source Description <sourceDesc>
- Bibliographic description of the electronic and source files
Encoding Description <encodingDesc>
- Documents relationship between the electronic texts and the source(s) from which it is derived
Profile Description <profileDesc>
- Documents non-bibliographic aspects of the text such as languages, names, etc.
Revision Description <revisionDesc>
- Documents changes made to the file (usually by editors)

`<teiHeader>` Examples

teiHeader Required Elements

teiHeader required elements

teiHeader Template for Victorian Women Writers Project
teiHeader for Victorian Women Writers Project text: Broughton’s Red as a Rose is She. 1887.

additions and deletions (`<add>` and `<del>`)

<add>added text</add>
<del>deleted text</del>

A simple deletion and addition

Swinburnes “Rondel.” Special Collections Research Center. Syracuse University. — Swinburne’s “Rondel.” Special Collections Research Center. Syracuse University.

A simple deletion and addition

Swinburnes “A Rondel.” Special Collections Research Center. Syracuse University. — Swinburne’s “A Rondel.” Special Collections Research Center. Syracuse University.

A simple deletion and addition

Code example, a simple deletion and addition

Code example, lines from Swinburnes “A Rondel” — Code example, lines from Swinburne’s “A Rondel”

`<add>` details

@place
@resp
@hand
@seq

Other transcription elements: `<gap>`

Other transcription elements: `<supplied>`

Other transcription elements: `<damage>`

Code example: <damage> — Code example: `<damage>`

Other transcription elements: `<unclear>`

“choices”: `<choice>` and related elements

original (<orig>) and regularized (<reg>) text.

The title page of the 1598 edition of Loves Labours Lost — The title page of the 1598 edition of *Love’s Labour’s Lost*

Code example: `<choice>`, `<orig>`, `<reg>`

“choices”: `<choice>` and related elements

abbreviated (<abbr>) and expanded (<expan>) text.

Code example: `<choice>`, `<abbr>`, `<expan>`

Code example: `<choice>`, `<sic>`, `<corr>`

names and dates: `<persName>`

Code examples: <persName> — Code examples: `<persName>`

names and dates: `placeName` & `<geogName>`

names and dates: `<orgName>`

`<name>`

<name> is a general-purpose name element. <name type="person"> is equivalent to <persName>, <name type="place"> is equivalent to <placeName>, etc. <name> also allows other possibilities, e.g.:
```
<name type="event">Siege of <placeName>Constantinople</placeName> (<date>1422</date>)</name>
```

Notes: `<note>`

TEI’s <note> element is a general purpose element for notes, footnotes, endnotes, inline notes, marginalia, etc.
The @resp attribute allows one to specify the agent responsible for the note.
The @type attribute allows one to categorize the note in some way.
The @place attribute allows one to identify the placement of the note in the source document, e.g., place="end", place="margin".

Notes: `<note>`

linking: `<ref>` and `<ptr>`

HTML links

<a href="http://tei-c.org/">The TEI Consortium</a>  
<a href="http://tei-c.org/">http://tei-c.org/</a>

TEI links

<ref target="http://tei-c.org/">The TEI Consortium</ref>  
<ptr target="http://tei-c.org"/>

images: `<figure>`

Code example: `<figure>` (simple)

Code example: `<figure>`

Bibliographic Elements: `<bibl>` & `<biblStruct>`

<bibl> is for loosely structured bibliographic citations and useful for encoding bibliographic elements in transcriptions, where you want to retain the structure of the original source document.
<biblStruct> is a highly structured bibliographic citations and is useful in “metadata” situations, such as one finds in the <teiHeader>.

Bibliographic Elements: `<bibl>`

Code example: <bibl> — Code example: `<bibl>`

Bibliographic Elements: `<biblStruct>`

Code example: <biblStruct> — Code example: `<biblStruct>`

`<teiHeader>`

File Description <fileDesc> includes Source Description <sourceDesc>
- Bibliographic description of the electronic and source files
Encoding Description <encodingDesc>
- Documents relationship between the electronic texts and the source(s) from which it is derived
Profile Description <profileDesc>
- Documents non-bibliographic aspects of the text such as languages, names, etc.
Revision Description <revisionDesc>
- Documents changes made to the file (usually by editors)

`<rendition>`, `@rendition`, and `@style`

TEI has a sophisticated system for describing the visual appearance of a source document.
Since TEI P5, TEI has included support for CSS, which many people are familiar with from experience with basic HTML and CSS Web development.
One can use other style languages, or free prose, to describe visual and design phenomena that cannot be adequately described with CSS.

CSS Resources

CSS learning resources are available from a variety of sources:
- Instructor-led training from UITS (http://ittraining.iu.edu)
- Online, self-paced video training from Lynda.com (free access for IU-affiliated faculty, staff, and students from http://ittraining.iu.edu)
- Online, self-paced video training from Treehouse Learning (free access for Monroe County residents from Monroe County Public Library)
- Online, self-paced interactive training from http://www.codecademy.com (free)
CSS reference resources are also readily available. A couple examples:
- CSS Reference at the Mozilla Developer Network
- Cascading Style Sheets at the Internet Explorer Dev Center
- CSS Reference at http://w3schoools.com

Define styles with CSS in `<rendition>` elements in the `<teiHeader>`

Code example: declaring <rendition> styles with CSS — Code example: declaring `<rendition>` styles with CSS

In your document (i.e., in `<text>`), point to `<rendition>` styles with the `@rendition` attribute

Code example: pointing to <rendition> styles with @rendition — Code example: pointing to `<rendition>` styles with `@rendition`

Embed CSS code in the `@style` attribute

Code example: embedding CSS in TEIs @style attribute — Code example: embedding CSS in TEI’s `@style` attribute

Roma

Roma is a TEI schema generation tool, that allows TEI users to create XML schemas from a selection of TEI modules. Roma also allows customization of the TEI schema.

Catapult/Scholar’s Commons TEI Workshop II

<teiHeader>

<teiHeader> Examples

additions and deletions (<add> and <del>)

A simple deletion and addition

A simple deletion and addition

A simple deletion and addition

Code example, a simple deletion and addition

<add> details

Other transcription elements: <gap>

Other transcription elements: <supplied>

Other transcription elements: <damage>

Other transcription elements: <unclear>

“choices”: <choice> and related elements

Code example: <choice>, <orig>, <reg>

“choices”: <choice> and related elements

Code example: <choice>, <abbr>, <expan>

Code example: <choice>, <sic>, <corr>

names and dates: <persName>

names and dates: placeName & <geogName>

names and dates: <orgName>

<name>

Notes: <note>

Notes: <note>

linking: <ref> and <ptr>

HTML links

TEI links

images: <figure>

Code example: <figure> (simple)

Code example: <figure>

Bibliographic Elements: <bibl> & <biblStruct>

Bibliographic Elements: <bibl>

Bibliographic Elements: <bibl>

Bibliographic Elements: <biblStruct>

<teiHeader>

<rendition>, @rendition, and @style

CSS Resources

Define styles with CSS in <rendition> elements in the <teiHeader>

In your document (i.e., in <text>), point to <rendition> styles with the @rendition attribute

Embed CSS code in the @style attribute

Roma

`<teiHeader>`

`<teiHeader>` Examples

additions and deletions (`<add>` and `<del>`)

`<add>` details

Other transcription elements: `<gap>`

Other transcription elements: `<supplied>`

Other transcription elements: `<damage>`

Other transcription elements: `<unclear>`

“choices”: `<choice>` and related elements

Code example: `<choice>`, `<orig>`, `<reg>`

“choices”: `<choice>` and related elements

Code example: `<choice>`, `<abbr>`, `<expan>`

Code example: `<choice>`, `<sic>`, `<corr>`

names and dates: `<persName>`

names and dates: `placeName` & `<geogName>`

names and dates: `<orgName>`

`<name>`

Notes: `<note>`

Notes: `<note>`

linking: `<ref>` and `<ptr>`

images: `<figure>`

Code example: `<figure>` (simple)

Code example: `<figure>`

Bibliographic Elements: `<bibl>` & `<biblStruct>`

Bibliographic Elements: `<bibl>`

Bibliographic Elements: `<bibl>`

Bibliographic Elements: `<biblStruct>`

`<teiHeader>`

`<rendition>`, `@rendition`, and `@style`

Define styles with CSS in `<rendition>` elements in the `<teiHeader>`

In your document (i.e., in `<text>`), point to `<rendition>` styles with the `@rendition` attribute

Embed CSS code in the `@style` attribute