=================================================================== RCS file: /cvs/mandoc/html.c,v retrieving revision 1.5 retrieving revision 1.55 diff -u -p -r1.5 -r1.55 --- mandoc/html.c 2008/12/04 16:19:52 1.5 +++ mandoc/html.c 2009/10/03 16:36:06 1.55 @@ -1,450 +1,582 @@ -/* $Id: html.c,v 1.5 2008/12/04 16:19:52 kristaps Exp $ */ +/* $Id: html.c,v 1.55 2009/10/03 16:36:06 kristaps Exp $ */ /* - * Copyright (c) 2008 Kristaps Dzonsons + * Copyright (c) 2008, 2009 Kristaps Dzonsons * * Permission to use, copy, modify, and distribute this software for any - * purpose with or without fee is hereby granted, provided that the - * above copyright notice and this permission notice appear in all - * copies. + * purpose with or without fee is hereby granted, provided that the above + * copyright notice and this permission notice appear in all copies. * - * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL - * WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED - * WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE - * AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL - * DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR - * PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER - * TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR - * PERFORMANCE OF THIS SOFTWARE. + * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES + * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF + * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR + * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES + * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN + * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF + * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. */ -#include -#include +#include +#include #include #include -#include -#include #include +#include +#include #include #include -#include "libmdocml.h" -#include "private.h" -#include "ml.h" +#include "chars.h" +#include "html.h" +#define DOCTYPE "-//W3C//DTD HTML 4.01//EN" +#define DTD "http://www.w3.org/TR/html4/strict.dtd" -static int html_loadcss(struct md_mbuf *, const char *); +struct htmldata { + char *name; + int flags; +#define HTML_CLRLINE (1 << 0) +#define HTML_NOSTACK (1 << 1) +}; -static ssize_t html_endtag(struct md_mbuf *, - const struct md_args *, - enum md_ns, int); -static ssize_t html_begintag(struct md_mbuf *, - const struct md_args *, - enum md_ns, int, - const int *, const char **); -static int html_begin(struct md_mbuf *, - const struct md_args *, - const struct tm *, - const char *, const char *, - const char *, const char *); -static int html_end(struct md_mbuf *, - const struct md_args *); -static ssize_t html_blocktagname(struct md_mbuf *, - const struct md_args *, int); -static ssize_t html_blocktagargs(struct md_mbuf *, - const struct md_args *, int, - const int *, const char **); -static ssize_t html_blockheadtagname(struct md_mbuf *, - const struct md_args *, int); -static ssize_t html_blockheadtagargs(struct md_mbuf *, - const struct md_args *, int, - const int *, const char **); -static ssize_t html_blockbodytagname(struct md_mbuf *, - const struct md_args *, int); -static ssize_t html_blockbodytagargs(struct md_mbuf *, - const struct md_args *, int, - const int *, const char **); -static ssize_t html_inlinetagname(struct md_mbuf *, - const struct md_args *, int); -static ssize_t html_inlinetagargs(struct md_mbuf *, - const struct md_args *, int, - const int *, const char **); +static const struct htmldata htmltags[TAG_MAX] = { + {"html", HTML_CLRLINE}, /* TAG_HTML */ + {"head", HTML_CLRLINE}, /* TAG_HEAD */ + {"body", HTML_CLRLINE}, /* TAG_BODY */ + {"meta", HTML_CLRLINE | HTML_NOSTACK}, /* TAG_META */ + {"title", HTML_CLRLINE}, /* TAG_TITLE */ + {"div", HTML_CLRLINE}, /* TAG_DIV */ + {"h1", 0}, /* TAG_H1 */ + {"h2", 0}, /* TAG_H2 */ + {"p", HTML_CLRLINE}, /* TAG_P */ + {"span", 0}, /* TAG_SPAN */ + {"link", HTML_CLRLINE | HTML_NOSTACK}, /* TAG_LINK */ + {"br", HTML_CLRLINE | HTML_NOSTACK}, /* TAG_LINK */ + {"a", 0}, /* TAG_A */ + {"table", HTML_CLRLINE}, /* TAG_TABLE */ + {"col", HTML_CLRLINE | HTML_NOSTACK}, /* TAG_COL */ + {"tr", HTML_CLRLINE}, /* TAG_TR */ + {"td", HTML_CLRLINE}, /* TAG_TD */ + {"li", HTML_CLRLINE}, /* TAG_LI */ + {"ul", HTML_CLRLINE}, /* TAG_UL */ + {"ol", HTML_CLRLINE}, /* TAG_OL */ + {"base", HTML_CLRLINE | HTML_NOSTACK}, /* TAG_BASE */ +}; +static const char *const htmlattrs[ATTR_MAX] = { + "http-equiv", + "content", + "name", + "rel", + "href", + "type", + "media", + "class", + "style", + "width", + "valign", + "target", +}; -static int -html_loadcss(struct md_mbuf *mbuf, const char *css) +#ifdef __linux__ +extern int getsubopt(char **, char * const *, char **); +#endif + +void * +html_alloc(char *outopts) { - size_t res, bufsz; - char *buf; - struct stat st; - int fd, c; - ssize_t ssz; + struct html *h; + char *toks[4], *v; - c = 0; - res = 0; - buf = NULL; + toks[0] = "style"; + toks[1] = "man"; + toks[2] = "includes"; + toks[3] = NULL; - if (-1 == (fd = open(css, O_RDONLY, 0))) { - warn("%s", css); - return(0); - } - - if (-1 == fstat(fd, &st)) { - warn("%s", css); - goto out; - } + if (NULL == (h = calloc(1, sizeof(struct html)))) + return(NULL); - bufsz = MAX(st.st_blksize, BUFSIZ); - if (NULL == (buf = malloc(bufsz))) { - warn("malloc"); - goto out; + SLIST_INIT(&h->tags); + SLIST_INIT(&h->ords); + + if (NULL == (h->symtab = chars_init(CHARS_HTML))) { + free(h); + return(NULL); } - for (;;) { - if (-1 == (ssz = read(fd, buf, bufsz))) { - warn("%s", css); - goto out; - } else if (0 == ssz) + while (outopts && *outopts) + switch (getsubopt(&outopts, toks, &v)) { + case (0): + h->style = v; break; - if ( ! ml_nputs(mbuf, buf, (size_t)ssz, &res)) - goto out; - } + case (1): + h->base_man = v; + break; + case (2): + h->base_includes = v; + break; + default: + break; + } - c = 1; + return(h); +} -out: - if (-1 == close(fd)) { - warn("%s", css); - c = 0; + +void +html_free(void *p) +{ + struct tag *tag; + struct ord *ord; + struct html *h; + + h = (struct html *)p; + + while ( ! SLIST_EMPTY(&h->ords)) { + ord = SLIST_FIRST(&h->ords); + SLIST_REMOVE_HEAD(&h->ords, entry); + free(ord); } - if (buf) - free(buf); + while ( ! SLIST_EMPTY(&h->tags)) { + tag = SLIST_FIRST(&h->tags); + SLIST_REMOVE_HEAD(&h->tags, entry); + free(tag); + } + + if (h->symtab) + chars_free(h->symtab); - return(c); + free(h); } -/* ARGSUSED */ -static int -html_begin(struct md_mbuf *mbuf, const struct md_args *args, - const struct tm *tm, const char *os, - const char *title, const char *section, - const char *vol) +void +print_gen_head(struct html *h) { - const char *preamble, *css, *trail; - char buf[512]; - size_t res; + struct htmlpair tag[4]; - preamble = - "\n" - "\n" - "\n" - " \n" - " \n" - " Manual Page for %s(%s)\n"; + tag[0].key = ATTR_HTTPEQUIV; + tag[0].val = "Content-Type"; + tag[1].key = ATTR_CONTENT; + tag[1].val = "text/html; charset=utf-8"; + print_otag(h, TAG_META, 2, tag); - css = - " \n"; - trail = - "\n" - "\n" - "
\n"; + tag[0].key = ATTR_NAME; + tag[0].val = "resource-type"; + tag[1].key = ATTR_CONTENT; + tag[1].val = "document"; + print_otag(h, TAG_META, 2, tag); - res = 0; + if (h->style) { + tag[0].key = ATTR_REL; + tag[0].val = "stylesheet"; + tag[1].key = ATTR_HREF; + tag[1].val = h->style; + tag[2].key = ATTR_TYPE; + tag[2].val = "text/css"; + tag[3].key = ATTR_MEDIA; + tag[3].val = "all"; + print_otag(h, TAG_LINK, 4, tag); + } +} - (void)snprintf(buf, sizeof(buf) - 1, - preamble, title, section); - if ( ! ml_puts(mbuf, buf, &res)) - return(0); +static void +print_spec(struct html *h, const char *p, int len) +{ + const char *rhs; + int i; + size_t sz; - assert(args->params.html.css); - if (HTML_CSS_EMBED & args->params.html.flags) { - if ( ! ml_puts(mbuf, " \n", &res)) - return(0); - } else { - (void)snprintf(buf, sizeof(buf) - 1, css, - args->params.html.css); - if ( ! ml_puts(mbuf, buf, &res)) - return(0); - } + rhs = chars_a2ascii(h->symtab, p, (size_t)len, &sz); - if ( ! ml_puts(mbuf, trail, &res)) - return(0); - - return(1); + if (NULL == rhs) + return; + for (i = 0; i < (int)sz; i++) + putchar(rhs[i]); } -/* ARGSUSED */ -static int -html_end(struct md_mbuf *mbuf, const struct md_args *args) +static void +print_res(struct html *h, const char *p, int len) { - size_t res; + const char *rhs; + int i; + size_t sz; - res = 0; - if ( ! ml_puts(mbuf, "
\n", &res)) - return(0); + rhs = chars_a2res(h->symtab, p, (size_t)len, &sz); - return(1); + if (NULL == rhs) + return; + for (i = 0; i < (int)sz; i++) + putchar(rhs[i]); } -/* ARGSUSED */ -static ssize_t -html_blockbodytagname(struct md_mbuf *mbuf, - const struct md_args *args, int tok) +static void +print_escape(struct html *h, const char **p) { - size_t res; + int j, type; + const char *wp; - res = 0; - if ( ! ml_puts(mbuf, "div", &res)) - return(-1); + wp = *p; + type = 1; - return((ssize_t)res); -} + if (0 == *(++wp)) { + *p = wp; + return; + } + if ('(' == *wp) { + wp++; + if (0 == *wp || 0 == *(wp + 1)) { + *p = 0 == *wp ? wp : wp + 1; + return; + } + print_spec(h, wp, 2); + *p = ++wp; + return; + } else if ('*' == *wp) { + if (0 == *(++wp)) { + *p = wp; + return; + } -/* ARGSUSED */ -static ssize_t -html_blockheadtagname(struct md_mbuf *mbuf, - const struct md_args *args, int tok) -{ - size_t res; + switch (*wp) { + case ('('): + wp++; + if (0 == *wp || 0 == *(wp + 1)) { + *p = 0 == *wp ? wp : wp + 1; + return; + } - res = 0; - if ( ! ml_puts(mbuf, "div", &res)) - return(-1); + print_res(h, wp, 2); + *p = ++wp; + return; + case ('['): + type = 0; + break; + default: + print_res(h, wp, 1); + *p = wp; + return; + } + + } else if ('f' == *wp) { + if (0 == *(++wp)) { + *p = wp; + return; + } - return((ssize_t)res); -} + switch (*wp) { + case ('B'): + /* TODO */ + break; + case ('I'): + /* TODO */ + break; + case ('P'): + /* FALLTHROUGH */ + case ('R'): + /* TODO */ + break; + default: + break; + } + *p = wp; + return; -/* ARGSUSED */ -static ssize_t -html_blocktagname(struct md_mbuf *mbuf, - const struct md_args *args, int tok) -{ - size_t res; + } else if ('[' != *wp) { + print_spec(h, wp, 1); + *p = wp; + return; + } - res = 0; - if ( ! ml_puts(mbuf, "div", &res)) - return(-1); + wp++; + for (j = 0; *wp && ']' != *wp; wp++, j++) + /* Loop... */ ; - return((ssize_t)res); + if (0 == *wp) { + *p = wp; + return; + } + + if (type) + print_spec(h, wp - j, j); + else + print_res(h, wp - j, j); + + *p = wp; } -/* ARGSUSED */ -static ssize_t -html_blockheadtagargs(struct md_mbuf *mbuf, const struct md_args *args, - int tok, const int *argc, const char **argv) +static void +print_encode(struct html *h, const char *p) { - size_t res; - res = 0; - - if ( ! ml_puts(mbuf, " class=\"head-", &res)) - return(0); - if ( ! ml_puts(mbuf, toknames[tok], &res)) - return(0); - if ( ! ml_puts(mbuf, "\"", &res)) - return(0); - - switch (tok) { - default: - break; + for (; *p; p++) { + if ('\\' == *p) { + print_escape(h, &p); + continue; + } + switch (*p) { + case ('<'): + printf("<"); + break; + case ('>'): + printf(">"); + break; + case ('&'): + printf("&"); + break; + default: + putchar(*p); + break; + } } - - return(0); } -/* ARGSUSED */ -static ssize_t -html_blockbodytagargs(struct md_mbuf *mbuf, const struct md_args *args, - int tok, const int *argc, const char **argv) +struct tag * +print_otag(struct html *h, enum htmltag tag, + int sz, const struct htmlpair *p) { - size_t res; + int i; + struct tag *t; - res = 0; + if ( ! (HTML_NOSTACK & htmltags[tag].flags)) { + if (NULL == (t = malloc(sizeof(struct tag)))) + err(EXIT_FAILURE, "malloc"); + t->tag = tag; + SLIST_INSERT_HEAD(&h->tags, t, entry); + } else + t = NULL; - if ( ! ml_puts(mbuf, " class=\"body-", &res)) - return(0); - if ( ! ml_puts(mbuf, toknames[tok], &res)) - return(0); - if ( ! ml_puts(mbuf, "\"", &res)) - return(0); + if ( ! (HTML_NOSPACE & h->flags)) + if ( ! (HTML_CLRLINE & htmltags[tag].flags)) + printf(" "); - switch (tok) { - default: - break; + printf("<%s", htmltags[tag].name); + for (i = 0; i < sz; i++) { + printf(" %s=\"", htmlattrs[p[i].key]); + assert(p->val); + print_encode(h, p[i].val); + printf("\""); } + printf(">"); - return(res); + h->flags |= HTML_NOSPACE; + if (HTML_CLRLINE & htmltags[tag].flags) + h->flags |= HTML_NEWLINE; + else + h->flags &= ~HTML_NEWLINE; + + return(t); } /* ARGSUSED */ -static ssize_t -html_blocktagargs(struct md_mbuf *mbuf, const struct md_args *args, - int tok, const int *argc, const char **argv) +static void +print_ctag(struct html *h, enum htmltag tag) { - size_t res; + + printf("", htmltags[tag].name); + if (HTML_CLRLINE & htmltags[tag].flags) + h->flags |= HTML_NOSPACE; + if (HTML_CLRLINE & htmltags[tag].flags) + h->flags |= HTML_NEWLINE; + else + h->flags &= ~HTML_NEWLINE; +} - res = 0; - if ( ! ml_puts(mbuf, " class=\"block-", &res)) - return(0); - if ( ! ml_puts(mbuf, toknames[tok], &res)) - return(0); - if ( ! ml_puts(mbuf, "\"", &res)) - return(0); - - switch (tok) { - default: - break; - } - - return(0); +/* ARGSUSED */ +void +print_gen_doctype(struct html *h) +{ + + printf("", DOCTYPE, DTD); } -/* ARGSUSED */ -static ssize_t -html_inlinetagargs(struct md_mbuf *mbuf, const struct md_args *args, - int tok, const int *argc, const char **argv) +void +print_text(struct html *h, const char *p) { - size_t res; - res = 0; + if (*p && 0 == *(p + 1)) + switch (*p) { + case('.'): + /* FALLTHROUGH */ + case(','): + /* FALLTHROUGH */ + case(';'): + /* FALLTHROUGH */ + case(':'): + /* FALLTHROUGH */ + case('?'): + /* FALLTHROUGH */ + case('!'): + /* FALLTHROUGH */ + case(')'): + /* FALLTHROUGH */ + case(']'): + /* FALLTHROUGH */ + case('}'): + if ( ! (HTML_IGNDELIM & h->flags)) + h->flags |= HTML_NOSPACE; + break; + default: + break; + } - if ( ! ml_puts(mbuf, " class=\"inline-", &res)) - return(0); - if ( ! ml_puts(mbuf, toknames[tok], &res)) - return(0); - if ( ! ml_puts(mbuf, "\"", &res)) - return(0); + if ( ! (h->flags & HTML_NOSPACE)) + printf(" "); + h->flags &= ~HTML_NOSPACE; + h->flags &= ~HTML_NEWLINE; - switch (tok) { - default: - break; - } + if (p) + print_encode(h, p); - return(0); + if (*p && 0 == *(p + 1)) + switch (*p) { + case('('): + /* FALLTHROUGH */ + case('['): + /* FALLTHROUGH */ + case('{'): + h->flags |= HTML_NOSPACE; + break; + default: + break; + } } -/* ARGSUSED */ -static ssize_t -html_inlinetagname(struct md_mbuf *mbuf, - const struct md_args *args, int tok) +void +print_tagq(struct html *h, const struct tag *until) { - size_t res; + struct tag *tag; - res = 0; - - switch (tok) { - case (ROFF_Pp): - if ( ! ml_puts(mbuf, "div", &res)) - return(-1); - break; - default: - if ( ! ml_puts(mbuf, "span", &res)) - return(-1); - break; + while ( ! SLIST_EMPTY(&h->tags)) { + tag = SLIST_FIRST(&h->tags); + print_ctag(h, tag->tag); + SLIST_REMOVE_HEAD(&h->tags, entry); + free(tag); + if (until && tag == until) + return; } - - return((ssize_t)res); } -static ssize_t -html_begintag(struct md_mbuf *mbuf, const struct md_args *args, - enum md_ns ns, int tok, - const int *argc, const char **argv) +void +print_stagq(struct html *h, const struct tag *suntil) { + struct tag *tag; - assert(ns != MD_NS_DEFAULT); - switch (ns) { - case (MD_NS_BLOCK): - if ( ! html_blocktagname(mbuf, args, tok)) - return(0); - return(html_blocktagargs(mbuf, args, - tok, argc, argv)); - case (MD_NS_BODY): - if ( ! html_blockbodytagname(mbuf, args, tok)) - return(0); - return(html_blockbodytagargs(mbuf, args, - tok, argc, argv)); - case (MD_NS_HEAD): - if ( ! html_blockheadtagname(mbuf, args, tok)) - return(0); - return(html_blockheadtagargs(mbuf, args, - tok, argc, argv)); - default: - break; + while ( ! SLIST_EMPTY(&h->tags)) { + tag = SLIST_FIRST(&h->tags); + if (suntil && tag == suntil) + return; + print_ctag(h, tag->tag); + SLIST_REMOVE_HEAD(&h->tags, entry); + free(tag); } - - if ( ! html_inlinetagname(mbuf, args, tok)) - return(0); - return(html_inlinetagargs(mbuf, args, tok, argc, argv)); } -static ssize_t -html_endtag(struct md_mbuf *mbuf, const struct md_args *args, - enum md_ns ns, int tok) +void +bufinit(struct html *h) { - assert(ns != MD_NS_DEFAULT); - switch (ns) { - case (MD_NS_BLOCK): - return(html_blocktagname(mbuf, args, tok)); - case (MD_NS_BODY): - return(html_blockbodytagname(mbuf, args, tok)); - case (MD_NS_HEAD): - return(html_blockheadtagname(mbuf, args, tok)); - default: - break; - } + h->buf[0] = '\0'; + h->buflen = 0; +} - return(html_inlinetagname(mbuf, args, tok)); + +void +bufcat(struct html *h, const char *p) +{ + + bufncat(h, p, strlen(p)); } -int -md_line_html(void *data, char *buf) +void +buffmt(struct html *h, const char *fmt, ...) { + va_list ap; - return(mlg_line((struct md_mlg *)data, buf)); + va_start(ap, fmt); + (void)vsnprintf(h->buf + h->buflen, + BUFSIZ - h->buflen - 1, fmt, ap); + va_end(ap); + h->buflen = strlen(h->buf); + assert('\0' == h->buf[h->buflen]); } -int -md_exit_html(void *data, int flush) +void +bufncat(struct html *h, const char *p, size_t sz) { - return(mlg_exit((struct md_mlg *)data, flush)); + if (h->buflen + sz > BUFSIZ - 1) + sz = BUFSIZ - 1 - h->buflen; + + (void)strncat(h->buf, p, sz); + h->buflen += sz; + assert('\0' == h->buf[h->buflen]); } -void * -md_init_html(const struct md_args *args, - struct md_mbuf *mbuf, const struct md_rbuf *rbuf) +void +buffmt_includes(struct html *h, const char *name) { + const char *p, *pp; - return(mlg_alloc(args, rbuf, mbuf, html_begintag, - html_endtag, html_begin, html_end)); + pp = h->base_includes; + while ((p = strchr(pp, '%'))) { + bufncat(h, pp, p - pp); + switch (*(p + 1)) { + case('I'): + bufcat(h, name); + break; + default: + bufncat(h, p, 2); + break; + } + pp = p + 2; + } + if (pp) + bufcat(h, pp); } + +void +buffmt_man(struct html *h, + const char *name, const char *sec) +{ + const char *p, *pp; + + pp = h->base_man; + while ((p = strchr(pp, '%'))) { + bufncat(h, pp, p - pp); + switch (*(p + 1)) { + case('S'): + bufcat(h, sec); + break; + case('N'): + buffmt(h, name ? name : "1"); + break; + default: + bufncat(h, p, 2); + break; + } + pp = p + 2; + } + if (pp) + bufcat(h, pp); +}