Your browser doesn't support the features required by impress.mod.js, so you are presented with a simplified version of this presentation.

For the best experience please use the latest Chrome, Safari or Firefox browser.

4. April 2017 | ADWL Mainz

workshop: EpiDoc

EpiDoc: TEI XML

Ein Auszeichnungsstandard für epigraphische Daten und historische Quellen

Slides: https://digicademy.github.io/2017-EpiDoc-WS

Max Grüntgens | Dominik Kasper | Thomas Kollatz
@digicademy | Twitter digicademy | CC-BY 4.0

Gliederung

  1. Grundlagen
    • XML
    • TEI
    • SIG
    • EpiDoc
  2. EpiDoc TEI XML Struktur
    • Processing Instructions
    • teiHeader
      • <fileDesc>
        • <titleStmt>
        • <publicationStmt>
        • <sourceDesc>
    • facsimile <graphic>
    • text
      • Leidener Klammerung
      • <div @type=edition | apparatus | translation |commentary | bibliography>
  3. Praxisteil
  4. Transformation
  5. Literatur

01

Grundlagen

XML – Extensible Markup Language

Semantic statt Typographie

  • device-independent and system-independent storing and processing of texts in electronic form
  • interchange and communication format
Generalizing from that sense, we define markup, or (synonymously) encoding, as any means of making explicit an interpretation of a text.

aus: A Gentle Introduction to XML

TEI: Text Encoding Initiative

The Text Encoding Initiative (TEI) is a consortium which collectively develops and maintains a standard for the representation of texts in digital form. Its chief deliverable is a set of Guidelines which specify encoding methods for machine-readable texts, chiefly in the humanities, social sciences and linguistics.

aus: http://www.tei-c.org

Special Interest Groups

Quelle: http://www.tei-c.org/Activities/SIG/

EpiDoc

Epigraphic Documents in TEI XML | text markup for ancient documents

EpiDoc is an international, collaborative effort that provides guidelines and tools for encoding scholarly and educational editions of ancient documents. It uses a subset of the Text Encoding Initiative's standard for the representation of texts in digital form and was developed initially for the publication of digital editions of ancient inscriptions (e.g. Inscriptions of Aphrodisias, Vindolanda Tablets). Its domain has expanded to include the publication of papyri and manuscripts (e.g. Papyri.info). It addresses not only the transcription and editorial treatment of texts themselves, but also the history and materiality of the objects on which the texts appear (i.e., manuscripts, monuments, tablets, papyri, and other text-bearing objects).

Quelle: https://sourceforge.net/p/epidoc/wiki/Home/

EpiDoc

Entwicklungsgeschichte – in Kürze

  • Subset der TEI
  • seit 1999 kollaborativ entwickelt
  • im März 2017 Release von Schema und Guidelines Version 8.23
  • Mittlerweile wird das TEI subset EpiDoc von zahlreichen – zunehmend auch nicht primär epigraphischen –  Projekten verwendet
  • mehr zur Geschichte https://sourceforge.net/p/epidoc/wiki/About/

Beispiele

Quelle: http://wiki.digitalclassicist.org/Category:EpiDoc

02

EpiDoc TEI XML Struktur

Ein paar Grundregeln

EpiDoc ist – wie die TEI – ein Vorschlag. Das "P" hinter TEI steht für proposal. TEI ist kein Zwangskorsett.
Nur Elemente und Attribute nutzen, die für das Verständnis der Quelle nötig und nützlich sind. (Das heisst: Nicht alles, was ausgezeichnet werden könnte, muss auch ausgezeichnet werden).
Sinnvoller Einsatz von TEI setzt ein Konzept voraus (Editionsrichtlinien, Fragestellung, etc.).
EpiDoc Schema und Struktur ermöglichen geführte, regelbasierte Erfassung von (historischen) Texten.
EpiDoc TEI XML nicht (auswendig) lernen! Das dahinterliegende Schema ist selbsterklärend …

Processing Instructions

Schemavalidierung

<? … ?>

<?xml version="1.0" encoding="UTF-8"?>
<?xml-model href="http://www.stoa.org/epidoc/schema/latest/tei-epidoc.rng"
    schematypens="http://relaxng.org/ns/structure/1.0"?>
<?xml-model href="http://www.stoa.org/epidoc/schema/latest/tei-epidoc.rng"
    schematypens="http://purl.oclc.org/dsdl/schematron"?>
/schema/latest – validiert gegen das aktuellste Schema
/schema/8.23 – validiert gegen das versionierte Schema (Release)

Struktur

Metadaten – Bilddaten – Textdaten

<TEI xmlns="http://www.tei-c.org/ns/1.0" xml:space="preserve" xml:lang="en">
   <teiHeader>
     <!-- Metadaten -->
   </teiHeader>

   <facsimile>
      <!-- Informationen zu Bilddaten-->
   </facsimile>

   <text>
       <!-- Textdaten: Edition, Kommentar, Übersetzung, etc. -->
   </text>
</TEI>

Metadaten

<teiHeader> – Pflichtelemente

<teiHeader>
   <fileDesc>             <!-- mögl. vollständige Beschreibung der Datei -->
        <titleStmt>       <!-- Titel -->
        <publicationStmt> <!-- Herausgeber -->
        <sourceDesc>      <!-- Beschreibung der Quelle -->
   </fileDesc>
</teiHeader>

Die Section <sourceDesc> bietet zahlreiche struktierende Elemente zur Beschreibung der Quelle.
  • <msIdentifier>
  • <physDesc>
  • <history>
Hinweis <msDesc> gilt nicht nur für Handschriften, sondern für jedes other text-bearing object

Metadaten

<teiHeader> – Optionale Elemente

Bilddaten

Bilddateien und andere digitale Faksimiles werden – so möglich mit @url – in der Faksimile-Section aufgeführt.

Textdaten – Edition

Textauszeichnung

  • Philologie und historische Wissenschaften nutzen zur Kennzeichnung textueller Phänomene ausgeklügelte und bewährte Klammersysteme. In der Regel werden durch runde, eckige, geschweifte Klammern, sowie durch hoch- und tiefgestellte Zeichen (Punkte, Striche) über, unter oder neben den Buchstaben bzw. Wörtern und Sätzen auf Probleme und Besonderheiten der Textüberlieferung hingewiesen.
  • EpiDoc hat diese Notation der Fachwissenschaftler in TEI übertragen. Hinweis: Die Textauszeichnung mit EpiDoc TEI XML ermöglicht die Gewissheit (@cert | @confidence) und die Begründung (@reason) einer textkritischen Entscheidung festzuhalten !

Leidener Klammersystem

Textauszeichnung

03

Praxisteil

Learning by Doing

Übertragen Sie mit Hilfe der EpiDoc Template Datei unter Zuhilfenahme der EpiDoc Guidelines das Fallbeispiel in ein valides EpiDoc: TEI XML Dokument !

Materialien

  1. EpiDoc-Template ex-epidoctemplate.xml herunterladen Optionen:
  2. EpiDoc Cheatsheet zur Struktur herunterladen
  3. Materialien zur Musterinschrift herunterladen:

Musterinschrift

Quelle: DIO 34, 561

Musterlösung

Einen Lösungsvorschlag zur EpiDoc TEI konformen Auszeichnung der Musterinschrift finden Sie in der Datei DIO_34_561_20170321.xml.

04

Transformation

Transformationen

Von EpiDoc TEI XML nach HTML

EpiDoc Converter API (Deutsches Archäologisches Institut)

05

Literatur

Literatur

EpiDoc

Digitale Epigraphik

TEI

Download