Syllabus – Fall 2022
Digital Editions: Start to Finish
Registration opens September 1, 2022! Please visit our online store to register.
Live class sessions will meet every Friday from September 30, 2022 to December 9, 2022 from 10:00 AM to 12:00 PM CST (video recordings of each class will be posted for participants who are unable to meet live).
Meeting dates and/or times may be subject to change. Changes, if necessary, will be emailed to registrants and updated on the syllabus.
See Course Description, Meeting Details, and Registration for more information.
| Week | Date | Topic | Additional Readings/Guides |
|---|---|---|---|
| 1 | September 30 | TEI: Introduction: Today we will introduce the class to the Text Encoding Initiative Consortium and the code recommendations and schemas that it has developed—in shorthand, TEI. We will describe what it is, why digital editors should use it, and the processes to be learned during this webinar that will make TEI-encoded documents viewable on the web. Everyone will learn how to install and use oXygen, the best TEI editor available at https://www.oxygenxml.com/. | Introductory lecture based upon the following readings: Charlotte Roueché, “Why Do We Mark Up Texts?” and David Birnbaum, “What is XML and Why Should Humanists Use It?” Students may wish to review “Introduction” (Tutorial), available at the TEI by Example website: https://teibyexample.org |
| 2 | October 7 | TEI Encoding: Essays, Fiction, Letters: Today we will learn how to encode in TEI simple essays, stories, novels, and letters. | Instructions based upon the following readings from the TEI Guidelines available at the Text Encoding Initiative Consortium website: https://tei-c.org: Ch. 3: Elements Available in all TEI Documents, focusing on sections 3.0-3.3, 3.6- 3.9, and 3.11-12. Ch. 4: Default Text Structure, focusing on sections 4.0-4.1.3 and 4.2.0-4.2.3 |
| 3 | October 14 | TEI Encoding: Frontmatter, Drama, Poetry: Today we will learn how to encode in TEI plays and poems as well as title pages, prefaces, prologues, epilogues, etc. | Instructions based upon the following readings from the TEI Guidelines: Ch. 3: Elements Available in all TEI Documents, focusing on 3.13 Ch. 4: Default Text Structure, focusing on 4.5- 4.7 Ch. 6: Verse, focusing on 6.0-6.1 |
| 4 | October 21 | TEI Header: Today, we will make available the Digital Editions, Start to Finish Website. Everyone will learn about the TEI Header metadata categories and publishing information, and then learn how to use the form available on the DE website to create a TEI Header for their projects. | Instructions based upon the following readings from the TEI Guidelines: Ch. 2: The TEI Header, focusing on 2.0-2.7 |
| 5 | October 28 | Online Publishing and HTML: (Online Publishing) We will learn how to structure Digital Edition Files for the smoothest transition from desktop to server space that allows for public viewing of encoded documents. We will discuss online publishing options and provide examples. (HTML) We will learn about Hypertext Markup Language 5 and will learn the HTML code for building a splash page. | Instructions based upon HTML and CSS QuickStart Guide, David DuRocher, and HTML and CSS: Design and Build Websites, Jon Duckett |
| 6 | November 4 | HTML and CSS: Now we will learn how to make a splash page beautiful with Cascading Style Sheets or css! We will also learn the basic HTML structure of documents and then how to modify their appearance with css. | Instructions based upon the books above and the W3C Schools (https://www.w3schools.com/): HTML 5 and CSS Tutorial |
| 7 | November 11 | XSLT to HTML: Introduction to Extensible Stylesheet Language Transformations or XSLT and how it produces HTML using the XSLT programs built into oXygen and then learning how to run a basic XSLT available on the DE website. We will learn some of the basic principles of XSLT by making changes to the basic XSLT. | Participants will be introduced to the XSLT and CSS files available on the Digital Editions website, an XSLT-css set for complex documents and an XSLT-css set that is very basic for illustrating the basic principles concerning how XSLT generates HTML that makes use of specific css files. |
| 8 | November 18 | XSLT to HTML: Today we will learn how to use the complicated XSLT on the DE website. We will begin with an introduction to XPath, the XML Path Language used in XSLT programming. We will also learn about params (setting parameters allows you to customize the HTML documents you publish) and running multiple files at a time using XSLT, useful for digital editions that contain multiple XML documents. | We will walk through — read together — the XSLT/css documents on the Digital Editions website. Instructions in XPath will be based upon two essays by David Birnbaum, “What Can XPath Do for Me?” and “The XPath Functions We Use Most.” |
| Thanksgiving Break | — | — | — |
| 9 | December 2 | XQuery: Today we will introduce XQuery, the XML Query Language that enables deep exploration of TEI-encoded data, and then everyone will learn how to write regex (Regular Expressions) and flwor expressions (pronounced “flower,” it is an acronym for “For, Let, Where, Order by, Return.” | Instructions can be reinforced and supplemented by XQuery for Humanists, Clifford Anderson and Joseph Wicentowski |
| 10 | December 9 | XQuery: Today everyone will focus on XQuery for document and corpora analysis. We will discuss when to use XQuery and when XSLT. And finally, we will discuss the paths forward for continuing to develop your own digital edition. | Instructions can be reinforced and supplemented by XQuery for Humanists, Clifford Anderson and Joseph Wicentowski |