Supported HTML Tags and Options

Table 2‑1
Tag	Attributes	Notes
A /A	HREF="<url>" NAME=”<text>”	Anchor. A special syntax for HREF will invoke a PCL call with string arguments. HREF=”PCL:funct1(string1,string2,string3)” Note: See example for AAI.html_calls.
ADDRESS /ADDRESS	none	Address style - causes a switch to italic font.
B /B	none	Bolds the current font, looks for best fit among available fonts.
BLOCKQUOTE /BLOCKQUOTE	none	Indents left margin 5 font spaces. A blank line precedes and follows the block.
BODY/BODY	BGCOLOR=<color> TEXT=<color> LINK=<color> VLINK=<color>	The various attributes of the display are changed: background color, text color, unvisited text color, and visited text color. Colors may be specified in #rrggbb format or as color names recognized by the font alias file.
BR/BR	none	Line Break - The current line is ended, new text appears as a new line. Multiple breaks do not cause further line feeds.
CAPTION /CAPTION	Table Caption - text between <CAPTION>	Table Caption - text between <CAPTION> and </CAPTION> is rendered before the table. These tags must appear in the scope of a table or they are ignored.
CENTER /CENTER	The text between the opening and closing	The text between the opening and closing center tag is centered. This is similar to <P ALIGN=CENTER> except no paragraph is started. Tables and images may also be centered using the center tag.
CITE/CITE	none	Citation style - causes a switch to italic font
CODE/CODE	none	Coding style - causes a switch to a fixed font
DD/DD	Definition Description - Used within a	Definition Description - Used within a <DL> </DL> block, the text that follows is the definition description for the term of the previous term given by the <DT>. The <DD> text is indented.
DL/DL	COMPACT	Definition List - Encloses a definition list block containing pairs of <DT> and <DD> tags. The COMPACT attribute causes HView to suppress the normal line feed between the <DT> and <DD> when the <DT> text would not run into the <DD> start of text.
DT/DT	none	Definition Term - Used within a <DL> </DL> block, the text that follows is the definition term. Normally, a <DD> tag follows which contains the definition description of this term.
EM/EM	none	Emphasis - causes a switch to italics.
FONT/FONT	BGCOLOR=<color> SIZE=<n>	Changes font size and/or color. Colors may be specified in #rrggbb format or as color names recognized by the font alias file. The size parameter ranges from 1 (smallest) to 7 (largest). Size may also have a leading sign (+/-) in which case the resulting size is the sum of this value and basefont which defaults to 3.
H1 H2 H3 H4 H5 H6 /H1 /H2 /H3 /H4 /H5 /H6	ALIGN=CENTER ALIGN=RIGHT	Level n Heading - Switch to corresponding font as given by the resources XcgNh1Font ... XcgNh6Font. Headers appear on new lines with vertical space before and after. ALIGN=CENTER causes the text to be centered while ALIGN=RIGHT causes the text to be right justified.
HEAD/HEAD	none	Header Information - The text contained within is information regarding the document. These tags are ignored by HView.
HR/HR	Horizontal Rule - Draws a horizontal	Horizontal Rule - Draws a horizontal line. The line spans the current left and right margins.
HTML/HTML	HTML Block - The text between the tags	HTML Block - The text between the tags is an HTML document. These tags are ignored by HView.
I/I	none	Italic - causes a switch to italics.
IDENT/IDENT	ORIGIN="<string>"	Identification - A CGI enhanced tag which functions as a comment to identify the document that was used to generate this HTML. See the function XcgHViewFindIdent
IMG/IMG	SRC="URL"	Include Graphic image - The application callback defined by the getImageCallback resource is called. It must return a Pixmap which is displayed.
KBD/KBD	none	Keyboard Font - causes a switch to a fixed font.
LI/LI	none	list Item - Used within a <OL> <MENU> or <UL> block, the text that follows is a list item
MENU /MENU	none	Menu Block - same as unordered list <UL>.
OL/OL	none	Ordered List - Indented numbered list. Each item is preceded by <LI> tag.
P/P	ALIGN=CENTER ALIGN=RIGHT	Paragraph - A new paragraph is begun. Normally, a blank line precedes the paragraph. The ALIGN=CENTER causes the text to be centered (see also <CENTER>). ALIGN=RIGHT causes the text to be right justified.
PRE/PRE	none	Preformatted style - rendered literally (respecting tabs and linefeeds of input stream) in a fixed font.
SAMP/SAMP	none	Sample style - causes a switch to fixed font.
SKIP_IF/SKIP_IF	DEF="<string>" SKIP_MASK	Run time text exclusion - A CGI enhanced tag which allows the section of HTML text and tags between <SKIP_IF> and </SKIP_IF> to be excluded form processing depending on the conditions given in the attributes. If neither attribute is present, skip is performed unconditionally. If both are present, they are logically ORed. No nesting of this tag is allowed at this time. DEF="<string>":<string> is an environment symbol -skip is performed if symbol is defined and is non-empty. SKIP_MASK:skip is performed if skipMask resource is non-zero.
STRONG /STRONG	none	Emphasis - causes switch to bold font.
SUB /SUB	none	Subscript. Text between <SUB> and </SUB> is rendered as a subscript or slightly lower but in the same font of the preceding text. Nesting of <SUP> and <SUB> is not permitted.
SUP/SUP	none	Superscript. Text between <SUP> and </SUP> is rendered as a superscript or slightly elevated but in the same font of the preceding text. Nesting of <SUP> and <SUB> is not permitted.
TABLE/TABLE	BORDER	Table - Specifies the definition of a table containing columns (<TD> and <TH> tags) and rows (<TR> tags). The border option causes a border to be drawn in the table.
TD/TD	NOWRAP ALIGN=LEFT (def) ALIGN=RIGHT ALIGN=CENTER	Table Column - Begins a table column. Text within the column is aligned as specified. The NOWRAP attribute forces the text in the column to be on a single line.
TH/TH	See TD	Table Column Header - Functions exactly like <TD> except that the text is also bolded.
TITLE/TITLE	none	Document Title - The text within is captured and returned to the application via the titleCallback. A browser typically displays this text in the window decoration.
TR/TR	none	Table Row - Concludes a table row. Used within a <TABLE> </TABLE> block. The final <TR> prior to </TABLE> is optional
TT/TT	none	Typewrite Style - causes a switch to a fixed font.
U/U	none	Underline - The text within is underlined.
UL/UL	none	Unordered List Block - a bullet list is begun. Each item is designated by a <LI> tag and is preceded by a bullet.
VAR/VAR	none	Variable style - causes a switch to bold font.
<!-- -->	none	Comment - Everything in between the opening < and closing > is ignored. This includes text and tags. Comments may be nested allowing large sections of HTML to be safely omitted.

