- Notifications
You must be signed in to change notification settings - Fork 46
/
Copy path4-htmlref.html
592 lines (484 loc) · 24.3 KB
/
4-htmlref.html
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
<HTML>
<BODY>
<!-- FOOTER RIGHT "4-$CHAPTERPAGE" -->
<DIVALIGN="justify">
<H1ALIGN="RIGHT"><ANAME="HTMLREF">Chapter 4 - HTML Reference</A></H1>
This chapter defines all of the HTML elements and attributes that are
recognized and supported by HTMLDOC.
<H2>General Usage</H2>
<P>There are two types of HTML files - structured documents using
headings (H1, H2, etc.) which HTMLDOC calls "books", and
unstructured documents that do not use headings which HTMLDOC
calls "web pages".
<P>A very common mistake is to try converting a web page using:
<PRE>
htmldoc -f filename.pdf filename.html
</PRE>
<P>which will likely produce a PDF file with no pages. To convert web
page files you <B>must</B> use the <CODE>--webpage</CODE> option at the
command-line or choose <VAR>Web Page</VAR> in the input tab of the GUI.</p>
<blockquote><b>Note:</b> HTMLDOC does not support HTML 4.0 elements, attributes, stylesheets, or scripting.</blockquote>
<!-- NEED 5in -->
<H2>Elements</H2>
<P>The following HTML elements are recognized by HTMLDOC:</P>
<CENTER>
<TABLEBORDER="1" CELLPADDING="5">
<TR><TH>Element</TH><TH>Version</TH><TH>Supported?</TH><TH>Notes</TH></TR>
<TR><TD>!DOCTYPE</TD><TDALIGN="CENTER">3.0</TD><TDALIGN="CENTER">Yes</TD><TD>DTD is ignored</TD></TR>
<TR><TD>A</TD><TDALIGN="CENTER">1.0</TD><TDALIGN="CENTER">Yes</TD><TD><AHREF="#LINKS">See Below</A></TD></TR>
<TR><TD>ACRONYM</TD><TDALIGN="CENTER">2.0</TD><TDALIGN="CENTER">Yes</TD><TD>No font change</TD></TR>
<TR><TD>ADDRESS</TD><TDALIGN="CENTER">2.0</TD><TDALIGN="CENTER">Yes</TD><TD> </TD></TR>
<TR><TD>AREA</TD><TDALIGN="CENTER">2.0</TD><TDALIGN="CENTER">No</TD><TD> </TD></TR>
<TR><TD>B</TD><TDALIGN="CENTER">1.0</TD><TDALIGN="CENTER">Yes</TD><TD> </TD></TR>
<TR><TD>BASE</TD><TDALIGN="CENTER">2.0</TD><TDALIGN="CENTER">No</TD><TD> </TD></TR>
<TR><TD>BASEFONT</TD><TDALIGN="CENTER">1.0</TD><TDALIGN="CENTER">No</TD><TD> </TD></TR>
<TR><TD>BIG</TD><TDALIGN="CENTER">2.0</TD><TDALIGN="CENTER">Yes</TD><TD> </TD></TR>
<TR><TD>BLINK</TD><TDALIGN="CENTER">2.0</TD><TDALIGN="CENTER">No</TD><TD> </TD></TR>
<TR><TD>BLOCKQUOTE</TD><TDALIGN="CENTER">2.0</TD><TDALIGN="CENTER">Yes</TD><TD> </TD></TR>
<TR><TD>BODY</TD><TDALIGN="CENTER">1.0</TD><TDALIGN="CENTER">Yes</TD><TD> </TD></TR>
<TR><TD>BR</TD><TDALIGN="CENTER">2.0</TD><TDALIGN="CENTER">Yes</TD><TD> </TD></TR>
<TR><TD>CAPTION</TD><TDALIGN="CENTER">2.0</TD><TDALIGN="CENTER">Yes</TD><TD> </TD></TR>
<TR><TD>CENTER</TD><TDALIGN="CENTER">2.0</TD><TDALIGN="CENTER">Yes</TD><TD> </TD></TR>
<TR><TD>CITE</TD><TDALIGN="CENTER">2.0</TD><TDALIGN="CENTER">Yes</TD><TD>Italic/Oblique</TD></TR>
<TR><TD>CODE</TD><TDALIGN="CENTER">2.0</TD><TDALIGN="CENTER">Yes</TD><TD>Courier</TD></TR>
<TR><TD>DD</TD><TDALIGN="CENTER">2.0</TD><TDALIGN="CENTER">Yes</TD><TD> </TD></TR>
<TR><TD>DEL</TD><TDALIGN="CENTER">2.0</TD><TDALIGN="CENTER">Yes</TD><TD>Strikethrough</TD></TR>
<TR><TD>DFN</TD><TDALIGN="CENTER">2.0</TD><TDALIGN="CENTER">Yes</TD><TD>Helvetica</TD></TR>
<TR><TD>DIR</TD><TDALIGN="CENTER">2.0</TD><TDALIGN="CENTER">Yes</TD><TD> </TD></TR>
<TR><TD>DIV</TD><TDALIGN="CENTER">3.2</TD><TDALIGN="CENTER">Yes</TD><TD> </TD></TR>
<TR><TD>DL</TD><TDALIGN="CENTER">2.0</TD><TDALIGN="CENTER">Yes</TD><TD> </TD></TR>
<TR><TD>DT</TD><TDALIGN="CENTER">2.0</TD><TDALIGN="CENTER">Yes</TD><TD>Italic/Oblique</TD></TR>
<TR><TD>EM</TD><TDALIGN="CENTER">2.0</TD><TDALIGN="CENTER">Yes</TD><TD>Italic/Oblique</TD></TR>
<TR><TD>EMBED</TD><TDALIGN="CENTER">2.0</TD><TDALIGN="CENTER">Yes</TD><TD>HTML Only</TD></TR>
<TR><TD>FONT</TD><TDALIGN="CENTER">2.0</TD><TDALIGN="CENTER">Yes</TD><TD><AHREF="#FONT">See Below</A></TD></TR>
<TR><TD>FORM</TD><TDALIGN="CENTER">2.0</TD><TDALIGN="CENTER">No</TD><TD> </TD></TR>
<TR><TD>FRAME</TD><TDALIGN="CENTER">3.2</TD><TDALIGN="CENTER">No</TD><TD> </TD></TR>
<TR><TD>FRAMESET</TD><TDALIGN="CENTER">3.2</TD><TDALIGN="CENTER">No</TD><TD> </TD></TR>
<TR><TD>H1</TD><TDALIGN="CENTER">1.0</TD><TDALIGN="CENTER">Yes</TD><TD>Boldface, <AHREF="#HEADING">See Below</A></TD></TR>
<TR><TD>H2</TD><TDALIGN="CENTER">1.0</TD><TDALIGN="CENTER">Yes</TD><TD>Boldface, <AHREF="#HEADING">See Below</A></TD></TR>
<TR><TD>H3</TD><TDALIGN="CENTER">1.0</TD><TDALIGN="CENTER">Yes</TD><TD>Boldface, <AHREF="#HEADING">See Below</A></TD></TR>
<TR><TD>H4</TD><TDALIGN="CENTER">1.0</TD><TDALIGN="CENTER">Yes</TD><TD>Boldface, <AHREF="#HEADING">See Below</A></TD></TR>
<TR><TD>H5</TD><TDALIGN="CENTER">1.0</TD><TDALIGN="CENTER">Yes</TD><TD>Boldface, <AHREF="#HEADING">See Below</A></TD></TR>
<TR><TD>H6</TD><TDALIGN="CENTER">1.0</TD><TDALIGN="CENTER">Yes</TD><TD>Boldface, <AHREF="#HEADING">See Below</A></TD></TR>
<TR><TD>HEAD</TD><TDALIGN="CENTER">1.0</TD><TDALIGN="CENTER">Yes</TD><TD> </TD></TR>
<TR><TD>HR</TD><TDALIGN="CENTER">1.0</TD><TDALIGN="CENTER">Yes</TD><TD> </TD></TR>
<TR><TD>HTML</TD><TDALIGN="CENTER">1.0</TD><TDALIGN="CENTER">Yes</TD><TD> </TD></TR>
<TR><TD>I</TD><TDALIGN="CENTER">1.0</TD><TDALIGN="CENTER">Yes</TD><TD> </TD></TR>
<TR><TD>IMG</TD><TDALIGN="CENTER">1.0</TD><TDALIGN="CENTER">Yes</TD><TD><AHREF="#IMAGES">See Below</A></TD></TR>
<TR><TD>INPUT</TD><TDALIGN="CENTER">2.0</TD><TDALIGN="CENTER">No</TD><TD> </TD></TR>
<TR><TD>INS</TD><TDALIGN="CENTER">2.0</TD><TDALIGN="CENTER">Yes</TD><TD>Underline</TD></TR>
<TR><TD>ISINDEX</TD><TDALIGN="CENTER">2.0</TD><TDALIGN="CENTER">No</TD><TD> </TD></TR>
<TR><TD>KBD</TD><TDALIGN="CENTER">2.0</TD><TDALIGN="CENTER">Yes</TD><TD>Courier Bold</TD></TR>
<TR><TD>LI</TD><TDALIGN="CENTER">2.0</TD><TDALIGN="CENTER">Yes</TD><TD> </TD></TR>
<TR><TD>LINK</TD><TDALIGN="CENTER">2.0</TD><TDALIGN="CENTER">No</TD><TD> </TD></TR>
<TR><TD>MAP</TD><TDALIGN="CENTER">2.0</TD><TDALIGN="CENTER">No</TD><TD> </TD></TR>
<TR><TD>MENU</TD><TDALIGN="CENTER">2.0</TD><TDALIGN="CENTER">Yes</TD><TD> </TD></TR>
<TR><TD>META</TD><TDALIGN="CENTER">2.0</TD><TDALIGN="CENTER">Yes</TD><TD><AHREF="#META">See Below</A></TD></TR>
<TR><TD>MULTICOL</TD><TDALIGN="CENTER">N3.0</TD><TDALIGN="CENTER">No</TD><TD> </TD></TR>
<TR><TD>NOBR</TD><TDALIGN="CENTER">1.0</TD><TDALIGN="CENTER">No</TD><TD> </TD></TR>
<TR><TD>NOFRAMES</TD><TDALIGN="CENTER">3.2</TD><TDALIGN="CENTER">No</TD><TD> </TD></TR>
<TR><TD>OL</TD><TDALIGN="CENTER">2.0</TD><TDALIGN="CENTER">Yes</TD><TD> </TD></TR>
<TR><TD>OPTION</TD><TDALIGN="CENTER">2.0</TD><TDALIGN="CENTER">No</TD><TD> </TD></TR>
<TR><TD>P</TD><TDALIGN="CENTER">1.0</TD><TDALIGN="CENTER">Yes</TD><TD> </TD></TR>
<TR><TD>PRE</TD><TDALIGN="CENTER">1.0</TD><TDALIGN="CENTER">Yes</TD><TD> </TD></TR>
<TR><TD>S</TD><TDALIGN="CENTER">2.0</TD><TDALIGN="CENTER">Yes</TD><TD>Strikethrough</TD></TR>
<TR><TD>SAMP</TD><TDALIGN="CENTER">2.0</TD><TDALIGN="CENTER">Yes</TD><TD>Courier</TD></TR>
<TR><TD>SCRIPT</TD><TDALIGN="CENTER">2.0</TD><TDALIGN="CENTER">No</TD><TD> </TD></TR>
<TR><TD>SELECT</TD><TDALIGN="CENTER">2.0</TD><TDALIGN="CENTER">No</TD><TD> </TD></TR>
<TR><TD>SMALL</TD><TDALIGN="CENTER">2.0</TD><TDALIGN="CENTER">Yes</TD><TD> </TD></TR>
<TR><TD>SPACER</TD><TDALIGN="CENTER">N3.0</TD><TDALIGN="CENTER">Yes</TD><TD> </TD></TR>
<TR><TD>STRIKE</TD><TDALIGN="CENTER">2.0</TD><TDALIGN="CENTER">Yes</TD><TD> </TD></TR>
<TR><TD>STRONG</TD><TDALIGN="CENTER">2.0</TD><TDALIGN="CENTER">Yes</TD><TD>Boldface Italic/Oblique</TD></TR>
<TR><TD>SUB</TD><TDALIGN="CENTER">2.0</TD><TDALIGN="CENTER">Yes</TD><TD>Reduced Fontsize</TD></TR>
<TR><TD>SUP</TD><TDALIGN="CENTER">2.0</TD><TDALIGN="CENTER">Yes</TD><TD>Reduced Fontsize</TD></TR>
<TR><TD>TABLE</TD><TDALIGN="CENTER">2.0</TD><TDALIGN="CENTER">Yes</TD><TD><AHREF="#TABLE">See Below</A></TD></TR>
<TR><TD>TD</TD><TDALIGN="CENTER">2.0</TD><TDALIGN="CENTER">Yes</TD><TD> </TD></TR>
<TR><TD>TEXTAREA</TD><TDALIGN="CENTER">2.0</TD><TDALIGN="CENTER">No</TD><TD> </TD></TR>
<TR><TD>TH</TD><TDALIGN="CENTER">2.0</TD><TDALIGN="CENTER">Yes</TD><TD>Boldface Center</TD></TR>
<TR><TD>TITLE</TD><TDALIGN="CENTER">2.0</TD><TDALIGN="CENTER">Yes</TD><TD> </TD></TR>
<TR><TD>TR</TD><TDALIGN="CENTER">2.0</TD><TDALIGN="CENTER">Yes</TD><TD> </TD></TR>
<TR><TD>TT</TD><TDALIGN="CENTER">2.0</TD><TDALIGN="CENTER">Yes</TD><TD>Courier</TD></TR>
<TR><TD>U</TD><TDALIGN="CENTER">1.0</TD><TDALIGN="CENTER">Yes</TD><TD> </TD></TR>
<TR><TD>UL</TD><TDALIGN="CENTER">2.0</TD><TDALIGN="CENTER">Yes</TD><TD> </TD></TR>
<TR><TD>VAR</TD><TDALIGN="CENTER">2.0</TD><TDALIGN="CENTER">Yes</TD><TD>Helvetica Oblique</TD></TR>
<TR><TD>WBR</TD><TDALIGN="CENTER">1.0</TD><TDALIGN="CENTER">No</TD><TD> </TD></TR>
</TABLE>
</CENTER>
<H2><ANAME="COMMENTS">Comments</A></H2>
<P>HTMLDOC supports many special HTML comments to
initiate page breaks, set the header and footer text, and
control the current media options:</P>
<DL>
<!-- NEED 1in -->
<DT><CODE><!-- FOOTER LEFT "foo" --></CODE>
<DD>Sets the left footer text; the test is applied to
the current page if empty, or the next page otherwise.
<!-- NEED 1in -->
<DT><CODE><!-- FOOTER CENTER "foo" --></CODE>
<DD>Sets the center footer text; the test is applied to
the current page if empty, or the next page otherwise.
<!-- NEED 1in -->
<DT><CODE><!-- FOOTER RIGHT "foo" --></CODE>
<DD>Sets the right footer text; the test is applied to
the current page if empty, or the next page otherwise.
<!-- NEED 1in -->
<DT><CODE><!-- HALF PAGE --></CODE>
<DD>Break to the next half page.
<!-- NEED 1in -->
<DT><CODE><!-- HEADER LEFT "foo" --></CODE>
<DD>Sets the left header text; the test is applied to
the current page if empty, or the next page otherwise.
<!-- NEED 1in -->
<DT><CODE><!-- HEADER CENTER "foo" --></CODE>
<DD>Sets the center header text; the test is applied to
the current page if empty, or the next page otherwise.
<!-- NEED 1in -->
<DT><CODE><!-- HEADER RIGHT "foo" --></CODE>
<DD>Sets the right header text; the test is applied to
the current page if empty, or the next page otherwise.
<!-- NEED 1in -->
<DT><CODE><!-- MEDIA BOTTOM nnn --></CODE>
<DD>Sets the bottom margin of the page. The "nnn" string can
be any standard measurement value, e.g. 0.5in, 36, 12mm, etc.
Breaks to a new page if the current page is already marked.
<!-- NEED 1in -->
<DT><CODE><!-- MEDIA COLOR "foo" --></CODE>
<DD>Sets the media color attribute for the page. The
"foo" string is any color name that is supported by the
printer, e.g. "Blue", "White", etc. Breaks to a new
page or sheet if the current page is already marked.
<!-- NEED 1in -->
<DT><CODE><!-- MEDIA DUPLEX NO --></CODE>
<DD>Chooses single-sided printing for the page; breaks to a
new page or sheet if the current page is already marked.
<!-- NEED 1in -->
<DT><CODE><!-- MEDIA DUPLEX YES --></CODE>
<DD>Chooses double-sided printing for the page; breaks to a
new sheet if the current page is already marked.
<!-- NEED 1in -->
<DT><CODE><!-- MEDIA LANDSCAPE NO --></CODE>
<DD>Chooses portrait orientation for the page; breaks to a
new page if the current page is already marked.
<!-- NEED 1in -->
<DT><CODE><!-- MEDIA LANDSCAPE YES --></CODE>
<DD>Chooses landscape orientation for the page; breaks to a
new page if the current page is already marked.
<!-- NEED 1in -->
<DT><CODE><!-- MEDIA LEFT nnn --></CODE>
<DD>Sets the left margin of the page. The "nnn" string can
be any standard measurement value, e.g. 0.5in, 36, 12mm, etc.
Breaks to a new page if the current page is already marked.
<!-- NEED 1in -->
<DT><CODE><!-- MEDIA POSITION nnn --></CODE>
<DD>Sets the media position attribute (input tray) for
the page. The "nnn" string is an integer that usually
specifies the tray number. Breaks to a new page or sheet
if the current page is already marked.
<!-- NEED 1in -->
<DT><CODE><!-- MEDIA RIGHT nnn --></CODE>
<DD>Sets the right margin of the page. The "nnn" string can
be any standard measurement value, e.g. 0.5in, 36, 12mm, etc.
Breaks to a new page if the current page is already marked.
<!-- NEED 1in -->
<DT><CODE><!-- MEDIA SIZE foo --></CODE>
<DD>Sets the media size to the specified size. The "foo"
string can be "Letter", "Legal", "Universal", or "A4"
for standard sizes or "WIDTHxHEIGHTunits" for custom
sizes, e.g. "8.5x11in"; breaks to a new page or sheet if
the current page is already marked.
<!-- NEED 1in -->
<DT><CODE><!-- MEDIA TOP nnn --></CODE>
<DD>Sets the top margin of the page. The "nnn" string can
be any standard measurement value, e.g. 0.5in, 36, 12mm, etc.
Breaks to a new page if the current page is already marked.
<!-- NEED 1in -->
<DT><CODE><!-- MEDIA TYPE "foo" --></CODE>
<DD>Sets the media type attribute for the page. The
"foo" string is any type name that is supported by the
printer, e.g. "Plain", "Glossy", etc. Breaks to a new
page or sheet if the current page is already marked.
<!-- NEED 1in -->
<DT><CODE><!-- NEED length --></CODE>
<DD>Break if there is less than <CODE>length</CODE>
units left on the current page. The <CODE>length</CODE>
value defaults to lines of text but can be suffixed by
<CODE>in</CODE>, <CODE>mm</CODE>, or <CODE>cm</CODE> to
convert from the corresponding units.
<!-- NEED 1in -->
<DT><CODE><!-- NEW PAGE --></CODE>
<DD>Break to the next page.
<!-- NEED 1in -->
<DT><CODE><!-- NEW SHEET --></CODE>
<DD>Break to the next sheet.
<!-- NEED 1in -->
<DT><CODE><!-- NUMBER-UP nn --></CODE>
<DD>Sets the number of pages that are placed on each
output page. Valid values are 1, 2, 4, 6, 9, and 16.
<!-- NEED 1in -->
<DT><CODE><!-- PAGE BREAK --></CODE>
<DD>Break to the next page.
</DL>
<!-- NEED 2in -->
<H3>Header/Footer Strings</H3>
<P>The <CODE>HEADER</CODE> and <CODE>FOOTER</CODE> comments
allow you to set an arbitrary string of text for the left,
center, and right headers and footers. Each string consists of
plain text; special values or strings can be inserted using the
dollar sign (<CODE>$</CODE>):</P>
<DL>
<!-- NEED 1in -->
<DT><CODE>$$</CODE>
<DD>Inserts a single dollar sign in the header.
<!-- NEED 1in -->
<DT><CODE>$CHAPTER</CODE>
<DD>Inserts the current chapter heading.
<!-- NEED 1.5in -->
<DT><CODE>$CHAPTERPAGE</CODE>
<DT><CODE>$CHAPTERPAGE(format)</CODE>
<DD>Inserts the current page number within a chapter or
file. When a format is specified, uses that numeric
format (1 = decimal, i = lowercase roman numerals, I =
uppercase roman numerals, a = lowercase ascii, A =
uppercase ascii) for the page numbers.
<!-- NEED 1.5in -->
<DT><CODE>$CHAPTERPAGES</CODE>
<DT><CODE>$CHAPTERPAGES(format)</CODE>
<DD>Inserts the total page count within a chapter or
file. When a format is specified, uses that numeric
format (1 = decimal, i = lowercase roman numerals, I =
uppercase roman numerals, a = lowercase ascii, A =
uppercase ascii) for the page count.
<!-- NEED 1in -->
<DT><CODE>$DATE</CODE>
<DT><CODE>$DATE(format)</CODE>
<DD>Inserts the current date. See <ahref="#DATETIME">Date/Time
Formats</a> for details on the format string. When no format is
supplied, the default date format for the current locale is used.
<!-- NEED 1in -->
<DT><CODE>$HEADING</CODE>
<DD>Inserts the current heading.
<!-- NEED 1in -->
<DT><CODE>$HFIMAGE1</CODE>
<DT><CODE>$HFIMAGE2</CODE>
<DT><CODE>$HFIMAGE3</CODE>
<DT><CODE>$HFIMAGE4</CODE>
<DT><CODE>$HFIMAGE5</CODE>
<DT><CODE>$HFIMAGE6</CODE>
<DT><CODE>$HFIMAGE7</CODE>
<DT><CODE>$HFIMAGE8</CODE>
<DT><CODE>$HFIMAGE9</CODE>
<DT><CODE>$HFIMAGE10</CODE>
<DD>Inserts the specified header/footer image; all other text in the
string will be ignored.
<!-- NEED 1in -->
<DT><CODE>$LETTERHEAD</CODE>
<DD>Inserts the logo image as a letterhead with no down-scaling; all
other text in the string will be ignored.
<!-- NEED 1in -->
<DT><CODE>$LOGOIMAGE</CODE>
<DD>Inserts the logo image; all other text in the string
will be ignored.
<!-- NEED 1in -->
<DT><CODE>$PAGE</CODE>
<DT><CODE>$PAGE(format)</CODE>
<DD>Inserts the current page number. When a format is
specified, uses that numeric format (1 = decimal, i =
lowercase roman numerals, I = uppercase roman numerals,
a = lowercase ascii, A = uppercase ascii) for the page
numbers.
<!-- NEED 1.5in -->
<DT><CODE>$PAGES</CODE>
<DT><CODE>$PAGES(format)</CODE>
<DD>Inserts the total page count. When a format is
specified, uses that numeric format (1 = decimal, i =
lowercase roman numerals, I = uppercase roman numerals,
a = lowercase ascii, A = uppercase ascii) for the page
count.
<!-- NEED 1in -->
<DT><CODE>$TIME</CODE>
<DT><CODE>$TIME(format)</CODE>
<DD>Inserts the current time. See <ahref="#DATETIME">Date/Time
Formats</a> for details on the format string. When no format is
supplied, the default time format for the current locale is used.
<!-- NEED 1in -->
<DT><CODE>$TITLE</CODE>
<DD>Inserts the document title.
<!-- NEED 1in -->
<DT><CODE>$URL</CODE>
<DD>Inserts the document filename or URL.
</DL>
<H3><ANAME="DATETIME">Date/Time Formats</A></H3>
<p>The <CODE>$DATE</CODE> and <CODE>$TIME</CODE> header/footer strings support
an optional format string in parenthesis. Letters represent date/time values
while other characters are inserted verbatim. The following letters are
supported:</p>
<center>
<tableborder="1" cellpadding="5">
<tr><th>Letter</th><th>Description</th></tr>
<tr><td><code>A</code></td><td>Full weekday name</td></tr>
<tr><td><code>a</code></td><td>Abbreviated weekday name</td></tr>
<tr><td><code>B</code></td><td>Full month name</td></tr>
<tr><td><code>b</code></td><td>Abbreviated month name</td></tr>
<tr><td><code>C</code></td><td>Century (CC)</td></tr>
<tr><td><code>c</code></td><td>Default date and time format</td></tr>
<tr><td><code>d</code></td><td>Day of the month ("01" to "31")</td></tr>
<tr><td><code>e</code></td><td>Day of the month (" 1" to "31")</td></tr>
<tr><td><code>F</code></td><td>YYYY-MM-DD</td></tr>
<tr><td><code>H</code></td><td>Hours for 24-hour clock ("00" to "23")</td></tr>
<tr><td><code>I</code></td><td>Hours for 12-hour clock ("01" to "12")</td></tr>
<tr><td><code>j</code></td><td>Day of the year ("001" to "366")</td></tr>
<tr><td><code>k</code></td><td>Hours for 24-hour clock (" 0" to "23")</td></tr>
<tr><td><code>l</code></td><td>Hours for 12-hour clock (" 1" to "12")</td></tr>
<tr><td><code>M</code></td><td>Minutes ("00" to "59")</td></tr>
<tr><td><code>m</code></td><td>Month number ("01" to "12")</td></tr>
<tr><td><code>p</code></td><td>"am" or "pm"</td></tr>
<tr><td><code>R</code></td><td>Hours and minutes ("HH:MM")</td></tr>
<tr><td><code>r</code></td><td>Hours, minutes, seconds, and am/pm ("HH:MM:SS am/pm")</td></tr>
<tr><td><code>S</code></td><td>Seconds ("00" to "60")</td></tr>
<tr><td><code>T</code></td><td>Hours, minutes, and seconds ("HH:MM:SS")</td></tr>
<tr><td><code>X</code></td><td>Default time format</td></tr>
<tr><td><code>x</code></td><td>Default date format</td></tr>
<tr><td><code>Y</code></td><td>Year with century (CCYY)</td></tr>
<tr><td><code>y</code></td><td>Year without century (YY)</td></tr>
<tr><td><code>Z</code></td><td>Time zone name</td></tr>
<tr><td><code>z</code></td><td>Time zone offset from UTC</td></tr>
</table>
</center>
<!-- NEED 5in -->
<H2><ANAME="FONT">FONT Attributes</A></H2>
<P>Limited typeface specification is currently supported to ensure
portability across platforms and for older PostScript printers:</P>
<CENTER><TABLEBORDER="1" CELLPADDING="5">
<TR><TH>Requested Font</TH><TH>Actual Font</TH></TR>
<TR><TD>Arial</TD><TD>Helvetica</TD></TR>
<TR><TD>Courier</TD><TD>Courier</TD></TR>
<TR><TD>Dingbats</TD><TD>Dingbats</TD></TR>
<TR><TD>Helvetica</TD><TD>Helvetica</TD></TR>
<TR><TD>Monospace</TD><TD>DejaVu Sans Mono</TD></TR>
<TR><TD>Sans</TD><TD>DejaVu Sans</TD></TR>
<TR><TD>Serif</TD><TD>DejaVu Serif</TD></TR>
<TR><TD>Symbol</TD><TD>Symbol</TD></TR>
<TR><TD>Times</TD><TD>Times</TD></TR>
</TABLE></CENTER>
<P>All other unrecognized typefaces are silently ignored.</P>
<H2><ANAME="HEADING">Headings</A></H2>
<P>Currently HTMLDOC supports a maximum of 1000 chapters
(H1 headings). This limit can be increased by changing the
<CODE>MAX_CHAPTERS</CODE> constant in the <VAR>config.h</VAR>
file included with the source code.
<P>All chapters start with a top-level heading (H1) markup. Any
headings within a chapter must be of a lower level (H2 to H15). Each
chapter starts a new page or the next odd-numbered page if duplexing is
selected.</p>
<blockquote><b>Note:</b> Heading levels 7 to 15 are not standard HTML and will not likely be recognized by most web browsers.</blockquote>
<P>The headings you use within a chapter must start at level 2 (H2). If
you skip levels the heading will be shown under the last level that was
known. For example, if you use the following hierarchy of headings:
<PRE>
<H1>Chapter Heading</H1>
...
<H2>Section Heading 1</H2>
...
<H2>Section Heading 2</H2>
...
<H3>Sub-Section Heading 1</H3>
...
<H4>Sub-Sub-Section Heading 1</H4>
...
<H4>Sub-Sub-Section Heading 2</H4>
...
<H3>Sub-Section Heading 2</H3>
...
<H2>Section Heading 3</H2>
...
<H4>Sub-Sub-Section Heading 3</H4>
...
</PRE>
the table-of-contents that is generated will show:
<ul>
<li><b>Chapter Heading</b><ul>
<li>Section Heading 1</li>
<li>Section Heading 2<ul>
<li>Sub-Section Heading 1<ul>
<li>Sub-Sub-Section Heading 1</li>
<li>Sub-Sub-Section Heading 2</li>
</ul></li>
<li>Sub-Section Heading 2<ul>
<li>Sub-Sub-Section Heading 3</li>
</ul></li>
</ul></li>
<li>Section Heading 3</li>
</ul></li>
</ul>
<!-- NEED 4in -->
<H3>Numbered Headings</H3>
When the numbered headings option is enabled, HTMLDOC recognizes the
following additional attributes for all heading elements:
<DL>
<DT><CODE>VALUE="#"</CODE>
<DD>Specifies the starting value for this heading level
(default is "1" for all new levels).
<DT><CODE>TYPE="1"</CODE>
<DD>Specifies that decimal numbers should be generated for this
heading level.
<DT><CODE>TYPE="a"</CODE>
<DD>Specifies that lowercase letters should be generated for
this heading level.
<DT><CODE>TYPE="A"</CODE>
<DD>Specifies that uppercase letters should be generated for
this heading level.
<DT><CODE>TYPE="i"</CODE>
<DD>Specifies that lowercase roman numerals should be generated
for this heading level.
<DT><CODE>TYPE="I"</CODE>
<DD>Specifies that uppercase roman numerals should be generated
for this heading level.
</DL>
<!-- NEED 2in -->
<H2><ANAME="IMAGES">Images</A></H2>
HTMLDOC supports loading of GIF, JPEG, and PNG image files. BMP image support
is deprecated and will be removed in a future version of HTMLDOC. EPS and other
types of image files are not supported at this time.
<!-- NEED 2in -->
<H2><ANAME="LINKS">Links</A></H2>
<P>External URL and internal (<CODE>#target</CODE> and
<CODE>filename.html</CODE>) links are fully supported for HTML
and PDF output.
<P>When generating PDF files, local PDF file links will be
converted to external file links for the PDF viewer instead of
URL links. That is, you can directly link to another local PDF
file from your HTML document with:
<PRE>
<A HREF="filename.pdf">...</A>
</PRE>
<!-- NEED 5in -->
<H2><ANAME="META">META Attributes</A></H2>
<P>HTMLDOC supports the following <CODE>META</CODE>
attributes for the title page and document information:
<DL>
<DT><CODE><META NAME="AUTHOR" CONTENT="..."</CODE>
<DD>Specifies the document author.
<DT><CODE><META NAME="COPYRIGHT" CONTENT="..."</CODE>
<DD>Specifies the document copyright.
<DT><CODE><META NAME="DOCNUMBER" CONTENT="..."</CODE>
<DD>Specifies the document number.
<DT><CODE><META NAME="GENERATOR" CONTENT="..."</CODE>
<DD>Specifies the application that generated the HTML file.
<DT><CODE><META NAME="HTMLDOC.filename" CONTENT="..."</CODE>
<DD>Specifies the filename that is reported in CGI mode.
<DT><CODE><META NAME="KEYWORDS" CONTENT="..."</CODE>
<DD>Specifies document search keywords.
<DT><CODE><META NAME="SUBJECT" CONTENT="..."</CODE>
<DD>Specifies document subject.
</DL>
<H2><ANAME="TABLE">Tables</A></H2>
Currently HTMLDOC supports a maximum of 200 columns within a
single table. This limit can be increased by changing the
<CODE>MAX_COLUMNS</CODE> constant in the <VAR>config.h</VAR> file
included with the source code.
<P><B>HTMLDOC does not support HTML 4.0 table elements or
attributes, such as <CODE>TBODY</CODE>, <CODE>THEAD</CODE>,
<CODE>TFOOT</CODE>, or <CODE>RULES</CODE>.</B>
</DIV>
</BODY>
</HTML>
