WWP Book
Women Writers Project: blockimage Women Writers Online blockimage About blockimage Texts blockimage Encoding blockimage Site Index blockimage Contact

block Training Guide

The following instructions describe the steps involved in encoding your first text from scratch. They focus on the easy parts first and work up to the more difficult parts, and they also try to make it easy to maintain a valid file at all times. Once you become more familiar with the encoding process, you may decide to do things in a different order, depending on the text you're working on.

Encode the basic outline of your text

First, try representing the overall structure of your document using just the largest structural elements: <front>, <body>, <back>, and <div>. Think carefully about what parts are nested inside each other; this may be difficult to determine, particularly in older texts. Include the headings (with <head>) so that you can keep track of what each part is, and use the type= attribute on <div> to identify the kinds of divisions you're encoding.

Validate and fix errors

Transcribe the first section

If the section is in prose:
  • encode the paragraphs with <p>
  • encode any headings with <head>
If the section is in verse:
  • encode each poem with <lg>
  • encode each line of the poem with <l>
  • encode the poem titles with <head>

Add phrase-level markup

Transcribe the title page

Run supraXML validation and fix errors

brownlogo