]> git.p6c8.net - selfforum.git/blob - selfforum-data/messages/forum.dtd
improved the behavior of get_all_threads and create_forum_xml_string
[selfforum.git] / selfforum-data / messages / forum.dtd
1 <!-- ***************************************************************************
2 * *
3 * File *
4 * Document Type Declaration (DTD) fuer das SELFHTML-Forum *
5 * *
6 * Authors *
7 * Thomas J. Sebestyen <thomasj.sebestyen@meta-text.net>, 2000-09-30 *
8 * Andre Malo <nd@o3media.de>, 2001-02-21 *
9 * Frank Schoenmann <fs@tower.de>, 2001-03-17 *
10 * *
11 * 2001-03-17, v2.13 *
12 * * style changes *
13 * * renamed "Message" attribute "visitings" -> "views" *
14 * * "Email" is now optional (not used in main forum xml) *
15 * *
16 * 2001-02-21, v2.12 *
17 * * replaced "Message" attribute "flag" -> "invisible" *
18 * * added "Message" attributes "archive", "ip", "unid" *
19 * *
20 * 2001-01-16, v2.11 *
21 * * added "Message" attributes "flag" *
22 * *
23 * 2000-12-27, v2.1 *
24 * * added "Message" attribues "visitings", "votingUser", "votingAteam", *
25 * "votingAdmin" *
26 * * added "Forum" attributes "lastThread", "lastMessage" *
27 * * replaced "Date" attributes by "longSec" *
28 * * removed "Flag" *
29 * * added "%boolean" type as attribute value *
30 * *
31 * 2000-09-30, v2.0 *
32 * * removed some "Thread" and "Message" attributes *
33 * * added "Header", "Email", "Homepage", "Imageurl", "Category", "Subject" *
34 * * renamed "Datum" -> "Date" *
35 * *
36 * Older history: *
37 * * 2000-07-29, v1.01 *
38 * * 2000-07-17, v1.00 *
39 * *
40 **************************************************************************** -->
41
42 <!ENTITY % boolean "(0 | 1)">
43 <!-- Parameterentity fuer ja (1) oder nein (0) Fragen -->
44
45
46 <!ELEMENT Forum ((Thread, ContentList) | (Thread)*)>
47 <!ATTLIST Forum
48 lastThread IDREF #IMPLIED
49 lastMessage IDREF #IMPLIED
50 >
51 <!-- ***************************************************************************
52 'Forum' ist das Root-Element und beinhaltet alle anderen Elemente.
53
54 Das Attribut 'lastThread' hat den Typ IDREF, es bezieht sich auf die ID
55 des jeweils letzten Threads im Forum
56 Das Attribut 'lastMessage' hat den Typ IDREF, es bezieht sich auf die ID
57 der jeweils letzten Messages im Forum
58 **************************************************************************** -->
59
60
61 <!ELEMENT Thread (Message)>
62 <!ATTLIST Thread
63 id ID #REQUIRED
64 >
65 <!-- ***************************************************************************
66 'Thread' stellt einen Nachrichtenbaum dar.
67
68 Das Attribut 'id' hat den Typ ID und muss vorhanden sein.
69 **************************************************************************** -->
70
71
72 <!ELEMENT ContentList (MessageContent)+>
73 <!-- ***************************************************************************
74 'ContentList' enthaelt alle Nachrichteninhalte.
75 **************************************************************************** -->
76
77
78 <!ELEMENT MessageContent (#PCDATA)>
79 <!ATTLIST MessageContent
80 mid IDREF #REQUIRED
81 >
82 <!-- ***************************************************************************
83 'MessageContent' beinhaltet den Nachrichtentext einer Nachricht.
84
85 Das Attribut 'mid' hat den Typ IDREF. Es bezieht sich auf die ID der
86 entsprechenden Nachricht.
87 **************************************************************************** -->
88
89
90 <!ELEMENT Message (Header, Message*)>
91 <!ATTLIST Message
92 id ID #REQUIRED
93 views NMTOKEN #IMPLIED
94 votingUser NMTOKEN #IMPLIED
95 votingAteam %boolean; #IMPLIED
96 votingAdmin %boolean; #IMPLIED
97 invisible %boolean; #IMPLIED
98 archive %boolean; #IMPLIED
99 ip CDATA #IMPLIED
100 unid CDATA #IMPLIED
101 >
102 <!-- ***************************************************************************
103 'Message' stellt eine Nachricht im Thread dar und darf andere 'Message'-
104 Elemente enthalten, um so Teilbaeume im Thread zu bilden.
105
106 Das Attribut 'id' hat den Typ ID und muss vorhanden sein.
107 Das Attribut 'views' zaehlt die Anzahl der Aufrufe einer Nachricht.
108 Das Attribut 'votingUser' zaehlt, wie oft User die Nachricht fuer das
109 Archiv vorgeschlagen haben.
110 Das Attribut 'votingAteam' speichert die Meinung des Auslese-Teams zu
111 dieser Nachricht (0 - nicht archivieren, 1 - archivieren).
112 Das Attribut 'votingAdmin" speichert die Meinung des Administrators zu
113 dieser Nachricht (0 - nicht archivieren, 1 - archivieren).
114 Das Attribut 'invisible' bestimmt, ob eine Nachricht angezeigt wird (0
115 oder nicht vorhanden) oder nicht (1).
116 Das Attribut 'archive' speichert den aktuellen Status, ob eine Nachricht
117 archiviert wird (1) oder nicht (0), basierend auf den Votings.
118 Das Attribut 'ip' speicher die IP-Adresse des Senders der Nachricht.
119 Das Attribute 'unid' enthaelt eine eindeutige Nummer fuer die Nachricht.
120 **************************************************************************** -->
121
122
123 <!ELEMENT Header (Author, Category, Subject, Date)>
124 <!-- ***************************************************************************
125 'Header' beinhaltet die Header-Informationen der Nachricht in Form von
126 Elementen.
127 **************************************************************************** -->
128
129
130 <!ELEMENT Author (Name, Email?, HomepageUrl?, ImageUrl?)>
131 <!-- ***************************************************************************
132 'Author' enthaelt alle benoetigten und optionalen Daten zum Autor einer
133 Nachricht.
134 **************************************************************************** -->
135
136
137 <!ELEMENT Category (#PCDATA)>
138 <!-- ***************************************************************************
139 'Category' enthaelt das Thema der Nachricht.
140 **************************************************************************** -->
141
142
143 <!ELEMENT Subject (#PCDATA)>
144 <!-- ***************************************************************************
145 'Subject' beinhaltet den Titel der Nachricht.
146 **************************************************************************** -->
147
148
149 <!ELEMENT Date EMPTY>
150 <!ATTLIST Date
151 longSec NMTOKEN #REQUIRED
152 >
153 <!--
154 year NMTOKEN #REQUIRED
155 mon NMTOKEN #REQUIRED
156 day NMTOKEN #REQUIRED
157 hour NMTOKEN #REQUIRED
158 min NMTOKEN #REQUIRED
159 sec NMTOKEN #REQUIRED
160 isoDate NMTOKEN #REQUIRED
161 -->
162 <!-- ***************************************************************************
163 'Date' enthaelt die Erstellungszeit der Nachricht.
164
165 Das Attribut 'longSec' speichert die Erstellungszeit als Sekunden seit
166 1970.
167 **************************************************************************** -->
168
169
170 <!ELEMENT Name (#PCDATA)>
171 <!-- ***************************************************************************
172 'Name' enthaelt den Namen des Autors.
173 **************************************************************************** -->
174
175
176 <!ELEMENT Email (#PCDATA)>
177 <!-- ***************************************************************************
178 'Email' enthaelt die eMail-Adresse des Autors.
179 **************************************************************************** -->
180
181
182 <!ELEMENT HomepageUrl (#PCDATA)>
183 <!-- ***************************************************************************
184 'HomepageUrl' enthaelt die Homepage-Adresse des Autors.
185 **************************************************************************** -->
186
187
188 <!ELEMENT ImageUrl (#PCDATA)>
189 <!-- ***************************************************************************
190 'ImageUrl' enthaelt die Adresse eines beliebigen Bildes des Autors.
191 **************************************************************************** -->

patrick-canterino.de