OS/2 Shareware BBS: 35 Internet/35-Internet.zip/htmlwiz.zip/htmlwiz.INF

OS/2 Help File | 1996-08-23 | 38KB | 1,071 lines

ΓòÉΓòÉΓòÉ 1. New in this version ΓòÉΓòÉΓòÉ

   1. Added a simple Table generator. You can specify the number of rows and
      columns, the indentation of row and column tags (for readability in the
      HTML source), and row/column commenting (again for readablility).
      Accessing "Tables" under the "Tags" menu brings up the Table Dialog.

   2. Added buttons on the Tagbar that enable you to reach some menu items
      without having to move the mouse back to the top of the window.

   3. The "Close" item under "File" defaults to closing the current file.
      Selecting the arrow to the right brings up a submenu that enables you to
      save all files at once.

   4. Added METHOD to the Form Dialog.

   5. Fixed a capitalization problem with the ALT attribute in image tags.


ΓòÉΓòÉΓòÉ 2. Introduction ΓòÉΓòÉΓòÉ

HTML Wizard is an editor designed to make writing HTML documents for WWW pages
a lot easier. The original version was written purely for my own use and was
not distributed. The arrival of Web Explorer lead a lot of OS/2 users to ask
about a native HTML editor, so I released an early version of HTML Wizard that
showed signs of being a program written for one person's use (no way to resize
the window, almost no configurability, etc.). Since then, a lot has changed and
the program is now much more powerful and configurable. I thank the many users
of the program for their suggestions for improvements.


ΓòÉΓòÉΓòÉ 3. Installation ΓòÉΓòÉΓòÉ

Installation of HTML Wizard is simple and straightforward. Unzip the HTML
Wizard archive in its own directory. Then run install.cmd by typing "install".
The install program will create an HTML Wizard object on your desktop. To run
the program successfully, VROBJ.DLL has to either be in your HTML Wizard
directory or be in a directory specified in the LIBPATH statement in your
CONFIG.SYS file. What I do is make a directory called \USR\DLL and put all my
application dll's in there. Then all you have to do is add \USR\DLL to the
LIBPATH and reboot. If you don't like the idea of messing with CONFIG.SYS, just
copy VROBJ.DLL to the \OS2\DLL directory or leave it in your HTML Wizard
directory if you have no other applications built with VX-REXX. You can then
run HTML Wizard by double-clicking it or dropping an HTML document onto it.


ΓòÉΓòÉΓòÉ 4. Command line options ΓòÉΓòÉΓòÉ

The following command line options are supported:

 -grabfocus Causes the program to grab the input focus when it has loaded.

 -noconsole Prevents the program from opening a console window. If this option
           is active, you may not see all error/diagnostic messages should
           problems arise.

 -nologo   Skips the opening logo on program startup.

 -nosocket Skips the loading of the sockets library used for running Weblint
           over the network. If you are getting errors about RXSOCK not working
           correctly, try this option.


ΓòÉΓòÉΓòÉ 5. Workplace Shell Features ΓòÉΓòÉΓòÉ

HTML Wizard supports the following Drag and Drop features with Workplace Shell
objects:

     Dropping an HTML file on the HTML Wizard object will open HTML Wizard and
      load the dropped file.

     Dropping an HTML file on the HTML Wizard edit window loads the HTML file
      for editing.

     Dropping a Web Explorer URL object on the editing window will insert an
      anchor for that URL.

     Dropping an image (GIF or JPEG) on the editing window will bring up the
      Image Dialog.

     Holding down Ctrl while dragging and dropping a file onto the HTML Wizard
      edit window does the following:

        -  If the dropped file is a text or HTML file, it is inserted at the
           current cursor location.

        -  If the dropped file is a GIF or JPEG image, the images window is
           opened.


ΓòÉΓòÉΓòÉ 6. Options Menu ΓòÉΓòÉΓòÉ

This section explains the various program settings in the "Options" menu.


ΓòÉΓòÉΓòÉ 6.1. Insert Tags as Uppercase ΓòÉΓòÉΓòÉ

This setting determines whether the tags that are inserted are done as upper or
lowercase text. Note that this does not apply to tags for special characters,
which are case sensitive.


ΓòÉΓòÉΓòÉ 6.2. Word Wrap ΓòÉΓòÉΓòÉ

Select this setting if you want long lines to be wrapped around the screen to
the next line. Deselect it if you want long lines to continue off the screen to
the right and be visible by using the horizontal scrollbar.


ΓòÉΓòÉΓòÉ 6.3. Auto-insert Paragraph Tags ΓòÉΓòÉΓòÉ

If this item is selected, text imported using the "Insert File" command will
have paragraph tags inserted automatically if:

     A line is blank

     A line begins with either a space or a tab


