Annotation of libwww/Library/src/HTML.html, revision 2.10
2.7 timbl 1: <HTML>
2: <HEAD>
3: <TITLE>HTML to rich text converter for libwww</TITLE>
2.8 timbl 4: <NEXTID N="z4">
2.7 timbl 5: </HEAD>
2.6 timbl 6: <BODY>
2.8 timbl 7: <H1>The HTML to styled text object converter</H1>This interprets the <A
8: NAME="z0" HREF="../../MarkUp/MarkUp.html">HTML</A> semantics
9: and some HTMLPlus.<P>
10: Part of <A
11: NAME="z2" HREF="Overview.html">libwww</A> . Implemented by <A
12: NAME="z3" HREF="HTML.c">HTML.c</A>
2.6 timbl 13: <PRE>#ifndef HTML_H
2.1 timbl 14: #define HTML_H
15:
16: #include "HTUtils.h"
17: #include "HTAnchor.h"
2.8 timbl 18: #include "HTMLPDTD.h"
2.1 timbl 19:
2.8 timbl 20: #define DTD HTMLP_dtd
21:
2.6 timbl 22: #ifdef SHORT_NAMES
23: #define HTMLPresentation HTMLPren
24: #define HTMLPresent HTMLPres
25: #endif
2.1 timbl 26:
27: extern CONST HTStructuredClass HTMLPresentation;
28:
2.6 timbl 29: </PRE>
2.9 timbl 30: <H2>HTML_new: A structured stream to
31: parse HTML</H2>
32: <PRE>extern HTStructured* HTML_new PARAMS((HTRequest * request,
2.8 timbl 33: void * param,
34: HTFormat input_format,
35: HTFormat output_format,
36: HTStream * output_stream));
37:
2.10 ! luotonen 38: </PRE>
! 39: <H3>Reopen</H3>Reopening an existing HTML object
! 40: allows it to be retained (for example
! 41: by the styled text object) after
! 42: the structured stream has been closed.
! 43: To be actually deleted, the HTML
! 44: object must be closed once more
! 45: times than it has been reopened.
! 46: <PRE>extern void HTML_reopen PARAMS((HTStructured *, me));
2.1 timbl 47:
2.10 ! luotonen 48: </PRE>
! 49: <H2>Converters</H2>
! 50: <PRE>extern HTConverter HTMLToPlain, HTMLToC, HTMLPresent;
2.8 timbl 51:
52:
53: </PRE>
54: <H2>Selecting internal character set
55: representations</H2>
56: <PRE>typedef enum _HTMLCharacterSet {
2.1 timbl 57: HTML_ISO_LATIN1,
58: HTML_NEXT_CHARS,
59: HTML_PC_CP950
60: } HTMLCharacterSet;
61:
62: extern void HTMLUseCharacterSet PARAMS((HTMLCharacterSet i));
63:
2.6 timbl 64: </PRE>
65: <H2>Record error message as a hypertext
66: object</H2>The error message should be marked
67: as an error so that it can be reloaded
68: later. This implementation just throws
69: up an error message and leaves the
70: document unloaded.
2.10 ! luotonen 71: <H3>On entry,</H3>
! 72: <DL>
! 73: <DT>sink
! 74: <DD>is a stream to the output device
! 75: if any
! 76: <DT>number
! 77: <DD>is the HTTP error number
! 78: <DT>message
! 79: <DD>is the human readable message.
! 80: </DL>
! 81:
! 82: <H3>On exit,</H3>a return code like HT_LOADED if object
! 83: exists else < 0
! 84: <PRE>PUBLIC int HTLoadError PARAMS((
2.1 timbl 85: HTStream * sink,
86: int number,
87: CONST char * message));
88:
89: #endif
2.6 timbl 90:
2.7 timbl 91:
2.10 ! luotonen 92: </PRE>end</A></BODY>
2.7 timbl 93: </HTML>
Webmaster