Newer
Older
<?xml version='1.0' encoding='UTF-8'?>
<?xml-model href="../Schema/tei_lite_ONB-DE.rng" type="application/xml" schematypens="http://relaxng.org/ns/structure/1.0"?><TEI xmlns="http://www.tei-c.org/ns/1.0" xml:id="aok_RED_Documentation">
<teiHeader>
<fileDesc>
<titleStmt>
<title>Technische Dokumentation zur Digitalen Edition der Tagebücher aus dem Nachlass
von Andreas Okopenko</title>
<author>
<persName xml:id="CS" ref="https://orcid.org/0000-0002-3651-8114">
<surname>Steindl</surname>
<forename>Christoph</forename>
</persName>
<persName xml:id="CF" ref="https://orcid.org/0000-0001-5099-8970">
<surname>Fritze</surname>
<forename>Christiane</forename>
</persName>
</author>
<funder xml:id="FWF" ref="http://d-nb.info/gnd/2054142-9"><name type="org">Fonds zur
Förderung der wissenschaftlichen Forschung</name>
<abbr>FWF</abbr>
<idno xml:id="p28344">P 28344 Einzelprojekte</idno>
</funder>
<principal>
<persName ref="https://orcid.org/0000-0003-2197-1706"><surname>Innerhofer</surname><forename>Roland</forename></persName>
</editionStmt>
<publicationStmt>
<publisher>
<orgName>
<ref target="http://www.onb.ac.at">Austrian National Library</ref>
</orgName>
<address>
<street>Josefsplatz 1</street>
<postCode>1015</postCode>
<settlement>Vienna</settlement>
<country>Austria</country>
</address>
</publisher>
<pubPlace ref="http://www.geonames.org/2761369/">Vienna</pubPlace>
<date type="last-changed" when-iso="2019-11-21">21.11.2019</date>
<availability>
<licence target="https://creativecommons.org/licenses/by-sa/4.0/">
<p>Distributed under the Creative Commons Attribution-ShareAlike 4.0 International
license (CC BY-SA 4.0)</p>
</licence>
</availability>
<idno type="PID">o:oko.documentation</idno>
</publicationStmt>
<sourceDesc>
<p>Born digital.</p>
</sourceDesc>
</fileDesc>
</teiHeader>
<text>
<body>
<div>
<head rend="h1">Technische Dokumentation</head>
<div>
<head rend="h2">Architektur</head>
<p>Die digitale Edition der Tagebücher von Andreas Okopenko wurde mit dem <ref target="http://gams.uni-graz.at/">Geisteswissenschaftlichen Asset Management
System</ref> (GAMS), das am <ref target="https://informationsmodellierung.uni-graz.at/de/">Zentrum für
Informationsmodellierung - Austrian Centre for Digital Humanities</ref>
(GZIM-ACDH) entwickelt wurde, umgesetzt. An der Österreichischen Nationalbibiothek
ist eine eigene Instanz der GAMS aufgesetzt. Die für diese Edition verwendeten
Kernkomponenten sind das <ref target="https://duraspace.org/fedora/">Fedora
Commons Repository</ref> und der Cirilo Client zur Verwaltung der
TEI-XML-Daten.</p>
<p>Die Rohdaten werden mittels XSL-Transformationen als HTML für den Browser
aufbereitet. Die einzelnen Transformationen bilden die unterschiedlichen
Dokumenttypen ab. Es wird in der digitalen Edition nach den Typen Startseite,
redaktionelle Texte, synoptische Darstellung/Transkription, Register und
Bibliographie unterschieden.</p>
<p>Statische Inhalte (CSS, JS, Logos, XSLT, etc.) werden nicht in das Repository
eingespielt sondern über einen Webserver statisch ausgeliefert.</p>
<p>Der Großteil der Bilder wird über einen IIIF-Server (<ref target="https://github.com/loris-imageserver/loris">Loris</ref>) ausgeliefert
und so in die online Präsentation eingebunden. Dies ermöglicht einerseits eine
optimale und zoombare Anzeige der Digitalisate in der synoptischen Ansicht,
andererseits ein Bereitstellen der Bilder in der optimalen Größe für kleine
Displaygrößen (responsive Design)</p>
</div>
<div>
<head rend="h2">Design</head>
<p>Die online Präsentation basiert auf dem generischen Design, das für alle digitalen
Editionen an der Österreichischen Nationalbibliothek entwickelt wurde. Das Design
der online Präsentation hat die Agentur <ref target="https://www.polarfux.com/">Polarfux</ref> gestaltet.</p>
<p>Für das Design wurde das Toolkit von Bootstrap verwendet. Dadurch gelingt eine
bestmögliche Darstellung der Inhalte auch auf Displays mit kleiner Bilddiagonale.
Für die Fälle von redaktionellen Inhalten und Registern wird das 12-spaltige Grid
dahingehend aufgeteilt, dass ¾ der Seite mit Inhalten und 1/3 mit Navigation
bespielt werden. Für kleinere Displays werden Navigation und Inhalt nacheinander
angezeigt. Auf der Startseite und der Bibliographie gibt es nur eine breite
Spalte. In der synoptischen Ansicht werden zwei Spalten verwendet, die die gesamte
Bildschirmbreite ausfüllen. Hier wird eine der beiden Spalten ausgeblendet, sobald
die Displaybreite kleiner wird.</p>
<p>Weiters wurden vor allem die folgenden Komponenten aus Bootstrap verwendet:
Navigationen, Cards, Popover, Bilderkarussell.</p>
<p><ref target="https://feathericons.com/">Feather icons</ref> dient als Bibliothek
für die Icons. Für die Darstellung der Bibliographie wird eine <ref target="https://datatables.net/">Datatable</ref> verwendet und die Anzeige der
Landkarte ist mit <ref target="https://leafletjs.com/">Leaflet</ref> und <ref target="https://www.openstreetmap.org">OpenStreetMap</ref> umgesetzt. Die
Visualisierung der Objektgalerie auf der Startseite basiert auf dem <ref target="https://nickpiscitelli.github.io/Glider.js/">glider.js-Framework</ref>.</p>
<p>Für Farbgestaltung und die Entwicklung der Stylesheets werden die von Bootstrap
zur Verfügung gestellten scss-Dateien angepasst beziehungsweise erweitert.
Zusätzlich gibt es für jedes Projekt in der Infrastruktur für Digitale Editionen
auch projektspezifische Stylesheets, die beim Kompilieren berücksichtigt werden.
Die Farbgestaltung ist von einer Primär- und einer Sekundärfarbe geprägt, die sich
bei den Editionsprojekten unterscheiden. Das Farblayout und Logo sind für
Editionen an der Österreichischen Nationalbibliothek so gehalten, dass sie
generisch nur durch Ändern des Textes und der Farben wiederverwendet werden
können.</p>
</div>
<div>
<head rend="h2">XML</head>
<p>Die gesamte digitale Edition ist in TEI-XML in der Fassung P5 umgesetzt, wobei
zwei unterschiedliche Schemata (redaktionelle Inhalte und Schema für editorische
Inhalte) verwendet werden. Die Codierungsrichtlinien finden sich in der Schemaspezifikation (<ref target="https://edition.onb.ac.at/fedora/objects/o:oko.odd/datastreams/TEI_SOURCE/content">ODD</ref>) des Projekts.</p>
<p>Zur weiteren Bearbeitung sind die einzelnen XML-Dokumente miteinander über <hi rend="italic">xi:include</hi>-Anweisungen verknüpft. So werden dem
Hauptdokument der Transkription alle Register und der Stellenkommentar angefügt.
Die redaktionellen Texte verbleiben eigenständig.</p>
</div>
<div>
<head rend="h2">Digitalisate</head>
<p>Die gesamten Digitalisate des Inventars wurden durch das Projektteam durchgeführt.
Für die digitale Edition wurden die Digitalisate auf eine Maximalbreite oder -höhe
von 3000px skaliert. Die Dateien werden als JPG über einen IIIF-Server (vgl. <ref target="https://iiif.io/">IIIF</ref>, <ref target="https://github.com/loris-imageserver/loris">Loris</ref>)
bereitgestellt, wobei sich der der IIIF-Support nur auf die <ref target="https://iiif.io/api/image/2.1/">Image API</ref> beschränkt.</p>