EpiDoc Workshops: Difference between revisions

From The Digital Classicist Wiki
Jump to navigation Jump to search
(→‎Past Events: added old programme)
(replaced 2014 programme with list of slideshows and materials)
Line 46: Line 46:
* provide a seminar room with space for 15-20 participants to sit comfortably, with wireless internet access, data projection and plenty of power sockets/extension cables
* provide a seminar room with space for 15-20 participants to sit comfortably, with wireless internet access, data projection and plenty of power sockets/extension cables


==Programme==
== Training Materials ==


The programme of the '''April 2014''' Workshop in London. All training materials are freely downloadable.
All slideshows and training materials are freely downloadable, and licensed for re-use and distribution.


====Monday April 28====
=== Current ===
{| border="1"
* [https://docs.google.com/presentation/d/1y4nnaXHK83AUmUbuLsS1Xvu7p_mxRIqzxNcqujm3qGo/present General Introduction]
|-
* [https://docs.google.com/presentation/d/1IYkFaJJHhetjZ-ODJ52-LdcFqKi3Z4zDC3eCyjcGb5g/present#slide=id.i0 Bibliographic Tagging]
|10:30
* [https://docs.google.com/presentation/d/16zXgfBgJ55qHAQ1THZ-sV-nplG_aBnEcKwIvE6aFX9U/present#slide=id.i0 Detailed XML Rules]
|Introduction to EpiDoc and XML (see [https://docs.google.com/presentation/d/1y4nnaXHK83AUmUbuLsS1Xvu7p_mxRIqzxNcqujm3qGo/present General Introduction])
* [http://sourceforge.net/p/epidoc/wiki/MarkupList/ Join the Markup List]
* [http://www.stoa.org/epidoc/gl/latest/ EpiDoc Guidelines]
* [https://docs.google.com/presentation/d/1bijIZQuJw2FwLbHZ5XEvsSHDxIcBT_NeL_LZGmQbxJ4 Manuscript Description overview]
* [http://docs.google.com/Presentation?id=dgwtk2rp_53hgqx7zc3 Divisions of an EpiDoc Edition])
* [http://www.digitalclassicist.org/temp/epidoc-201504.zip EpiDoc Download Package])
* [https://docs.google.com/presentation/d/1uNMmrFgB07ny1br3vgAfhvZ4-Q1wwNWWg7RE-Od7zCg/present Object Description]
* [https://docs.google.com/presentation/d/1sZwAeCIctbfPFYMAgE33H-LOWsjy0AyJ8uA6B05PYaU/present Dates, Dating and Age at Death]
* [https://docs.google.com/presentation/d/10zQchguylqF2qNmHYQ3kCJMkY5BMKx37ijx1QHoJyS0/present Places and Locations]
* [https://docs.google.com/presentation/d/1URjFkyIbmpJ9-4haWv4wcAk-9IDZ8Umu5G6nWOh4u2o/present Authority Lists]
* [http://docs.google.com/Presentation?id=dgwtk2rp_187dckqc5c8 EpiDoc and EAGLE/EDR conformance]
* [https://docs.google.com/present/view?id=dgwtk2rp_104g6d8p9ft IRT to EDH]
* [http://www.stoa.org/epidoc/gl/latest/ EpiDoc Guidelines]
* [https://sourceforge.net/p/epidoc/code/HEAD/tree/trunk/guidelines/msword/cheatsheet.doc Cheatsheet]
* [http://docs.google.com/Doc?id=ddfkbz69_9gt2mq2c9 Running XSLT in Oxygen]
* [https://docs.google.com/presentation/d/12S4nc596MUg0wGSb9jDS-UzHQmRAFdKw7tm1SVuJKYw/present Abbreviations and symbols]
* [https://docs.google.com/presentation/d/1gmlTWwOKzjDFVO_KMJhhbTAc3cPETR4a4C21IC-ANJI Gaps and lacunae]
* [https://docs.google.com/presentation/d/1fLVq9n9ML4S-QPsE4W__wOchY07arcA8FIRyz45jkr4/present Structure of the Text]
* [https://docs.google.com/presentation/d/1p8jZ-XFbEDmi0KDI1bC2tu8dCUKUbvKpx8uacSebLfE/present Textual Corrections]
* [https://docs.google.com/presentation/d/16l2Slh_HtqOxnMb1fiFz5uL3SF6xa_awSmEf6Iy-6P0/present#slide=id.i0 Apparatus Criticus]
* [https://docs.google.com/presentation/d/1Q8y7evPzl1msYRP2gSw3YtuBEaHC-ZM-mapnlrSsPVA/present Verse in EpiDoc]
* [https://docs.google.com/document/d/1w0TXTq5VuIzQxGYq9vO0CJRER3JJr6tKmwwaCzyGrXs/edit?authkey=CKnGk_ML&hl=en# Brief guide to SoSOL]
* [http://papyri.info/editor/documentation Leiden+ guidelines]
* [https://spreadsheets.google.com/ccc?key=0As1AGmWRrRdUdDg5TUc3MEJYSl9kZ0doVWxmWXJnQ2c Papyrological text assignments]
* [https://docs.google.com/presentation/d/1hJG2azrjKIFPYijb3Eh9kcL_H-uaqCQbWt8TU6ERQRk/present Word Name and Place Markup]
* [https://docs.google.com/presentation/d/1dfYAD3M8ATERAsAh7-q5VJyjH0XsU7Hh8oBOW0m6fag/present Certainty and Precision]
* [http://epidoc.sf.net/ EpiDoc website]
* [http://lsv.uky.edu/archives/markup.html Markup list]
* [https://sourceforge.net/p/epidoc/feature-requests/ Sourceforge Tickets])


[https://docs.google.com/presentation/d/1IYkFaJJHhetjZ-ODJ52-LdcFqKi3Z4zDC3eCyjcGb5g/present#slide=id.i0 Bibliographic Tagging]; [https://docs.google.com/presentation/d/16zXgfBgJ55qHAQ1THZ-sV-nplG_aBnEcKwIvE6aFX9U/present#slide=id.i0 Detailed XML Rules]
=== other materials not used recently ===
 
[http://sourceforge.net/p/epidoc/wiki/MarkupList/ Join the Markup List]
|-
|12:30
|''lunch''
|-
|14:00
|[http://www.stoa.org/epidoc/gl/latest/ EpiDoc Guidelines]
 
EpiDoc edition structure (see [https://docs.google.com/presentation/d/1bijIZQuJw2FwLbHZ5XEvsSHDxIcBT_NeL_LZGmQbxJ4 Manuscript Description overview]; [http://docs.google.com/Presentation?id=dgwtk2rp_53hgqx7zc3 Divisions of an EpiDoc Edition])
 
Oxygen setup and practice (see [http://epiduke.cch.kcl.ac.uk/epidoc-201407.zip EpiDoc Download Package])
 
Description and history (see [https://docs.google.com/presentation/d/1uNMmrFgB07ny1br3vgAfhvZ4-Q1wwNWWg7RE-Od7zCg/present Object Description]; [https://docs.google.com/presentation/d/1sZwAeCIctbfPFYMAgE33H-LOWsjy0AyJ8uA6B05PYaU/present Dates, Dating and Age at Death])
|-
|16:30
|''ends'' (students do independent exercises)
|-
|}
 
====Tuesday April 29====
{| border="1"
|-
|10:30
| Review exercises.
 
[https://docs.google.com/presentation/d/10zQchguylqF2qNmHYQ3kCJMkY5BMKx37ijx1QHoJyS0/present Places and Locations]
 
[https://docs.google.com/presentation/d/1URjFkyIbmpJ9-4haWv4wcAk-9IDZ8Umu5G6nWOh4u2o/present Authority Lists]; [http://docs.google.com/Presentation?id=dgwtk2rp_187dckqc5c8 EpiDoc and EAGLE/EDR conformance]; [https://docs.google.com/present/view?id=dgwtk2rp_104g6d8p9ft IRT to EDH]
 
More practice
|-
|12:30
|''lunch''
|-
|14:00
|Introduction to EpiDoc XML and Leiden distinctions (see [http://www.stoa.org/epidoc/gl/latest/ EpiDoc Guidelines]; [https://sourceforge.net/p/epidoc/code/HEAD/tree/trunk/guidelines/msword/cheatsheet.doc Cheatsheet])
 
Transformation with Oxygen (see [http://docs.google.com/Doc?id=ddfkbz69_9gt2mq2c9 Running XSLT in Oxygen])
 
EpiDoc markup features (see [https://docs.google.com/presentation/d/12S4nc596MUg0wGSb9jDS-UzHQmRAFdKw7tm1SVuJKYw/present Abbreviations and symbols]; [https://docs.google.com/presentation/d/1gmlTWwOKzjDFVO_KMJhhbTAc3cPETR4a4C21IC-ANJI Gaps and lacunae]; [https://docs.google.com/presentation/d/1fLVq9n9ML4S-QPsE4W__wOchY07arcA8FIRyz45jkr4/present Structure of the Text])
 
More practice
|-
|16:30
|''ends'' (students do independent exercises)
|-
|}
 
====Wednesday April 30====
{| border="1"
|-
|10:30
| Review exercises.
 
Editing scenario and parameters for XSLT.
 
Other information in the transcribed text (see [https://docs.google.com/presentation/d/1p8jZ-XFbEDmi0KDI1bC2tu8dCUKUbvKpx8uacSebLfE/present Textual Corrections]; [https://docs.google.com/presentation/d/16l2Slh_HtqOxnMb1fiFz5uL3SF6xa_awSmEf6Iy-6P0/present#slide=id.i0 Apparatus Criticus]; [https://docs.google.com/presentation/d/1Q8y7evPzl1msYRP2gSw3YtuBEaHC-ZM-mapnlrSsPVA/present Verse in EpiDoc])
 
More practice
|-
|12:30
|''lunch''
|-
|14:00
|Introduction to SoSOL (http://papyri.info/editor)
 
Brief guide to SoSOL: ([https://docs.google.com/document/d/1w0TXTq5VuIzQxGYq9vO0CJRER3JJr6tKmwwaCzyGrXs/edit?authkey=CKnGk_ML&hl=en# guide])
 
Text (see [http://papyri.info/editor/documentation 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: [http://147.142.225.252/Xcoded/OPetrMus/ O.Petr.Mus], [http://147.142.225.252/Xcoded/PKoelnXII/ P.Koeln 12], [http://147.142.225.252/Xcoded/PKoelnXIII/ P.Koeln 13] and [http://147.142.225.252/Xcoded/PBagnall/ P.Bagnall]).
Assigned papyrological texts, SoSOL/Leiden+ practice (see [https://spreadsheets.google.com/ccc?key=0As1AGmWRrRdUdDg5TUc3MEJYSl9kZ0doVWxmWXJnQ2c 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 [http://dixit.uni-koeln.de/mmsda.html MMSDA] students in [http://www.taylor-walker.co.uk/pub/plough-bloomsbury/m2605/#find-us Plough], Museum Street.
|-
|}
 
====Thursday May 1====
{| border="1"
|-
|10:30
| Review exercises.
 
[https://docs.google.com/presentation/d/1hJG2azrjKIFPYijb3Eh9kcL_H-uaqCQbWt8TU6ERQRk/present Word Name and Place Markup]; [https://docs.google.com/presentation/d/1dfYAD3M8ATERAsAh7-q5VJyjH0XsU7Hh8oBOW0m6fag/present Certainty and Precision]
 
Further practice (EpiDoc and/or SoSOL)
|-
|12:30
|''lunch''
|-
|14:00
|EpiDoc community and support (see [http://epidoc.sf.net/ EpiDoc website], [http://lsv.uky.edu/archives/markup.html Markup list], [https://sourceforge.net/p/epidoc/feature-requests/ 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 [http://dixit.uni-koeln.de/mmsda.html MMSDA] programme; EpiDoc participants all welcome.
 
'''Alberto Campagnolo, 'A tale of two fields: book conservation and digital humanities''''
|-
|}
 
==materials not used this time==
* [http://docs.google.com/Doc?id=ddfkbz69_8g5c46bgh CSS Customization]
* [http://docs.google.com/Doc?id=ddfkbz69_8g5c46bgh CSS Customization]
* [http://docs.google.com/Presentation?id=dgwtk2rp_84d8gh9dxq XSLT Tutorial]
* [http://docs.google.com/Presentation?id=dgwtk2rp_84d8gh9dxq XSLT Tutorial]

Revision as of 15:49, 9 April 2015

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

  • Institute for Classical Studies, University of London, April 20-24, 2015
  • 3-day EpiDoc training, University of Oxford, May 5-7, 2015
  • EpiDoc/EAGLE training, Univerity of Bologna, Italy, May 25-27, 2015
  • Half-day EpiDoc/SNAP:DRGN training, University of Grenoble, France, September 2, 2015
  • Advanced EpiDoc / Digital Humanities summer school, University of Sofia, Bulgaria, September 7-11, 2015

Past Events

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

  • EpiDoc/SoSOL workshop, Bologna, January 10-14, 2011; May 6-10, 2013; May 26-29, 2014
  • Institute for Classical Studies, London, September 5-8, 2011; April 22-25, 2013; April 28-May 1, 2014 (programme)
  • EpiDoc training workshop on September 3-6, 2013 in Sofia, Bulgaria
  • EpiDoc/SoSOL workshop, Duke University, July 15-17, 2010
  • EpiDoc/SoSol workshop, Università «Mediterranea», Reggio Calabria, June 4-7, 2012
  • EpiDoc/SoSOL workshop, Lyon, September 13-17, 2010
  • 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
  • EpiDoc/SoSOL workshop, King's College London, March 8-13, 2010
  • British School at Rome, September 21-25, 2009
  • Humanities Lab, IULM, Milan, June 16-20, 2008
  • Shorter training events have taken place at:
    • Digital Humanities Conference, Lausanne, July 2014
    • EAGLE Europeana meeting, Ljubljana, Slovenia, February 2014
    • TEI conference in La Sapienze, Roma, October 2013
    • Maison Méditerranéenne des Sciences de l'Homme, Aix-en-Provence, February 2011
    • National e-Science Centre in Edinburgh, February 2009
    • AIA/APA meeting in San Diego, January 2007
    • American Academy in Rome, October 2006
    • Center for Hellenic Studies, Washington DC in 2005

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
    • ideally you should be prepared to pay the trainers for their time as well
    • a funded project should enquire for consultancy rates; a limited number (1-2) of expenses-only workshops will be run per year
  • begin planning the workshop at least 6 months ahead, and be flexible
  • provide a seminar room with space for 15-20 participants to sit comfortably, with wireless internet access, data projection and plenty of power sockets/extension cables

Training Materials

All slideshows and training materials are freely downloadable, and licensed for re-use and distribution.

Current

other materials not used recently

Notes

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

Retrieved from ‘https://wiki.digitalclassicist.org/index.php?title=EpiDoc_Workshops&oldid=5559’