selfforum-data/messages/forum.dtd

   1 <!--
   2 Document Type Declaration fuer das SELFHTML-Forum
   3 Autor: Thomas J. Sebestyen      thomasj.sebestyen@meta-text.net
   4
   5 Version 1.00    17.07.2000
   6 Version 1.01    29.07.2000
   7 Version 2.00    30.09.2000
   8         Aenderung der DTD:
   9         - Vereinfachung der Syntax: Wegfall von Attributen bei 'Thread' und 'Message'.
  10         - Einfuehren von den Elementen 'Header' 'Email' 'Homepage' 'Imageurl' 'Category' 'Subject'.
  11         - AEndern von 'Datum' auf 'Date' und Erweiterung der Attribute.
  12
  13    Aenderung 27.12.2000
  14    - Hinzufuegen von den Attributen: visitings, votingUser, votingAteam und votingAdmin beim "Message"
  15      lastThread und lastMessage beim "Forum"
  16    - Reduzierung der Attribute beim "Date" auf 'longSec'
  17    - Wegfall vom "Flag"
  18    - Einfuehren von %boolean als ja/nein Wertangabe
  19
  20     Aenderung 16.01.2001
  21     - hinzufuegen vom Attribut 'flag' beim "Message"
  22
  23     Aenderung 21.02.2001
  24     - ersetzen vom Attribut 'flag' beim "Message" durch 'invisible'
  25     - hinzufuegen vom Attribut 'archive', 'ip' und 'unid' beim "Message"
  26
  27    Last modified: 21.02.2001
  28 -->
  29
  30 <!ENTITY % boolean "(0 | 1)">
  31 <!-- Parameterentity fuer ja (1) oder nein (0) Fragen -->
  32
  33
  34 <!ELEMENT               Forum                   ((Thread, ContentList) | (Thread)*)>
  35 <!-- *****************************************************************************************************
  36                 Das Element 'Forum' wurde definert.
  37       'Forum' ist das rootelement und beinhaltet alle anderen Elemente
  38 ***************************************************************************************************** -->
  39 <!ATTLIST      Forum
  40    lastThread     IDREF    #IMPLIED
  41    lastMessage    IDREF    #IMPLIED
  42 >
  43 <!-- *****************************************************************************************************
  44       Das Attribut 'lastThread' hat den Typ IDREF, es bezieht sich auf die ID des
  45       jeweils letzten Threads im Forum
  46       Das Attribut 'lastMessage' hat den Typ IDREF, es bezieht sich auf die ID der
  47       jeweils letzten Messages im Forum
  48 ***************************************************************************************************** -->
  49
  50
  51
  52
  53
  54 <!ELEMENT               Thread                  (Message)>
  55 <!-- *****************************************************************************************************
  56                 Das Element 'Thread' wurde definert.
  57       'Thread' stellt ein Nachrichtnbaum dar.
  58 ***************************************************************************************************** -->
  59 <!ATTLIST      Thread
  60         id              ID              #REQUIRED
  61 >
  62 <!-- *****************************************************************************************************
  63                 Das Attribut 'id' hat den Typ ID  und muss zwingend vorhanden sein.
  64 ***************************************************************************************************** -->
  65
  66
  67
  68 <!ELEMENT               ContentList             (MessageContent)+>
  69 <!-- *****************************************************************************************************
  70                 Das Element 'ContentList' wurde definert.
  71       'ContentList' enthaelt alle Nachrichteninhalte.
  72 ***************************************************************************************************** -->
  73
  74
  75
  76 <!ELEMENT               MessageContent  (#PCDATA)>
  77 <!-- *****************************************************************************************************
  78                 Das Element 'MessageContent' wurde definert.
  79       'MessageContent' beinhaltet den Nachrichtentext eines Messages
  80 ***************************************************************************************************** -->
  81 <!ATTLIST MessageContent
  82         mid             IDREF           #REQUIRED
  83 >
  84 <!-- *****************************************************************************************************
  85                 Das Attribut 'mid' hat den Typ IDREF, es bezieht sich auf die ID der entsprechnden Messages.
  86 ***************************************************************************************************** -->
  87
  88
  89
  90
  91 <!ELEMENT               Message                 (Header, Message*)>
  92 <!-- *****************************************************************************************************
  93                 Das Element 'Message' wurde definert.
  94       'Message' stellt eine Nachricht im Thread dar und darf andere 'Messages' enthalten
  95        um so Teilbaeume im Thread zu bilden.
  96 ***************************************************************************************************** -->
  97 <!ATTLIST Message
  98         id              ID              #REQUIRED
  99         visitings   NMTOKEN     #IMPLIED
 100    votingUser  NMTOKEN     #IMPLIED
 101    votingAteam %boolean;   #IMPLIED
 102    votingAdmin %boolean;   #IMPLIED
 103    invisible   %boolean;   #IMPLIED
 104    archive     %boolean;   #IMPLIED
 105    ip          CDATA       #IMPLIED
 106    unid        CDATA       #IMPLIED
 107 >
 108 <!-- *****************************************************************************************************
 109                 Das Attribut 'id' hat den Typ ID  und muss zwingend vorhanden sein.
 110       Das Attribut 'visitings' zaehlt die Anzahl der Aufrufe einer Messages.
 111       Das Attribut 'votingUser' zaehlt wie oft User die Nachricht fuer das Archiv vorgeschlagen haben.
 112       Das Attribut 'votingAteam'  ja/nein Entscheidung eines Mitgliedes des Auslese-Teams fuer die
 113       Archivierung einer Nachricht. 0 = auf keinem Fall archivieren, 1 = auf jedem Fall archivieren.
 114       Das Attribut 'votingAdmin'  ja/nein Entscheidung eines Mitgliedes des SELFHTML-Redaktionsteams
 115       fuer die Archivierung einer Nachricht.
 116       0 = auf keinem Fall archivieren, 1 = auf jedem Fall archivieren.
 117       Das Attribut 'invisible' bestimmt ob ein Message angezeigt wird (0 oder nicht vorhanden) oder nicht (1)
 118       Das Attribut 'archive' bestimmt ob ein Message archiviert wird (1) oder nicht (0): 1 oder 0 wird
 119          anhand der Werte von 'votings' bestimmt.
 120      Das Attribut 'ip' speichert die IP der Sender des Messages.
 121      Das Attribut 'unid' enthaelt eine unique Nummer fuer das Message.
 122 ***************************************************************************************************** -->
 123
 124
 125
 126 <!ELEMENT               Header                  (Author, Category, Subject, Date)>
 127 <!-- *****************************************************************************************************
 128                 Das Element 'Header' wurde definert.
 129       'Header' beinhaltet die fuer die Nachricht relevanten Informationen in Form von Elementen
 130 ***************************************************************************************************** -->
 131
 132
 133
 134 <!ELEMENT               Author                  (Name, Email, HomepageUrl?, ImageUrl?)>
 135 <!-- *****************************************************************************************************
 136                 Das Element 'Author' wurde definert.
 137       'Autor' enthaelt alle benoetingten und optionalen Daten zum Nachrichtenautor.
 138 ***************************************************************************************************** -->
 139
 140
 141
 142 <!ELEMENT               Category                (#PCDATA)>
 143 <!-- *****************************************************************************************************
 144                 Das Element 'Category' wurde definert.
 145       'Category' enthaelt ein, aus einer Liste waehlbares Forumsthema.
 146 ***************************************************************************************************** -->
 147
 148
 149
 150 <!ELEMENT               Subject                 (#PCDATA)>
 151 <!-- *****************************************************************************************************
 152                 Das Element 'Subject' wurde definert.
 153       'Subject' beinhaltet den vom User definierten Titel der Nachricht.
 154 ***************************************************************************************************** -->
 155
 156
 157
 158 <!ELEMENT               Date                     EMPTY>
 159 <!-- *****************************************************************************************************
 160                 Das Element 'Datum' wurde definert.
 161                 'Date' enthaelt die Zeit, zu der die Nachricht gepostet wurde.
 162 ***************************************************************************************************** -->
 163 <!ATTLIST Date
 164         longSec NMTOKEN         #REQUIRED
 165 >
 166 <!--
 167         year            NMTOKEN         #REQUIRED
 168         mon             NMTOKEN         #REQUIRED
 169         day             NMTOKEN         #REQUIRED
 170         hour            NMTOKEN         #REQUIRED
 171         min             NMTOKEN         #REQUIRED
 172         sec             NMTOKEN         #REQUIRED
 173         isoDate NMTOKEN         #REQUIRED
 174 -->
 175 <!-- *****************************************************************************************************
 176                 Die Liste der Attribute fuer das Element 'Date' wurde definert.
 177                 Alle Attribute haben den Typ NMTOKEN und jedes der Attribute muss zwingend vorhanden sein.
 178                 NMTOKEN = Es duerfen Werte in den Attributen mit Zahlen beginnen;
 179                 und Buchstaben, Zahlen, den ( . ), den Unterstrich ( _ ) und Bindestrich ( - ) enthalten.
 180                 'isoDate' ist fuer Datumformat: YYYY-MM-DD gedacht.
 181                 'longSec' steht fuer Datum/Zeit in Sekunden seit 1970.
 182 ***************************************************************************************************** -->
 183
 184
 185
 186 <!ELEMENT               Name                    (#PCDATA)>
 187 <!-- *****************************************************************************************************
 188       'Name' enthaelt den Namen des Messageautors
 189 ***************************************************************************************************** -->
 190
 191
 192
 193 <!ELEMENT               Email                   (#PCDATA)>
 194 <!-- *****************************************************************************************************
 195                 Das Element 'Email' wurde definert.
 196       'Email' enthaelt die E-Mail-Adresse des Messageautors
 197 ***************************************************************************************************** -->
 198
 199
 200
 201 <!ELEMENT               HomepageUrl                     (#PCDATA)>
 202 <!-- *****************************************************************************************************
 203                 Das Element 'HomepageURL' wurde definert.
 204       'HomepageUrl' enthaelt die Internetadresse der Website des Messageautors.
 205 ***************************************************************************************************** -->
 206
 207
 208
 209 <!ELEMENT               ImageUrl                (#PCDATA)>
 210 <!-- *****************************************************************************************************
 211                 Das Element 'ImageURL' wurde definert.
 212       'ImageUrl' enthaelt die Internetadresse eines beliebigen Bildes (Banners) des Messageautors.
 213 ***************************************************************************************************** -->