Tags Supported by the Library

title, /title

The document title. No markup is permitted between the opening and closing tags, otherwise the title string is truncated at the first non /title tag.

h1, h2, h3, h4, h5, h6 /h1, /h2, /h3, /h4, /h5, /h6

Heading levels.

p, /p (optional)

Paragraphs are rendered block left, with one blank line.

pre, /pre

Preformatted text. All whitespace is preserved. Any markup is permitted inside of a pre tag. Rendered in a mono-spaced font.

address, /address

Address delimeters, rendered in an italic font.

blockquote, /blockquote

Block quotes nest on the left with the list constructs and other blockquote tags, but the right-margin indent level does not nest. They are rendered in italics, with a blank line above and below.

ul li... /ul

Unordered lists. Rendered with a different marker symbol for each indent level. The default symbols are: O*=+-o\xd7\xb0:\xb7

ol li... /ol

Ordered lists. Rendered with a number for each list element. Each indent level has its own numbering.

dir li... /dir

Directory listings. Rendered the same as unordered lists.

menu li... /menu

Menu lists. Rendered with a unique (->) list element symbol.

dl (dt...,dd)... /dl

Definition lists. There may be multiple dt elements per dd element.

cite

Citation. Rendered in italics.

code

Code fragment. Rendered in a mono-spaced font.

em

Emphasized. Rendred in italics.

kbd

Keyboard or user input. Rendered in a bold, mono-spaced font.

samp

Sample. endered in a mono-spaced font.

strong

Different from em. Rendered in bold face.

var

A variable reference. Rendered in italics.

b

Bold face.

i

Italics

tt

A typewriter, or mono-spaced font.

br

A line break.

hr

A horizontal rule. Rendered as a full width horizontal line.

a

A hyperlink anchor. The supported parameters are name and href. The name parameter is the target, or destination of a hyperlink. It can be referenced by using the HMgoto callback, with name as an argument.

The href tag is accessed by two callback routines. HMlink_setup is called once for each hyperlink. It is expected to associate any application specific behavior with a hyper-link. The default version of HMlink_setup arranges for hyperlinks to be highlighted/dehilighted upon cursor entry and exit. When the link is activated (with mouse button 1) HMlink_callback, which is supplied by the application, is called.

Any additional parameters supplied with the a tag are passed as an argument to the call-back routines.

img

An in-line image. Inline images are obtained in two steps. First, The align, alt, src, and ismap attributes are handled by the library.

As each inline image tag is seen, the procedure (supplied by the application) HMset_image handle src is called. The application is expected to locate the image (using src, and create a TK image with it.

The application then calls HM_got_image handle image, where handle was the value passed to HM_set_image, and image is either the name of a TK image, or an error message.

If the parameter ismap was supplied, then a call to HMlink_callback is made when the image is clicked on.

Tags Supported by the Library that are not in the spec

u

underline

strike

Text is rendered with a horizontal line through it.

center

All text and images starting at the next line break are centered.

dfn

Definition terms

Unsupported tags

head /head

This tag is used by servers, and has no meaning in the context of document display.

body /body

This tag is used by servers, and has no meaning in the context of document display.

meta /meta

This tag is used by servers, and has no meaning in the context of document display.

base /base

This tag does not effect the document display. The functions HMtag_base and HMtag_/base need to be supplied by the application.

link

This tag does not effect the document display. The function HMtag_link needs to be supplied by the application.

nextid

This tag is deprecated and does not effect the document display.

xmp

listing

These tags are deprecated and not supported

Notes

• All of the list constructs: ul,ol,menu,dir and dl support the compact attribute, which produces a more compact rendering
• If the li elements are left off of lists, the ul,/ul or pairs act as a indent operator.
• No markup may be contained within a dt element of a definition list, although any prevailing font properties are observered.
• No markup is permitted between the opening and closing title tags, otherwise the title string is truncated at the first tag.
• The application may supply its own behavior for any html tag, or override the default behavior by supplying a procedure of the form HMtag_tag or HMtag_/tag, where tag is the html tag whose behavior is to be defined. See the reference manual for details.
• The default white space and font style selection for all built-in tags may be changed by the application by changing values in either the HMinsert_map or HMtag_map. See the manual for details.

Exceptions

• The text scrolling behavior is poor when the page contains large embedded images
• In this version, there is no direct way to change the font used in form data entry fields, you need to use the option database.
• Too much white space sometimes gets added when succesive multiple white-space separated html tags with no plain text are encountered.