Auszeichnungsregeln
Einrichtung …
- Visual Studio Code (fortan: VSC) für sich installieren.
- VSC öffnen und die folgenden Erweiterungen installieren:
- “HTML Preview” von George Oliveira für eine laufende Vorschau. Nach der Installation über einen Knopf oben rechts öffnen.
- “HTMLHint” von htmlhint.com zur steten Prüfung des HTMLs, das man schreibt. Nach der Installation öffnen über das Menü: “Terminal”, “New Terminal”; darin der Reiter “Problems”. Das Terminalfenster nach Gefallen kleiner schieben. – Man kann die im Reiter “Problems” aufgeführten Fälle anklicken, um in die betroffene Zeile zu springen.
- Das eigentliche Schreibwerk mit dem Gesamtrahmen beginnen.
- Anmerkungen:
-
Über den Gesamtrahmen werden CSS- und JS-Dateien geladen (mit den link- und script-Elementen im head-Element), um auf Gestaltung und Verhalten der Vorschau und Browseranzeige einzuwirken. Das muss in der Regel erlaubt werden: Nach dem Öffnen der Vorschau klicke man auf “Some content has been disabled” o. ä. und dann im sich oben öffnenden kleinen Fenster auf “Disable 〈…〉”.
-
Wenn die CSS- und JS-Dateien einmal geändert wurden und die Änderungen in der Vorschau nicht aufscheinen, klicke man in die Vorschau, dann auf das rechts oben durch “…” angedeutete Menü und darin auf “Refresh Preview” o. ä. Schlägt das noch nicht an, muss man wohl: den Editor schließen; auf Windows im Explorer “%AppData%\Code\Cache” eingeben – auf MacOS “$HOME/Library/Application\ Support/Code/Cache” – auf Linux “$HOME/.config/Code/Cache” –, um in den “Cache”-Ordner von VSC zu gelangen; dort alle Dateien markieren (Strg-a) und löschen (Entf).
-
HTML und XML sind Auszeichnungssprachen mit folgender Grundregel: Ein Textabschnitt, über den man etwas festhalten will, wird in sogenannte Tags gefasst. Z. B. könnte man
<drop-cap>A</drop-cap>mit dem Anfangstag<drop-cap>und dem Endtag<drop-cap>schreiben, um zu sagen: ‘Dieses “A” ist eine Initiale’. Der Ausdruck “drop-cap” ist der Tagname und ein Kürzel für die festzuhaltende Aussage.Zum Tagnamen hinzukommen können Attribute. Z. B. könnte man
<time datetime="1802-12-31">Sylvester h. a.</time>mit dem Attributnamen “datetime” und einem Attributwert “1802-12-31” schreiben, um zu sagen: ‘Dieses “Sylvester h. a.” ist eine Zeitangabe (time) und bezeichnet das Datum 31.12.1802 (datetime="1802-12-31")’.Die Attribute stehen nur im öffnenden Tag (nicht auch im schließenden) und können in beliebiger Reihenfolge geschrieben werden.
Welche Tagnamen, Attributnamen und Attributwerte (im Folgenden: “TAA”) man in welcher Bedeutung verwendet, kann man in XML frei selbst bestimmen. Der Austauschbarkeit halber verabredet man gerne bestimmte TAA und was sie bedeuten. Ein solches XML mit verabredeten TAA ist z. B. TEI-XML. – HTML ist zunächst auch eine solche verabredete Menge von TAA, allerdings kann man diese Menge inzwischen auch mit eigenen TAA erweitern. Außerdem würde HTML aus historischen Gründen hie und da eine syntaktische Variante erlauben, die es in XML nicht gibt; wir verwenden einfachheitshalber immer die XML-Variante. Zusammengefasst ist das, was wir schreiben, HTML-kompatibles XML.
-
| Bedeutung | HTML-Gestalt (SM, Beispiele meist nach Michael Hackl) | XML-Gestalt (nach der Ausarbeitung von Michael Hackl) | |
|---|---|---|---|
|
Überall nötige Umschreibungen von Zeichen, die sonst mit Steuerzeichen verwechselt würden |
〈Für die Schellingausgabe:〉
|
〈Für die Schellingausgabe:〉
|
|
|
Urheber‑, Quellen‑, Art- und Zweifelangabe durch Attribut |
|||
|
Urheberangabe: Im umfassenden article-Element wird der Urheber gesetzt mit dem Attribut “data-by="vf"”; dabei verweist “vf” auf die jeweilige Person, die in der Datenbank als Urheber des Werkes (oder entsprechend als Absender des Briefes) angegeben ist. Diese Angabe vererbt sich auf alle umfassten Elemente, solange sie nicht durch eine andere data-by-Angabe überschrieben wird. (Nur die Kurzschreibung zur Abkürzungsergänzung, z. B. “Krit˖[ik]”, setzt implicite: data-by="hg".) |
〈Wenn nicht schon ein Element da ist, dem das data-by-Attribut beigegeben werden kann, nehme man das span-Element:〉
〈Nur für die Otlohausgabe:〉
|
〈Gleich, nur dass |
|
|
Bestand von zu verwendenden Urheberkürzeln |
〈…〉 |
〈ebenso, aber:〉
|
|
|
Quellenangabe: Als Quelle ist der Überlieferungsträger gesetzt, der durch den Dateinamen anzugeben ist. Eine Abweichung davon kann durch ein data-from-Attribut angegeben werden. Das geschieht in Entsprechung zur Urheberangabe (s. o.) |
|
|
|
|
Bestand von zu verwendenden Quellenkürzeln |
〈…〉 |
〈ebenso〉 |
|
|
Artangabe: wie getilgt oder eingefügt wurde, wird ins |
|
|
|
|
Bestand von zu verwendenden Artkürzeln |
〈In
〈In
〈Nur für die Otlohausgabe:〉
|
〈ebenso〉 |
|
|
Zweifelangabe: |
〈z. B.〉 〈um zu sagen, die Bestimmung dieses “Rehfues” als Person 777 sei zweifelhaft〉 |
||
|
〈Nur für Wiener Teil:〉
|
〈Mit übertragener Verwendung der unclear-Auszeichnung: wenn Schelling selbst oder sein Sohn Verfasser sein mag und das nicht entscheidbar ist:〉
|
||
|
Elemente innerhalb von absatzartigen Elementen |
|||
|
kursiv |
|
|
|
|
gesperrt 〈Nur für die Otlohausgabe:〉Herausgeberhervorhebung von Vergleichsstellen |
|
|
|
|
fett 〈Nur für die Otlohausgabe:〉Herausgeberhervorhebung von Vergleichsstellen |
|
|
|
|
fett und gesperrt |
|
|
|
|
einmal unterstrichen |
|
|
|
|
mehrmals unterstrichen |
|
|
|
|
in Kapitälchen |
|
|
|
|
bedeutsam kleinere Schrift |
|
|
|
|
bedeutsam größere Schrift (nicht für ganze Überschriften, denn sie sind schon als Überschrift hinreichend ausgezeichnet) |
|
|
|
|
lateinische Schrift |
|
|
|
|
tiefgestellt |
|
|
|
|
hochgestellt |
|
|
|
|
Schriftfarbe |
… |
… |
|
|
Initiale |
|
|
|
|
mathematische Ausdrücke |
〈Und darin eingeschlossen LaTex-Formeln von dieser Seite: https://katex.org/docs/supported.html〉 〈Z. B. der Buch ¾:〉
|
〈Gemäß DTA werden Formeln in LaTeX-Weise geschrieben. Vgl. https://katex.org/docs/supported.html〉 〈Z. B. der Bruch ¾:〉
|
|
|
bedeutsamer Leerraum im Fließtext (links vom Element) |
|
|
|
|
In die Handschrift eingeklebte Druckseiten |
〈mit Angabe des Ursprungs:〉
〈Wenn das Einklebsel in einem Absatz beginnt und im nächsten endet, muss das paste-in-Element aufgespalten werden:〉
|
〈mit Angabe des Ursprungs:〉
〈Wenn das Einklebsel in einem Absatz beginnt und im nächsten endet, muss das hi-rend-print-Element aufgespalten werden:〉
|
|
|
Anmerkung / Note / Fußnote der Vorlage (muss – wie die anderen Elemente dieses Abschnitts 3 – in einem p-Element oder in einem h1/h2/h3/h4/h5/h6-Element stehen) |
〈Fußnote im Kontext – zu beachten das Fehlen des Leerzeichens:〉 … diese Schrift 〈Fußnote mit Angabe der Zählung, wenn sie von mechanischer Durchzählung abweicht:〉
〈Fußnote mit Urheberangabe:〉
〈Bogenzählung am Rande:〉
〈Um der Druckausgabe willen: note-l- und note-r-Fälle, die ebenso wie die Bogenzählung am Rande verbleiben und nicht nach unten gesetzt werden soll:〉
〈Nur für die Otlohausgabe:〉
|
〈Fußnote im Kontext – zu beachten das Fehlen des Leerzeichens:〉
〈Fußnote mit Angabe der Zählung, wenn sie von mechanischer Durchzählung abweicht:〉
〈Fußnote mit Urheberangabe:〉
〈Bogenzählung am Rande:〉
|
|
|
〈Für die Schellingausgabe:〉 Ergänzung einer Abkürzung durch Hg. |
〈Anm.: Hat die Quelle einen eindeutigen Abkürzungspunkt (der nicht auch Satzendezeichen sein kann), wird dieser durch
|
〈Kurzform:〉
〈Anm.: Hat die Quelle einen eindeutigen Abkürzungspunkt (der nicht auch Satzendezeichen sein kann), wird dieser durch
|
|
|
Ersetzung (Streichung und Einfügung) ohne / mit Urheberangabe |
〈Zwischen
〈Nur für die Otlohausgabe:〉Angabe von Co-Varianten, also paralleler Lesarten:
〈Zwischen zwei Elementen mit |
|
|
|
Bloße Tilgung ohne / mit Urheberangabe |
|
|
|
|
Bloße Einfügung ohne / mit Urheberangabe |
|
|
|
|
Quellen- oder Artangabe zu Änderung |
|
|
|
|
Wiederherstellung oder Verschachtelung von Änderungen |
〈Haus wird getilgt, dann aber wiederhergestellt:〉
〈Das Folgende ergibt sich aus den schon bekannten Regeln:〉 〈In das Haus am Strom wird Haus getilgt, dann alles:〉
〈Haus wird in den Text eingefügt, dann aber wieder getilgt:〉
〈Der Satz wurde um sehr ergänzt, welches getilgt wurde, danach wurde der ganze Satz getilgt:〉
〈Der Satz Das Haus … geworden wurde korrigiert und dann durch Der Turm … gebaut ersetzt:〉
|
〈Haus wird getilgt, dann aber wiederhergestellt:〉
〈Das Folgende ergibt sich aus den schon bekannten Regeln:〉 〈In das Haus am Strom wird Haus getilgt, dann alles:〉
〈Haus wird in den Text eingefügt, dann aber wieder gestrichen:〉
〈Der Satz wurde um sehr ergänzt, welches getilgt wurde, danach wurde der ganze Satz getilgt:〉
〈Der Satz Das Haus … geworden wurde korrigiert und dann durch Der Turm … gebaut ersetzt:〉
|
|
|
mittelschlecht bzw. sehr schlecht lesbar |
〈Immer in 〈Einzelner Buchstabe:〉 〈Ganzes Wort:〉 〈Zwei Wörter:〉 〈Mehrere Wörter oder unbekannte Wortanzahl:〉 〈Bei zwei unleserlichen Wörtern, z.B.:〉
〈Nur für die Otlohausgabe:〉〈Ganz anders, nämlich:〉 〈Ein Buchstabe:〉 # 〈Zwei Buchstaben:〉 ## 〈usw.〉 〈Ein Buchstabe oder mehrere, die Anzahl ist unklar:〉 █ |
〈Immer in 〈Einzelner Buchstabe:〉 ¿ 〈Ganzes Wort:〉 ¿¿¿ 〈Zwei Wörter:〉 ¿¿¿ ¿¿¿ 〈Mehrere Wörter oder unbekannte Wortanzahl:〉 ¿¿¿ … ¿¿¿ 〈Bei zwei unleserlichen Wörtern, z.B.:〉
|
|
|
mittelschlecht bzw. sehr schlecht lesbar, mit Angabe des Grundes |
|
|
|
|
Bestand zu verwendender Grund-Angaben |
illegible covered damage 〈…〉 |
||
|
Erklärende Anmerkung von Hg. |
〈Nur für die Otlohausgabe:〉
〈Anmerkung im apparatus criticus.〉
〈Wenn sich die meta-Marke nicht auf das allernächste e-a-Element beziehen soll, muss sie ein data-on-Attribut und das bezügliche e-a-Element ein data-off-Attribut bekommen, und diese beiden Attribute müssen denselben Wert haben.〉 |
|
|
|
Sprache |
〈Latein:〉 〈Hebr.:〉 〈Griech. (ἑλληνική):〉 〈Sprachangaben zweibuchstabig nach ISO-632-1: https://de.wikipedia.org/wiki/Liste_der_ISO-639-1-Codes〉 〈Das lang-Attribut kann in jedes Element geschrieben werden; also ist “span” nur nötig, wenn nicht schon ein anderes Element da ist, in das man das lang-Attribut einfach mit hineinschreiben kann, z. B.:〉
〈oder〉
|
〈Latein:〉 〈Bibl. Hebr.:〉 〈Altgriech.:〉 〈Sprachangaben dreibuchstabig nach ISO-632-3:〉 https://de.wikipedia.org/wiki/Listen_der_ISO-639-3-Codes 〈Das
〈oder〉
|
|
|
Zeit |
|
|
|
|
Ort Die IDs entstammen der DB-Tabelle “ort”. |
|
|
|
|
Person Die IDs entstammen der DB-Tabelle “person”. |
〈Sollen zur selben Stelle mehrere Personen angegeben werden, schreibt man hinter das erste a-Element die nötigen weiteren als leere Elemente. Dient dies der Angabe von Alternativmöglichkeiten, schreibt man in jedes a-Element das Attribut |
|
|
|
System (Religion, Mythologie, Weltanschauung) mit dem Sonderfall der Bibel Die IDs für Systeme entstammen der DB-Tabelle “system”. |
〈verweist auf das System mit der ID 8. Für “█” kann eine Stellenangabe stehn.〉 〈Für die Bibel aber gilt eine andere Schreibweise:〉
|
〈verweist auf das System mit der ID 8. Für “█” kann eine Stellenangabe stehn.〉 〈Für die Bibel aber gilt eine andere Schreibweise:〉
|
|
|
Brief Die IDs entstammen der DB-Tabelle “dokument”. |
|
|
|
|
Sonstiges Werk Die IDs entstammen der DB-Tabelle “literatur”. |
〈Es wird ein Werk genannt:〉
〈Jahreszahl nicht einschließen.〉 〈Es wird auf ein Werk angespielt:〉
〈Also ein leeres Element, nach Satzzeichen einzufügen.〉 |
〈 〈Es wird ein Werk genannt:〉
〈Jahreszahl nicht einschließen.〉 〈Es wird auf ein Werk angespielt:〉
〈Also ein leeres Element, nach Satzzeichen einzufügen.〉 |
|
|
Indirektes Zitat |
〈A: Es wird auf eine Stelle angespielt:〉
〈B: Es wird auf eine Stelle angespielt, und die Anspielung kann – nach Herausgeberermessen – genauer abgegrenzt werden:〉
〈Das |
〈 〈A: Es wird auf eine Stelle angespielt:〉
〈B: Es wird auf eine Stelle angespielt, und die Anspielung kann – nach Herausgeberermessen – genauer abgegrenzt werden:〉
〈Das |
|
|
Direktes Zitat |
〈Es wird eine Stelle genannt – wie oben Fall B, nur mit Anführungszeichen:〉
〈Bibelstellen entsprechend:〉
〈Nur für die Otlohausgabe:〉
〈Einfache Anführungsstriche bezeichnen ein direktes, aber nicht treues Zitat: wie hier “enim” statt “autem”.〉 |
〈 〈Es wird eine Stelle genannt – wie oben Fall B, nur mit Anführungszeichen:〉
〈Bibelstellen aber ohne
|
|
|
(Direktes) Zitat in eigenem Absatz, mit Verfasserangabe darunter |
〈Ergibt sich aus Regeln für Zitate, Absätze und Zeilenwechsel:〉
〈Merkmale wie Zentrierung, Kursivierung mit den dafür vorgesehenen Elementen auszeichnen.〉 |
〈Ergibt sich aus Regeln für Zitate, Absätze und Zeilenwechsel:〉
〈Merkmale wie Zentrierung, Kursivierung mit den dafür vorgesehenen Elementen auszeichnen.〉 |
|
|
Thema, “Kapitel” Die IDs für Themen und Kapitel entstammen der DB-Tabelle “thema”. |
…
…
〈Ein mit solch leerem a-Element gesetztes Thema gilt bis zum Textende oder zum nächsten so gesetzten Thema. Ein Kapitel gilt bis zum Textende oder nächsten gesetzten Thema oder nächsten gesetzten Kapitel (was immer früher kommt). Will man ein Thema schließen, kann aber dem dann folgenden Abschnitt kein Thema zuweisen, weist man ihm das Nicht-Thema |
… |
|
|
Schlagwort |
〈Das ist eine Auszeichnung erst einmal nur dafür, eine genauere Untersuchung über die Bedeutungen und Bedeutungsbeziehungen zu ermöglichen, indem man sich die so ausgezeichneten Formen mit Kontext und sortiert ausgeben lässt.〉 |
… |
|
|
Verweis auf einen Absatz in einem anderen Dokument (Rückverweis, Vorausverweis oder Vergleichsverweis) |
〈Im anderen Dokument: Der Absatz, auf den verwiesen wird, bekommt eine ID:〉
〈Im vorliegenden Dokument, darin der Verweis stehen soll:〉 〈Rückverweis auf diesen Absatz als inhaltlich vorausgehenden:〉
〈Vorverweis auf diesen Absatz als inhaltlich folgenden:〉
〈Vergleichsverweis auf diesen Absatz als inhaltlich zu vergleichenden:〉
〈Das “█” steht für die ID des Dokumentes, das “░” für die ID des Absatzes in diesem Dokument, auf den verwiesen werden soll. Ein Beispiel: 〈Ein Vergleichsverweis wird ans Ende des Absatzes vor das |
〈Bisher nur:〉 〈Vergleichsverweis auf Meilenstein in anderem Dokument als inhaltlich zu vergleichenden:〉
〈…, was bei der Übersetzung in HTML-XML zu …〉
〈… wird, wonach noch mehrfache IDs aufgeräumt werden müssen, das heißt, alle |
|
|
Ad-hoc-Bild |
〈Für “█” den genauen Namen der Bilddatei schreiben (mit Erweiterung wie “.png”, “.jpg” u. ä.) und die Bilddatei neben die HTML-XML-Datei in denselben Ordner legen.〉 |
||
|
Nur für die Otlohausgabe: Einbettungsstrich für Druckausgabe vorwegnehmen |
〈um im Druck an der Stelle von |
||
|
Element in oder zwischen absatzartigen Elementen |
|||
|
Seitenwechsel mit Seitenzahl Seitenzahlen dürfen nur die Zahl und etwaige Foliierungsangaben wie “r”, “v” enthalten, jedenfalls kein Leerzeichen und keins der folgenden neun Zeichen: | : < " / ? > * \ |
〈“█” steht für die Seitenzahl, die identisch sein muss mit dem Namen der Bilddatei minus “.jpg”, z. B. “1r” oder “21”〉 〈Seitenwechsel, die nicht in ein Wort fallen:〉
〈Seitenwechsel, die in ein Wort fallen:〉
〈Wobei hier ein Trennstrich in der Vorlage entfällt und damit der Unterschied aufgegeben wird zwischen fehlenden und vorhandenen Trennstrichen.〉 〈Bei Seitenwechseln, die nicht in ein
|
〈“█” steht für die Seitenzahl, die identisch sein muss mit dem Namen der Bilddatei minus “.jpg”, z. B. “1r” oder “21”〉 |
|
|
Absatzartige Elemente (dürfen nur Elemente aus den vorigen Abschnitten enthalten) |
|||
|
Überschrift 1. Grades = Überschrift des Werkes (steht daher schon unter |
|
|
|
|
Überschriften weiteren Grades (Eine solche steht immer unmittelbar unter einer |
Tritt immer nur auf als erstes Element in einer
|
|
|
|
Überschrift weiteren Grades am linken oder rechten Rand |
|
|
|
|
Absatz (steht immer in einer |
|
|
|
|
Absatz, der statt dem Vorlagentext eine Inhaltsangabe von Hg. enthält |
|
|
|
|
Absatz, rechtsbündig gesetzt |
|
|
|
|
Absatz, zentriert gesetzt |
|
|
|
|
Absatz, eingerückt |
|
|
|
|
Versgruppe (Strophe oder einstrophiges Gedicht) |
|
|
|
|
bedeutsam größerer Abstand zwischen zwei Absätzen |
|
|
|
|
Horizontale Trennlinie (z. B. am Ende eines Kapitels) |
|
|
|
|
Abbildungen |
〈Näheres wird noch entschieden je nach dem, was an der Stelle transkribiert werden und erscheinen soll.〉 |
https://www.deutschestextarchiv.de/doku/basisformat/abbildung.html |
|
|
Stempel, Poststempel |
|
〈Der Inhalt des ana-Attributes ist in der Regel: eine ISO-8601-Zeitpunktangabe (höchstens tagesgenau), dann ein Leerzeichen, dann der Rest, wobei dieser Rest eine Ortsangabe ist.〉 |
|
|
Liste |
|
|
|
|
Tabellen und Spalten |
〈Tabellen:〉
〈Spalten: Wenn anscheinend bedeutungstragend, dann mit einer Tabelle, in der die Spaltenaufteilung und die Zeilenentsprechungen genau festgehalten werden können; wenn nicht bedeutungstragend, dann nicht transkribiert, sondern schlicht im Faksimile sichtbar.〉 |
〈Tabellen:〉
〈Spaltenumbrüche werden durch
|
|
|
Elemente um absatzartige Elemente |
|||
|
HTML-Gesamtrahmen In leere Datei kopieren und Transkript zwischen die Der Dateiname muss text.html sein. Der Ordnername muss die ID des Datenbankeintrages des transkribierten Werkes sein. In diesem Ordner liegen neben “text.html” die Bilddateien der Seiten, ihrerseits benannt nach dem Muster “█.jpg”, wobei “█” für die Seitenangabe steht ganz genau so, wie sie in der Datei “text.html” in den Dieser Ordner wiederum muss in einem der Überordner “Briefe”, “Dokumente”, “Literatur” liegen. |
|
|
|
|
Abschnitt in einem Werk (= in einer Datei) (also eine “Abteilung”, ein “Teil”, “Kapitel”, “Unterkapitel” o. ä.) In größeren Abschnitten enthaltene Abschnitte werden in jene größeren eingeschachtelt. Das Beispiel rechts zeigt ein Kapitel mit zwei eingeschachtelten Unterkapiteln. Zum Schreiben von Abschnittsüberschriften siehe oben. |
|
|
|
|
Vorlesungssitzung (ist Kind – kein Enkel – des |
|
|
|
|
Briefanschrift (ist Kind – kein Enkel – des |
〈Ort und Zeit werden wie üblich ausgezeichnet.〉 |
|
|
|
Briefanrede (ist Kind – kein Enkel – des |
〈In
|
〈In 〈Das umgebende Element |
|
|
Briefhauptteil (ist Kind – kein Enkel – des |
|
|
|
|
Briefschluss (ist Kind – kein Enkel – des |
|
|
|
|
Brief-Postscriptum (ist Kind – kein Enkel – des |
|
|
|
|
Nur für die Otlohausgabe: Elementreihen |
|||
|
Zusammengehörigkeit: Unterbrochene Elemente mittels Reihen-ID zusammenfügen. |
|