HyperMaker HTML 2001.03

Basics

 Third party reviews &
Awards 		What is new? Supported tags
Download Registration Frequently Asked Questions Examples and links
Bonus ISBN

Appendix Supported HTML tags

Multimedia and non Standard Tags

<BGSOUND>
   SRC=wav, mp3 or midi file
   LOOP=-1 | -2 | n

-1 will replay the sound while the page is loaded.
-2 will replay the sound until another sound is called.
n will replay the sound n times
Otherwise the sound will be played one time.
The sound toolbar will not be shown.

<A HREF= *.avi>...</A>
     WIDTH|HEIGHT|CLOSE|REWIND

The AVI file will be played and dimensioned. Example:

                 MYVIDEO.AVI 400 500 CLOSE

This file will be played in a window of 400x500 pixels (centered in screen), and will be closed automatically when the AVI ends. The parameters can be separated only with spaces.

The <PANEL> tag allows to play an AVI file sinto a page.

<A HREF= *.exe|*.bat [Parameter]>...</A>

The program will be executed. Parameter is a file that will be opened.

<A HREF= *.hlp>...</A>

The help file will be opened.

<A HREF= *.mid|*.wav|*.mp3>...</A>

The sound will be played. To control sound playing, the Target parameter can be used.

<A HREF= *.pop>...</A>

The message included before the .POP extension will be displayed in a pop-up Windows. The maximum length is 255 characters. The '%' character isn't supported. The pop-up background color can be set in the Interface tab in Publication window.

<A HREF= *.tel>...</A>

The telephone number included before the .TEL extension will be dialed. The last number of the telephone number may be the comm port. Example

                    543-00082.tel

This will dial the 543-0008 number using COM2.

<PANEL>

Shockwave Flash (.SWF), Acrobat (.PDF) and Video for Windows (.AVI) and MPEG Videos (.MPG) documents can be included into the page or in a frameset, using this tag.

Rotative banners (Random images and links)

This is an anchor or an image element pointing to multiple pages or images, that are randomly choosen.

<IMG SRC=im1.gif,img2,im3.gif>

or

<A HREF=aa.htm,bb.htm,cc.htm,dd.htm,ee.htm>

In both cases, each time the link is clicked or the image is loaded, one of the files will be randomly choosen and displayed.

<PAGE>

Attributes:none
The <PAGE> tag causes printing to end on the current page and a new page started. It has no effect on the displayed document.

<!--Include-->

This pseudo tag is used to insert a file, the current date, time, registration or refund information, I.D. or a key on a (HTML) page.

<!--#ID-->

<!--#PT-->

<!--#Regis-->

<!--#Time-->

<!--#Date-->

<!--#Refund-->

<!--#Include FILE="myfile.html"-->

Each tag would insert the appropriate content (I.D. key, Publication Title (PT), Registration information (Regis), Time, Date or File) into the current HTML document, at the insertion point. The text can also be inserted in a Form Text box.

Regis use: if the publication is unlocked regis will display "Unlocked publication".
If the publication is registered it will display "This publication is registered to" + the user name.
If the publication is locked and unregistered it will display "Unregistered publication" (language string 38).

Refund use: it will display the refund code after doing a refund. If the page is accessed without doing a refund, it will not display anything.

 

Document Tags

<HTML>...</HTML>
<HEAD>...</HEAD>
<STYLE>...</STYLE>
<BASE>
   HREF=base
<TITLE>...</TITLE>
<META>
   REFRESH

The refresh property can load a page or an AVi file after a specified number of seconds.

         <META http-equiv="refresh" content="3,intro.htm">

Macros can also be played with the REFRESH tag, as:

         <META http-equiv="refresh" content="3,close">

This META Refresh tag will close the publication.

   SCREEN

The SCREEN property is what allows you to modify the HyperMaker Viewer display in width and height. Example:

      <META http-equiv="screen" content="600,300">
<BGSOUND>
   SRC=wav or midi file
   LOOP=INFINITE (only for wav files)
<BODY>...</BODY>
   BACKGROUND=bitmap

   TEXT=color
   BGCOLOR=color
   LINK=color
   VLINK=color
   OLINK=color
   MARGINWIDTH=n
   MARGINHEIGHT=n

Physical Phrase Markup Tags

<B>...</B>
<I>...</I>
<U>...</U>
<TT>...</TT>
<S>...</S>
<FONT>...</FONT>
   SIZE=n  (n=1..7) or SIZE=+-n (incremental change)
   COLOR=color
   FACE=facename
<SUB>...</SUB>
<SUP>...</SUP>
<BIG>...</BIG>
<SMALL>...</SMALL>
<STRIKE>...</STRIKE>
<>...</>

Logical Phrase Markup Tags

<EM>...</EM>
<STRONG>...</STRONG>
<CITE>...</CITE>
<VAR>...</VAR>
<CODE>...</CODE>
<KBD>...</KBD>
<SAMP>...</SAMP>

