Skip to content

Cyprus EpiDoc DH May 2022

Gabriel Bodard edited this page May 27, 2022 · 36 revisions

Digital Humanities Introductory Workshop:

An introduction to technologies for text editing, geographical visualisation and 3D imaging 23-27 May 2022, 10:00 ‒ 12:30 (EEST), 14:30 ‒ 17:00 (EEST)

Workshop organised by the Department of Classics and Philosophy and the Department of History and Archaeology of the University of Cyprus, in collaboration with Laboratory of Geophysical-Satellite Remote Sensing and Archaeo-environment, Institute of Classical Studies, School of Advanced Study, University of London, Department of History and Cultures - Alma Mater Studiorum Università di Bologna, and ENCODE.

Venue: University of Cyprus Campus, Library “Stelios Ioannou” Learning Resource Centre

The workshop will offer introductions to a range of archaeological and philological technologies, including features of EpiDoc XML, linguistic analysis (including treebanking, translation alignment), 3D Imaging, GIS, and Linked Open Geographical Data.

The workshop will be suitable for advanced undergraduates, postgraduates and early career scholars with little or no previous experience of digital humanities. The workshop will be capped at 20 participants. A limited number of spaces will also be available for remote, asynchronous participants. Those participating physically will have to comply with UCY’s safety protocols, which will depend on the epidemiological situation during the time the event is held. Further details on the programme, preparation material (software, readings) and safety protocols will be sent to the selected participants in advance.

Organisers:

  • Margarita Alexandrou (Department of Classics and Philosophy, UCY)
  • Maria Parani (Department of History and Archaeology, UCY)
  • Apostolos Sarris (Sylvia Ioannou Chair on Digital Humanities, Dept. of History & Archaeology, UCY)
  • Gabriel Bodard (School of Advanced Study, University of London)
  • Irene Vagionakis (University of Bologna and ENCODE Project)
  • Valeria Vitale (The Alan Turing Institute)

Draft programme

NB: Workshop times are in EEST = GMT+3

Day 1: Monday May 23

3D imaging: photogrammetry

Morning 10:00 – 12:30 [Coffee Break: 11:00 ‒ 11:30]

This session will introduce the concept of 3D imaging of heritage artefacts (or any other object). We will focus in particular on the technique of photogrammetry—the production of a 3D model from multiple digital photographs of an object. You will be able to try out the methods yourself using your own digital camera, tablet or smartphone, and running the 3D modelling process using free trial software on your laptop.

Before the session:

EpiDoc object description

Afternoon 14:30 – 17:00 [Coffee Break: 15:30 ‒ 16:00]

This session will allow you to practice the EpiDoc XML recommendations for encoding descriptions of text-bearing objects such as ancient inscriptions. We will focus on the markup of physical description and historical context of artefacts, and give hands-on support working with editions in an XML editor.

For the exercise:

  • Download (right-click on the link and "save link as…") the EpiDoc Template

Before the session:

Day 2: Tuesday May 24

Introducing semantic annotation and Linked Open GeoData

Morning 10:00 – 12:30 [Coffee Break: 11:00 ‒ 11:30]

This session will introduce the main concepts of Linked Open Data for cultural heritage, with a particular focus on place. It will explain the role played by authority lists of unique identifiers, such as gazetteers for places and prosopographies for people, and how they enable meaningful connections among different resources and new pathways for discovery and exploration. The practical exercise will be based on the award winning online annotation platform Recogito. Students will produce their own semantic annotations on text and images, through a user-friendly graphic interface.

Files to annotate:

Before the session:

EpiDoc text transcription

Afternoon 14:30 – 17:00 [Coffee Break: 15:30 ‒ 16:00]

This session will involve practice in encoding text transcription features and other elements of the transcribed text of an inscription, papyrus, or other historical text-bearing object, building on the example of the Leiden System for papyrology and epigraphy. You will receive hands-on support as you encode some texts in EpiDoc XML in an XML editor.

For the exercise:

  • Download (right-click on the link and "save link as…") the EpiDoc Template

Before the session:

Day 3: Wednesday May 25

Geo-visualisation and GIS.

Morning 10:00 – 12:30 [Coffee Break: 11:00 ‒ 11:30]

This session will focus on the use of ArcGIS software for mapping applications and geo-visualization purposes. It will introduce the environment and the main options (spatial tools) available from the software, discuss the different types of data (raster and vector) that can be supported, the import of existing databases or spreadsheets, the population of attributes, the use of freely available background layers, and the creation of maps based on the different attributes of the features.

