|
Die Spezifikation soll für den Bereich Fragen
und Antworten eine inhaltliche sowie strukturelle
Hilfe zur Anordnung bzw. Auswahl von Elementen und
Attributen gemäß der DTD (faq.dtd)
sein.
- Grundsätzliches zu den Elementen und Attributen kann bei "Was
ist eine DTD" nachgesehen werden.
- Einen Gesamtüberblick zur Struktur der Fragen und Antworten gewinnt man eher durch die DTD.
- Für inhaltliche und weitere Fragen
bezüglich der Elemente oder Attribute eignet
sich mehr diese Spezifikation.
- Die grau gekennzeichneten Abschnitte
entsprechen exakt der DTD.
- Die blau gekennzeichneten Abschnitte werden vom Stylesheet generiert.
|
Elemente/Subelemente gemäss DTD
|
Attribute gemäss DTD
|
Bemerkung
|
|---|
| <! ELEMENT faq (head,body) > |
|
Jede faq besteht aus den zwei Elementen head, body.
Die Bezeichnungen lehnen sich inhaltlich und funktional stark an die Hypertext Markup Language
HTML an.
Im head, insbesondere innerhalb seiner Subelemente sind die Meta-Informationen
zur jeweiligen Frage anzugeben; der body mit seinen Unterelementen unterstützt
mehr die inhaltliche Strukturierung der jeweiligen Antwort. |
| |
<! ATTLIST faq id ID #REQUIRED > |
Jede faq ist mittels der id identifizierbar;
sie wird für jede Frage neu vergeben. Die ID-Angabe als Attribut jeder faq gewährleistet die Eindeutigkeit in der Nummerierung aller Dokumente;
eine Angabe ist daher unbedingt erforderlich #REQUIRED. |
| < !ELEMENT head (titel,autor+,design+,thema+,sw*,rank?) > |
|
Das Element head als Subelement von faq verfügt über
folgende Unterelemente zur Erfassung:
| titel | genau einmal notwendig; |
| autor+ | einmal notwendig,
mehrfach möglich; |
| design+ | einmal notwendig,
mehrfach möglich; |
| thema+ | einmal notwendig,
mehrfach möglich; |
| sw* | keinmal notwendig,
mehrfach möglich; |
| rank? | keinmal notwendig,
einmal möglich; |
|
| < !ELEMENT titel (#PCDATA) > |
|
Das Element titel als Subelement von head beinhaltet jeweils eine Frage;
diese kann als reiner Buchstaben-String erfasst werden oder durch Ziffern bzw. Sonderzeichen
ergänzt; die Daten werden geparst #PCDATA und ggf. umgeformt. |
| |
< !ATTLIST titel alpha CDATA #IMPLIED > |
Das Attribut alpha im Element titel ermöglicht eine alphabetische
Einordnung der Frage; kann als String in Kleinbuchstaben bzw. Ziffern oder Sonderzeichen
erfasst werden; die Daten werden nicht geparst sondern 1:1 interpretiert CDATA; also originalgetreu
übernommen; Angabe ist nicht unbedingt erforderlich #IMPLIED. |
| < !ELEMENT autor (datum) > |
|
Das Element autor als Subelement von head erfordert
jeweils ein datum; Zeitpunkt der Entstehung des Inhaltes. |
| |
< !ATTLIST autor id
IDREF #REQUIRED > |
Das Attribut id im Element autor dient als Verweis
IDREF auf das Porträt des jeweiligen Verfassers einer Frage bzw. Antwort;
id="per_geburtsname_vorname_00"; Angabe ist unbedingt erforderlich #REQUIRED. |
| < !ELEMENT datum (dattext*,jahr?,monat?,tag?) > |
|
Das Element datum als Subelement von autor,
design kann je nach Erfordernis, wahlweise als Text
dattext* oder exakte Angabe des Tages
tag?, Monats monat?
oder Jahres jahr? erfolgen. |
| < !ELEMENT dattext (#PCDATA) > |
|
Das Element dattext erlaubt eine Angabe des Datums in Worten;
insbesondere wenn exakte Angaben fehlen. |
| < !ELEMENT jahr (#PCDATA) > |
|
Das Element jahr sieht die Angabe der Jahreszahl vor. |
| < !ELEMENT monat (#PCDATA) > |
|
Das Element monat sieht die Angabe des Monats als Ziffer vor. |
| < !ELEMENT tag (#PCDATA) > |
|
Das Element tag sieht die Angabe des Tages als Ziffer vor. |
| < !ELEMENT design (datum) > |
|
Das Element design als Subelement von head erfordert
jeweils ein datum; Zeitpunkt der Erstellung des elektronischen Dokumentes.
Vom Stylesheet unberücksichtigt. |
| |
< !ATTLIST design id IDREF #REQUIRED > |
Das Attribut id im Element design dient als Verweis
IDREF auf das Porträt des jeweiligen Designers einer Frage;
id="per_geburtsname_vorname_00";
Angabe des Attributes unbedingt erforderlich #REQUIRED. |
| |
< !ATTLIST design typ
(erstellung|
modifikation|
verschlagwortung)
#REQUIRED > |
Das Attribut typ im Element design dient der Typisierung von Aufgabenbereichen;
optionale Auswahl erstellung| modifikation| verschlagwortung des Designertyps;
Angabe des Attributes unbedingt erforderlich #REQUIRED. |
| < !ELEMENT thema (#PCDATA) > |
|
Das Element thema als Subelement von head
wird gemäß dem Inhalt der Frage vergeben; eine Zuordnung sollte
anhand einer vorab festgelegten Themenliste erfolgen. Auf eine korrekte Schreibweise ist hier zu achten, da jede Abweichung
als neues Thema erkannt wird. |
| < !ELEMENT sw (#PCDATA) > |
|
Das Element Schlagwort sw als Subelement von head
wird gemäß dem Inhalt von Frage und Antwort vergeben. Dieses Element
kann und soll beliebig oft genutzt werden, wenn erforderlich. Auf eine korrekte Schreibweise ist hier
ebenso zu achten, da jede Abweichung als neues Schlagwort erkannt wird. |
| < !ELEMENT rank EMPTY > |
|
Das Element rank als Subelement von head bietet die Option einer gewissen Ordnung bzw. Struktur
im Hinblick auf die Reihenfolge der Anordnung von Fragen und Antworten. Dieses Element
bleibt inhaltlich leer EMPTY; hat nur durch die Wertzuweisung mittels
Attribut eine Bedeutung. |
| |
< !ATTLIST rank value (1|2|3) #REQUIRED > |
Das Attribut value im Element rank
weißt der Frage den Wert zu; optionale Auswahl 1|2|3;
wenn das Element rank eingesetzt wird, ist die Angabe des Attributes unbedingt
erforderlich #REQUIRED. |
| |
| < !ELEMENT body (frage?,antwort) > |
|
Das Element body als Subelement von faq läßt nur
zwei Unterelemente zu; frage und antwort;
die Frage ist optional ?, da evtl. vom Titel abzuleiten. |
| |
< !ATTLIST body sprache (DE|DEO|FR|IT|LT|GR) #REQUIRED > |
Das Attribut sprache im Element body
gibt sozusagen die Basissprache des gesamten Dokumentes an; diese Attributsangabe ist unbedingt
erforderlich #REQUIRED. |
| < !ELEMENT frage (#PCDATA) > |
|
Das Element frage als Subelement von body
wird nur eingesetzt, wenn die Frage anders benannt wird
als im Titel; Rohdaten werden entsprechend umgeformt
#PCDATA; sieht keine weiteren Subelemente
vor. |
| < !ELEMENT antwort (p) *> |
|
Das Element antwort als Subelement von body
erfordert als Unterelement ein p; sämtliche Inhalte müssen innerhalb
des Elementes p (stammt von Paragraph in HTML)
genested bzw. eingegliedert werden. |
| |
|---|
| Nachfolgende
Elemente gelten global und unterstützen hauptsächlich
die formale Struktur. |
| |
|---|
< !ENTITY % block
"p|erweitert|sprache|rede|extrakt_ref|beleg_ref|
komm_ref|brief_ref|ewerk_ref|bib_ref|link_ref|quelle_ref|
per_ref|ort_ref|faq_ref" > |
SONDERFUNKTION: Die Entity "block" vereinfacht das
Einbinden gleichbleibender Strings in Elemente/Subelemente und bewahrt die
Übersichtlichkeit der DTD; deckt alle globalen Elemente ab. |
| < !ELEMENT p (%block;|br|ul|ol) *> |
|
Paragraph p: Absatz = neue
Zeile plus Leerzeile; innerhalb von Absätzen
sind sämtliche Referenzen verfügbar. Sowohl
die in der Entity block enthaltenen
Elemente, als auch Zeilenumbrüche br
und Auflistungen ul, ol. |
| < !ELEMENT br EMPTY > |
|
Break br: Zeilenumbruch = neue
Zeile;
inhaltlich leer. |
| < !ELEMENT ul (%block;|li) > |
|
Unordered List ul: Liste mit Punkten;
sämtliche Referenzen erlaubt; einfachheitshalber
über die Entity block; das Subelement
li erzeugt hier durch das Stylesheet
Listenpunkte. |
| < !ELEMENT li (%block;)* > |
|
Listenpunkte li;
reine Punkte bei ul; Ziffern bei ol; |
| < !ELEMENT ul (%block;|li) > |
|
Ordered List ol = Liste mit Ziffern;
sämtliche Referenzen erlaubt; einfachheitshalber als Entity % block; das Subelement
li erzeugt hier durch das Stylesheet die Nummerierung. |
| < !ELEMENT erweitert (beschriftung?, (% block;)*) > |
|
Das Element erweitert fungiert sowohl als Element als auch als Subelement;
grundsätzlich werden mit diesem Element erweitert Inhalte erfasst,
die mittels einer Funktion im Stylesheet sozusagen "ausgeklappt" werden können
und eine Art "Maxi-Version" darstellen; ein Unterelement beschriftung? ist vorgesehen, falls vorhanden.
Das Element erweitert kann gleichzeitig
als Unterelement in alle Entity - Referenzen
eingebaut werden (ersichtlich in der entity %block "...
| erweitert | ...") sowie alle
Entity - Referenzen selbst beinhalten
% block. |
| < !ELEMENT beschriftung (%block;) *> |
|
Das Element beschriftung als Subelement
von erweitert benennt sozusagen die
Erweiterung (also eine Art Überschrift). Mittels
Stylesheet wird ein Link generiert
(kursiv mit Fußnote). |
| < !ELEMENT sprache (%block;|li)* > |
|
Das Element sprache dient der Markierung von Textstellen
in anderer Sprache. Mittels Stylesheet: kursive
Schrift. Textstellen die andersprachig sind, als
die im body definierte Basissprache. |
| |
< !ATTLIST sprache sprache (DE|DEO|FR|IT|LT|GR) #REQUIRED > |
Das Attribut sprache im Element
sprache ermöglicht eine Angabe
der Sprache gemäß der vorgegebenen Optionen
(DE|DEO|FR|IT|LT|GR). |
| < !ELEMENT rede (% block;|luecke|auslassung)* > |
|
Im Element rede erfolgt die Kennzeichnung
von direkter/indirekter Rede; enthält als Unterelemente
luecke und auslassung. |
| |
< !ATTLIST rede typ (direkt|indirekt) #REQUIRED > |
Als Attribut typ des Elementes rede; Hinweis auf den Typ der Rede direkt|indirekt; eine Angabe ist unbedingt erforderlich #REQUIRED. |
| |
< !ATTLIST rede id IDREF #REQUIRED > |
Im Attribut rede erfolgt der Verweis auf Quelle, Ewerk,
Briefe, Extrakte über die id. z.B.: id="we_zar_00";
Angabe des Attributes unbedingt erforderlich. |
| <!ELEMENT luecke (EMPTY)> |
|
Zur Markierung von fehlendem Text innerhalb einer Rede oder eines Extraktes.
Das Stylesheet generiert: [...]. |
| < !ELEMENT auslassung EMPTY > |
|
Zur Markierung von ausgelassenem Text innerhalb einer Rede oder eines Extraktes.
Das Stylesheet generiert: (...). |
| < !ELEMENT hinweis (#PCDATA) > |
|
Zur Kennzeichnung von Werken Nietzsches auf
die es keine Verweise gibt - sondern nur ein Hinweis
im Text.
Das Stylesheet generiert: fettgedruckte
Schrift . |
| < !ELEMENT wichtig (#PCDATA) > |
|
Zur Kennzeichnung von Werken anderer Autoren
im Kontext, auf die es keine Verweise gibt: Brandes'
Essay-Titel Aristokratischer Radikalismus. Das
Stylesheet generiert: fettgedruckte
Schrift . |
| < !ELEMENT betont (#PCDATA) > |
|
Lediglich zur Wiedergabe von Textstellen, die der
Autor - in unserem Falle Nietzsche oder der Verfasser
der Fragen hervorheben wollte: faszinosum. Das
Stylesheet generiert: kursive Schrift. |
| |
|---|
| Verweise auf andere Kategorien werden durch das Stylesheet alle zu Links: |
|---|
| |
|---|
| < !ELEMENT extrakt_ref (% block;|luecke|auslassung)* > |
|
Verweis auf Extrakte! |
| |
< !ATTLIST extrakt id IDREF #REQUIRED > |
Angabe id="extrakt_li_0124"
ist unbedingt erforderlich , wenn das Element <extrakt_ref>
genutzt wird. |
| < !ELEMENT beleg_ref (%block;)* > |
|
Verweis auf vorhandenen Beleg optional. |
| |
< !ATTLIST beleg id IDREF #REQUIRED > |
Angabe id="beleg_01234"
ist unbedingt erforderlich , wenn das Element <beleg_ref>
genutzt wird. |
| |
< !ATTLIST beleg medium CDATA #REQUIRED > |
Angabe des Medientyps medium="notizzettel"
ist unbedingt erforderlich, wenn das Element <beleg_ref>
genutzt wird. Die Benennung des Typs ist frei wählbar
CDATA. |
| < !ELEMENT komm_ref (%block;)* > |
|
Verweis auf Kommentare optional. |
| |
< !ATTLIST komm id IDREF #REQUIRED > |
Angabe id="komm_ref_00004" ist unbedingt erforderlich. |
| < !ELEMENT brief_ref (%block;)* > |
|
Verweis auf Briefe optional. |
| |
< !ATTLIST brief id IDREF #REQUIRED > |
Angabe id="brief_e0241" ist unbedingt erforderlich. |
| < !ELEMENT link_ref (%block;)* > |
|
Verweis auf Linksammlung optional. |
| |
< !ATTLIST link id IDREF #REQUIRED > |
Angabe id="link_00241" ist unbedingt erforderlich. |
| < !ELEMENT quelle_ref (%block;)* > |
|
Verweis auf Quelle optional. |
| |
< !ATTLIST quelle id IDREF #REQUIRED > |
Angabe id="quelle_00111" ist unbedingt erforderlich. |
| < !ELEMENT per_ref (%block;)* > |
|
Verweis auf Porträts optional. |
| |
< !ATTLIST per id IDREF #REQUIRED > |
Angabe id="per_geburtsname_vorname_00" ist unbedingt erforderlich. |
| < !ELEMENT ort_ref (%block;)* > |
|
Verweis auf Ort optional. |
| |
< !ATTLIST ort id IDREF #REQUIRED > |
Angabe id="ort_ortsname_00" ist unbedingt erforderlich. |
| < !ELEMENT faq_ref (%block;)* > |
|
Verweis auf andere Fragen und Antworten optional |
| |
< !ATTLIST faq id IDREF #REQUIRED > |
Angabe id="faq_00000" ist unbedingt erforderlich. |
| < !ELEMENT extern_ref (#PCDATA) > |
|
Verweis auf externe Links optional |
| |
< !ATTLIST extern_ref href IDREF #REQUIRED > |
Angabe href="http://www.url" ist unbedingt erforderlich. |