Table 2‑1

Tag

Attributes

Notes

A /A

HREF="<url>"
NAME=”<text>”

Anchor. A special syntax for HREF will invoke a PCL call with string arguments.
HREF=”PCL:funct1(string1,string2,string3)”

Note: See example for AAI.html_calls.

ADDRESS
/ADDRESS

none

Address style - causes a switch to italic font.

B /B

none

Bolds the current font, looks for best fit among available fonts.

BLOCKQUOTE

/BLOCKQUOTE

none

Indents left margin 5 font spaces. A blank line precedes and follows the block.

BODY/BODY

BGCOLOR=<color>
TEXT=<color>
LINK=<color>
VLINK=<color>

The various attributes of the display are changed: background color, text color, unvisited text color, and visited text color. Colors may be specified in #rrggbb format or as color names recognized by the font alias file.

BR/BR

none

Line Break - The current line is ended, new text appears as a new line. Multiple breaks do not cause further line feeds.

CAPTION
/CAPTION

Table Caption - text between <CAPTION>

Table Caption - text between <CAPTION> and </CAPTION> is rendered before the table. These tags must appear in the scope of a table or they are ignored.

CENTER
/CENTER

The text between the opening and closing

The text between the opening and closing center tag is centered. This is similar to <P ALIGN=CENTER> except no paragraph is started. Tables and images may also be centered using the center tag.

CITE/CITE

none

Citation style - causes a switch to italic font

CODE/CODE

none

Coding style - causes a switch to a fixed font

DD/DD

Definition Description - Used within a

Definition Description - Used within a <DL> </DL> block, the text that follows is the definition description for the term of the previous term given by the <DT>. The <DD> text is indented.

DL/DL

COMPACT

Definition List - Encloses a definition list block containing pairs of <DT> and <DD> tags. The COMPACT attribute causes HView to suppress the normal line feed between the <DT> and <DD> when the <DT> text would not run into the <DD> start of text.

DT/DT

none

Definition Term - Used within a <DL> </DL> block, the text that follows is the definition term. Normally, a <DD> tag follows which contains the definition description of this term.

EM/EM

none

Emphasis - causes a switch to italics.

FONT/FONT

BGCOLOR=<color>

SIZE=<n>

