]> git.cameronkatri.com Git - mandoc.git/blob - man_html.c
Install sources with mode 0644. Noted by Jack Nagel. Ok schwarze@.
[mandoc.git] / man_html.c
1 /* $Id: man_html.c,v 1.76 2011/07/03 22:57:32 kristaps Exp $ */
2 /*
3 * Copyright (c) 2008, 2009, 2010, 2011 Kristaps Dzonsons <kristaps@bsd.lv>
4 *
5 * Permission to use, copy, modify, and distribute this software for any
6 * purpose with or without fee is hereby granted, provided that the above
7 * copyright notice and this permission notice appear in all copies.
8 *
9 * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
10 * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
11 * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
12 * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
13 * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
14 * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
15 * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
16 */
17 #ifdef HAVE_CONFIG_H
18 #include "config.h"
19 #endif
20
21 #include <sys/types.h>
22
23 #include <assert.h>
24 #include <ctype.h>
25 #include <stdio.h>
26 #include <stdlib.h>
27 #include <string.h>
28
29 #include "mandoc.h"
30 #include "out.h"
31 #include "html.h"
32 #include "man.h"
33 #include "main.h"
34
35 /* TODO: preserve ident widths. */
36 /* FIXME: have PD set the default vspace width. */
37
38 #define INDENT 5
39 #define HALFINDENT 3
40
41 #define MAN_ARGS const struct man_meta *m, \
42 const struct man_node *n, \
43 struct mhtml *mh, \
44 struct html *h
45
46 struct mhtml {
47 int fl;
48 #define MANH_LITERAL (1 << 0) /* literal context */
49 };
50
51 struct htmlman {
52 int (*pre)(MAN_ARGS);
53 int (*post)(MAN_ARGS);
54 };
55
56 static void print_bvspace(struct html *,
57 const struct man_node *);
58 static void print_man(MAN_ARGS);
59 static void print_man_head(MAN_ARGS);
60 static void print_man_nodelist(MAN_ARGS);
61 static void print_man_node(MAN_ARGS);
62
63 static int a2width(const struct man_node *,
64 struct roffsu *);
65
66 static int man_alt_pre(MAN_ARGS);
67 static int man_br_pre(MAN_ARGS);
68 static int man_ign_pre(MAN_ARGS);
69 static int man_in_pre(MAN_ARGS);
70 static int man_literal_pre(MAN_ARGS);
71 static void man_root_post(MAN_ARGS);
72 static void man_root_pre(MAN_ARGS);
73 static int man_B_pre(MAN_ARGS);
74 static int man_HP_pre(MAN_ARGS);
75 static int man_I_pre(MAN_ARGS);
76 static int man_IP_pre(MAN_ARGS);
77 static int man_PP_pre(MAN_ARGS);
78 static int man_RS_pre(MAN_ARGS);
79 static int man_SH_pre(MAN_ARGS);
80 static int man_SM_pre(MAN_ARGS);
81 static int man_SS_pre(MAN_ARGS);
82
83 static const struct htmlman mans[MAN_MAX] = {
84 { man_br_pre, NULL }, /* br */
85 { NULL, NULL }, /* TH */
86 { man_SH_pre, NULL }, /* SH */
87 { man_SS_pre, NULL }, /* SS */
88 { man_IP_pre, NULL }, /* TP */
89 { man_PP_pre, NULL }, /* LP */
90 { man_PP_pre, NULL }, /* PP */
91 { man_PP_pre, NULL }, /* P */
92 { man_IP_pre, NULL }, /* IP */
93 { man_HP_pre, NULL }, /* HP */
94 { man_SM_pre, NULL }, /* SM */
95 { man_SM_pre, NULL }, /* SB */
96 { man_alt_pre, NULL }, /* BI */
97 { man_alt_pre, NULL }, /* IB */
98 { man_alt_pre, NULL }, /* BR */
99 { man_alt_pre, NULL }, /* RB */
100 { NULL, NULL }, /* R */
101 { man_B_pre, NULL }, /* B */
102 { man_I_pre, NULL }, /* I */
103 { man_alt_pre, NULL }, /* IR */
104 { man_alt_pre, NULL }, /* RI */
105 { man_ign_pre, NULL }, /* na */
106 { man_br_pre, NULL }, /* sp */
107 { man_literal_pre, NULL }, /* nf */
108 { man_literal_pre, NULL }, /* fi */
109 { NULL, NULL }, /* RE */
110 { man_RS_pre, NULL }, /* RS */
111 { man_ign_pre, NULL }, /* DT */
112 { man_ign_pre, NULL }, /* UC */
113 { man_ign_pre, NULL }, /* PD */
114 { man_ign_pre, NULL }, /* AT */
115 { man_in_pre, NULL }, /* in */
116 { man_ign_pre, NULL }, /* ft */
117 };
118
119 /*
120 * Printing leading vertical space before a block.
121 * This is used for the paragraph macros.
122 * The rules are pretty simple, since there's very little nesting going
123 * on here. Basically, if we're the first within another block (SS/SH),
124 * then don't emit vertical space. If we are (RS), then do. If not the
125 * first, print it.
126 */
127 static void
128 print_bvspace(struct html *h, const struct man_node *n)
129 {
130
131 if (n->body && n->body->child)
132 if (MAN_TBL == n->body->child->type)
133 return;
134
135 if (MAN_ROOT == n->parent->type || MAN_RS != n->parent->tok)
136 if (NULL == n->prev)
137 return;
138
139 print_otag(h, TAG_P, 0, NULL);
140 }
141
142 void
143 html_man(void *arg, const struct man *m)
144 {
145 struct html *h;
146 struct tag *t;
147 struct mhtml mh;
148
149 h = (struct html *)arg;
150
151 print_gen_decls(h);
152
153 memset(&mh, 0, sizeof(struct mhtml));
154
155 t = print_otag(h, TAG_HTML, 0, NULL);
156 print_man(man_meta(m), man_node(m), &mh, h);
157 print_tagq(h, t);
158
159 printf("\n");
160 }
161
162 static void
163 print_man(MAN_ARGS)
164 {
165 struct tag *t;
166
167 t = print_otag(h, TAG_HEAD, 0, NULL);
168 print_man_head(m, n, mh, h);
169 print_tagq(h, t);
170
171 t = print_otag(h, TAG_BODY, 0, NULL);
172 print_man_nodelist(m, n, mh, h);
173 print_tagq(h, t);
174 }
175
176
177 /* ARGSUSED */
178 static void
179 print_man_head(MAN_ARGS)
180 {
181
182 print_gen_head(h);
183 bufcat_fmt(h, "%s(%s)", m->title, m->msec);
184 print_otag(h, TAG_TITLE, 0, NULL);
185 print_text(h, h->buf);
186 }
187
188
189 static void
190 print_man_nodelist(MAN_ARGS)
191 {
192
193 print_man_node(m, n, mh, h);
194 if (n->next)
195 print_man_nodelist(m, n->next, mh, h);
196 }
197
198
199 static void
200 print_man_node(MAN_ARGS)
201 {
202 int child;
203 struct tag *t;
204 struct htmlpair tag;
205
206 child = 1;
207 t = h->tags.head;
208
209 switch (n->type) {
210 case (MAN_ROOT):
211 man_root_pre(m, n, mh, h);
212 break;
213 case (MAN_TEXT):
214 /*
215 * If we have a blank line, output a vertical space.
216 * If we have a space as the first character, break
217 * before printing the line's data.
218 */
219 if ('\0' == *n->string) {
220 print_otag(h, TAG_P, 0, NULL);
221 return;
222 } else if (' ' == *n->string && MAN_LINE & n->flags)
223 print_otag(h, TAG_BR, 0, NULL);
224
225 print_text(h, n->string);
226
227 /*
228 * If we're in a literal context, make sure that words
229 * togehter on the same line stay together. This is a
230 * POST-printing call, so we check the NEXT word. Since
231 * -man doesn't have nested macros, we don't need to be
232 * more specific than this.
233 */
234 if (MANH_LITERAL & mh->fl &&
235 (NULL == n->next ||
236 n->next->line > n->line))
237 print_otag(h, TAG_BR, 0, NULL);
238 return;
239 case (MAN_EQN):
240 PAIR_CLASS_INIT(&tag, "eqn");
241 print_otag(h, TAG_SPAN, 1, &tag);
242 print_text(h, n->eqn->data);
243 break;
244 case (MAN_TBL):
245 /*
246 * This will take care of initialising all of the table
247 * state data for the first table, then tearing it down
248 * for the last one.
249 */
250 print_tbl(h, n->span);
251 return;
252 default:
253 /*
254 * Close out scope of font prior to opening a macro
255 * scope.
256 */
257 if (HTMLFONT_NONE != h->metac) {
258 h->metal = h->metac;
259 h->metac = HTMLFONT_NONE;
260 }
261
262 /*
263 * Close out the current table, if it's open, and unset
264 * the "meta" table state. This will be reopened on the
265 * next table element.
266 */
267 if (h->tblt) {
268 print_tblclose(h);
269 t = h->tags.head;
270 }
271 if (mans[n->tok].pre)
272 child = (*mans[n->tok].pre)(m, n, mh, h);
273 break;
274 }
275
276 if (child && n->child)
277 print_man_nodelist(m, n->child, mh, h);
278
279 /* This will automatically close out any font scope. */
280 print_stagq(h, t);
281
282 switch (n->type) {
283 case (MAN_ROOT):
284 man_root_post(m, n, mh, h);
285 break;
286 case (MAN_EQN):
287 break;
288 default:
289 if (mans[n->tok].post)
290 (*mans[n->tok].post)(m, n, mh, h);
291 break;
292 }
293 }
294
295
296 static int
297 a2width(const struct man_node *n, struct roffsu *su)
298 {
299
300 if (MAN_TEXT != n->type)
301 return(0);
302 if (a2roffsu(n->string, su, SCALE_BU))
303 return(1);
304
305 return(0);
306 }
307
308
309 /* ARGSUSED */
310 static void
311 man_root_pre(MAN_ARGS)
312 {
313 struct htmlpair tag[3];
314 struct tag *t, *tt;
315 char b[BUFSIZ], title[BUFSIZ];
316
317 b[0] = 0;
318 if (m->vol)
319 (void)strlcat(b, m->vol, BUFSIZ);
320
321 snprintf(title, BUFSIZ - 1, "%s(%s)", m->title, m->msec);
322
323 PAIR_SUMMARY_INIT(&tag[0], "Document Header");
324 PAIR_CLASS_INIT(&tag[1], "head");
325 if (NULL == h->style) {
326 PAIR_INIT(&tag[2], ATTR_WIDTH, "100%");
327 t = print_otag(h, TAG_TABLE, 3, tag);
328 PAIR_INIT(&tag[0], ATTR_WIDTH, "30%");
329 print_otag(h, TAG_COL, 1, tag);
330 print_otag(h, TAG_COL, 1, tag);
331 print_otag(h, TAG_COL, 1, tag);
332 } else
333 t = print_otag(h, TAG_TABLE, 2, tag);
334
335 print_otag(h, TAG_TBODY, 0, NULL);
336
337 tt = print_otag(h, TAG_TR, 0, NULL);
338
339 PAIR_CLASS_INIT(&tag[0], "head-ltitle");
340 print_otag(h, TAG_TD, 1, tag);
341
342 print_text(h, title);
343 print_stagq(h, tt);
344
345 PAIR_CLASS_INIT(&tag[0], "head-vol");
346 if (NULL == h->style) {
347 PAIR_INIT(&tag[1], ATTR_ALIGN, "center");
348 print_otag(h, TAG_TD, 2, tag);
349 } else
350 print_otag(h, TAG_TD, 1, tag);
351
352 print_text(h, b);
353 print_stagq(h, tt);
354
355 PAIR_CLASS_INIT(&tag[0], "head-rtitle");
356 if (NULL == h->style) {
357 PAIR_INIT(&tag[1], ATTR_ALIGN, "right");
358 print_otag(h, TAG_TD, 2, tag);
359 } else
360 print_otag(h, TAG_TD, 1, tag);
361
362 print_text(h, title);
363 print_tagq(h, t);
364 }
365
366
367 /* ARGSUSED */
368 static void
369 man_root_post(MAN_ARGS)
370 {
371 struct htmlpair tag[3];
372 struct tag *t, *tt;
373
374 PAIR_SUMMARY_INIT(&tag[0], "Document Footer");
375 PAIR_CLASS_INIT(&tag[1], "foot");
376 if (NULL == h->style) {
377 PAIR_INIT(&tag[2], ATTR_WIDTH, "100%");
378 t = print_otag(h, TAG_TABLE, 3, tag);
379 PAIR_INIT(&tag[0], ATTR_WIDTH, "50%");
380 print_otag(h, TAG_COL, 1, tag);
381 print_otag(h, TAG_COL, 1, tag);
382 } else
383 t = print_otag(h, TAG_TABLE, 2, tag);
384
385 tt = print_otag(h, TAG_TR, 0, NULL);
386
387 PAIR_CLASS_INIT(&tag[0], "foot-date");
388 print_otag(h, TAG_TD, 1, tag);
389
390 print_text(h, m->date);
391 print_stagq(h, tt);
392
393 PAIR_CLASS_INIT(&tag[0], "foot-os");
394 if (NULL == h->style) {
395 PAIR_INIT(&tag[1], ATTR_ALIGN, "right");
396 print_otag(h, TAG_TD, 2, tag);
397 } else
398 print_otag(h, TAG_TD, 1, tag);
399
400 if (m->source)
401 print_text(h, m->source);
402 print_tagq(h, t);
403 }
404
405
406
407 /* ARGSUSED */
408 static int
409 man_br_pre(MAN_ARGS)
410 {
411 struct roffsu su;
412 struct htmlpair tag;
413
414 SCALE_VS_INIT(&su, 1);
415
416 if (MAN_sp == n->tok) {
417 if (NULL != (n = n->child))
418 if ( ! a2roffsu(n->string, &su, SCALE_VS))
419 SCALE_VS_INIT(&su, atoi(n->string));
420 } else
421 su.scale = 0;
422
423 bufinit(h);
424 bufcat_su(h, "height", &su);
425 PAIR_STYLE_INIT(&tag, h);
426 print_otag(h, TAG_DIV, 1, &tag);
427
428 /* So the div isn't empty: */
429 print_text(h, "\\~");
430
431 return(0);
432 }
433
434
435 /* ARGSUSED */
436 static int
437 man_SH_pre(MAN_ARGS)
438 {
439 struct htmlpair tag;
440
441 if (MAN_BLOCK == n->type) {
442 mh->fl &= ~MANH_LITERAL;
443 PAIR_CLASS_INIT(&tag, "section");
444 print_otag(h, TAG_DIV, 1, &tag);
445 return(1);
446 } else if (MAN_BODY == n->type)
447 return(1);
448
449 print_otag(h, TAG_H1, 0, NULL);
450 return(1);
451 }
452
453
454 /* ARGSUSED */
455 static int
456 man_alt_pre(MAN_ARGS)
457 {
458 const struct man_node *nn;
459 int i;
460 enum htmltag fp;
461 struct tag *t;
462
463 for (i = 0, nn = n->child; nn; nn = nn->next, i++) {
464 t = NULL;
465 switch (n->tok) {
466 case (MAN_BI):
467 fp = i % 2 ? TAG_I : TAG_B;
468 break;
469 case (MAN_IB):
470 fp = i % 2 ? TAG_B : TAG_I;
471 break;
472 case (MAN_RI):
473 fp = i % 2 ? TAG_I : TAG_MAX;
474 break;
475 case (MAN_IR):
476 fp = i % 2 ? TAG_MAX : TAG_I;
477 break;
478 case (MAN_BR):
479 fp = i % 2 ? TAG_MAX : TAG_B;
480 break;
481 case (MAN_RB):
482 fp = i % 2 ? TAG_B : TAG_MAX;
483 break;
484 default:
485 abort();
486 /* NOTREACHED */
487 }
488
489 if (i)
490 h->flags |= HTML_NOSPACE;
491
492 if (TAG_MAX != fp)
493 t = print_otag(h, fp, 0, NULL);
494
495 print_man_node(m, nn, mh, h);
496
497 if (t)
498 print_tagq(h, t);
499 }
500
501 return(0);
502 }
503
504
505 /* ARGSUSED */
506 static int
507 man_SM_pre(MAN_ARGS)
508 {
509
510 print_otag(h, TAG_SMALL, 0, NULL);
511 if (MAN_SB == n->tok)
512 print_otag(h, TAG_B, 0, NULL);
513 return(1);
514 }
515
516
517 /* ARGSUSED */
518 static int
519 man_SS_pre(MAN_ARGS)
520 {
521 struct htmlpair tag;
522
523 if (MAN_BLOCK == n->type) {
524 mh->fl &= ~MANH_LITERAL;
525 PAIR_CLASS_INIT(&tag, "subsection");
526 print_otag(h, TAG_DIV, 1, &tag);
527 return(1);
528 } else if (MAN_BODY == n->type)
529 return(1);
530
531 print_otag(h, TAG_H2, 0, NULL);
532 return(1);
533 }
534
535
536 /* ARGSUSED */
537 static int
538 man_PP_pre(MAN_ARGS)
539 {
540
541 if (MAN_HEAD == n->type)
542 return(0);
543 else if (MAN_BLOCK == n->type)
544 print_bvspace(h, n);
545
546 return(1);
547 }
548
549
550 /* ARGSUSED */
551 static int
552 man_IP_pre(MAN_ARGS)
553 {
554 struct roffsu su;
555 struct htmlpair tag;
556 const struct man_node *nn;
557
558 /*
559 * This scattering of 1-BU margins and pads is to make sure that
560 * when text overruns its box, the subsequent text isn't flush
561 * up against it. However, the rest of the right-hand box must
562 * also be adjusted in consideration of this 1-BU space.
563 */
564
565 if (MAN_BODY == n->type) {
566 print_otag(h, TAG_TD, 0, NULL);
567 return(1);
568 }
569
570 nn = MAN_BLOCK == n->type ?
571 n->head->child : n->parent->head->child;
572
573 SCALE_HS_INIT(&su, INDENT);
574
575 /* Width is the second token. */
576
577 if (MAN_IP == n->tok && NULL != nn)
578 if (NULL != (nn = nn->next))
579 a2width(nn, &su);
580
581 /* Width is the first token. */
582
583 if (MAN_TP == n->tok && NULL != nn) {
584 /* Skip past non-text children. */
585 while (nn && MAN_TEXT != nn->type)
586 nn = nn->next;
587 if (nn)
588 a2width(nn, &su);
589 }
590
591 if (MAN_BLOCK == n->type) {
592 print_bvspace(h, n);
593 print_otag(h, TAG_TABLE, 0, NULL);
594 bufinit(h);
595 bufcat_su(h, "width", &su);
596 PAIR_STYLE_INIT(&tag, h);
597 print_otag(h, TAG_COL, 1, &tag);
598 print_otag(h, TAG_COL, 0, NULL);
599 print_otag(h, TAG_TBODY, 0, NULL);
600 print_otag(h, TAG_TR, 0, NULL);
601 return(1);
602 }
603
604 print_otag(h, TAG_TD, 0, NULL);
605
606 /* For IP, only print the first header element. */
607
608 if (MAN_IP == n->tok && n->child)
609 print_man_node(m, n->child, mh, h);
610
611 /* For TP, only print next-line header elements. */
612
613 if (MAN_TP == n->tok)
614 for (nn = n->child; nn; nn = nn->next)
615 if (nn->line > n->line)
616 print_man_node(m, nn, mh, h);
617
618 return(0);
619 }
620
621
622 /* ARGSUSED */
623 static int
624 man_HP_pre(MAN_ARGS)
625 {
626 struct htmlpair tag;
627 struct roffsu su;
628 const struct man_node *np;
629
630 bufinit(h);
631
632 np = MAN_BLOCK == n->type ?
633 n->head->child :
634 n->parent->head->child;
635
636 if (NULL == np || ! a2width(np, &su))
637 SCALE_HS_INIT(&su, INDENT);
638
639 if (MAN_HEAD == n->type) {
640 print_otag(h, TAG_TD, 0, NULL);
641 return(0);
642 } else if (MAN_BLOCK == n->type) {
643 print_bvspace(h, n);
644 print_otag(h, TAG_TABLE, 0, NULL);
645 bufcat_su(h, "width", &su);
646 PAIR_STYLE_INIT(&tag, h);
647 print_otag(h, TAG_COL, 1, &tag);
648 print_otag(h, TAG_COL, 0, NULL);
649 print_otag(h, TAG_TBODY, 0, NULL);
650 print_otag(h, TAG_TR, 0, NULL);
651 return(1);
652 }
653
654 su.scale = -su.scale;
655 bufcat_su(h, "text-indent", &su);
656 PAIR_STYLE_INIT(&tag, h);
657 print_otag(h, TAG_TD, 1, &tag);
658 return(1);
659 }
660
661
662 /* ARGSUSED */
663 static int
664 man_B_pre(MAN_ARGS)
665 {
666
667 print_otag(h, TAG_B, 0, NULL);
668 return(1);
669 }
670
671
672 /* ARGSUSED */
673 static int
674 man_I_pre(MAN_ARGS)
675 {
676
677 print_otag(h, TAG_I, 0, NULL);
678 return(1);
679 }
680
681
682 /* ARGSUSED */
683 static int
684 man_literal_pre(MAN_ARGS)
685 {
686
687 if (MAN_nf == n->tok) {
688 print_otag(h, TAG_BR, 0, NULL);
689 mh->fl |= MANH_LITERAL;
690 } else
691 mh->fl &= ~MANH_LITERAL;
692
693 return(0);
694 }
695
696
697 /* ARGSUSED */
698 static int
699 man_in_pre(MAN_ARGS)
700 {
701
702 print_otag(h, TAG_BR, 0, NULL);
703 return(0);
704 }
705
706
707 /* ARGSUSED */
708 static int
709 man_ign_pre(MAN_ARGS)
710 {
711
712 return(0);
713 }
714
715
716 /* ARGSUSED */
717 static int
718 man_RS_pre(MAN_ARGS)
719 {
720 struct htmlpair tag;
721 struct roffsu su;
722
723 if (MAN_HEAD == n->type)
724 return(0);
725 else if (MAN_BODY == n->type)
726 return(1);
727
728 SCALE_HS_INIT(&su, INDENT);
729 if (n->head->child)
730 a2width(n->head->child, &su);
731
732 bufinit(h);
733 bufcat_su(h, "margin-left", &su);
734 PAIR_STYLE_INIT(&tag, h);
735 print_otag(h, TAG_DIV, 1, &tag);
736 return(1);
737 }