EpiDoc Workshops

From The Digital Classicist Wiki
Jump to navigation Jump to search

EpiDoc Workshops have been run on several occasions over the past few years, with the intention of disseminating skills and experience and encouraging discussion on the topic of TEI markup for the encoding of epigraphic, papyrological, and other ancient texts.

Future events

  • EpiDoc workshop at Institute for Classical Studies, University of London, April 28 - May 1, 2014
  • Advanced EpiDoc / Digital Humanities summer school, University of Sofia, Bulgaria, August? 2014

Past Events

Full, week-long Summer Schools have been run at:

  • EpiDoc training workshop on September 3-6, 2013 in Sofia, Bulgaria
  • Institute for Classical Studies, London, September 5-8, 2011; April 22-25, 2013
  • EpiDoc/SoSOL workshop, Bologna, January 10-14, 2011; May 6-10, 2013
  • Centre for Computing in the Humanities, King's College London, July 2005; May 2006; June 2007; July 14-18, 2008; June 28th-July 1st, 2010
  • Humanities Lab, IULM, Milan, June 16-20, 2008
  • British School at Rome, September 21-25, 2009
  • EpiDoc/SoSOL workshop, King's College London, March 8-13, 2010
  • EpiDoc/SoSOL workshop, Duke University, July 15-17, 2010
  • EpiDoc/SoSOL workshop, Lyon, September 13-17, 2010
  • EpiDoc/SoSol workshop, Università «Mediterranea», Reggio Calabria, June 4-7, 2012

Shorter training events have taken place at the Center for Hellenic Studies, Washington DC in 2005; at the American Academy in Rome, October 2006; at the AIA/APA meeting in San Diego, January 2007; at the Centre Camille Jullian, Maison Méditerranéenne des Sciences de l'Homme, in Aix-en-Provence, in February 2011; at the TEI conference in La Sapienze, Roma, October 2013; EAGLE Europeana meeting, Ljubljana, Slovenia, February 2014.

If you want to run an EpiDoc workshop

If you would like to run or host an EpiDoc training workshop at some point, please in the first instance contact the Markup list to canvass the possible trainers for their availability.

Please be prepared to:

  • raise money to fund travel and accommodation (at least) for two or preferably three experienced trainers to visit and run the workshop
  • begin planning the workshop at least 6 months ahead, and be flexible
  • provide a seminar room with space for 10-15 participants to sit comfortably, with wireless internet access and data projection
  • ...


The programme of the April 2014 Workshop in London. All training materials are freely downloadable.

Monday April 28

10:30 Introduction to EpiDoc and XML (see General Introduction)

Bibliographic Tagging; Detailed XML Rules

Join the Markup List

12:30 lunch
14:00 EpiDoc Guidelines

EpiDoc edition structure (see Manuscript Description overview; Divisions of an EpiDoc Edition)

Oxygen setup and practice (see EpiDoc Download Package)

Description and history (see Object Description; Dates, Dating and Age at Death)

16:30 ends (students do independent exercises)

Tuesday April 29

10:30 Review exercises.

Places and Locations

Authority Lists; EpiDoc and EAGLE/EDR conformance; IRT to EDH

More practice

12:30 lunch
14:00 Introduction to EpiDoc XML and Leiden distinctions (see EpiDoc Guidelines; Cheatsheet)

Transformation with Oxygen (see Running XSLT in Oxygen)

EpiDoc markup features (see Abbreviations and symbols; Gaps and lacunae; Structure of the Text)

More practice

16:30 ends (students do independent exercises)

Wednesday April 30

10:30 Review exercises.

Editing scenario and parameters for XSLT.

Other information in the transcribed text (see Textual Corrections; Apparatus Criticus; Verse in EpiDoc)

More practice

