DH 2026

Daejeon, July 27–31

Workshop

LEAF-Writer Commons: An introduction to a lightweight web-based tags-off TEI+RDF editor

James Cummings
Newcastle University, United Kingdom · james.cummings@newcastle.ac.uk
Diane Jakacki
Bucknell University, USA · dkj004@bucknell.edu
Susan Brown
University of Guelph, Canada · sbrown@uoguelph.ca
Mihaela Ilovan
University of Alberta, Canada · ilovan@ualberta.ca
Luciano Frizzera
University of Waterloo, Canada · lucaju@gmail.com

This half-day in-person workshop introduces textual scholars and practitioners to LEAF-Writer, a lightweight web-based editor that enables TEI+RDF encoding in the user’s browser without installing any software. This workshop speaks directly to one of the conference sub-themes of “Annotating | Beyond Patterns: Interpretation with Small Data”. LEAF-Writer is an editor for documents encoded following the Text Encoding Initiative (TEI) Guidelines. It enables researchers to create small-scale datasets with researcher-defined nuanced semantic interpretations to produce high-quality Linked Open Data (LOD) based on either standard named entity authorities or an individual project’s corpus of named entities.

LEAF stands for the Linked Editing Academic Framework, a collaborative software suite that provides a set of modular tools for text editing and publication. The LEAF Commons tools constitute an accessible, low-barrier, no-cost infrastructure for researchers to produce online texts, editions, or collections, whether for teaching or for undertaking research and collaboration on a sustainable basis. The LEAF Commons tools are freely available in the browser, enabling collaboration and publication through Github, in addition to permitting local storage. Promoting the reuse of data in keeping with the FAIR (Findable, Accessible, Interoperable, and Reusable) data principles, LEAF uses open-source software, open-access platforms, and open international standards for best practices in text-encoding (TEI-XML) and web annotation (RDF). LEAF-Writer is part of a suite of web-based, easy-to-use tools ‘LEAF Commons’ (meaning that they function both inside and outside the LEAF-VRE platform) that supports a range of activities from text encoding, named entity recognition, web annotation, text analysis and publication all running in the user’s browser without them having to learn complex coding languages.

LEAF-Writer: an open-source, open-access Extensible Markup Language (XML) editor that runs in a web browser offering scholars and their students a rich textual editing experience without the need to download, install, and configure proprietary software, pay ongoing subscription fees, or learn complex coding languages. This user-friendly editing environment incorporates TEI and Resource Description Framework (RDF) standards, meaning that texts edited in LEAF-Writer are interoperable both with other texts produced by the scholarly editing community and with other materials produced for the Semantic Web. It also incorporates Named Entity reconciliation using linked open data identifiers to standard authorities or a project’s own corpus of named entities. LEAF-Writer is particularly valuable for pedagogical purposes, allowing instructors to teach students best practices for encoding texts without also having to teach students how to code.

While this workshop will concentrate on one of these tools, LEAF-Writer Commons, it will introduce some of the other LEAF Commons tools:

DToC: (the Dynamic Table of Contexts) provides an online interactive reading and publication environment for digital scholarly texts where the two conventional overviews provided in print editions - the table of contents and the index - have been dynamically merged to provide an interactive online e-reading experience that leverages the power of TEI XML markup.

LEAF-TE: (The LEAF Turning Engine) is a web interface that enables users to easily and automatically transform documents between a number of formats to TEI XML suitable for importing into LEAF-Writer. It also exports from LEAF-Writer to HTML, Markdown, RDF, CSV, and plain text for publication or use in other workflow tools.

NERVE: (the Named Entity Relationship and Vetting Environment) is an application that performs Named Entity Recognition (NER) on machine-readable texts, allowing users to identify candidate entities in a document, review, and correct the results. Users can reconcile data to an authority and export their reconciled data in TEI-XML or HTML formats to an online repository or to their desktop.

LEAF promotes best practices, reuse, and sustainability in the production of digital scholarship in the humanities through tools bridging the gap between scholars with (en)coding skills and those without. LEAF Commons offers communities of researchers, teachers, and students the opportunity to take part in digital knowledge production and open collaboration. The workshop will end with an open discussion about pursuing such forms of open knowledge production and collaboration. The LEAF team has conducted similar workshops at disciplinary conferences and in consultation with project teams over the past few years (see bibliography, below).

Agenda:

The workshop will be managed as follows:

  • Introductions and Setup (20 minutes)
    • Ensuring participants have access to a fork of the LEAF-Writer workshop’s GitHub Repository
  • Part 1 (50 minutes)
    • An introduction to the LEAF project and TEI markup, followed by a walk-through demonstration of LEAF-Writer functions and named entity linking
  • Part 2 (30 minutes)
    • Hands-on practical exercise with workshop-provided files encoding TEI elements and named entity linking
  • Break (~10 minutes)
  • Part 3 (25 minutes) 
    • Explanation and demonstration of enabling local project-specific named entity authority files
  • Part 4 (25 minutes)
    • Hands-on practical exercise of setting up a local project-specific named entity authority file; Experimentation with user’s own TEI-encoded materials
  • Conclusion (20 minutes or more)
    • Introduction to other LEAF Commons tools; feedback and discussion of LEAF Commons development roadmap 

Requirements:

Participants will need a web-enabled laptop computer (not a tablet or a mobile device) and WiFi access. No software installation is required. Sample texts in multiple languages will be provided; participants are also welcome to bring their own documents in TEI-conformant XML.

Facilitator:

The workshop will be presented solely by Dr James Cummings, Newcastle University (UK), but the project work, teaching materials, and sample documents have been created by the LEAF-VRE team including: James Cummings (Newcastle University), Susan Brown (University of Guelph), Mihaela Ilovan (Canadian Writing Research Collaboratory / University of Alberta), Diane Jakacki (Bucknell University), Rachel Milio (University of Crete), and Luciano Frizzera (University of Waterloo).

James Cummings (Newcastle University - James.Cummings@newcastle.ac.uk) is the Reader in Digital Textual Studies and Late-Medieval Literature at the School of English Literature, Language, and Linguistics at Newcastle University. His interests include the use of digital technology for scholarly editing and also late-medieval performance. He has a long history of involvement with the TEI Consortium and is an elected member to the TEI’s Board of Directors. He has recently been leading projects on both HTR to TEI workflows and digital pedagogy, as well as the Newcastle PI for the LEAF project.

References
  1. Brown, Susan (2014): “Scaling Up Collaboration Online: Towards a Collaboratory for Research on Canadian Writing,” in International Journal of Canadian Studies 48: 233-51.
  2. Brown, Susan / Simpson, John / the INKE Research Group / the CWRC project team (2015): “The Changing Culture of Humanities Scholarship: Iteration, Recursion, and Versions in Scholarly Collaboration Environments; Special Issue on "Building Partnerships to Transform Scholarly Publishing," in Scholarly and Research Communication 5.4.
  3. Brown, Susan / Cummings, James / Frizzera, Luciano / Ilovan, Mihaela / Jakacki, Diane / Milio, Rachel (2025): “LEAF: Exploring Sustainable Development of Researcher-Led Software”, workshop at the DH2025 Annual Meeting. 
  4. Brown, Susan / Cummings, James / Frizzera, Luciano / Ilovan, Mihaela / Jakacki, Diane / Milio, Rachel (2022): “Engaging TEI Editors Through LEAF-Writer,” workshop at the TEI 2022 Annual Meeting. 
  5. Brown, Susan / Jakacki, Diane (2024): “‘I don’t even see the code:’ The Dynamic Table of Contexts – Optimizing our Encoded Texts for Web-based Reading and Analysis Environments.” TEI Annual Meeting.
  6. —. “The Linked Editing Academic Framework (LEAF) in the multimodal annotation ecosystem.” (2024) Reimagining Annotation for Multimodal Cultural Heritage. Rennes, France.
  7. Calarco, Gabriel / Cummings, James / Jakacki, Diane (2024) “Producing Semantic Digital Editions Using LEAF Commons Tools” workshop at the TEI 2024 Annual Meeting. (Conducted in English and Spanish).
  8. Canning, Erin / Brown, Susan / Roger, Sarah / Martin, Kim (2022): “The Power to Structure: Making Meaning from Metadata through Ontologies,” in Kula 6.3.
  9. Cope, Bill, et al., eds (2011): Towards a Semantic Web: Connecting Knowledge in Academic Research. Chandos Publishing.
  10. Cummings, James (2025): “The Future is Already Here: Navigating the New Frontiers of Digital Scholarly Editing in an Age of HTR and AI / El futuro ya está aquí: navegar por las nuevas fronteras de la edición filológica digital en la era de la HTR y la IA.” in Philologia Hispalensis. 39(2), 179-199.
  11. Cummings, James (2023): “Academics Retire and Servers Die: Adventures in the Hosting and Storage of Digital Humanities Projects.” in: Digital Humanities Quarterly, 17(1)
  12. Cummings, James (2019): “A World of difference: Myths and misconceptions about the TEI.” in: Digital Scholarship in the Humanities. 34(Supplement 1), i58-i79
  13. Cummings, James (2019): “Opening the Book: Data Models and Distractions in Digital Scholarly Editing.” in: International Journal of Digital Humanities. 1, 179-193
  14. Cummings, James / Flex, Valentina / Healey, Alexandra / Jakacki, Diane / Johnson, Ian / Pirmann, Carrie (2022): “Evolving Hands: HTR and TEI Workflows for cultural institutions,” at the TEI 2022 Annual Meeting.
  15. Cummings, James / Jakacki, Diane (2023): “Building Workflows for HTR to TEI Up-Conversion and Enhancement.” at the TEI Annual Meeting.
  16. Jakacki, Diane (2022): "Complex Textual Editing through Text Encoding: LEAF-Writer." Atelier "Éditions critiques numériques et multilinguisme," workshop at the Université de Montréal.
  17. Jakacki, Diane / Brown, Susan / Cummings, James / Ilovan, Mihaela (2023): “LEAF: Developing Streamlined Digital Scholarly Workflows with the Linked Editing Academic Framework” workshop at the Digital Humanities 2023 Annual Meeting.
  18. —. (2022): “The Linked Editing Academic Framework: Creating an Editorial Environment for Collaborative Scholarship and Publication," at the Digital Humanities 2022 Annual Meeting. <https://youtu.be/jyCXRrfh5vk>.