File: extensions.html

package info (click to toggle)
xmhtml 1.1.7-18
links: PTS
area: main
in suites: wheezy
size: 6,576 kB
sloc: ansic: 68,174; makefile: 438; sh: 158; perl: 36
file content (226 lines) | stat: -rw-r--r-- 7,757 bytes
parent folder | download | duplicates (10)
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2//EN">
<HTML>
<HEAD>
	<TITLE>XmHTML HTML extensions</TITLE>
	<META HTTP-EQUIV="Keywords" CONTENT="XmHTML, HTML, Motif, Widget, eXode, XntHelp, Linux">
	<META HTTP-EQUIV="Reply-to" CONTENT="ripley@xs4all.nl">
	<META HTTP-EQUIV="Description" CONTENT="This document describes the 
XmHTML HTML extensions to HTML 3.2">
	<META NAME="Author" CONTENT="Koen D'Hondt">
	<META NAME="Copyright" content="1995-1997 by Ripley Software Development">
	<META NAME="Source" content="$Source$">
	<META NAME="Revision" content="$Revision$">
<!--
	<base href="http://www.xs4all.nl/~ripley/eXode/">
-->
	<link rev="made" href="mailto:ripley@xs4all.nl">
	<link rel="home" href="http://www.xs4all.nl/~ripley">
	<link rel="previous" href="debug.html">
	<link rel="index" href="XmHTML.html">
	<link rel="TOC" href="XmHTML.html#toc">
	<link rel="copyright" href="copyrights.html">
</HEAD>

<BODY BGCOLOR="#FFFFFF" text="#000000">

<h1><a name="top">XmHTML HTML Extensions</a></h1>
XmHTML implements the following extensions to the HTML 3.2 standard.

<p><IMG SRC="../Images/wood/bar.gif" width=508 height=15><p>

<h3>The FRAMESET Extension</h3>

XmHTML widget's fully recognize and support the &lt;FRAMESET&gt; extension. See
the <a href="xmhtml_prog.html#advanced_frame">XmHTML Programmers Manual</a> on
how you can add frame support to your application by using XmHTML.

<p><IMG SRC="../Images/wood/bar.gif" width=508 height=15><p>

<h3>Extensions to the &lt;A&gt; Element</h3>

Support for the &lt;FRAMESET&gt; extension also implies that XmHTML recognizes
the <b>target</b> attribute on the &lt;A&gt; element. 
<p>

Besides being usefull for the frameset extension, the <b>target</b> attribute
can be usefull in a variety of other ways, e.i., one could use this extension
in a Hypertext Help system to indicate that something should be displayed in a
popup window. 

<p><IMG SRC="../Images/wood/bar.gif" width=508 height=15><p>
<h3>Extensions to the &lt;FONT&gt; Element</h3>

XmHTML widget's fully support the <b>FACE</b> tag on the HTML 3.2 &lt;FONT&gt;
element. This extension specifies the typeface of a font in which the text that
this element encloses should be rendered.
<p>

The value for this tag should be a quoted, comma seperated list of alternative
typefaces.

<p><IMG SRC="../Images/wood/bar.gif" width=508 height=15><p>
<h3>Extensions to the &lt;OL&gt; Element</h3>

XmHTML introduces the <b>ISINDEX</b> tag to the HTML 3.2 &lt;OL&gt; element.
Using this extension produces a Table of Contents by propagating the current
item numbering within nested lists:

<pre>
&lt;OL&gt;
	&lt;LI&gt;The Basics of a XmHTML Widget
	&lt;OL ISINDEX TYPE="a"&gt;
		&lt;LI&gt;Creating a XmHTML Widget
		&lt;LI&gt;The XmHTML Widget's Text
	&lt;/OL&gt;
	&lt;LI&gt;Modifying the Document Appearance
&lt;/OL&gt;
</pre>
is rendered as:
<pre>
	1. The Basics of a XmHTML Widget
		1.a Creating a XmHTML Widget
		1.b The XmHTML Widget's Text
	2. Modifying the Document Appearance
</pre>
This extension can be used with any combination of the <b>TYPE</b> and
<b>START</b> tags.

<p><IMG SRC="../Images/wood/bar.gif" width=508 height=15><p>
<h3><a name="form">Extensions to the &lt;INPUT&gt; Element</a></h3>

A XmHTML Widget fully supports the file form input element. This element is
consists of a textfield with a pushbutton. When a user presses this button a
file selection dialog is displayed allowing the user to select a file for
uploading.
<p>

The following attributes are recognized for this input element:
<blockquote><tt>
<b>NAME=string</b>, VALUE=string, SRC=string, SIZE=n, MULTIPLE
</tt></blockquote>
<p>
<dl>
	<dt>NAME
	<dd>Mandatory, name for this input field;
	<dt>VALUE
	<dd>optional, a label to be used for the pushbutton. The default
		value is <tt><b>Browse...</b></tt>;
	<dt>SRC
	<dd>optional, a file selection pattern to be used for the file
		selection dialog. The default value is <tt><b>*</b></tt>;
	<dt>SIZE
	<dd>optional, the width of the textfield. The default value is
		<tt><b>20</b></tt>;
	<dt>MULTIPLE
	<dd>optional, allows multiple file selection. Each file that is
		selected via the file selection dialog is separated from already
		selected files by a colon.
