Schlagwort-Archive: DHd

How to build a digital edition web app

Beitrag von Peter Andorfer (ACDH), Dario Kampkaspar (HAB) und Timo Steyer (MWW)

Aufgrund zahlreicher Sommer-Schulen, Workshops, DH-Studiengänge und vielfältiger online Tutorials stellt die Kodierung eines Textes in XML nach dem de facto-Standard TEI für viele GeisteswissenschaftlerInnen mittlerweile eine gut zu bewältigende Herausforderung dar. Anders formuliert: Digitale Editionen haben die Wild-West-Phase hinter sich und bieten dem Forscher ein methodisch und theoretisch sicheres Terrain. Was jedoch häufig fehlt sind einstiegsfreundliche Anleitungen, Tutorials, HowTos zu dem sich an die Kodierung anschließenden Themenkomplex der Publikation einer digitalen Edition. Die Frage nach dem »Wohin?« der oftmals in langer und mühsamer Arbeit erstellten Editionen betrifft vor allem jene Forschende, welche nicht Teil eines größer angelegten Projektes sind oder auch sonst über keine allzu starke Anbindung an eine gut institutionalisierte Forschungsinfrastruktur verfügen. Zwar entwickeln zunehmend mehr Institutionen, vielfach durch Drittmittelprojekte, Kompetenzen, Workflows und (technische) Infrastrukturen zur Veröffentlichung Digitaler Editionen, aufgrund chronisch knapper Finanzierungen können oftmals aber nur wenige und in erster Linie nur eigene/interne Projekte hinreichend betreut werden.

Gleichzeitig kann in vielen Digitalen Editionsprojekten eine sehr starre Arbeitsteilung zwischen so genannten FachwissenschlafterInnen und TechnikerInnen beobachtet werden. Obwohl es sicherlich nicht als Nachteil bewertet werden kann, wenn jeder das tut, wofür er ausgebildet wurde und was sie bzw. er demzufolge auch gut kann, so besteht in einem stark arbeitsteiligen Umfeld die Gefahr asymmetrischer Kompetenzverhältnisse und daraus resultierender Abhängigkeiten. Sei es durch unrealistische Wünsche seitens der Fachwissenschaft, die aufgrund mangelnder technischer Kenntnisse an die Technik herangetragen werden. Oder sei es die Verzögerung des Arbeitfortschritts aufgrund schleppender Implementierung basaler Technologien oder von editorischer Seite dringend benötigter Funktionalitäten.

Dies ist aber nur die eine Seite der Medaille, denn es gibt nach wie vor infrastrukturelle Fallstricke bei der Erstellung von digitalen Editionen. Viele Editionsprojekte beginnen ohne eine entsprechende Infrastruktur für die spätere Präsentation der Texte, andere Editionstexte entstehen als „Nebenprodukt“ eines wissenschaftlichen Forschungsvorhaben und werden nie publiziert, da eine wissenschaftliche out-of-the-box Präsentationslösung fehlt. Es fehlt sichtbar an einer einfachen Lösung für Editionsvorhaben ihre Texte in einer Infrastruktur zu publizieren bzw. zu erproben, die noch keine institutionelle Anbindung mit einem festen „Layout- und Funktionskorsett“ hat und den Editoren so noch den weitreichenden experimentellen Freiraum lässt, um die für die Editionsvorhaben notwendigen Präsentationsmodi zu identifizieren.

Dieser Problematik widmete sich der von Peter Andorfer (ÖAW/ACDH), Dario Kampaskar (HAB) und Timo Steyer (MWW/HAB) konzipierte Workshop mit dem Titel „How to build a digital edition web app“ auf der diesjährigen Tagung des DHd-Vereins in der Schweizer Bundeshauptstadt Bern. Auf der Basis der XML-Datenbank eXist-DB wurde gemeinsam mit den Workshopteilnehmern eine Präsentationsoberfläche am Beispiel der Korrespondenz von Leo Thun-Hohenstein erstellt. Für die Verwendung der XML-Datenbank eXist-db spricht ihr Open-Source-Charakter, die verbreitete Nutzung im digitalen Editionskontext und die Möglichkeit weitere Funktionsweisen durch Zusatzprogramme hinzuzufügen. Die Nachteile von eXist liegen in der relativ kleinen Community und der für viele Anwendungsbereiche noch nicht existierenden detaillierten Dokumentation.

Beginn des Workshops auf der Dhd17 in Bern. Bild des Tweets von Stefan Münnich (@music_enfanthen):”Workshop #w6 how to build your own digital web app with @csae8092 @steyer_ti & kampkaspar about to start #dhd2017″. https://twitter.com/music_enfanthen/status/831406933852684288 (20.02.2017)

Eine ›Digital Edition Web-App‹ sollte ganz generell die kodierten Texte in einer möglichst benutzerfreundlichen Art und Weise präsentieren und den »technischen Unterbau« dem Benutzer nicht aufbürden, wohl aber die computergestützte Weiterverarbeitung der Texte jederzeit ermöglichen. Konkreter formuliert heißt das, dass eine solche Anwendung  folgende Anforderungen zu erfüllen hat.

NutzerInnen sollen auf einer zentralen Einstiegsseite einen möglichst vollständigen Überblick über den kompletten Umfang der Edition erhalten. Dies ist insbesondere dann von großer Bedeutung, wenn die Edition aus mehreren Editionseinheiten besteht, wie zum Beispiel im Falle eines Briefwechsels.

