1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
|
/* SGML parse and stream definition for libwww
SGML AND STRUCTURED STREAMS
The SGML parser is a state machine. It is called for every character
of the input stream. The DTD data structure contains pointers
to functions which are called to implement the actual effect of the
text read. When these functions are called, the attribute structures pointed to by the
DTD are valid, and the function is passed a pointer to the current tag structure, and an
"element stack" which represents the state of nesting within SGML elements.
The following aspects are from Dan Connolly's suggestions: Binary search,
Structured object scheme basically, SGML content enum type.
(c) Copyright CERN 1991 - See Copyright.html
*/
#ifndef SGML_H
#define SGML_H
#include <HTStream.h>
#include <HTAnchor.h>
#include <LYJustify.h>
/*
SGML content types
*/
typedef enum _SGMLContent {
SGML_EMPTY, /* No content. */
SGML_LITTERAL, /* Literal character data. Recognize exact close tag only.
Old www server compatibility only! Not SGML */
SGML_CDATA, /* Character data. Recognize </ only. */
SGML_RCDATA, /* Replaceable character data. Recognize </ and &ref; */
SGML_MIXED, /* Elements and parsed character data.
Recognize all markup. */
SGML_ELEMENT, /* Any data found will be returned as an error. */
SGML_PCDATA /* Added by KW. */
} SGMLContent;
typedef struct {
char * name; /* The (constant) name of the attribute */
#ifdef USE_PSRC
char type; /* code of the type of the attribute. Code
values are in HTMLDTD.h */
#endif
} attr;
typedef int TagClass;
/* textflow */
#define Tgc_FONTlike 0x00001 /* S,STRIKE,I,B,TT,U,BIG,SMALL,STYLE,BLINK;BR,TAB */
#define Tgc_EMlike 0x00002 /* EM,STRONG,DFN,CODE,SAMP,KBD,VAR,CITE,Q,INS,DEL,SPAN,.. */
#define Tgc_MATHlike 0x00004 /* SUB,SUP,MATH,COMMENT */
#define Tgc_Alike 0x00008 /* A */
#define Tgc_formula 0x00010 /* not used until math is supported better... */
/* used for special structures: forms, tables,... */
#define Tgc_TRlike 0x00020 /* TR and similar */
#define Tgc_SELECTlike 0x00040 /* SELECT,INPUT,TEXTAREA(,...) */
/* structure */
#define Tgc_FORMlike 0x00080 /* FORM itself */
#define Tgc_Plike 0x00100 /* P,H1..H6,... structures containing text or
insertion but not other structures */
#define Tgc_DIVlike 0x00200 /* ADDRESS,FIG,BDO,NOTE,FN,DIV,CENTER;FIG
structures which can contain other structures */
#define Tgc_LIlike 0x00400 /* LH,LI,DT,DD;TH,TD structure-like, only valid
within certain other structures */
#define Tgc_ULlike 0x00800 /* UL,OL,DL,DIR,MENU;TABLE;XMP,LISTING
special in some way, cannot contain (parsed)
text directly */
/* insertions */
#define Tgc_BRlike 0x01000 /* BR,IMG,TAB allowed in any text */
#define Tgc_APPLETlike 0x02000 /* APPLET,OBJECT,EMBED,SCRIPT */
#define Tgc_HRlike 0x04000 /* HR,MARQUEE can contain all kinds of things
and/or are not allowed (?) in running text */
#define Tgc_MAPlike 0x08000 /* MAP,AREA some specials that never contain
(directly or indirectly) other things than
special insertions */
#define Tgc_outer 0x10000 /* HTML,FRAMESET,FRAME,PLAINTEXT; */
#define Tgc_BODYlike 0x20000 /* BODY,BODYTEXT,NOFRAMES,TEXTFLOW; */
#define Tgc_HEADstuff 0x40000 /* HEAD,BASE,STYLE,TITLE; */
/* special relations */
#define Tgc_same 0x80000
/* Some more properties of tags (or rather, elements) and rules how
to deal with them. - kw */
typedef int TagFlags;
#define Tgf_endO 0x00001 /* end tag can be Omitted */
#define Tgf_startO 0x00002 /* start tag can be Omitted */
#define Tgf_mafse 0x00004 /* Make Attribute-Free Start-tag End instead
(if found invalid) */
#define Tgf_strict 0x00008 /* Ignore contained invalid elements,
don't pass them on */
#define Tgf_nreie 0x00010 /* Not Really Empty If Empty,
used by color style code */
/* A tag structure describes an SGML element.
** -----------------------------------------
**
**
** name is the string which comes after the tag opener "<".
**
** attributes points to a zero-terminated array
** of attribute names.
**
** litteral determines how the SGML engine parses the characters
** within the element. If set, tag openers are ignored
** except for that which opens a matching closing tag.
**
*/
typedef struct _tag HTTag;
struct _tag{
char * name; /* The name of the tag */
#ifdef USE_COLOR_STYLE
int name_len; /* The length of the name */
#endif
#ifdef EXP_JUSTIFY_ELTS
BOOL can_justify; /* justification allowed?*/
#endif
attr * attributes; /* The list of acceptable attributes */
int number_of_attributes; /* Number of possible attributes */
SGMLContent contents; /* End only on end tag @@ */
TagClass tagclass,
contains, /* which classes of elements this one can contain directly */
icontains, /* which classes of elements this one can contain indirectly */
contained, /* in which classes can this tag be contained ? */
icontained, /* in which classes can this tag be indirectly contained ? */
canclose; /* which classes of elements can this one close
if something looks wrong ? */
TagFlags flags;
};
/* DTD Information
** ---------------
**
** Not the whole DTD, but all this parser uses of it.
*/
typedef struct {
HTTag * tags; /* Must be in strcmp order by name */
int number_of_tags;
CONST char ** entity_names; /* Must be in strcmp order by name */
size_t number_of_entities;
/* "entity_names" table probably unused,
** see comments in HTMLDTD.c near the top
*/
} SGML_dtd;
/* SGML context passed to parsers
*/
typedef struct _HTSGMLContext *HTSGMLContext; /* Hidden */
/*__________________________________________________________________________
*/
/*
Structured Object definition
A structured object is something which can reasonably be represented
in SGML. I'll rephrase that. A structured object is an ordered
tree-structured arrangement of data which is representable as text.
The SGML parser outputs to a Structured object. A Structured object
can output its contents to another Structured Object. It's a kind of
typed stream. The architecture is largely Dan Conolly's. Elements and
entities are passed to the sob by number, implying a knowledge of the
DTD. Knowledge of the SGML syntax is not here, though.
Superclass: HTStream
The creation methods will vary on the type of Structured Object.
Maybe the callerData is enough info to pass along.
*/
typedef struct _HTStructured HTStructured;
typedef struct _HTStructuredClass{
char* name; /* Just for diagnostics */
void (*_free) PARAMS((
HTStructured* me));
void (*_abort) PARAMS((
HTStructured* me,
HTError e));
void (*put_character) PARAMS((
HTStructured* me,
char ch));
void (*put_string) PARAMS((
HTStructured* me,
CONST char * str));
void (*_write) PARAMS((
HTStructured* me,
CONST char * str,
int len));
void (*start_element) PARAMS((
HTStructured* me,
int element_number,
CONST BOOL* attribute_present,
CONST char** attribute_value,
int charset,
char ** include));
void (*end_element) PARAMS((
HTStructured* me,
int element_number,
char ** include));
int (*put_entity) PARAMS((
HTStructured* me,
int entity_number));
}HTStructuredClass;
/*
Equivalents to the following functions possibly could be generalised
into additional HTStructuredClass members. For now they don't do
anything target-specific. - kw
*/
extern BOOLEAN LYCheckForCSI PARAMS((HTParentAnchor *anchor, char **url));
extern void LYDoCSI PARAMS((char *url, CONST char *comment, char **csi));
extern BOOLEAN LYCommentHacks PARAMS((HTParentAnchor *anchor, CONST char *comment));
/*
Find a Tag by Name
Returns a pointer to the tag within the DTD.
*/
extern HTTag * SGMLFindTag PARAMS((
CONST SGML_dtd * dtd,
CONST char * string));
/*
Create an SGML parser
*/
/*
** On entry,
** dtd must point to a DTD structure as defined above
** callbacks must point to user routines.
** callData is returned in callbacks transparently.
** On exit,
** The default tag starter has been processed.
*/
extern HTStream * SGML_new PARAMS((
CONST SGML_dtd * dtd,
HTParentAnchor * anchor,
HTStructured * target));
extern CONST HTStreamClass SGMLParser;
#endif /* SGML_H */
/*
*/
|