Changes font size and/or color. Colors may be specified in #rrggbb format or as color names recognized by the font alias file. The size parameter ranges from 1 (smallest) to 7 (largest). Size may also have a leading sign (+/-) in which case the resulting size is the sum of this value and basefont which defaults to 3.

H1 H2 H3
H4 H5 H6
/H1 /H2 /H3
/H4 /H5 /H6

ALIGN=CENTER

ALIGN=RIGHT

Level n Heading - Switch to corresponding font as given by the resources XcgNh1Font ... XcgNh6Font. Headers appear on new lines with vertical space before and after. ALIGN=CENTER causes the text to be centered while ALIGN=RIGHT causes the text to be right justified.

HEAD/HEAD

none

Header Information - The text contained within is information regarding the document. These tags are ignored by HView.

HR/HR

Horizontal Rule - Draws a horizontal

Horizontal Rule - Draws a horizontal line. The line spans the current left and right margins.

HTML/HTML

HTML Block - The text between the tags

HTML Block - The text between the tags is an HTML document. These tags are ignored by HView.

I/I

none

Italic - causes a switch to italics.

IDENT/IDENT

ORIGIN="<string>"

Identification - A CGI enhanced tag which functions as a comment to identify the document that was used to generate this HTML. See the function XcgHViewFindIdent

IMG/IMG

SRC="URL"

Include Graphic image - The application callback defined by the getImageCallback resource is called. It must return a Pixmap which is displayed.

KBD/KBD

none

Keyboard Font - causes a switch to a fixed font.

LI/LI

none

list Item - Used within a <OL> <MENU> or <UL> block, the text that follows is a list item

MENU /MENU

none

Menu Block - same as unordered list <UL>.

OL/OL

none

Ordered List - Indented numbered list. Each item is preceded by <LI> tag.

P/P

ALIGN=CENTER

ALIGN=RIGHT

Paragraph - A new paragraph is begun. Normally, a blank line precedes the paragraph. The ALIGN=CENTER causes the text to be centered (see also <CENTER>). ALIGN=RIGHT causes the text to be right justified.

PRE/PRE

none

Preformatted style - rendered literally (respecting tabs and linefeeds of input stream) in a fixed font.

SAMP/SAMP

none

Sample style - causes a switch to fixed font.

SKIP_IF/SKIP_IF

DEF="<string>"

SKIP_MASK

Run time text exclusion - A CGI enhanced tag which allows the section of HTML text and tags between <SKIP_IF> and </SKIP_IF> to be excluded form processing depending on the conditions given in the attributes.

If neither attribute is present, skip is performed unconditionally. If both are present, they are logically ORed. No nesting of this tag is allowed at this time.

DEF="<string>":<string> is an environment symbol -skip is performed if symbol is defined and is non-empty.

SKIP_MASK:skip is performed if skipMask resource is non-zero.

STRONG /STRONG

none

Emphasis - causes switch to bold font.

SUB /SUB

none

Subscript. Text between <SUB> and </SUB> is rendered as a subscript or slightly lower but in the same font of the preceding text. Nesting of <SUP> and <SUB> is not permitted.

SUP/SUP

none

Superscript. Text between <SUP> and </SUP> is rendered as a superscript or slightly elevated but in the same font of the preceding text. Nesting of <SUP> and <SUB> is not permitted.

TABLE/TABLE

BORDER

Table - Specifies the definition of a table containing columns (<TD> and <TH> tags) and rows (<TR> tags). The border option causes a border to be drawn in the table.

TD/TD

NOWRAP
ALIGN=LEFT (def)
ALIGN=RIGHT
ALIGN=CENTER

Table Column - Begins a table column. Text within the column is aligned as specified. The NOWRAP attribute forces the text in the column to be on a single line.

TH/TH

See TD

Table Column Header - Functions exactly like <TD> except that the text is also bolded.

TITLE/TITLE

none

Document Title - The text within is captured and returned to the application via the titleCallback. A browser typically displays this text in the window decoration.

TR/TR

none

Table Row - Concludes a table row. Used within a <TABLE> </TABLE> block. The final <TR> prior to </TABLE> is optional

TT/TT

none

Typewrite Style - causes a switch to a fixed font.

U/U

none

Underline - The text within is underlined.

UL/UL

none

Unordered List Block - a bullet list is begun. Each item is designated by a <LI> tag and is preceded by a bullet.

VAR/VAR

none

Variable style - causes a switch to bold font.

none

Comment - Everything in between the opening < and closing > is ignored. This includes text and tags. Comments may be nested allowing large sections of HTML to be safely omitted.