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 different 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 substantial understanding of TEI and XML. These tutorials are designed for those who have already completed either the TEI Primer or the Manuscripts and the TEI Primer (or who already have a background in TEI).

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.

Publication Overview

This tutorial provides an overview of XML publication platforms and outlines the basic framework for the rest of the tutorials in the Transformation and Publication primer. Covered here is why one might want to publish TEI data, and how one might go about publishing it.

Get started

XSLT Intro

This tutorial discusses how to begin an XSLT stylesheet and some basic transformations one can perform with XSLT. This tutorial provides important conceptual information about how an XSLT stylesheet processes information, which is necessary in understanding how to structure a stylesheet.

Get started

XSLT Debugger

This tutorial is meant to introduce the XSLT debugger view in Oxygen. It is a supplement to the XSLT Introduction tutorial that discusses the mechanics of using XSL files to transform XML files into plain text, and into XHTML. This tutorial is important for using the example files in this and other XSLT tutorials.

Get started

XSLT Processing

This tutorial continues the discussion of how XSLT stylesheets process their input information to create a new output. It also describes namespaces and languages, which are important to keep in mind when transforming from one XML language into another.

Get started

XPath Intro

This slide set builds on the previous XSLT tutorials by discussing XPath, which is a way of navigating an XML tree. It is particularly important for XSLT and publication because it allows the selection of specific elements depending on their context. For example, you may want to render “quote” differently when it comes up in “epigraph” than when it occurs in “p.” XPath allows you to specify context for a given element, which makes your transformations more nuanced.

Get started

Conditionals

This tutorial, continuing in the set of materials focused on XSLT, outlines how to set up conditional statements for your transformations. Using examples, this tutorial explains the two conditional branching structures available in XSL: “if” and “choose.” For an additional branching structure using XPath, see: XPath if-then-else.

Get started

XPath if-then-else

This tutorial is designed as a supplement to the XSL Conditionals tutorial, which covers two conditional branching structures in detail, but does not cover XPath if-then-else. XPath if-then-else is explained in this tutorial on slide 4. An example of a possible solution to an XSLT task using XPath if-then-else is given on slide 5.

Get started

XTF and TEI Boilerplate

This tutorial contains a broad overview of two different publication tools. TEI Boilerplate allows you to easily publish simple versions of your encoded texts online. XTF (or the eXtensible Text Framework) is much more complex than TEIBP, but it is useful for indexing TEI data to make it more searchable and accessible. This tutorial provides conceptual understandings of the two frameworks and resources for more information.

Get started

What next?

If you have finished this primer, you might be wondering where to go next. After completing this primer, we assume that you have a working knowledge of advanced markup concepts and might be interested in customizing the TEI for the particular needs of your project (see description below). You might also be interested in choosing particular tutorials based on the specific needs of your project. You can also return to the Tutorial Curriculum Page for full descriptions of all the primers.

  • TEI Customization Primer: this primer discusses customizing the TEI for the needs of a specific project.
  • View All Tutorials: Each tutorial is listed here with a description. The primers are meant as suggested paths through the available tutorials, but they can also be accessed individually to design alternative curricula.