WWP Tutorial curriculum

The primers listed below have been adapted from the slides and lecture notes developed for the Women Writers Project’s seminar and workshop series, with generous funding from the National Endowment for the Humanities. The primers group tutorials thematically based on particular needs for teachers and learners of TEI. You can also design an alternative course through the tutorials by visiting the page collecting all the tutorials.

Set-up for Tutorials

Before you begin, see our tutorial set-up page. This provides instructions on working in oXygen XML Editor, downloading the files for hands-on exercises, and using the tutorials.

TEI Primer

This primer contains tutorials that focus on building a knowledge of the TEI from the very basics to more advanced markup concepts. We recommend starting here if you are new to the TEI. The primer begins with a preliminary explanation of the mechanics of XML. Following this introduction, we cover the reasons one might want to use XML—or, more specifically, TEI encoding. Moving from the conceptual realm, the tutorials cover how to mark up basic structural and phrase-level textual features using the TEI as well as more advanced encodings, such as marking rendition, images, notes, and handwritten additions. This primer also contains tutorials that provide overviews of metadata and TEI customization.

This tutorial is great for those learning TEI for the first time. If you are considering using TEI on your project, begin here.

Get started

Manuscripts and the TEI Primer

This primer covers the basics of the TEI, with a specific focus on manuscript encoding. It is a parallel track to the TEI primer. The primer begins with a preliminary explanation of the mechanics of XML. Following this introduction, we cover the reasons one might want to use XML—or, more specifically, TEI encoding. Moving from the conceptual realm, the tutorials cover how to mark up basic structural and phrase-level textual features using the TEI as well as more advanced encodings, such as marking up the zones and surfaces of manuscripts and describing handwriting features. This primer also contains tutorials that provide overviews of metadata and customization of the TEI.

This tutorial is great for those learning TEI for the first time. If you are considering using TEI to mark up manuscripts and other handwritten materials, this is a good place to start.

Get started

Contextual Encoding Primer

This primer outlines the encoding of metadata and other contextual information about texts. The tutorials within this section discuss: metadata categories provided in the TEI header, as well as other mechanisms for creating metadata that the TEI does not provide; “ographies,” which are the TEI’s mechanisms for encoding structured information about people, places, organizations, and other entities; and further interpretive categories and classifications that you can define for your texts.

The tutorials in this section are designed for those who have already completed either the TEI Primer or the Manuscripts and the TEI Primer (or for those who already have a background in XML and TEI).

Get started

Transformation and Publication Primer

This primer defines and describe the methods for publishing TEI documents. It first offers an overview of the different publication systems and platforms that a given TEI project might use and then explains which platforms are most realistic for projects of various scopes. The majority of the tutorials in this primer are devoted to XSLT (eXtensible Stylesheet Language Transformations), which allows you to convert TEI into other XML languages. In particular, the tutorials focus on transforming XML into HTML, which is the easiest language for publishing documents online. Other mechanisms for simple web publication, like TEI Boilerplate and CSS, are also covered.

This section is intended for those who already have a strong understanding of TEI and XML. These tutorials are designed for those who have completed either the TEI Primer or the Manuscripts and the TEI Primer (or who already have a substantial background in TEI). If you are interested in transforming your XML documents for publication on the web, this is a good place to start.

Get started

TEI Customization Primer

This primer discusses customizing the TEI for the needs of a specific project. The TEI has extensive guidelines for marking up texts, but you may find that it does not offer everything you need. Additionally, you may find that some of the TEI’s features are unnecessary for your project. These tutorials cover how to constrain and expand upon the TEI, using ODD (or “One Document Does it all”) customization. Topics covered in these tutorials include: the constraint of elements, attributes, and attribute values; the addition of new elements and attributes; customized schema documentation; and best practices for project customization.

This primer is designed for people who are somewhat familiar with XML and the TEI guidelines, or for those who have already completed either the TEI Primer or the Manuscripts and the TEI Primer.

Get started