Technik, Tools, Nachnutzbarkeit

Kodierung

Die Transkription der Handschriften im XML-Format TEI P5 folgt in großen Teilen dem Basisformat des Deutschen Textarchivs (DTABf). Neben den Metadaten im Kopf – <teiHeader> – werden im Textbereich – <text> – folgende Elemente benutzt:

Darstellung von Textphänomenen

Handschriftenspezifische Phänomene

Allgemeine Formatierungen

Technische Implementation

Minimalistische Voraussetzungen

Der technische Ansatz der Präsentation der Edition und aller Begleittexte hat zum Ziel, mit möglichst wenig Voraussetzungen aus den vorhandenen XML-Daten eine komplett lauffähige Webseite zu erstellen, für deren Hosting kein weiterer Software-Stack (außer einem Webserver) nötig ist. Für das Erstellen der für die Tabellen und Aktenansichten nötigen Datenexzerpte sowie für die Generierung der HTML-Ansichten der einzelnen Dokumente und Begleittexte sind lediglich die beiden Tools jq und xsltproc Voraussetzung.

TEI-Transformation

Die Transformation der einzelnen Texte aus XML in eine HTML-Ansicht mithilfe von XSLT 1.0 erfolgt vollständig über die Konvertierung von XML-Elementen in das HTML-Element <span> mit entsprechenden @data-Attributen:

<!-- TEI text elements -->
<xsl:template match="/t:TEI/t:text//t:*">
  <span class="tei-{local-name(.)}">
    <xsl:call-template name="set-data-attributes"/>
    <xsl:apply-templates/>
  </span>
</xsl:template>

<!-- data attributes -->
<xsl:template name="set-data-attributes">
  <xsl:for-each select="@*">
    <xsl:call-template name="data-attribute">
      <xsl:with-param name="name" select="name(current())"/>
      <xsl:with-param name="value" select="current()"/>
    </xsl:call-template>
  </xsl:for-each>
</xsl:template>

<!-- single data attribute -->
<xsl:template name="data-attribute">
  <xsl:param name="name"/>
  <xsl:param name="value"/>
  <xsl:attribute name="data-{translate($name, ':', '-')}">
    <xsl:value-of select="$value"/>
  </xsl:attribute>
</xsl:template>

Die ausschließliche Verwendung von <span>-Elementen hat den positiven Nebeneffekt, dass stets valides HTML produziert wird. Die Gestaltung der einzelnen Textelemente wird mit wenigen Zeilen CSS realisiert. Besondere Effekte wie die Einbindung der Faksimilebilder und eine Verfeinerung der Textdarstellung v. a. bzgl. rechtsbündigem und zentriertem Text werden mit Javascript umgesetzt. Dabei ist der gesamte Quellcode dieser Webseite öffentlich und kann für ähnlich ansetzende Projekte unter der Lizenz CC BY-SA 4.0 nachgenutzt werden.

Die Auslieferung der generierten Webseite benötigt nur einen Webserver. Alle für den Betrieb nötigen Dateien, Schriften und Bibliotheken werden im Paket mitgeliefert, aufwendige Rechenzeit für Server entfällt. Damit folgt das Projekt den Zielen der Digital Humanities Climate Coalition für einen nachhaltigeren und bewussteren Umgang mit den begrenzten Ressourcen aus Sicht der Digital Humanities.

Nachnutzung

Alle Textquellen im XML-Format TEI P5 sowie der Quellcode zur Erstellung dieser Webseite sind unter Beachtung der Lizenz Namensnennung – Weitergabe unter gleichen Bedingungen 4.0 International (CC BY-SA 4.0) verfügbar:

• Daten im Repositorium auf GitHub
• Download des Repositoriums von GitHub