xref: /netbsd/external/bsd/mdocml/dist/html.h (revision 6550d01e)
1 /*	$Vendor-Id: html.h,v 1.38 2011/01/06 11:55:39 kristaps Exp $ */
2 /*
3  * Copyright (c) 2008, 2009, 2010 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 #ifndef HTML_H
18 #define HTML_H
19 
20 __BEGIN_DECLS
21 
22 enum	htmltag {
23 	TAG_HTML,
24 	TAG_HEAD,
25 	TAG_BODY,
26 	TAG_META,
27 	TAG_TITLE,
28 	TAG_DIV,
29 	TAG_H1,
30 	TAG_H2,
31 	TAG_SPAN,
32 	TAG_LINK,
33 	TAG_BR,
34 	TAG_A,
35 	TAG_TABLE,
36 	TAG_TBODY,
37 	TAG_COL,
38 	TAG_TR,
39 	TAG_TD,
40 	TAG_LI,
41 	TAG_UL,
42 	TAG_OL,
43 	TAG_DL,
44 	TAG_DT,
45 	TAG_DD,
46 	TAG_BLOCKQUOTE,
47 	TAG_P,
48 	TAG_PRE,
49 	TAG_B,
50 	TAG_I,
51 	TAG_CODE,
52 	TAG_SMALL,
53 	TAG_MAX
54 };
55 
56 enum	htmlattr {
57 	ATTR_HTTPEQUIV,
58 	ATTR_CONTENT,
59 	ATTR_NAME,
60 	ATTR_REL,
61 	ATTR_HREF,
62 	ATTR_TYPE,
63 	ATTR_MEDIA,
64 	ATTR_CLASS,
65 	ATTR_STYLE,
66 	ATTR_WIDTH,
67 	ATTR_ID,
68 	ATTR_SUMMARY,
69 	ATTR_ALIGN,
70 	ATTR_MAX
71 };
72 
73 enum	htmlfont {
74 	HTMLFONT_NONE = 0,
75 	HTMLFONT_BOLD,
76 	HTMLFONT_ITALIC,
77 	HTMLFONT_MAX
78 };
79 
80 struct	tag {
81 	struct tag	 *next;
82 	enum htmltag	  tag;
83 };
84 
85 struct tagq {
86 	struct tag	 *head;
87 };
88 
89 struct	htmlpair {
90 	enum htmlattr	  key;
91 	const char	 *val;
92 };
93 
94 #define	PAIR_INIT(p, t, v) \
95 	do { \
96 		(p)->key = (t); \
97 		(p)->val = (v); \
98 	} while (/* CONSTCOND */ 0)
99 
100 #define	PAIR_ID_INIT(p, v)	PAIR_INIT(p, ATTR_ID, v)
101 #define	PAIR_CLASS_INIT(p, v)	PAIR_INIT(p, ATTR_CLASS, v)
102 #define	PAIR_HREF_INIT(p, v)	PAIR_INIT(p, ATTR_HREF, v)
103 #define	PAIR_STYLE_INIT(p, h)	PAIR_INIT(p, ATTR_STYLE, (h)->buf)
104 #define	PAIR_SUMMARY_INIT(p, v)	PAIR_INIT(p, ATTR_SUMMARY, v)
105 
106 enum	htmltype {
107 	HTML_HTML_4_01_STRICT,
108 	HTML_XHTML_1_0_STRICT
109 };
110 
111 struct	html {
112 	int		  flags;
113 #define	HTML_NOSPACE	 (1 << 0)
114 #define	HTML_IGNDELIM	 (1 << 1)
115 #define	HTML_KEEP	 (1 << 2)
116 #define	HTML_PREKEEP	 (1 << 3)
117 #define	HTML_NONOSPACE	 (1 << 4)
118 	struct tagq	  tags; /* stack of open tags */
119 	struct rofftbl	  tbl; /* current table */
120 	void		 *symtab; /* character-escapes */
121 	char		 *base_man; /* base for manpage href */
122 	char		 *base_includes; /* base for include href */
123 	char		 *style; /* style-sheet URI */
124 	char		  buf[BUFSIZ]; /* see bufcat and friends */
125 	size_t		  buflen;
126 	struct tag	 *metaf; /* current open font scope */
127 	enum htmlfont	  metal; /* last used font */
128 	enum htmlfont	  metac; /* current font mode */
129 	enum htmltype	  type;
130 };
131 
132 void		  print_gen_decls(struct html *);
133 void		  print_gen_head(struct html *);
134 struct tag	 *print_otag(struct html *, enum htmltag,
135 				int, const struct htmlpair *);
136 void		  print_tagq(struct html *, const struct tag *);
137 void		  print_stagq(struct html *, const struct tag *);
138 void		  print_text(struct html *, const char *);
139 void		  print_tbl(struct html *, const struct tbl_span *);
140 
141 void		  bufcat_su(struct html *, const char *,
142 			const struct roffsu *);
143 void		  buffmt_man(struct html *,
144 			const char *, const char *);
145 void		  buffmt_includes(struct html *, const char *);
146 void		  buffmt(struct html *, const char *, ...);
147 void		  bufcat(struct html *, const char *);
148 void		  bufcat_style(struct html *,
149 			const char *, const char *);
150 void		  bufncat(struct html *, const char *, size_t);
151 void		  bufinit(struct html *);
152 
153 void		  html_idcat(char *, const char *, int);
154 
155 __END_DECLS
156 
157 #endif /*!HTML_H*/
158