Exercise 0

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