Dieses Repository beinhaltet die Quellenstücke für Projekt „Zürcher Rechtsquellen“. Die TEI-Publisher Webapplikation, mit der die Quellenstücke angezeigt werden, befindet sich hier: https://github.com/stazh/qzh
Die Quellenstücke (TEI-XMLs) befinden sich im Verzeichnis /quellenstuecke. Quellenstücke, die in diesen Ordner abgelegt werden, werden durch die Webapplikation automatisch erfasst.
Mit einem GIT-Client können die Quellenstücke bearbeitet, gelöscht oder ergänzt werden. Eine Einführung in das Thema GIT befindet sich hier: https://www.youtube.com/watch?v=dyY539HzN6Q (Minute 0 bis Minute 39)
Minimale Anpassungen an den Quellenstücken können auch direkt über die GitHub Webseite vorgenommen werden:
Für grössere Änderungen empfiehlt sich jedoch stark die Verwendung eines GIT-Clients (zum Beispiel Sourcetree oder GitHub Desktop).
Eine konkrete Anleitung zum Anlegen eines Accounts bei GitHub und zum Verbinden mit dem Git-Client (SourceTree, GitHub Desktop) befindet sich hier: https://github.com/stazh/qzh/blob/master/documentation/Arbeiten_mit_TEI_Publisher_GIT_Workflow/index.md. Für die Pflege der Quellenstücke müssen nur die Schritte 3, 4, 5, 11 und 12 beachtet werden. Die restlichen Schritte werden nur dann benötigt, wenn man Änderungen am Quellcode der Webapplikation selbst vornehmen will. Für Änderungen an den Quellenstücken wird nicht zwingend eine lokale Installation der ExistDB benötigt. Eine lokale Installation der ExistDB hat jedoch den Vorteil, dass die Änderungen an den Quellenstücken auf dem lokalen ExistDB-Server getestet werden können.
Im Tag seriesStmt könnten Metadaten für das Quellenstück eingetragen werden. Hier ein Beispiel:
<teiHeader>
<fileDesc>
<titleStmt>
<respStmt>
<persName>Andrea Schmid-Kunz</persName>
<resp key="transcript"/>
</respStmt>
<respStmt>
<persName>Michael Schaffner</persName>
<resp key="tagging"/>
</respStmt>
</titleStmt>
<publicationStmt>
<date type="electronic" when="2021-05-01"/>
<date type="print" when="2018-12-31"/>
</publicationStmt>
<seriesStmt xml:id="ssrq-sds-fds">
<title>Gelebte Reformation. Zürich 1500-1800</title>
<link>https://www.zh.ch/de/direktion-der-justiz-und-des-innern/staatsarchiv.html</link>
<respStmt>
<persName>Francisca Loetz. Unter Mitarbeit von Wolfram Schneider-Lastin</persName>
<resp>Herausgeberschaft</resp>
</respStmt>
<idno>QZH_022</idno>
</seriesStmt>
...
</fileDesc>
</teiHeader>Diese Informationen werden im TEI-Publisher verwendet, um die Metadaten zum Quellenstück darzustellen:
Es ist zu beachten, dass der angegebene Text für den Tag <idno> mit dem Dateinamen der XML-Datei übereinstimmen muss. Die Datei quellenstücke/QZH_022.xml hat also den Tag <idno>QZH_022</idno>
Die Angabe eines Links unterhalb des Titels ist optional. Wird ein Link angegeben, so muss dieser mit https:// oder mit http:// beginnen.
Innerhalb der Metadaten gibt es einen Tag <msIdentifier> mit einem verschachtelten Tag idno. Der eingetragene Wert im Attribut „source“ beinhaltet die Institution, die für das Quellenstück verantwortlich ist. Im folgenden Beispiel ist dies die Institution „StAZH“.
<msIdentifier>
<idno source="https://suche.staatsarchiv.djiktzh.ch/detail.aspx?ID=4903814">StAZH A 61.5, Nr. 28</idno>
</msIdentifier>Anhand dieser Angabe wird in der TEI-Publisher Webapplikation die Liste der Filtermöglichkeiten automatisch generiert:
Es sind zwei Varianten vorgesehen, um Personen in den Quellenstücken zu kennzeichnen:
<persName>Heinrich Bullinger</persName>Dies ist die einfachste Variante, um eine Person auszuzeichnen. Im Gegensatz zum Rechtsquellenportal ist es nicht zwingend notwendig, dass jeder Person im Quellenstück eine eindeutige Referenz zugeordnet wird. Somit entfällt der Aufwand, bei jeder Person zu prüfen, ob diese bereits in anderen Quellenstücken erwähnt wurde und ob es sich bei identischen Namen tatsächlich auch um dieselbe Person handelt.
In der Personenübersicht werden Personen, die auf diese Art ausgezeichnet worden sind, als einzelne Einträge dargestellt. So ist es wahrscheinlich, dass in der Liste mehrmals der gleiche Name erscheint (da nicht ausgeschlossen werden kann, dass es sich bei mehreren Erwähnungen des gleichen Namens in einem Quellenstück oder mehreren Quellenstücken um die gleiche Person handelt).
Zusätzlich werden für diese Personen ohne Identifier in der Personenübersicht der Name des Quellenstücks sowie das Jahr des Quellenstücks angeben:
Auf diese Weise können sich die Besucherinnen und Besucher der Webseite selbst einen Eindruck davon machen, ob es sich bei mehreren Namenseinträgen um die gleiche Person handelt.
Bei der Jahresangabe sollte beachtet werden, dass sich diese auf das Quellenstück bezieht und somit nicht das Geburtsjahr der erwähnten Person darstellt. Das angezeigte Jahr dient zur ungefähren zeitlichen Einordnung. Wo vorhanden, wird das Jahr angezeigt, in dem das Quellenstück verfasst wurde. Ist dieses Datum nicht in den Metadaten des Quellenstücks vorhanden, kann alternativ auch das Erstelldatum der Abschrift angezeigt werden.
Innerhalb des Quellenstücks werden gekennzeichnete Personen farblich hervorgehoben:
Wird kein eindeutiger Identifier angegeben, wird bei einem Klick auf den Personennamen im Quellenstück die Personensuche angezeigt und automatisch der erste Buchstabe der angeklickten Person ausgewählt:
Auf diese Weise hat die Benutzerin oder der Benutzer die Möglichkeit, andere Vorkommen des gleichen Namens zu finden.
Bekannte Personen können auch mit einem GND Identifier getaggt werden. Es handelt sich dabei um einen bestimmten Identifier, der auch von der Deutschen Nationalbibliothek verwendet wird.
<persName ref="GND_118517384">Heinrich Bullinger</persName>Hier ist zum Beispiel der Eintrag für Heinrich Bullinger mit der GND/NID „118517384“: https://portal.dnb.de/opac.htm?method=simpleSearch&cqlMode=true&query=nid%3D118517384
In den Quellenstücken wird jeweils vor die GND/NID das Prefix „GND_“ gestellt.
Durch das Tagging mit einer GND/NID hat man alle Vorteile der Variante 2 (gruppierte Darstellung von mehreren Personen und Schreibweisen sowie Auflistung der „Erwähnungen“ in den Quellenstücken).
Zusätzlich wird bei dieser Variante in der Detailansicht für eine Person ein Link in die GND-Datenbank angezeigt:
Es kann vorkommen, dass es weitere Schreibweisen für Personennamem gibt, ohne dass diese Schreibweise in einem Quellenstück erwähnt ist. In diesen Fall können zusätzliche Personennamen in die Datei person/person-additions.xml eingetragen werden. Hinweis: Ein Eintrag in diese Datei macht nur für Personen Sinn, die bereits unter einer anderen Schreibweise in einem oder mehreren Quellenstücken vorhanden sind und über einen Identifier verfügen.
Änderungen an dieser Datei werden nicht direkt auf der Webapplikation sichtbar. Zuerst muss dazu erneut die Übersicht mit allen Personen generiert werden (dort fliessen dann die Änderungen mitein).
Siehe Kapitel unterhalb: „Vor der Veröffentlichung von neuen Versionen: Übersicht der Personen und Orte generieren“
Es sind drei Varianten vorgesehen, um Orte in den Quellenstücken zu kennzeichnen:
<placeName>Zürich</placeName>Dies ist die einfachste Variante, um einen Ort auszuzeichnen. Im Gegensatz zum Rechtsquellenportal ist es nicht zwingend notwendig, dass jedem Ort im Quellenstück eine eindeutige Referenz zugeordnet wird. Somit entfällt der Aufwand, bei jedem Ort zu prüfen, ob dieser bereits in anderen Quellenstücken erwähnt wurde und ob es sich bei identischen Namen tatsächlich auch um denselben Ort handelt.
In der Ortsübersicht werden Orte, welche auf diese Weise ausgezeichnet worden sind, als einzelne Einträge dargestellt. So ist es wahrscheinlich, dass in der Liste mehrmals der gleiche Name erscheint (da nicht ausgeschlossen werden kann, dass es sich bei mehreren Erwähnungen des gleichen Namens in einem Quellenstück oder mehreren Quellenstücken um den gleichen Ort handelt):
Auf diese Weise können sich die Besucherinnen und Besucher der Webseite selbst einen Eindruck davon machen, ob es sich bei mehreren Einträgen um den gleichen Ort handelt.
Innerhalb des Quellenstücks werden gekennzeichnete Orte farblich hervorgehoben:
Wird kein eindeutiger Identifier angegeben, wird bei einem Klick auf den Ortsnamen in der Weboberfläche die Ortssuche angezeigt und automatisch der erste Buchstabe des angeklickten Ortes ausgewählt:
Auf diese Weise hat die Benutzerin oder der Benutzer die Möglichkeit, andere Vorkommen des gleichen Namens zu finden.
Orte können auch mit einem Koordinaten-Identifier getaggt werden. Dabei werden die beiden Koordinaten-Komponenten „Latitude“ und „Longitude“ im folgenden Format encodiert:
<placeName ref="LOC_47.37721420014591_8.527299029687203">Zürich<placeName>Damit das Tool erkennt, dass es sich um eine Koordinate handelt, wird das Previx „LOC_“ verwendet. Die beiden Koordinatenbestandteile sind mit einem Unterstrich (_) voneinander getrennt.
Durch das Tagging mit einer Koordinate hat man alle Vorteile der Variante 2 (gruppierte Darstellung von mehreren Orten und Schreibweisen sowie Auflistung der „Erwähnungen“ in den Quellenstücken).
Zusätzlich wird bei dieser Variante in der Detailansicht für den Ort eine Karte angezeigt:
Ausserdem erscheint in der Suche für Orte mit einer Koordinate ein Kartensymbol:
Es kann vorkommen, dass es weitere Schreibweisen für Ortsnamen gibt, ohne dass diese Schreibweise in einem Quellenstück erwähnt ist. In diesen Fall können zusätzliche Ortsnamen in die Datei place/place-additions.xml eingetragen werden. Hinweis: Ein Eintrag in diese Datei macht nur für Orte Sinn, die bereits unter einer anderen Schreibweise in einem oder mehreren Quellenstücken vorhanden sind und über einen Identifier verfügen.
Änderungen an dieser Datei werden nicht direkt auf der Webapplikation sichtbar. Zuerst muss dazu erneut die Übersicht mit allen Ort generiert werden (dort fliessen dann die Änderungen mitein).
Siehe Kapitel unterhalb: „Vor der Veröffentlichung von neuen Versionen: Übersicht der Personen und Orte generieren“
Schlagworte werden innerhalb der TEI-XML’s referenziert:
<!-- Auszug -->
<teiHeader>
<!-- ... -->
<profileDesc>
<textClass default="false">
<keywords scheme="http://www.ssrq-sds-fds.ch/taxonomie">
<term ref="key000325">Fremde</term>
<term ref="key000334">Gefängnis</term>
<term ref="key000670">Konfession</term>
<term ref="key005339">Konversion</term>
<term ref="key005473">Nachgang</term>
<term ref="key003408">Taufe</term>
</keywords>
</textClass>
</profileDesc>
</teiHeader>Die Definitionen werden zentral in der Datei taxonomy/taxonomy.xml abgelegt. Im Gegensatz zu person/person.xml und place/place.xml muss taxonomy/taxonomy.xml manuell gepflegt werden.
So sieht ein beispielhafter Eintrag im taxonomy/taxonomy.xml aus:
<!-- auszug -->
<category xml:id="key000325">
<desc xml:lang="deu">Fremder</desc>
<gloss>Person, die nicht dem eigenen Rechtskreis angehört und bei verminderter Rechtsfähigkeit Beschränkungen im Alltag und Erwerbsleben erfährt
</gloss>
</category>Diese Definitionen sind dafür verantwortlich, auf der Webapplikation die Übersicht mit den Stichworten anzuzeigen:
Ausserdem wird pro Quellenstück am rechten Bildschirmrand eine Liste mit Definitionen zum aktuellen Quellenstück angezeigt:
Die Webapplikation zeigt neben den Quellenstücken auch ein Register mit Orten, Personen und Schlagwörtern an.
Alle drei Register basieren jeweils auf einer .xml-Datei, welche die entsprechenden Registerdaten enthält: person/person.xml, place/place.xml, taxonomy/taxanomy.xml.
Vor der Veröffentlichung einer neuen Version der Webapplikation (genauer gesagt vor der Veröffentlichung von neuen Quellenstücken) müssen diese Dateien aktualisiert werden.
Die Datei taxanomy/taxanomy.xml enthält Stichworte und Definitionen und muss manuell gepflegt werden. Details sind im Kapitel oberhalb (Hinweise für das Tagging der Quellenstücke) beschrieben.
Die Datei person/person.xml enthält die benötigten Informationen für das Personenregister.
Die Datei kann automatisch aus den Quellenstücken generiert werden. Manuelle Korrekturen an der Datei sind zwar möglich, sind jedoch nicht empfohlen, da die Gefahr besteht, dass manuell eingetragene Änderungen beim nächsten Mal wieder gelöscht werden, sobald die Datei erneut automatisch generiert wird.
So sieht ein beispielhafter, generierter Personeneintrag aus:
<person xml:id="GND_118517384">
<persName type="full">Heinrich Bullinger, Bullingers, Bullinger
</persName>
</person>Bei Personen, die in den Quellenstücken keine explizite Referenz zugewiesen haben, wird automatisch ein Identifier generiert, der sich aus dem Quellenstück und der Stelle im Quellenstück zusammensetzt. Ausserdem wird automatisch die Quelle und das Datum der Quelle eingetragen. Diese Informationen werden ebenfalls im Register angezeigt (siehe Screenshot).
<person xml:id="QZH_016_10">
<persName type="full">Heinrich Buochman</persName>
<source>QZH_016</source>
<dateOfTheSource>1692</dateOfTheSource>
</person>Hinweise zum Taggen von Personen in den Quellenstücken sind weiter oben beschrieben.
Um die Datei person/person.xml zu generieren, wird eine lokale Installation der eXist-DB benötigt. Im Dashboard der eXist-DB kann eXide geöffnet werden:
Auf der linken Bildschirmseite wird die Datei-Hierarchie angezeigt. Hier navigiert man zum Skript, welches dafür zuständig ist, die Liste der Personen zu generieren:
/db/apps/qzh-data/script/generate-list-of-people.xml
Nach einem Klick auf „Eval“ wird die generierte XML-Datein mit den Personen am unteren Bildschirmrand ausgegeben:
Dieser ausgegebene Text sollte kopiert, und anschliessend in der Datei person/person.xml eingefügt werden:
Achtung: Nicht vergessen, die Änderungen wieder auf GitHub zu pushen.
Die Datei place/place.xml enthält die benötigten Informationen für das Ortsregister.
Die Datei kann automatisch aus den Quellenstücken generiert werden. Manuelle Korrekturen an der Datei sind zwar möglich, sind jedoch nicht empfohlen, da die Gefahr besteht, dass manuell eingetragene Änderungen beim nächsten Mal wieder gelöscht werden, sobald die Datei erneut automatisch generiert wird.
So sieht ein beispielhafter, generierter Ortseintrag aus:
<place xml:id="loc000065" n="Zürich">
<placeName type="main">Zürich</placeName>
</place>Bei Orten, die in den Quellenstücken keine explizite Referenz zugewiesen haben, wird automatisch ein Identifier generiert, der sich aus dem Quellenstück und der Stelle im Quellenstück zusammensetzt:
<place xml:id="QZH_016_33" n="Hirzel">
<placeName type="main">Hirzel</placeName>
</place>Bei Orten, die mit einem speziellen Koorindaten-Identifier gekennzeichnet sind, wird ausserdem die Koordinate in den Eintrag geschrieben:
<place xml:id="LOC_47.37721420014591_8.527299029687203" n="Zürich">
<placeName type="main">Zürich</placeName>
<location>
<geo>47.37721420014591 8.527299029687203</geo>
</location>
</place>Hinweise zum Taggen von Orten in den Quellenstücken sind weiter oben beschrieben.
Um die Datei place/place.xml zu generieren, wird eine lokale Installation der eXist-DB benötigt. Im Dashboard der eXist-DB kann eXide geöffnet werden:
Auf der linken Bildschirmseite wird die Datei-Hierarchie angezeigt. Hier navigiert man zum Skript, welches dafür zuständig ist, die Liste der Orten zu generieren:
/db/apps/qzh-data/script/generate-list-of-places.xml
Nach einem Klick auf „Eval“ wird die generierte Liste mit den Orten am unteren Bildschirmrand ausgegeben:
Dieser ausgegebene Text sollte kopiert, und anschliessend in der Datei place/place.xml eingefügt werden:
Achtung: Nicht vergessen, die Änderungen wieder auf GitHub zu pushen.
Der HTML-Code für das Literaturverzeichnis ist im Repository "code" mit dem Namen literaturverzeichnis.html abgelegt. Die XML-Version des Literaturverzeichnisses wird nicht mehr benötigt.