Block Tags

<P>...(</P>)
    ALIGN=left|center|right
<ADDRESS>...</ADDRESS>
<BLOCKQUOTE>...</BLOCKQUOTE>
<PRE>...</PRE>
<CENTER>...</CENTER>
<DIV>...</DIV>
    ALIGN=left|center|right

Lists

<OL>...</OL>
   START=value
   TYPE=1|a|A|i|I
<UL>...</UL>
   PLAIN
<DIR>...</DIR>
<MENU>...</MENU>
  <LI>...(</LI>)

Description List

<DL>...</DL>
  <DD>...</DD>
  <DT>...</DT>

Tables

<TABLE>...<TABLE>
   BORDER or BORDER=0
   ALIGN=left|center|right
   CELLSPACING=value
   CELLPADDING=value
   WIDTH=n|n%
   BGCOLOR=color
   BORDERCOLOR=color
   BORDERCOLORLIGHT=color
   BORDERCOLORDARK=color
   HSPACE=n
   VSPACE=n
<CAPTION>...</CAPTION>
   ALIGN=top|bottom
<TR>...</TR>
   VALIGN=top|center|bottom
   ALIGN=left|center|right
   BGCOLOR=color
<TH>...</TH>, <TD>...</TD>
   ROWSPAN=n
   COLSPAN=n
   WIDTH=n|n%
   HEIGHT=n
   VALIGN=top|center|bottom
   ALIGN=left|center|right
   BGCOLOR=color

Forms

<FORM>...</FORM>
   METHOD=post|get
   ACTION=url
<INPUT>...</INPUT>
   TYPE=text|password|submit|reset|radio|checkbox|hidden|
   NAME=string
   VALUE=string
   SIZE=chars       (text, password)
   MAXLENGTH=chars  (text, password)
   CHECKED          (radio, checkbox)
<SELECT>...</SELECT>
   NAME=string
   MULTIPLE
   SIZE=lines
   <OPTION>...(</OPTION>)
      SELECTED
      VALUE=string
<TEXTAREA>...</TEXTAREA>
   NAME=string
   ROWS=n
   COLS=n
<OPTION>...</OPTION>

HyperMaker Viewer prints the page when the form is placed at submitted time.

Character Level Elements

<BR>
   CLEAR=left|right
<WBR>
<IMG>
   SRC=image
   ALT=string
   ALIGN=top|middle|bottom|left|right
   BORDER=0
   WIDTH=n,n%
   HEIGHT=n
   IMAGEMAP
   USEMAP=url (local URL only)
   HSPACE=n
   VSPACE=n
   ACTIVE

Anchors

<A>...</A>

Client Side Image Maps

<MAP>...</MAP>
   NAME=string
<AREA>
   SHAPE=RECT|CIRC|CIRCLE|POLY|POLYGON
   COORDS="n1, n2, ...., nn"
   HREF=url
   NOHREF

Miscellaneous

<Hn>...</Hn>   n = 1..6
   ALIGN=left|center|right
<HR>
   SIZE=n
   WIDTH=n|n%
   COLOR=color
<BASEFONT>
   SIZE=n  (n=1..7) or SIZE=+-n (incremental change)

Frame Syntax

<FRAMESET>...</FRAMESET>
   ROWS|COLS=n1, n2, .., nn  (absolute, %, or *)
   BORDER=n         (Main FRAMESET only)
   FRAMEBORDER=n    (Main FRAMESET only)
<FRAME>
   SRC=filename
   NAME=windowname
   SCROLLING=yes|no|auto
   NORESIZE
   MARGINHEIGHT=n
   MARGINWIDTH=n
<NOFRAMES>...</NOFRAMES>

Information on the special HTML Frame syntax can be found at:
    http://home.netscape.com/assist/net_sites/frames.html

Color Syntax

Color information may consist of a hexadecimal red, green, and blue value such as FF8000 or be one of the following identifiers:

