In this repository you can find 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.
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. Install the TEI Publisher 6.
NB 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.
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.
- 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
- XPath for processing XML and managing projects: DHSI 2019 course material by Elisa Beshero-Bondar and David Birnbaum
- 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