ΓòÉΓòÉΓòÉ 6.4. Insert <LI> Tags in Selected Lists ΓòÉΓòÉΓòÉ

This item controls whether <LI> tags will be automatically inserted in text
that is selected when using the OL or UL tag buttons (ordered or unordered
lists). If this option is selected, each line in the selected text will have
the <LI> inserted at the beginning. Note that "line" here means a true line
defined by a CR/LF pair. It is best to turn Word Wrap off to see true lines.


ΓòÉΓòÉΓòÉ 6.5. Vertical Tagbar ΓòÉΓòÉΓòÉ

Toggles the Tagbar between horizontal and vertical orientation.


ΓòÉΓòÉΓòÉ 6.6. Hide Tagbar ΓòÉΓòÉΓòÉ

Toggles the Tagbar between visible and hidden.


ΓòÉΓòÉΓòÉ 6.7. Translate Non-English Characters ΓòÉΓòÉΓòÉ

This feature enables users of non-English code pages to type HTML documents
with special characters directly from the keyboard, rather than having to use
the "Characters" menu or multiple keystrokes. With this feature enabled, all
files are passed through a translator program when opened or saved. On input,
HTML entities for special characters (e.g., ò) are converted into the
character appropriate for the user's code page and displayed as that character
in the editing window. On output, the characters are converted into the
corresponding HTML entity. The key file for this is "trans.def" in the HTML
Wizard directory. This file tells the program which characters in the user's
character set go with a particular HTML entity. I have supplied two files,
cp850.def (code page 850) and latin1.def (ISO Latin-1) which will cover the
people who have requested this feature. (The trans.def file that is in the ZIP
archive is for code page 850.) If you are using code page 850, copy cp850.def
to trans.def, or copy latin1.def to trans.def if you are using ISO Latin-1. If
you are using another code page, you will have to build a .def file for that
page. Look at the supplied files to see how it is done. Basically, the file has
two columns: the first is the character number on that code page, and the
second is the corresponding HTML entity. The included utility DefEdit is
designed for editing these files. It is a PM program that allows you to
create/modify .def files very easily. Start it up, and load a .def file, and it
will be pretty obvious how to use it. If you do create a .def file for another
code page, I would appreciate it if you would send me a copy, so that I can
include it in future releases of HTML Wizard.


ΓòÉΓòÉΓòÉ 7. How Do I... ΓòÉΓòÉΓòÉ

This section explains how to do various things with HTML Wizard.


ΓòÉΓòÉΓòÉ 7.1. Use HTML Wizard? ΓòÉΓòÉΓòÉ

Start the program by double-clicking the HTML Wizard icon or by dropping an
HTML document onto it. If you double-click the icon, the program will start up
and load an HTML skeleton template in the file DEFAULT.HTM and you can modify
that file to suit your needs. You can then write your HTML document by typing
in the edit window and using the Tagbar or Tags menu items to insert tags. If
you have some text that you would like to put inside a tag, select that text
with the mouse and click on the tag button or menu item. HTML Wizard will then
put the tag around the text. If you insert a tag with no text selected, HTML
Wizard will simply place the tag at the insertion point and place the cursor in
the appropriate place to enter text for the tag. Once you are done, you can
save the HTML file with the "Save" or "Save As" items under the "File" menu. If
you want to start a new HTML document choose "Close" under the "File" menu, and
a fresh template will be loaded.


ΓòÉΓòÉΓòÉ 7.2. Insert HTML tags? ΓòÉΓòÉΓòÉ

To insert tags, there are three options. First, you can insert tags by clicking
on the appropriate buttons in the Tagbar. Or, you can choose the tag you want
from the "Tags" menu. A final way is to right-click in the edit window,
bringing up the tags menu. In all cases if text is selected before the tag is
inserted, the tag will be placed around the selected text (where appropriate,
of course). Inserting a tag with no text selected places the tag at the
insertion point and puts the cursor at the place where text can be typed in the
tag.


ΓòÉΓòÉΓòÉ 7.3. Program the user-definable tags? ΓòÉΓòÉΓòÉ

To program a user button, right-click on it and a window will pop up. In the
top entry field enter the "Hint" text for that button. (This is the message
displayed in the status area at the bottom of the Tagbar when the mouse passes
over a button. Use this to remind yourself what the tag is for.) The bottom
entry field is the tag itself. If your tag should enclose text that has been
selected, move the cursor to the point in the tag where the selected text
should be placed. For example, let's say you have a tag like <tag></tag>. If
the user selects text in the editing window, and this text should go within the
tag, you would position the cursor like this: <tag>|</tag> before hitting the
OK button. You can also set the label to appear on the Tagbar button (3
characters or less). You can then immediately begin to use your new tag by left
clicking on the button you just progammed.


