Files
lenz-briefe/OPUS.md
Simon Martens d7979d6285 Update OPUS.md
2024-07-07 02:04:29 +02:00

18 KiB

Kurzbeschriebung Opus

Dateien

Dateiname XML-Pfad(e) Zweck
Bibel-Kommentar.xml opus/kommentare/kommcat[@value='bibel'] Bibelstellenregister
briefe.xml opus/document/ Brieftexte
edits.xml opus/edits Texteingriffe
Maginal-Kommentar.xml opus/marginalien Stellenkommentar
meta.xml opus/descriptions Brief-Metadaten
references.xml opus/definitions Personen-, Orts- und Kategorien(?)verzeichnis
Register-Kommentar.xml opus/kommentare/kommcat[@value='neuzeit'] Personen- und Sachregister
traditions.xml opus/traditions Textprovinienz und -zusätze
forschung.xml opus/kommentare/kommcat[@value='forschung']
opus/kommentare/kommcat[@value='editionen']
opus/kommentare/kommcat[@value='nachschlagewerke']
Sekundärliteratur

Dateistruktur

Alle Dateien müssen mit dem XML-Prolog <?xml version="1.0" encoding="utf-8"?> beginnen. Weiter erkennt man Dateien, die zum Hamann-Projekt gehören, am ersten Tag, auch "Root" genannt:

<opus>          Root-Element für ein Hamann-Dokument
<data>          (nicht mehr benötigt) Zweites Element

Datei-spezifische Tags & Attribute

Die Tags kommentare, document, edits, marginalien, definitions, descriptions und traditions kennzeichnen die Kategorien Registerkommentare, Briefe, Texteingriffe, Marginalien, Verzeichnisse, Metadaten, und Daten zur Überlieferung. Hier sind Tags und Attribute dokumentiert, die aussschließlich als Kind-Elemente eines dieser Tags vorkommen und Sinn ergeben (kommcat kommt nur als Kind von kommentare infrage, isProofread nur in descriptions usw.).

kommentare

opus/kommentare/kommcat                                     Registereinträge
opus/kommentare/kommcat[@value]                             Identifiziert die Kategorie der Registereinträge eindeutig (Text)
opus/kommentare/kommcat[@sorting]                           Gibt die Reihenfolge der Kategorie in der Anzeige an (Nummer)
opus/kommentare/kommcat/kommentar                           Registereintrag
opus/kommentare/kommcat/kommentar[@id]                      Identifiziert den Registereitrag (Text). Wird zur Sortierung verwendet!
opus/kommentare/kommcat/kommentar[@type]                    Gibt die Kategorie eines Registereintrags an (Text)
opus/kommentare/kommcat/kommentar/lemma
opus/kommentare/kommcat/kommentar/subsection/lemma          Lemma eines Register(unter)eintrags
opus/kommentare/kommcat/kommentar/lemma/titel
opus/kommentare/kommcat/kommentar/subsection/lemma/titel    Titel eines Werkes
opus/kommentare/kommcat/kommentar/eintrag  
opus/kommentare/kommcat/kommentar/subsection/eintrag        Register(unter)eintrag

descriptions

