EpiDoc Workshops

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

• A short tutorial on EpiDoc markup and tools will be held , September 30-October 1, 2013, in the run-up the TEI Members Meeting in Rome (October 2-5, 2013)
• EpiDoc workshops have been proposed or considered for Bari, Berlin, Brown, Michigan, Paris, Rome, Torino, Udine, Vienna

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
• ...

Programme

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

Tuesday April 29

10:30	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

Wednessday April 30

10:00	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 P.Koeln XIII and P.Bagnall will be entered (text documents can be found here: P.Koeln 13 and P.Bagnall). Assigned papyrological texts, SoSOL/Leiden+ practice (see Assignments)
16:30	ends

Thursday May 1

10:00	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 Alberto Campagnolo, 'A tale of two fields: book conservation and digital humanities' As part of the MMSDA programme; EpiDoc participants all welcome

materials not used this time

• CSS Customization
• XSLT Tutorial
• EpiDoc Projects
• Documentation
• EpiDoc Guidelines Outline
• The Epigrapher as Encoder
• IDP and SoSOL
• Publishing with XML
• EpiDoc Metadata
• Example Inscription (Latin)
• Example Inscription (Greek)
• Figures and Facsimile
• Relationships between persons, places, events, texts
• HGV to EpiDoc
• CSS and XSLT
• XPath

Notes

• Online: <?xml-model href="http://www.stoa.org/epidoc/schema/latest/tei-epidoc.rng" schematypens="http://relaxng.org/ns/structure/1.0"?>
• Local: <?xml-model href="tei-epidoc.rng" schematypens="http://relaxng.org/ns/structure/1.0"?>

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

Contact

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