ΓòÉΓòÉΓòÉ 7.4. Preview with Web Explorer? ΓòÉΓòÉΓòÉ

Previewing with Web Explorer is as simple as selecting "Preview Document" from
the "File" menu, or by pressing F10. If Web Explorer is not running, HTML
Wizard will start it and load the HTML document you are editing. If Web
Explorer is already running, HTML Wizard simply forces it to load the present
version of your HTML document (rather than starting another session of Web
Explorer). For this feature to work properly, the Web Explorer executable
(explore.exe) must be in your PATH. If you use the default Web Explorer
installation, it will be in \TCPIP\BIN.


ΓòÉΓòÉΓòÉ 7.5. Check the HTML syntax of my document with WebLint? ΓòÉΓòÉΓòÉ

If you are online, selecting "Check Document with Weblint" (or pressing F7)
will send your HTML document to the WebLint web site (www.unipress.com) for
syntax checking. If all goes well, the results of the syntax check will be sent
back and automatically loaded into Web Explorer. This function runs on a
separate thread, so you can continue to edit your document, but be aware that
the line numbers reported back by WebLint refer to the line numbers as they
were when you sent the file (Weblint will send back the HTML code you sent to
be checked with the line numbers labelled.). REMEMBER, THIS FUNCTION ONLY WORKS
IF YOU ARE CONNECTED TO THE NET!