opus/descriptions/letterDesc                                                Metadaten eines Briefes
opus/descriptions/letterDesc[@letter]                                       Identifiziert eine Brief eindeutig (Text)
opus/descriptions/letterDesc/date                                           Datum eines Briefes
opus/descriptions/letterDesc/date[@value]                                   Menschenlesbares Entstehungsdatum eines Briefes (Text)
opus/descriptions/letterDesc/sort                                           Maschinenlesbares Entstehungsdatum eines Briefes
opus/descriptions/letterDesc/sort[@value]                                   Maschinenlesbares Entstehungsdatum eines Briefes (ISO 8601 Datum)
opus/descriptions/letterDesc/sort[@notBefore]                               Datierung eines Briefes nach einem Datum (ISO 8601 Datum)
opus/descriptions/letterDesc/sort[@notAfter]                                Datierung eines Briefes vor einem Datum (ISO 8601 Datum)
opus/descriptions/letterDesc/sort[@from]                                    Beginn des Entstehungsdatums eines Briefes (ISO 8601 Datum)
opus/descriptions/letterDesc/sort[@to]                                      Ende des Entstehungsdatums eines Briefes (ISO 8601 Datum)
opus/descriptions/letterDesc/sort[@cert]                                    Angabe über die Zuverlässigkeit der Datierung low | high (Default)
opus/descriptions/letterDesc/location                                       Entstehungsort eines Briefes, wie er aus dem Text hervorgeht
opus/descriptions/letterDesc/location[@ref]                                 Verweis auf opus/definitions/locationDefs/locationDef[@index]
opus/descriptions/letterDesc/senders                                        Liste der Absender eines Briefes
opus/descriptions/letterDesc/senders/sender                                 Absender eines Briefes
opus/descriptions/letterDesc/senders/sender[@ref]                           Verweis auf opus/definitions/personDefs/personDef[@index]
opus/descriptions/letterDesc/receivers                                      Liste der Empfänger eines Briefes
opus/descriptions/letterDesc/receivers/receiver                             Empfänger eines Briefes
opus/descriptions/letterDesc/receivers/receiver[@ref]                       Verweis auf opus/definitions/personDefs/personDef[@index]
opus/descriptions/letterDesc/hasOriginal                                    Überlieferungsquelle: Original?
opus/descriptions/letterDesc/hasOriginal[@value]                            Überlieferungsquelle: Original true | false
opus/descriptions/letterDesc/isProofread                                    (abgekündigt) Status der kritischen Edition
opus/descriptions/letterDesc/isProofread[@value]                            (abgekündigt) Status der kritischen Edition true | false
opus/descriptions/letterDesc/isDraft                                        Status des Briefs: wurde der Brief abgeschickt?
opus/descriptions/letterDesc/isDraft[@value]                                Status des Briefs: Entwurf true | false
opus/descriptions/letterDesc/ZHInfo                                         Informationen zur Voredition von ZH
opus/descriptions/letterDesc/ZHInfo[@inZH]                                  Ob der Brief in ZH ediert wurde true | false
opus/descriptions/letterDesc/ZHInfo/dateChanged                             Ob sich die Datierung gegenüber der Edition ZH geändert hat
opus/descriptions/letterDesc/ZHInfo/dateChanged[@value]                     Ob sich die Datierung gegenüber der Edition ZH geändert hat true | false
opus/descriptions/letterDesc/ZHInfo/begin                                   Position des Briefs in ZH
opus/descriptions/letterDesc/ZHInfo/begin[@vol]                             Position des Briefes in ZH - Band (Nummer)
opus/descriptions/letterDesc/ZHInfo/begin[@page]                            Position des Briefes in ZH - Seite (Text)
opus/descriptions/letterDesc/ZHInfo/alternativeLineNumbering                Änderung der Zeilennummerierung gegnüber ZH
opus/descriptions/letterDesc/ZHInfo/alternativeLineNumbering[@value]        Änderung der Zeilennummerierung gegnüber ZH true | false

definitions