</dl>

<p><IMG SRC="../Images/wood/bar.gif" width=508 height=15><p>

<h3>The ALIGN tag</h3>
The ALIGN tag is extended by one additional alignment, namely JUSTIFY. This
alignment will cause text to be justified between the text margins, causing
each line in a paragraph to have the same left and right margin. The last
line in a paragraph is never justified, it's alignment is determined by
the <a href="XmHTML.html#XmNalignment">default alignment</a>.
<p> 

Hyphenation is not supported by this
extension, but may be added in the future when a LANGUAGE tag is added to the
STYLE element.

<p>
This extension for the ALIGN tag is supported for the following elements:
<p>

<menu>
<li>&lt;P&gt;
<li>&lt;DIV&gt;
<li>&lt;TABLE&gt;
<li>&lt;TD&gt;
<li>&lt;TH&gt;
<li>&lt;H1&gt; thru &lt;H6&gt;
</menu>

<p><a name="color"><IMG SRC="../Images/wood/bar.gif" width=508 height=15></a><p>

<h3>The COLOR tag</h3>
XmHTML extends the use of the COLOR tag from the &lt;FONT&gt; element to
a number of other HTML elements. These elements are:
<p>
<menu>
<li>&lt;CODE&gt;
<li>&lt;SAMP&gt;
<li>&lt;KBD&gt;
<li>&lt;TT&gt;
<li>&lt;STRONG&gt;
<li>&lt;B&gt;
<li>&lt;EM&gt;
<li>&lt;VAR&gt;
<li>&lt;CITE&gt;
<li>&lt;I&gt;
<li>&lt;ADDRESS&gt;
<li>&lt;H1&gt; thru &lt;H6&gt;
<li>&lt;BLOCKQUOTE&gt;
<li>&lt;PRE&gt;
<li>&lt;DIV&gt; and its derivative &lt;CENTER&gt;
<li>&lt;P&gt;
<li>&lt;HR&gt; with or without the <b>noshade</b> attribute set. Rules
	inherit the color attribute from surrounding container tags (such as
	&lt;DIV&gt; or &lt;CENTER&gt;)
</menu>

<p>
<h4><a name="colors">Color Specification</a></h4>
<p>
Colors are given in RGB as hexadecimal numbers (e.g. COLOR="#C0FFC0") or as 
one of 16 widely understood color names. These colors were originally picked 
as being the standard 16 colors supported with the Windows VGA palette
(or how low can you go).

<table align=center width="80%" border=1 cellspacing=10 cellpadding=3>
<caption>Color names and sRGB values</caption>
<tr><td bgcolor=black width=8>&nbsp;<td>Black  = "#000000"
<td bgcolor=green width=8>&nbsp;<td>Green  = "#008000"</tr>
<tr><td bgcolor=silver>&nbsp;<td>Silver = "#C0C0C0"
<td bgcolor=lime>&nbsp;<td>Lime   = "#00FF00"</tr>
<tr><td bgcolor=gray>&nbsp;<td>Gray   = "#808080"
<td bgcolor=olive>&nbsp;<td>Olive  = "#808000"</tr>
<tr><td bgcolor=white>&nbsp;<td>White  = "#FFFFFF"
<td bgcolor=yellow>&nbsp;<td>Yellow = "#FFFF00"</tr>
<tr><td bgcolor=maroon>&nbsp;<td>Maroon = "#800000"
<td bgcolor=navy>&nbsp;<td>Navy   = "#000080"</tr>
<tr><td bgcolor=red>&nbsp;<td>Red    = "#FF0000"
<td bgcolor=blue>&nbsp;<td>Blue   = "#0000FF"</tr>
<tr><td bgcolor=purple>&nbsp;<td>Purple = "#800080"
<td bgcolor=teal>&nbsp;<td>Teal   = "#008080"</tr>
<tr><td bgcolor=fuchsia>&nbsp;<td>Fuchsia  = "#FF00FF"
<td bgcolor=aqua>&nbsp;<td>Aqua   = "#00FFFF"</tr>
</table>
<p>

<p><IMG SRC="../Images/wood/bar.gif" width=508 height=15><br>

<img ismap usemap=#back src="../Images/wood/back.gif" border=0>
<map name=back>
	<area href="XmHTML.html" shape=rect coords=0,0,83,33>
</map>

<img ismap usemap=#index_map src="../Images/wood/home.gif" border=0>
<map name=index_map>
	<area href="../index.html#toc" shape=rect coords=0,0,83,33>
</map>
<img ismap usemap=#email_map src="../Images/wood/email.gif" border=0>
<map name=email_map>
	<area href="mailto:ripley@xs4all.nl" shape=rect coords=0,0,83,33>
</map>

<br><IMG SRC="../Images/wood/bar.gif" width=508 height=15><br>
<i><font size="-1">
&copy;Copyright 1996-1997 by Ripley Software Development<br>
Last update: April 3, 1998 by Koen
</font></i>
</BODY>
</HTML>