In version 1.55, Weblint and Perl have been included with HTML Wizard so that
you can now check your document by running Weblint locally instead of over the
network. This has some advantages over the obvious one. You can customize
Weblint yourself if you are proficient in Perl, and you can also update Weblint
when the author (Neil Bowers - [e-mail]; see
http://www.khoral.com/staff/neilb/weblint.html) releases new versions.


ΓòÉΓòÉΓòÉ 7.6. Insert accented/special character tags? ΓòÉΓòÉΓòÉ

There are three ways of inserting tags for accented/special characters if you
are not using the "Translate Non-English Characters" option (see the "Options"
section for more details).

     Choose the character you want from the "Characters" menu.

     Type the character you want to accent, say "a", then select the accent
      you want from the "Accents" menu.

     Type the character you want to accent, then press:

        -  Alt-a for acute

        -  Alt-g for grave

        -  Alt-u for umlaut

        -  Alt-c for circumflex

        -  Alt-s for slash

        -  Alt-t for tilde

 The general pattern for the hot keys is Alt for accents and Ctrl for inserting
 certain characters. (Like Ctrl-Shift-& for the ampersand).


ΓòÉΓòÉΓòÉ 7.7. Register the program? ΓòÉΓòÉΓòÉ

HTML Wizard is distributed as shareware which means you have 25 free uses to
try it out and see how it works. If you want to continue to use it after that,
you must register the program. The registration fee is $20 US. There are 3 ways
of registering:

     With the Author (US funds only)

     With BMT Micro (Checks and Credit Cards)

     With DiscoverWare GbR (In Germany)


ΓòÉΓòÉΓòÉ 7.7.1. Registering with the author directly ΓòÉΓòÉΓòÉ

I can accept checks drawn on US banks, or International Money orders. Please
include an email address when you send in your registration so that I can put
you on the registered users' mailing list. The registration fee should be sent
to:

Dirk Terrell
510 SW 34th St. Apt. #6
Gainesville, FL 32607
    (USA)

If you receive HTML Wizard after August 1997, there is a distinct possibility
that I may have moved. The best thing to do is send e-mail to
[e-mail] and find out where I am.


ΓòÉΓòÉΓòÉ 7.7.2. Registering with BMT Micro ΓòÉΓòÉΓòÉ

Mail Orders To: BMT Micro
   452 Horn Road
   Wilmington, NC 28412-2411
   U.S.A.

Voice Orders: 9:00am - 7:00pm EST (-5 GMT)
   [phone] (orders only)
   [phone]

Fax Orders: [phone]  24 hours / 7 Days

Online Orders via modem: [phone]  10 lines, all 14.4K
                [phone]  Direct 28.8K line

Ordering and general ordering questions:
   via AOL: bmtmicro
   via Compuserve: Thomas Bradford, 74031,307
   via Internet: [e-mail]

BMT Micro accepts Visa, Mastercard, Discover, American Express, Money Order,
Cashiers Check, Personal Check.  Please do not send cash in the mail.
Personal checks are subject to clearance.

Please note that BMT Micro is only a distributor of HTML Wizard, and does not
provide technical support for the program. Please do not use the BMT Micro 800 number
for this purpose. All technical support is done by the author.


ΓòÉΓòÉΓòÉ 7.7.3. Registering with DiscoverWare GbR ΓòÉΓòÉΓòÉ

DiscoverWare GbR
Sacha Bertram - Matthias Heinemann
Nordstr. 10/1
75392 Deckenpfronn

EMail: [e-mail]

Registriergebuehr: 35,- DM


ΓòÉΓòÉΓòÉ 7.8. Contact the author of this program? ΓòÉΓòÉΓòÉ

If you have problems or suggestions for improvements, send them to
[e-mail] (preferred address before August, 1997) or
[e-mail].


ΓòÉΓòÉΓòÉ 8. Help on HTML Tags ΓòÉΓòÉΓòÉ

This section contains help on the HTML tags supported by HTML Wizard


ΓòÉΓòÉΓòÉ 8.1. Heading Tags ΓòÉΓòÉΓòÉ

The heading tags <H1></H1> ... <H6></H6> are used to separate an HTML document
into sections and subsections. <H1> is the topmost heading, with the next level
being <H2>, and so on. Text placed between the tags will be displayed as the
title text for that section. For example

<H1>HTML Wizard for OS/2 Home Page</H1>

might be displayed as:

HTML Wizard for OS/2 Home Page


ΓòÉΓòÉΓòÉ 8.2. Typeface tags ΓòÉΓòÉΓòÉ

These tags control the appearance of text in an HTML document by changing
fonts.


ΓòÉΓòÉΓòÉ 8.2.1. Bold ΓòÉΓòÉΓòÉ

Use this tag to cause the text to be displayed in a bold font.

<B>This text is bold.</B>

might be displayed as:

This text is bold.


ΓòÉΓòÉΓòÉ 8.2.2. Emphasis ΓòÉΓòÉΓòÉ

Use this tag to cause the text to be emphasized. This is usually preferable to
using the bold or italic tag.

<EM>This text is emphasized.</EM>

might be displayed as:

This text is emphasized.


ΓòÉΓòÉΓòÉ 8.2.3. Italic ΓòÉΓòÉΓòÉ

Use this tag to cause the text to be displayed in an italic font.

<I>This text is in italics.</I>

might be displayed as:

This text is in italics.


ΓòÉΓòÉΓòÉ 8.2.4. Underline ΓòÉΓòÉΓòÉ

Use this tag to cause the text to be underlined when rendered by the browser.

<U>This text is underlined.</U>

might be displayed as:

This text is underlined.


ΓòÉΓòÉΓòÉ 8.2.5. Typewriter ΓòÉΓòÉΓòÉ

Use this tag to cause the text to be displayed in a typewriter (fixed-width)
font.

<TT>This text is rendered with a fixed-width font.</TT>

might be displayed as:

This text is rendered with a fixed-width font.


ΓòÉΓòÉΓòÉ 8.3. List tags ΓòÉΓòÉΓòÉ

The HTML list tags are used to create, amazingly enough, lists of items. There
are three list types in HTML:

     Ordered (numbered) lists

     Unordered (bulleted) lists

     Descriptive lists


ΓòÉΓòÉΓòÉ 8.3.1. Ordered Lists ΓòÉΓòÉΓòÉ

The ordered list tags <OL></OL> are used to create lists that are numbered,
rather than bulleted as in the unordered list tags. These tags are used in
conjunction with the list item tag  <LI>. The <OL></OL> tags surround a series
of <LI> tags to produce the ordered list. For example:

<OL>
<LI>Item 1
<LI>Item 2
<LI>Item 3
</OL>

might be displayed as

   1. Item 1

   2. Item 2

   3. Item 3

 You can also nest lists to make outlines as in:

  <OL>
  <LI>Item 1
  <OL>
  <LI>Sub-item 1
  <LI>Sub-item 2
  </OL>
  <LI>Item 2
  <LI>Item 3
  </OL>

 which might be rendered as:

   1. Item 1

        a. Sub-item 1

        b. Sub-item 2

   2. Item 2

   3. Item 3

 Finally, if you would like to make the list more compact by eliminating the
 spaces between each item, as the COMPACT modifier to the <OL> tag like this:

  <OL COMPACT>
  <OL>
  <LI>Item 1
  <OL COMPACT>
  <LI>Sub-item 1
  <LI>Sub-item 2
  </OL>
  <LI>Item 2
  <LI>Item 3
  </OL>

 which might be rendered like this:

   1. Item 1
        a. Sub-item 1
        b. Sub-item 2
   2. Item 2
   3. Item 3

 HTML Wizard Time Saver:

 If you already have the text for the items loaded into HTML Wizard (say, from
 a file import), you can create lists quickly by selecting the text (making
 sure that there is one list item per line), then choosing the <OL> Tagbar
 button or corresponding Tags menu option. If you have "Auto-insert <LI> tags
 in Lists" checked in the "Options" menu, HTML Wizard will place the outer <OL>
 and </OL> tags around the text and place the <LI> tag in front of each list
 item.


ΓòÉΓòÉΓòÉ 8.3.2. Unordered Lists ΓòÉΓòÉΓòÉ

The unordered list tags <UL></UL> are used to create lists that are bulleted,
rather than numbered as in the ordered list tags. These tags are used in
conjunction with the list item tag  <LI>. The <UL></UL> tags surround a series
of <LI> tags to produce the ordered list. For example:

<UL>
<LI>Item 1
<LI>Item 2
<LI>Item 3
</UL>

might be displayed as

     Item 1

     Item 2

     Item 3

 You can also nest lists to make outlines as in:

  <UL>
  <LI>Item 1
  <UL>
  <LI>Sub-item 1
  <LI>Sub-item 2
  </UL>
  <LI>Item 2
  <LI>Item 3
  </UL>

 which might be rendered as:

     Item 1

        -  Sub-item 1

        -  Sub-item 2

     Item 2

     Item 3

 Finally, if you would like to make the list more compact by eliminating the
 spaces between each item, as the COMPACT modifier to the <UL> tag like this:

  <UL COMPACT>
  <UL>
  <LI>Item 1
  <UL COMPACT>
  <LI>Sub-item 1
  <LI>Sub-item 2
  </UL>
  <LI>Item 2
  <LI>Item 3
  </UL>

 which might be rendered like this:

     Item 1
        -  Sub-item 1
        -  Sub-item 2
     Item 2
     Item 3

 HTML Wizard Time Saver:

 If you already have the text for the items loaded into HTML Wizard (say, from
 a file import), you can create lists quickly by selecting the text (making
 sure that there is one list item per line), then choosing the <UL> Tagbar
 button or corresponding Tags menu option. If you have "Auto-insert <LI> tags
 in Lists" checked in the "Options" menu, HTML Wizard will place the outer <UL>
 and </UL> tags around the text and place the <LI> tag in front of each list
 item.


ΓòÉΓòÉΓòÉ 8.3.3. Descriptive Lists ΓòÉΓòÉΓòÉ

Descriptive (or definition) lists are useful when you want to make a list that
has item names and a description of each item, as in the following:

 Item 1

           This would be some text that describes item number 1.
 Item 2

           This would be some text that describes item number 2.

 Descriptive lists are created with the <DL></DL> tags surrounding a series of
 <DT> and <DD> tags with appropriate text. The <DT> tag marks the text that is
 to be shown as a list item (Think of it as descriptive title.), and the <DD>
 tag marks the descriptive text that goes with the preceding list item. The
 above example would be coded as:

  <dl>
  <dt>Item 1
  <dd>This would be some text
  that describes item number 1.
  <dt>Item 2
  <dd>This would be some text
  that describes item number 2.
  </dl>


ΓòÉΓòÉΓòÉ 8.3.4. Directory Lists ΓòÉΓòÉΓòÉ

The directory tag <DIR></DIR> is used to create a directory list. Items within
the list are marked with the list item tag. The COMPACT modifier may be used
with this tag.


ΓòÉΓòÉΓòÉ 8.3.5. List Items ΓòÉΓòÉΓòÉ

The list item tag <LI> is used to mark the text in each item of an ordered,
unordered, or directory list.


ΓòÉΓòÉΓòÉ 8.4. Formatting tags ΓòÉΓòÉΓòÉ

These tags control the formatting of text in an HTML document.


ΓòÉΓòÉΓòÉ 8.4.1. Address ΓòÉΓòÉΓòÉ

The address tag <ADDRESS></ADDRESS> is used to mark text as being an email
address. It is frequently used to indicate the author of a Web page like this:

This Web page produced by <ADDRESS>Dirk Terrell</ADDRESS> using HTML Wizard.

which might be rendered as:

This Web page produced by Dirk Terrell using HTML Wizard.


ΓòÉΓòÉΓòÉ 8.4.2. Block Quote ΓòÉΓòÉΓòÉ

The block quote tag <BLOCKQUOTE></BLOCKQUOTE> is used to set off text that is
being quoted. Most browsers do this by indenting the text between the tags.


ΓòÉΓòÉΓòÉ 8.4.3. Line Break ΓòÉΓòÉΓòÉ

The line break tag <BR> is used to force the HTML browser to continue text on
the following line. This tag is very useful in Tables.

HTML Wizard Time Saver:

If you select text before pressing the line break Tagbar button, HTML Wizard
will insert line break tags in the selected text when:

     A line is blank
     A line begins with a tab or a space


ΓòÉΓòÉΓòÉ 8.4.4. Paragraph ΓòÉΓòÉΓòÉ

The paragraph tag <P> is used to mark the beginning of a new paragraph.

<P>Notice that this sentence is separated
from the following one even though we typed
all of the text together.<P>This is caused
by the use of the paragraph tag.

might be rendered as:

Notice that this sentence is separated from the following one even though we
typed all of the text together.

This is caused by the use of the paragraph tag.

HTML Wizard Time Saver:

If you select text before pressing the paragraph Tagbar button, HTML Wizard
will insert paragraph tags in the selected text when:

     A line is blank
     A line begins with a tab or a space


ΓòÉΓòÉΓòÉ 8.4.5. Pre-formatted ΓòÉΓòÉΓòÉ

The pre-formatted tag <PRE></PRE> is used when you do not want the HTML browser
to change the formatting of the enclosed text. All spacing and line breaks will
be preserved, and most browsers will display the text in a fixed-width font.

This text is not surrounded by pre-formatted tags, so
line breaks and        spaces      are not
preserved.
<PRE> On the other hand, this text is
enclosed in pre-formatted tags, so line
breaks and        spaces       are preserved.</PRE>

might be rendered as:

This text is not surrounded by pre-formatted tags, so line breaks and spaces
are not preserved.

On the other hand, this text is
enclosed in pre-formatted tags, so line
breaks and        spaces       are preserved.


ΓòÉΓòÉΓòÉ 8.5. Forms Tags ΓòÉΓòÉΓòÉ

These tags are used in creating HTML documents for Web pages with forms. Forms
enable you to create a Web page that allows users to fill out entry fields and
submit a document to your Web server for processing. You might use this if you
wanted to be able to allow searching of a database on your Web server. The user
would fill out the form and submit it. Your server would process the request
and send the results back to the user.

The following tags are used to implement forms:

     <FORM></FORM>
     <INPUT>
     <SELECT></SELECT>
     <OPTION>
     <TEXTAREA></TEXTAREA>


ΓòÉΓòÉΓòÉ 8.5.1. The <FORM> Tag ΓòÉΓòÉΓòÉ

The <FORM></FORM> tag is used to delineate a form within an HTML document. You
can have several forms within an HTML document, but forms cannot be nested
(i.e., a <FORM></FORM> tag sequence cannot be used with another <FORM></FORM>
pair.

The <FORM> tag must have an ACTION modifier which is a URL that points a Web
server that will process the form. It must also have the METHOD modifier which
is either GET or POST, with the latter usually the preferred method for most
applications.

HTML Wizard makes form creation much easier by providing a window that allows
you to enter the ACTION modifier value in an entry field. The METHOD modifier
is selected by choosing the desired radio button.

Example:

<FORM ACTION="http://www.unipress.com/cgi-bin/web-lint" METHOD=POST> ...
</FORM>


ΓòÉΓòÉΓòÉ 9. Program modification history ΓòÉΓòÉΓòÉ

This section lists the changes and bug fixes applied to the program over time.


ΓòÉΓòÉΓòÉ 9.1. Version 1.60 ΓòÉΓòÉΓòÉ

   1. The major feature added in this version is the ability to edit multiple
      files. The program uses a "ring" scheme like the OS/2 Enhanced Editor
      (EPM). The arrows to the left and right of "Ring" in the main menu will
      cycle through the files that are currently loaded. (F11 and F12 are the
      keyboard shortcuts for these functions.) Selecting "Ring" from the menu
      will list all of the files currently loaded. As of now, there is a limit
      of 10 files that can be opened at one time.

   2. In order to make the program a little more efficient, I have placed some
      functions on separate threads, such as running Weblint locally, and some
      processing during program startup. The latter should make the program
      seem to load faster and allow you to get started quicker.

   3. The drag and drop previewing feature was eliminated for performance
      reasons. Use F10 to preview your document with Web Explorer.

   4. Added some more Drag and Drop features

          Dropping a Web Explorer URL object on the editing window will insert
           an anchor for that URL.

          Dropping an image (GIF or JPEG) on the editing window will bring up
           the Image Dialog. (Use Ctrl if you want the entire path to the image
           file inserted in the anchor entry field.)

   5. Added some configurability features:

          The selectable colors on the Background Dialog can now be changed by
           creating a color for the selected box and then right-clicking on it.

          The program stores the color information if you drop colors from a
           Palette Object onto the editing window.

          Added a menu item under "Edit" that will change all back slashes (\)
           to forward slashes (/). If your web server is on a Unix machine, you
           know why I did this. Note that this is an all-or-nothing
           replacement. If you wish to be more selective, use the
           Search/Replace Dialog.

   6. Fixed several bugs.


ΓòÉΓòÉΓòÉ 9.2. Version 1.55 ΓòÉΓòÉΓòÉ

   1. Weblint can now be run locally, so that you don't have to be connected to
      the network to check the syntax of your HTML document. Choose "Local
      Weblint" in the "File" menu (or F6) to run Weblint. For this function to
      work properly, the file EMX.DLL (included in the HTML Wizard
      distribution) must be somewhere in the LIBPATH. Weblint is a Perl script
      written by Neil Bowers ([e-mail]) and is included free of charge
      with HTML Wizard (For more information on Weblint see
      http://www.khoral.com/staff/neilb/weblint.html). To make it easier for
      you, I have included the OS/2 port of Perl with the HTML Wizard
      distribution. This also included free of charge, and the full Perl
      package can be found on hobbes.nmsu.edu ( I have included only those
      files necessary to run Weblint from HTML Wizard.).

   2. The Background dialog has been greatly expanded to make it easier to set
      up background image/color, text color, and link colors.

   3. Added some additional WPS features.

   4. The program now saves the font information if you drop a font on the
      editor from the Font Palette.

   5. Some trailing tags have been added to match expected HTML 3.0
      specifications.

   6. GIF and JPEG image objects can now be dropped on the "Link" edit field
      when "External Image" is selected in the Images window.

   7. Added a -nologo command line option for people who are experiencing
      problems with the opening splash screen.

   8. The Alt-z hotkey now brings up the Images window if the last tag inserted
      was an image tag.


ΓòÉΓòÉΓòÉ 9.3. Version 1.54 ΓòÉΓòÉΓòÉ

   1. Added the ability to specify a button label for the user-defined tags.

   2. Cleaned up the Tags menu quite a bit, and added ... to menu items that
      lead to dialogs.

   3. Added HTML, HEAD, BODY, DFN, CITE, CODE, and STRONG tags.

   4. Corrected a bug in which the default document template was not being
      passed through the translator when "Translate Non-English Characters" was
      active.

   5. Added/changed some hotkeys:

          Ctrl+G is now > and Ctrl+L is < (This was done because the previous
           hotkeys were not available on some keyboard setups.)

          Ctrl+P now inserts <P>

          Ctrl+B now inserts <BR>

          Alt+Backspace is Undo.

   6. Added a "Replace/Find" button in the Search dialog.


ΓòÉΓòÉΓòÉ 9.4. Version 1.53 ΓòÉΓòÉΓòÉ

   1. Added the ability to recall the last five HTML documents edited with menu
      items in the File menu.

   2. Added a new utility DefEdit that makes editing the translation files
      (.def) much simpler.

   3. WPS objects that are images can now be dropped on the entry field for the
      image name in the Anchors and Images dialogs. If the image is in GIF or
      JPEG format, the program will automatically determine and set the WIDTH
      and HEIGHT parameters in the HTML tag.

   4. Dropping an HTML file on the editing window will open that file.

   5. Added command line options -grabfocus and -nosocket. Specifying
      -grabfocus in the parameters field of the HTML Wizard object will cause
      the program to grab the focus once it is set up and running. Some people
      were having problems running the program on OS/2 2.1 without TCP/IP
      installed. The command line option -nosocket disables the Preview with
      WebLint feature and allows the program run normally.

   6. Modified the non-English character translation routines to ignore & when
      embedded in double quotes in a URL.

   7. Stripping of HTML tags from files now supports the translation of &xxx;
      entities like &. Previously only <xxx> tags were removed. The file
      tstrip.def contains the entity definitions and should be modified to suit
      your needs. (See the section on translation of non-English characters for
      details.)

   8. Numerous bug fixes involving problems with previewing and non-English
      character translation.


ΓòÉΓòÉΓòÉ 9.5. Version 1.52 ΓòÉΓòÉΓòÉ

   1. Alt-z repeats the last tag insertion.

   2. Status information is displayed when importing a file so that you can
      tell that something is going on if the file is large.

   3. The program now properly reports an error when saving a file is
      unsuccessful.

   4. The help file is in the process of being expanded to include entries on
      the supported HTML tags. This work hasn't been completed, but you can
      bring up help on some tags by right- clicking on the buttons in the
      Tagbar. And you can still bring up the help file under "Help" in the main
      menu.

   5. Fixed many annoying bugs such as:

          Word wrap setting not properly saved upon exiting.

          Incorrect syntax on the mailto: tag.

          Timing problem with previewing when WE was already running.

          Overwriting of clipboard during insertion of some tags.

          Incorrect insertion point for user-programmable tags.

          Save Without Tags wasn't working properly.

          Incorrect result when inserting a list with only 1 line selected.

          Files dropped onto the program object weren't being closed.

          Minor little problems with focus when some windows were opened.


ΓòÉΓòÉΓòÉ 9.6. Version 1.51 ΓòÉΓòÉΓòÉ

   1. Added a nice splash screen while the program loads.

   2. Fixed some bugs:

          File saving was not done properly, and the new file was being
           appended to the old one rather than overwriting it.

          Choosing "Close" from the "File" menu would not prompt the user to
           save changes if the file had been modified.

          I had inadvertently removed the code to load the REXXUtil library,
           causing all sorts of problems with previewing and using the new
           WebLint feature.


ΓòÉΓòÉΓòÉ 9.7. Version 1.50 ΓòÉΓòÉΓòÉ

   1. You can now have your HTML document checked for syntax errors by clicking
      on "Check Document with WebLint" under the "File" menu. THIS ONLY WORKS
      IF YOUR NETWORK CONNECTION IS ACTIVE. What the program does is send your
      document to the WebLint web site (www.unipress.com) for syntax checking.

   2. Added WIDTH, HEIGHT, and ALT entities to the IMG tag window. If you
      specify a GIF file, HTML Wizard will automatically fill in the WIDTH and
      HEIGHT entries with the correct values.

   3. The Alt-z key sequence repeats the insertion of the last tag. This makes
      it a little easier when you have to add the same tag repeatedly (like the
      <P> tag).

   4. Removed the dependency on RXEXTRAS.DLL. You can delete this file from
      your HTML Wizard directory.

   5. Fixed some bugs:

          The preview file is now saved in the working directory rather than
           the HTML Wizard directory. This enables Web Explorer to find images
           and linked items listed in your HTML file.

          Alt-r now brings up the Characters menu. Previously this was set to
           Alt-h, conflicting with the Help menu hotkey.

          The correct closing tag for the underline tag is now inserted when
           using the horizontal Tagbar.

          The "Hide Tagbar" setting is now correctly stored in the .ini file,
           so that the proper setting is used when the program is restarted.


ΓòÉΓòÉΓòÉ 9.8. Version 1.40 ΓòÉΓòÉΓòÉ

   1. Support for some HTML 3 tags has been added, including tables and
      backgrounds.

   2. Added a URL item for NAME=... links in an anchor.

   3. Added the FONT tag

   4. Fixed a problem that messed up previewing when Translate Non-English
      Characters was turned off.


ΓòÉΓòÉΓòÉ 9.9. Version 1.32 ΓòÉΓòÉΓòÉ

   1. Previewing with Web Explorer is now easier. To preview your HTML
      document, just select "Preview Document" from the "File" menu, or press
      F10.


ΓòÉΓòÉΓòÉ 9.10. Version 1.30 ΓòÉΓòÉΓòÉ

   1. A new "Options" item, "Translate Non-English Characters" allows you to
      edit HTML documents using non-English characters directly. This feature
      mainly benefits users of code pages whose non-English characters are
      available on their keyboards. HTML Wizard will (if this option is
      checked) pass files through a filter that converts these characters to
      and from their corresponding HTML entities when loading and saving the
      files. So, instead of seeing ö, you will see a single 'o' character
      with the umlaute accent. If you do not have your keyboard set up for a
      non-English character set, it is best to leave this option off. No harm
      will be done in using it, but file I/O will be slower because it has to
      pass through the translator. See the online help for more details on this
      feature.

   2. Forms support has finally been added.

   3. "Save Without Tags" is done through a C++ program rather than REXX, so it
      is much faster now. As of now, only <....> tags are removed. Character
      entities such as & are not converted. I hope to have this implemented
      soon.


ΓòÉΓòÉΓòÉ 9.11. Version 1.25 ΓòÉΓòÉΓòÉ

   1. Added automatic insertion of <P> tags when text files are imported. (Can
      be toggled in the Options menu)

   2. Added automatic insertion of <P> and <BR> tags when blocks of text are
      selected.

   3. Added an option to control whether <LI> tags are automatically inserted
      when lists are created.

   4. Added a "Save Without Tags" feature to save an HTML file without the HTML
      tags so that it can be imported into other editors, or to send text by
      email without all the tags, etc. Right now, this is done in REXX, so it
      can be painfully slow for a large file. Experiment with small files first
      to find out what your patience limit is. I have already coded this up in
      C++ to be much faster, but it will take a little time to get it merged
      seamlessly with HTML Wizard. It should make the next release, so this is
      just to whet your appetite. :-)