opus/definitions/structureDefs/*                                            Abgekündigt
opus/definitions/sourceDefs/*                                               Abgekündigt
opus/definitions/locationDefs/                                              Ortsverzeichnis
opus/definitions/locationDefs/locationDef                                   Ortsverzeichniseintrag
opus/definitions/locationDefs/locationDef[@index]                           Identifiziert einen Ortsverzeichniseintrag eindeutig (Zahl)
opus/definitions/locationDefs/locationDef[@name]                            Name des Ortes (jeder physische Ort kommt einmal vor)
opus/definitions/locationDefs/locationDef[@ref]                             GeoNames-URL (optional)
opus/definitions/personDefs/                                                Personenverzeichnis
opus/definitions/personDefs/personDef                                       Personenverzeichniseintrag
opus/definitions/personDefs/personDef[@index]                               Identifiziert einen Personenverzeichniseintrag eindeutig (Zahl)
opus/definitions/personDefs/personDef[@name]                                Name der Person (jede Person kommt einmal vor)
opus/definitions/personDefs/personDef[@vorname]                             Vorname der Person (unbenutzt)
opus/definitions/personDefs/personDef[@nachname]                            Nachname der Person (zur Sortierung, Pflichtfeld)
opus/definitions/personDefs/personDef[@ref]                                 GND-URL (optional)
opus/definitions/personDefs/personDef[@komm]                                ID des Registereintrags der Person (optional)
opus/definitions/handDefs/                                                  Dokumentation von Briefautorinnen (bald: abgekündigt)
opus/definitions/handDefs/handDef                                           Briefautor:in
opus/definitions/handDefs/handDef[@index]                                   Identifiziert eine:n Briefautor:in eindeutig (Zahl)
opus/definitions/handDefs/handDef[@name]                                    Personenname
opus/definitions/appDefs/                                                   Liste von Apperaten, in tradition.xml referenziert
opus/definitions/appDefs/appDef                                             Apparat
opus/definitions/appDefs/appDef[@index]                                     Identifiziert einen Apparat eindeutig (Zahl)
opus/definitions/appDefs/appDef[@name]                                      Name des Apparats
opus/definitions/appDefs/appDef[@category]                                  Kategorie des Apparats zur Gruppierung

edits

opus/edits/                                                                 Verzeichnis von Texteingriffen (haupsächlich Korrekturen ggü. ZH)
opus/edits/editreason                                                       Texteingriff, Editorischer Kommentar zu einer Textstelle
opus/edits/editreason[@id]                                                  Identifiziert den Texteingriff eindeutig (Nummer)
opus/edits/editreason/zh                                                    Textstelle, wie sie in ZH steht

traditions

opus/traditions/                                                            Verzeichnis von Textprovinienzen, -zusätzen & -apparaten
opus/traditions/letterTradition                                             Textprovinienz, -zusatz oder -apparat
opus/traditions/letterTradition[@letter]                                    Verweis auf den zugehörigen Brief (Text)
opus/traditions/letterTradition/app                                         Apparat
opus/traditions/letterTradition/app[@ref]                                   Verweis auf opus/definitions/appDefs/appDef[@index]
opus/traditions/letterTradition/app/ZHText                                  Zusätzliches, zeilengenaues Textmaterial
opus/traditions/letterTradition/app/ZHText/edit                             Texteingriff, Verweis auf opus/edits/editreason[@id]
opus/traditions/letterTradition/app/text                                    Textmaterial, nicht zeilengenau (Übersetzungen etc.)

marginalien

opus/marginalien/                                                           Verzeichnis von Marginalien
opus/marginalien/marginal                                                   Marginalie
opus/marginalien/marginal[@letter]                                          Verweis auf den zugehörigen Brief (Text)
opus/marginalien/marginal[@page]                                            Verweis auf die zugehörige Seite (Text)
opus/marginalien/marginal[@line]                                            Verweis auf die zugehörige Zeile (Text)
opus/marginalien/marginal[@sort]                                            Gibt die Reihenfolge der Marginalie in der Anzeige an (Nummer)
opus/marginalien/marginal/bzg                                               Lemma der Marginalie

document

opus/document/                                                              Verzeichnis von Brieftexten
opus/document/letterText/                                                   Brieftext
opus/document/letterText[@letter]                                           Verweis auf den zughörigen Brief (Text)
opus/document/letterText/edit                                               Texteingriff
opus/document/letterText/edit[@ref]                                         Verweis auf opus/edits/editreason[@id]

Die folgenden Tags und Attribute sind in allen Dateien erlaubt und dienen der Textformatierung und der Verlinkung von Textstellen. Sie können in verschiedenen Kontexten vorkommen und, wo sinnvoll, beliebig verschachtelt vorkommen:

opus/document/letterText/
opus/edits/editreason/
opus/marginalien/marginal/
opus/traditions/letterTradition/app/
opus/kommentare/kommcat/kommentar/

Außer den leeren Elementen insb. line und page können alle Tags beliebig verschachtelt werden. Die Reihenfolge der Tags ist nicht relevant.

Textformatierung:

added                   Editorischer Texteingriff, hinzugefügt [Text]
align                   Textausrichtung
align[@value]           Textausrichtung left | right | center
anchor                  Fußnotenanker
anchor[@ref]            Verweis auf die fn[@index] der Fußnote
aq                      Text in lateinischen Buchstaben
del                     Gestrichener Text
dul                     Doppelt unterstrichener Text
fn                      Fußnote
fn[@index]              Identifiziert die Fußnote eindeutig (Nummer)
ful                     Linie im Text (Tabellenkontext)
gr                      Text in griechischen Buchstaben
hand                    Text fremder Hand
hand[@ref]              Verweis auf opus/definitions/handDefs/handDef[@index]
hb                      Text in hebräischen Buchstaben
insertion               nachträglich eingefügt (transkribierte Originale)
note                    Anmerkung der Editor:innen
nr                      Unentziffert
sub                     Tiefgestellter Text
super                   Hochgestellter Text
ul                      Unterstrichener Text
tul                     Dreifach unterstrichener Text

Tabellen:

tabs                    Tabellenkontext
tabs/tab                Tabellenzelle
tabs/tab[@value]        Position der Zelle in der Zeile als Bruch (z.B. 1-3 = 1/3, die Zelle beginnt also bei 1/3 der Zeilenbreite)
                        0-3 1-3 2-3 wären also drei gleich weite Zellen in einer Zeile, jeweils ein Drittel der Zeile weit.
                        0-6 3-6 5-6 wären drei Zellen, die 1/2, 1/4 und 1/6 der Zeilenbreite einnehmen.

Semantische Auszeichnungen (zzt. Unbenutzt, dennoch getaggt, ausser sal):

sal                     Briefanrede
address                 Adresszeile
datum                   Datum
ps                      Postskriptum
sig                     Unterschrift

Seiten- und Zeilengrenzen:

page                    Zeilengrenze. Leerer Tag. Der Seitenkontext beginnt in jedem Brief neu. Jeder <letterText> beginnt idR mit <page>
page[@index]            Seitenangabe. Bezieht sich auf Seiten in ZH, oder Seiten im Manuskript, je nach Kontext
page[@autopsic]         Abgekündigt
line                    Zeilengrenze. Leerer Tag.
line[@index]            Zeilenangabe. Bezieht sich auf Zeilen in ZH, oder Zeilen im Manuskript, je nach Kontext
                        Fehlt index, wird die Zeile nicht gezählt (etwa bei Zeilen @type="empty")
line[@autopsic]         Abgekündigt
line[@tab]              Einzug der Zeile:
                        1 = Absatzeinzug
                        2 = Weiter Einzug für Briefanreden
                        3 = Weiter Einzug für Briefanreden
                        4 = Weiter Einzug für Briefanreden, eingerückte Verse & Gedichte
                        5 = Weiter Einzug für extra eingerückte Verse
                        6 = Strophenüberschriften & Sprecherrollen bei Gedichten
                        7 = Rechts eingerückte Autorangabe meist unter Gedichten
line[@type]             Zeilentyp:
                        empty = Leerzeile
                        break = Erzwungener, semantisch relevanter Zeilenumbruch, der nicht durch tab deutlich wird
                        line  = Horizontale Linie

Mit folgenden Tags wird innerhalb der Datei verlinkt:

link                    Verweis auf einen Registereintrag
link[@ref]              Verweis auf opus/kommentare/kommcat/kommentar[@id]
link[@subref]           Verweis auf opus/kommentare/kommcat/kommentar/subsection/eintrag[@id]
link[@linktext]         Bei leerem Element oder linktext = true wird der Linktext automatisch aus dem Eintrtag generiert
wwwlink                 Verweis auf eine externe URL
wwwlink[@address]       URL
intlink                 Verweis auf eine Briefstelle
intlink[@letter]        Verweis auf opus/document/letterText[@letter]
intlink[@page]          Verweis auf die zugehörige Seite
intlink[@line]          Verweis auf die zugehörige Zeile
intlink[@linktext]      Bei leerem Element oder linktext = true wird der Linktext automatisch generiert

Links sind erlaubt in

opus/marginalien/marginal/*
opus/traditions/letterTradition/app/*
opus/kommentare/kommcat/kommentar/*
opus/edit/editreason/*