Exercise0

From Digital Scholarship Group
Jump to navigation Jump to search

This first exercise is just to get comfortable with inserting TEI elements. Use the printed letter handout.

1. In the Oxygen XML editor, navigate to the textbase/training directory and open the training_template.xml file.

2. Save a copy (using "Save as...") under a different name, using your surname (e.g. smith.training.xml) so that we know whose file it is.

3. Validate the file (using the red check-mark icon, or type Command-shift-v). You should get two error messages, both referring to information that is missing from the <change> element. Fill in the date and your name key if you have one; now your file should be valid. (If you don't have a name key yet, don't worry about it.)

4. Inside the <body> element, you're going to encode the letter from the sample text. The TEI elements you're going to need are:

<div>: a division of the text, used to represent whatever kinds of major structural pieces (poems, letters, essays, chapters, etc.) the text is divided into. The @type attribute is required and it indicates what type of division is being represented, using a controlled vocabulary. You can look up the permitted values in the WWP documentation.
<p>: a prose paragraph
<lb>: a line break; this is an empty element, so you'll encode it as <lb/> (a start-tag and end-tag all in one). A line break marks the beginning of any new line that isn't at the beginning of a new element.
<head>: any kind of heading
<persName>: for names of persons
<name>: for names of non-persons, groups of people (e.g. the Greeks), and things.
<emph>: for words that are emphasized to give them rhetorical weight
<hi>: for words that are highlighted for purely decorative reasons (e.g. because they are the first word of the text)
<pb>: for page breaks. The @n attribute indicates what page begins at this break.
<said>: for direct speech and dialogue
<closer>: for groupings of information that come at the end of a division (especially in the case of letters): the "sincerely yours" and associated information
<salute>: for the salutation ("sincerely yours", "dear sir") in a letter
<signed>: for the name signed at the bottom of a letter or other signed textual structure