In der im Zuge des Workshops zu entwickelnden Applikation wird das in Form einer ListView gelöst, welche sämtliche XML/TEI Dokumente bzw. ausgewählte Informationen aus dem teiHeader in einer von den NutzerInnen such-, filter- und sortierbaren Ansicht präsentiert. Von diesem Inhaltsverzeichnis gelangen die NutzerInnen dann über Verlinkung zu den einzelnen Dokumenten.

Da Digitale Editionen im www verfügbar sind, muss davon ausgegangen werden, dass diese generell in digitaler Form, sprich auf einem PC, Notebook, Tablet, eventuell auch auf einem Smartphone gelesen werden. Insofern gilt es, den kodierten Text in einer leserfreundlichen Darstellung anzuzeigen, die die verschiedenen Formate der Anzeigegeräte berücksichtigt (womit einige der Grundlagen des sog. ›responsive design‹ berücksichtigt werden müssen). Andererseits darf aber der Wunsch vieler Nutzer, die Inhalte »klassisch« auf Papier zu nutzen, nicht vergessen werden.

Die digitalen Darstellung im Web eröffnet indes auch die Möglichkeit für dynamische, sprich von den Nutzer/innen frei konfigurierbare, Darstellungsweisen. Abhängig vom konkreten Mark-Up können, um nur ein paar Beispiele zu nennen, etwa Anmerkungen ein- oder ausgeblendet, Abkürzungen aufgelöst, oder Korrekturschritte ausgeblendet werden.

In der ›Digital Edition Web-App‹ wird mittels XSLT Transformation aus den XML Dateien eine HTML Dokument ›on the fly‹ generiert. Diese ›DetailView‹ verfügt, sofern aufgrund des Markups des Ausgangsdokumentes möglich, über ein Navigationsmenü, welches eine rasche Orientierung im Text ermöglicht. Über ein weiteres Menü können außerdem verschiedene Darstellungsoptionen (de)aktiviert werden.

Die Möglichkeit, eine digitale Edition in ihrer Gesamtheit im Volltext durchsuchen zu können, wird häufig als einer der größten Vorzüge einer digitalen Edition beschrieben. Zusätzlich zu einer so genannten »einfachen Suche« wird darüber hinaus auch gerne eine »erweiterte Suche« angeboten, welche eine spezifizierte Suche wie zum Beispiel nur in Anmerkungen oder über  Metadaten ermöglicht.

Aufgrund der Integration der Volltext-Suchengine Lucene in die Datenbanksoftware eXist-db ist die Realisierung sowohl einer »einfachen« wie auch einer »erweiterten« Suche im Rahmen der ›Digital Edition Web-App‹ einfach zu bewerkstelligen, wobei die Spezifika der »erweiterten« Suche vom konkreten Markup der einzelnen Editionen abhängt.

Neben einer Volltextsuche bieten viele digitale Editionen auch eine registerbasierte Suche an, mit deren Hilfe etwa gezielt Personen oder Orte in der Edition identifiziert werden können.

Je nach Art der Daten wird ein solches Register auf verschiedene Weisen demonstriert werden. Da die Texte in einer (einigermaßen) standardisierten Art und Weise kodiert sind, können diese auch maschinell prozessiert werden. Dafür ist es notwendig, dass nicht nur eine HTML Darstellung der Daten veröffentlicht wird, sondern auch die eigentlichen XML/TEI-Daten.

Die ›Digital Edition Web-App‹ wird ihre Daten über die in der eXist-db integrierte ›REST-Style Web API‹ veröffentlichen.

Es würde hier zu weit führen, einen vollständigen Abriss des Workshops zu geben, dies ist aber auch gar nicht nötig, da die einzelnen Bestandteile des Workshop inkl. Code- und Datenbeispiele hier zu finden sind:

https://howto.acdh.oeaw.ac.at/blog/books/how-to-build-a-digital-edition-web-app

Peter Andorfer und Dario Kampkaspar: Time to set you free. Posterbeitrag auf der TEI-Konferenz 2016. https://howto.acdh.oeaw.ac.at/blog/books/how-to-build-a-digital-edition-web-app/ (4.3.2017)

Es kann also jeder den Workshop nachvollziehen und seine eigene Umgebung für Editionstexte aufbauen. Der Workshop zeigte von Beginn an, wie eXist-db eingerichtet wird, wie die Texte in die Datenbank gelangen, wie eine auf Bootstrap basierende Präsentationsoberfläche gebaut wird. Darauf aufbauend lernten die Workshopteilnehmer die Erstellung von automatisiert erstellten Register, die Erstellung einer Volltextsuche und von Inhaltsverzeichnisse. Die in XML in die Datenbank geladende Texte werden über XLST-Skripte dynamisch in eine HTML-Ausgabe transformiert.

Gelobt wurde die Gestaltung eines Workshops verbunden mit einer Dokumentation, die es den Teilnehmern erlaubt auch nach der Konferenz noch alles nachzunutzen – ganz im Sinne des Tagungsmotto: Nachhaltigkeit.

Weiterführende Links: “set you free”: 

https://howto.acdh.oeaw.ac.at/blog/books/how-to-build-a-digital-edition-web-app/

Zitierempfehlung: Peter Andorfer / Dario Kampkaspar / Timo Steyer: How to build a digital edition web app. In: Ex officina Seleni: aus der Werkstatt der Herzog August Bibliothek Wolfenbüttel. Blog der Arbeitsgemeinschaft Digitale Editionen. 13. März 2017. https://eos.hypotheses.org/151.