This repository contains data and assignments for our online workshop «Stay Home Learn TEI Publisher From Scratch». It is a 3-part online course taking place on the 8th, 15th, and 22nd of June, always at 4-5 pm (CEST). (Find your local time via these links: Session 1, Session 2, and Session 3.)
The online session will be lecture-like with room for questions. Afterwards attendants are encouraged to work through a list of weekly assignments. Usually the first assignment for each topic will be covered in the online session, but we recommend that participants carry out the assignment on their own too.
The online session will be hosted on jitsi. Please use the following URL to connect:
https://meet.jit.si/e-editiones-events
Should anything go wrong during the event, we will inform you via twitter and the slack channel mentioned below.
Participants are strongly encouraged to join the dedicated #workshop channel on the e-editiones slack for asking questions, but also to help others with the assignments. We hope to have a lively discussion there and would love to see participants support each other. Due to the large number of participants, we won't have enough tutors to answer every question.
You may also want to clone this repository or download its contents as a zip file. This way you can look at the example documents on your own machine. To clone or download, click the green Clone or Download button on the top right of the landing page of this repository.
A server will be provided for everyone to work on the exercises, so all you need is a decent web browser (Chrome, Firefox, and Safari work; the latest Edge on Windows works despite being slow; and IE definitely doesn't). The address of the server is:
http://apps5test.existsolutions.com/
Due to the large number of attendees the common server might become overloaded. We thus encourage more experienced users to either:
The basic steps are described in the TEI Publisher documentation. However, we would recommend to install the release candidate for TEI Publisher 6.
The release candidate is not available on eXist's public package repository yet, so you would need to download it manually:
- Download the
.xarfrom the github release page - If you installed an older version of TEI Publisher before, check if you are offered updates for
tei-publisher-lib. You need version 2.8.7 of this package. - Go to the eXist Dashboard/Package Manager, click on the Upload button, and select the downloaded
tei-publisher-6.0.0-RC1.xar
Using docker is a good alternative for the workshop, though it comes with a small performance penalty. The installation process is described in the docs.
Again we recommend to use the release candidate for TEI Publisher 6, so in the docker commands, replace existdb/teipublisher:latest with existdb/teipublisher:6.0.0-RC1.
- Week 1: Recording of the online session
- Week 1: Implementing the Assignments
- Week 2: Recording of the online session
- Week 2: Implementing the Assignments
- Week 3: Recording of the online session
- Week 3: Implementing the Assignments
Working with TEI Publisher requires some knowledge of TEI, basic XPath and a little CSS. If you don't know any XPath yet, we recommend to read the short introduction linked below.
- Mozilla MDN
- DevDocs: searchable reference of CSS features and properties
- Follow the XPath!: short introduction to XPath
- XPath and XQuery Functions: the official W3C specification covering all standard XPath functions
- XQuery for Humanists: book with companion website
- https://teibyexample.org/
- TEI Guidelines: the ultimate reference
- What is the Text Encoding Initiative?, a French translation is also available
- Section 22.5.4.1 of the TEI Guidelines: the official specification of the TEI Processing Model
- TEI Publisher Documentation