[BACK]Return to HTML.html CVS log [TXT] [DIR] Up to [Public] / libwww / Library / src

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 &lt; 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