12:30 lunch
14:00 Introduction to SoSOL (http://papyri.info/editor)

Brief guide to SoSOL: (guide)

Text (see Leiden+ guidelines)

Practice with various papyrological texts, which will be specified nearer the time and assigned during the training session. Texts taken from O.Petr. Mus., P.Koeln XII, P.Koeln XIII and P.Bagnall will be entered (text documents can be found here: P.Koeln 12, P.Koeln 13 and P.Bagnall). Assigned papyrological texts, SoSOL/Leiden+ practice (see Assignments).

For the O.Petr. Mus. texts see the Assignments googledoc. Most of the texts in O.Petr. Mus. are reeditions of existing texts. The list supplied is only for those texts for which there is no text entry at all in papyri.info. These texts will all have to be hand typed into the editor as there is no digital version of the text, which is of any help in entering Unicode Greek.

16:30 ends (students do independent exercises)
17:00 Optional: meeting with MMSDA students in Plough, Museum Street.

Thursday May 1

10:30 Review exercises.

Word Name and Place Markup; Certainty and Precision

Further practice (EpiDoc and/or SoSOL)

12:30 lunch
14:00 EpiDoc community and support (see EpiDoc website, Markup list, Sourceforge Tickets)

EpiDoc support website feedback session

Closing remarks

16:00 workshop ends
17:30 - 19:30 Evening lecture and reception: IALS Lecture Theatre, 17 Russell Square, part of the MMSDA programme; EpiDoc participants all welcome.

Alberto Campagnolo, 'A tale of two fields: book conservation and digital humanities'

materials not used this time


Questions for discussion on Markup

  • typology of interpuncts and other g-types (done)
  • typology of letterforms/letter fragments (Daniel)
  • encoding word-spacing on source text (Zheira)
    • and layout features generally: image+text; directionality and orientation; text-formatting; genre+format relationship? (Celia)
  • referent of @xml:lang: source or edition? (Terhi)
  • msPart or similar when objects (incl. fragments) are primary in edition (Emmanuelle)
    • @type on msPart? (Ulrike)
  • interlinear spacing: layout or handNote? (Emmanuelle)
  • encourage full segmentation/tokenization (cf. insaphdoco); or offer severallevels of conformance? (Thomas)
  • New edition-type value: qualitycontrol: highlight "invisible" features, flag missing attributes, impossible dates, etc. (Emmanualle)
  • Bibliographic control (various levels: inscription; project; corpus; global); via API? via namespaced uris? Relate to biblio authority training session? Related to IDEs bibl-abbr? Relate to CMR/DAI thinking...?
  • relationship of text and editorial theories to (a) material evidence, (b) other kinds of evidence, (c) scholarly reasoning behind evidence (@resp, @source/@ed, @evidence) (Emmanuelle)

Guidelines improvements needed

  • why/when list language tags in header?
  • default that lb is word-dividing?
  • default text direction?

XSLT fixes needed

  • spacing around milestones (and lines) when no tei:w markup
  • omit first milestone element in each line
  • Rahtz re nbsp in egXML

Future meetings

  • GB: hackathon to convert crappy corpus to EpiDoc
  • Emmanuelle: philological modelling of text and user needs prior to modelling encoding
    • cf. limitations of VREs (below) (RB)
  • Ulrike: examine whether EpiDoc (and TEI?) model is driven by underlying assumptions of theory of text (transformation reveals some of this)
    • make explicit transformation rules and assumptions behind them (EM)
  • Ryan: workshop to try to create LOD from participants' own EpiDoc collection; and identify resources for linking to
  • Emmanuelle: mine Markup list for good practices, deprecated practices, discussions that never finished, decisions that never made it into Guidelines (workshop, or student project)
  • Frank: (link to LOD workshop) automatic enrichment of EpiDoc data (NER, period links, disambiguation)
  • Angela: editing practice, and discussion of other editing environments, tools, shortcuts, assistants.
    • incorporate into EpiDoc Summer School practice some day? (GB)
  • Celia: Virtual Research Environments: test VREs for working with XML, editors, tools, linking data. CSAD VRE, TextGrid, Papyri.info?, TAPAS, (EFES?), others..?
  • Ulrike: bring along existing EpiDoc files to hack on: visualizations, indexing, upconversion, linked data, unpredictable/undesirable re-use
  • Emmanualle: how to evaluate electronic publications [in epigraphy]

Training suggestions

  • Summer School training:
    • slideshow on <supplied>+<gap> combinations
    • more examples on screen, working together
    • set concrete homework for every day private study
    • make time for participants to present their work / their needs
  • Advanced training:
    • introduction to XSLT, XPath, XQuery
    • customizing and adapting EpiDoc XSLT
    • project management, setting up project, identifying technical tasks/skills
    • advanced markup, linking, vocabularies, LOD
      • especially bibliography
    • EpiDoc tools tutorial
    • Kiln tutorial


For more information on future EpiDoc training events, please inquire on the Markup list