Black, Maroon, Green, Olive, Navy, Purple, Teal, Gray, Silver, Red, Lime, Yellow, Blue, Fuchsia, Aqua, white, Aliceblue, Antiquewhite, Aquamarine, Azure, Beige, Bisque, Blanchedalmond, Blueviolet, Brown, Burlywood, Cadetblue, Chartreuse, Chocolate, Coral, Cornflowerblue, Cornsilk, Crimson, Cyan, Darkblue, Darkcyan, Darkgoldenrod, Darkgray, Darkgreen, Darkkhaki, Darkmagenta, Darkolivegreen, Darkorange, Darkorchid, Darkred, Darksalmon, Darkseagreen, Darkslateblue, Darkslategray, Darkturquoise, Darkviolet, Deeppink, Deepskyblue, Dimgray, Dodgerblue, Firebrick, Floralwhite, Forestgreen, Gainsboro, Ghostwhite, Gold, Goldenrod, Greenyellow, Honeydew, Hotpink, Indianred, Indigo, Ivory, Khaki, Lavender, Lavenderblush, Lawngreen, Lemonchiffon, Lightblue, Lightcoral, Lightcyan, Lightgoldenrodyellow, Lightgreen, Lightgrey, Lightpink, Lightsalmon, Lightseagreen, Lightskyblue, Lightslategray, Lightsteelblue, Lightyellow, Limegreen, Linen, Magenta, Mediumaquamarine, Mediumblue, Mediumorchid, Mediumpurple, Mediumseagreen, Mediumslateblue, Mediumspringgreen, Mediumturquoise, Mediumvioletred, Midnightblue, Mintcream, Mistyrose, Moccasin, Navajowhite, Oldlace, Olivedrab, Orange, Orangered, Orchid, Palegoldenrod, Palegreen, Paleturquoise, Palevioletred, Papayawhip, Peachpuff, Peru, Pink, Plum, Powderblue, Rosybrown, Royalblue, Saddlebrown, Salmon, Sandybrown, Seagreen, Seashell, Sienna, Skyblue, Slateblue, Slategray, Snow, Springgreen, Steelblue, Tan, Thistle, Tomato, Turquoise, Violet, Wheat, Whitesmoke, Yellowgreen

Local CGI

With online web sites, you can write Web applications which process form input and produce result pages which are then sent back to the browser. This is usually done using "Common Gateway Interface" (CGI) calls. Local CGI gives HMViewer the same capability, except that the crafting of Local CGI applications is usually much easier than the online variety!

Just as with regular CGI, a Local CGI call is defined using the <FORM> tag's Method and Action attributes, e.g.

    <form Action="notepad.exe" Method="output.htm">

The above statement tells HMViewer that when the submit button on the form is pressed, it should:

  1. Store the form data in output.htm.
  2. Run the notepad.exe program with "output.htm" as parameter.
  3. If the file created for the HMViewer is modified within 30 seconds, the HMViewer will load the file. This is useful if you need to generate HTML pages, in response to a user's request.

You can also use the HREF tag for a Local CGI call:

    <A HREF="myprog.exe CGI=output.htm ITEM1=ALFA ITEM2=BETA">Submit CGI</A>

This will generate a file with this two lines:

     ITEM1=ALFA
     ITEM2=BETA

Where files are located when using Local CGI

EXE files referenced in Action statements (and also in direct HREF links) are assumed to be:

  1. in the specified path if an absolute path is given
  2. in or relative to the publication location
  3. otherwise assumed to be on the system path

Form data is located in the Windows temporary directory and automatically erased once the CGI call is finished.

Once you know how to call your Local CGI program, you need only write the code to process the form data file. Then if necessary, have the program generate an HTML response page and open it in the HMViewer.

Macro Commands

Using the macro commands of Hyper Maker you can realize usual tasks as shown below.

You can create links using this set of macro commands:

Task

Command

Display About Window  <A HREF="about">Display About Window</A>
Find text <A HREF="find">Find text</A>
Increase Font Size  <A HREF="fontp">Increase Font Size</A>
Decrease Font Size  <A HREF="fontm">Decrease Font Size</A>
Change default Font  <A HREF="fontname">Open the Typeface selection window</A>
Restore original font typeface and size   <A HREF="restorefont">Restore Font specifications</A>
Exit program <A HREF="close">Exit program</A>
Close modal window <A HREF="closemodal">Close modal</A>
This macro is intended to be used into a REFRESH tag to close a Modal window automatically
Extract file (a save dialog box will be opened)  <A HREF="extract=document1.doc">Extract Document1.doc</A>
Minimize program <A HREF="minimize">Minimize program</A>
Back to previously viewed page <A HREF="back">Go Back</A>
Forward to next page <A HREF="forward">Go Forward</A>
Open Publication <A HREF="open">Open Publication</A>
Only opens the Open publication dialog box, to allow the user to select a filename.
Print current page* <A HREF="print">Print page</A>
Open Print Preview window* <A HREF="printpreview">Print page</A>
Print several pages <A HREF="print,_1.htm,_2.htm,_3.htm">Print pages</A>
Print many pages <A HREF="print=pages.txt">Print pages</A>
The text file must list only HTML pages, one in each line.
Register Publication <A HREF="register">Register Publication</A>
This tag is only enabled  in locked publications.
Generate a refund code  <A HREF="refund=refpage.htm">Get a refund code and cancel the registration</A>
Stop Sound Playing <A HREF="stopsound">Stop Sound Playing</A>

* Usually, the buttons that call the macros are located in a toolbar frame of your publication. In this situation, you need to specify which frame you want to print or use to display the search results, by filling in the appropriate Main Frame field, in the Interface page of the Publication Window.