(Alternative video tutorial and exercise for remote participants who can't get ArcGIS working or prefer to use free QGIS software)

Before the session:

  • Remote participants: Register for a 21-day free trial of ArcGIS or watch the alternative video above and install the free QGIS package as instructed there
    • (in-person participants will use the ArcGIS installed on the PCs in the computer lab)
  • All: download and unzip the following zip archive: GIS_DIGITAL_HUMANITIES_2022.zip. (NB if you are in the computer lab, you will need to unzip the files on your own machine and then copy then to the lab PC on a USB stick.)

Videos:

Readings:

Place and person tagging in EpiDoc

Afternoon 14:30 – 17:00 [Coffee Break: 15:30 ‒ 16:00]

This session will focus on the tagging of personal names, placenames, and other features that might be indexed or controlled by authority lists in an EpiDoc project. Compare these methods to the tagging of personal and place names in the Recogito session yesterday morning. You will be expected to practice tagging your own texts or some example inscriptions provided, and there will be questions and support.

For the exercise:

Before the session:

Day 4: Thursday May 26

Editorial correction and Apparatus Criticus

Morning 10:00 – 12:30 [Coffee Break: 11:00 ‒ 11:30]

This session will offer practice in encoding editorial corrections and apparatus criticus in EpiDoc. During the workshop you will encode your own or some practice files, with support from the instructors in the room.

Text analysis

Afternoon 14:30 – 17:00 [Coffee Break: 15:30 ‒ 16:00]

This session will introduce the very basics of the concept of textual analysis, including visualisation, translation alignment, and linguistic analysis. Exercises involving Voyant Tools and the Ugarit iAligner will be suggested.

Texts to visualise and/or align:

Day 5: Friday May 27

Visualising and Publishing EpiDoc with EFES

Morning 10:00 – 12:30 [Coffee Break: 11:00 ‒ 11:30]

This session will focus on using the EFES platform to visualise, search and publish your EpiDoc files. Instructors will be available to support you during the practice sessions.

Before the workshop:

  • Download EFES (click on “Code” → “Download ZIP”), and follow the Installation instructions (including making sure you have the correct Java version to run EFES on your operating system)
  • Watch the following instructional video:
Closing discussion, feedback and further resources

Afternoon 14:30 – 17:00 [Coffee Break: 15:30 ‒ 16:00]

Sources of further support or training:


EpiDoc exercises

For all exercises, you are encouraged to use your own texts from your project, or texts that you are interested in and know well.

Practice inscriptions

Simple inscriptions for exercises 1–2

Longer inscriptions for tagging/indexing

More challenging inscriptions for exercise 4

For further texts, you may copy texts and/or descriptive data from some of the following projects

Details of the daily exercises

Day 1: Encode object description. Take at least 5 inscriptions or papyri, create a copy of the EpiDoc Template (right-click on the link and "save link as…"), and encode the object description in EpiDoc.

Day 2: Encode text transcription features. Take at least 5 inscriptions or papyri (more if they are all very short), create a copy of the EpiDoc Template (right-click on the link and "save link as…"), and encode the Greek or Latin transcribed text in EpiDoc.

Day 3: Encode indexing features. Take the EpiDoc files you encoded in the first two exercises, and add encoding for names, places, and any other features of the text or description that would be useful to index. Consider what normalization or authority list information would be useful for this indexing.

Day 4: Encode editorial corrections and critical apparatus. Take either the texts you used in exercises 1–3, or some of the more advanced texts from the list, and encode editorial corrections and other features that would be useful to see represented in an apparatus criticus of the epigraphic edition.

Day 5: Display EpiDoc files in EFES. Set up EFES according the the Installation Guide and copy your EpiDoc files from examples 1–4 into the folder /webapps/ROOT/content/xml/epidoc/. Index the platform, and look at your inscriptions in the table of contents. Does this help you spot any errors in your encoding, or features you would like to see displayed differently by the EpiDoc Stylesheets?

Downloads

Files to download and copy (right-click on the link and "save link as…"):

NB1: make a copy of the template under a new name (which should not include any spaces) before editing it, so you can have a new copy for each EpiDoc text you edit.

NB2: do not copy the schema file (tei-epidoc.rng) into the EpiDoc folder in EFES, or the programme will not be able to harvest and index properly.