TrainingMaterialsFall2021

Before meeting

Read:

• Julia Flanders, Syd Bauman, and Sarah Connell “Text Encoding Fundamentals with TEI” (Sarah will email to you)

• Sample Text

Optional readings:

• Statement of Editorial Principles

• Even Gentler Intro to XML

October 6 1:30–3pm or October 8 12–1:30pm

Topics

• Intro to the WWP
• Logistics and training process notes
  • Make sure to attend one instance of each session
  • There are office hours you can attend if you have questions or if you need to miss a session
• Why are we here and what are we doing?
  • Training will start with some foundational concepts of encoding, then move on to the specifics of how the WWP approaches things
  • Some of this might feel abstract at first, but the end goal is that everyone will know how to take early women's documents and create digital models of them with XML and the Text Encoding Initiative markup language
  • To do that, you first need to understand what XML is!
• Intro to XML
  • XML Intro Tutorial with notes

Session 2: October 8 3:30–5pm or October 13 2–3:30pm

Topics

• Questions?
• Additional discussion on XML validity
• Sample letter to encode and another
• The schema URL
• Basics of Using Oxygen See also Oxygen Cheat Sheet
  • Clearing your working space
  • Opening a new TEI file
  • Inserting tags
  • Inserting attributes
  • Surrounding text with tags
  • Checking validity and well-formedness
  • Adding comments
  • Letting Oxygen help you work!
  • Setting up for homework
    • Getting the textbase
    • Opening the letter files and associating the schema
• Basics of Prose Markup part one
  • [Tutorial version https://wwp.northeastern.edu/outreach/seminars/_current/presentations/basic_encoding/basic_encoding_tutorial_00.xhtml]

Homework

• Before our next session, please make sure that you have downloaded Oxygen, following the instructions and using the key from Sarah's email
• Practice encoding with the samples:
  • letter one
  • letter two
  • The schema URL
• To create a new “letter” XML document (in order to start the above homework):
  • In oXygen, start the process to create a new XML document:
  • ⌘-N (or CTL-N on Windows or Linux)
    • Select (but do not double-click on) “XML Document” — typing “xml” in the filter box usually makes this pretty easy to find
    • Do NOT double click on it, click on the “Create” button, or press ENTER (which is the same); rather …
    • Click the “Customize” button (which is on the bottom row)
    • The “New” dialog box will change dramatically; don’t panic
    • The first field you can fill in is the “Schema URL” field.
    • Copy the URL that points to the schema (in this case it should end in “.rnc”), and paste it into the “Schema URL” field.
    • The “Root Element” field should now say “letter”.
    • Now go ahead and click the “Create” button

Session 3: Sept 22 10–11:30 or 1–2:30

Topics

• Document Analysis
• Using the Internal Documentation
• Basics of Prose Markup continued

Hands-on Practice

• Letters

• Exercise 0, download document

Session 4: Sept 25 9–10:30 or 1:30–3

Topics

• Questions about the exercise?
• Common Markup
  • Persons, Places, &c.
    • <persName>
    • <placeName>
    • <name>
    • <orgName>
    • <rs>

• Quotations & Direct Speech
  • <quote>
  • <said>

Hands-on Practice

• Exercise 2

Homework

• Review the materials in Getting started with encoding

Session 5: Sept 29 10–11:30 or 1–2:30

Topics

• Questions about the exercise?

• Scheduling another session

• Text selection from the Aquifer (Green texts are priorities, yellow are also possible, put your name next to a text to claim it, look up EEBO and ECCO texts by starting at the library's list of databases)

• Special Characters
  • Unicode Quick Guide
  • Typography & Special Characters
  • Hard and Soft Hyphens

• Drama
  • <sp>
  • <stage>
  • <castList>

• Poetry
  • <lg>
  • Encoding Verse

• Page Breaks & Metawork
  • Page Numbers
  • <milestone>
  • <pb>
  • Metawork
  • Boundaries Between Elements

• Rendition, part 1
  • Rendition Ladders
  • Outline of Keywords & Arguments

Homework

• Exercise 5: Add rendition to previous exercises (if you want to; you could also wait until after the Friday session)

Session 6: Oct 2 9–10:30 or 1:30–3

Topics

• Rendition, part 2
  • Elements for marking changes in rendition
    • <emph>
    • <hi>
    • <mcr>
  • Rendition Ladders
  • Outline of Keywords & Arguments
  • Delimiters
  • To see a template for setting up renditional defaults, open tagsDecl.xml in under_construction

• Linking & Referencing
  • Identifiers
  • Overlap in Direct Speech

• Notes
  • <note>

Session 7: Oct 6 10–11:30 or 1–2:30

• Questions and follow-up on anything

• Quick note on default break behavior and linking dialogue; note also that we are updating the documentation on renditional defaults, so for now you should follow what is in the template

• Supplied, Missing, & Unclear Text
  • • <supplied>
    • <gap>
    • <unclear>

• Corrections
  • <sic>

• Subversion
  • Version Control and Using Subversion
  • There is also an outline of the basic processes for using Subversion in encoding in Getting started with encoding

• Workflow
  • Trello
  • Change Logs
  • Listserv
  • Wiki
  • Office Texts

Follow up

Exercises

• For more practice: Exercise 3 and Exercise 4Exercise 1: Poetry

Further reading

• • WWP Training Guide
  • Training Start Page

Text Selection

• Choose your first text for encoding and claim it in the aquifer