
HTML Extensions for EPM (Version 0.97)
======================================

New features of version 0.97: see the end of this file.

Legal stuff
See the file license.txt

Contents
The HTMEPM97.ZIP package contains 6 files:
    README         - This file.
    LICENSE.TXT    - License information (basically taken from IBM).
    HTMLTAGS.E     - The E source code of the HTM extensions.
    HTMLTAGS.EX    - Compiled code for EPM 5.51a (the editor supplied with Warp)
    HTMLTAGS.551   - Compiled code for EPM 5.51  (the editor supplied with OS/2 2.1)
    FILE_ID.DIZ    - Brief description of the package

Rationale
The widening popularity of the World Wide Web has created the need for
writing documents using the HTML format.  There are some simple editors
available that give HTML Editing capabilities but limited general editing
features.  I have worked the other way around, giving menu-driven HTML
editing tools to a very powerful Editor.  I took inspiration from the
Customized version of EPM distributed freely by IBM as CSTEPM.ZIP that
includes support for SGML, TeX,...


Installation
The IBM OS/2 EPM Enhanced Editor can be extended using macros written in a
language called E. The E extensions can be added to the editor either the
hard way by modifying and recompiling the epm and extra macros (you will
need to download the ETPM compiler,standard macros,...)  or the easy way:
since the 5.51 version, EPM allows for the use of External Modules that can be
linked at any time, so I have supplied the HTML extensions as an external
linkable module in a 13Kb single file named HTMLTAGS.EX (sic, .EX not
.EXE).

Installation for Warp Users:
All you need to do is to copy the HTMLTAGS.EX file into your \OS2\APPS directory
(or wherever you have the EPM.EXE file). Now follow the steps indicated in
the "COMMON SECTION"

Installation for OS/2 2.1 users:
Copy the HTMLTAGS.551 file to your \OS2\APPS directory (or
wherever you have the EPM.EXE file). Rename it as HTMLTAGS.EX.
Now follow the steps indicated in the "COMMON SECTION".


COMMON SECTION
Start the EPM editor, open a Command Dialog Window (select Command then
Command dialog):  then type 'link htmltags' (WITHOUT quotes).  The editor
should inform you of the operation with a 'Link completed, module#n' message,
and an HTML option should now be visible in the editor main menu.
The extensions will last till the end of your session with EPM or until
you unlink them using again a Command dialog window (you should
now type 'unlink htmltags', WITHOUT quotes) and the HTML option
will be removed from the main menu.
If you want to have the extensions always linked you can either edit the
standard macros and recompile them or (again the easy way) just open the
settings notebook of the Enhanced Editor object in your Desktop and type
as parameter to be passed to the program 'link htmltags' (WITH the single
quotes now!).  From then on everytime you launch EPM by double-clicking on
its icon the HTML extensions will be linked at start time so you won't
need to reinstall them manually.



Compiling E Language Macros
The E source of the extensions is provided so those willing to incorporate
it permanently to EPM are free to do it.  It will need just a litle
tweaking of your standard or customized macros to include it.  I am not an
expert in writing E macros but if you have troubles just drop me a note
and I will try to help.


Using the Extensions
I think the use of the extensions should be intuitive to anyone familiar
with the HTML tagging.  The different tags that constitute the HyperText
Mark-up Language can be embedded in the text selecting the HTML option
that has been added to the editor main menu.  If the tag to be inserted is
a single one (new paragraph, horizontal rule,...)  it is inserted at the
cursor.  If the tag is "double" (i.e.  it needs a start tag and an end
tag) then if there is no text area previously selected by dragging both
tags are inserted at the cursor position and the cursor will be placed
between the tags; if text is selected the tags will (usually) be placed
encircling it.  Forms are supported in what seemed (to me) a useful way
but I am open to receive any suggestion.
Some of the extensions can be selected If you right-click anywhere over
EPM main windows:  a simplified HTML menu will pop-up for quicker access.

Viewing files with the WebExplorer
The preview option is kept but it is only useful to launch the WebExplorer.
Once the Explorer is running all you need to do to "view" the file you're
editing is drag it from EPM to the Explorer, using the book icon of EPM
(the icon on the top-left of EPM, that you should drag and then drop into
the WebExplorer main window). Beware that (in my experience at least)
you need to "prime" the Explorer (1.02) by dropping into it a file from any
folder but not from the EPM. If the first drop to the WebExplorer comes
from EPM, the Explorer crashes! Once you have "primed" it, you can drag &
drop as many files as you want from EPM to WebExplorer without problems.

EPM Documentation
The IBM documentation and tools needed to write and compile E macros can
be found on several files in the /epm directory in software.watson.ibm.com
and several other ftp sites .

EPMAPP.ZIP - Contains the compiler, the editor,...
EPMMAC.ZIP - The standard macros used to compile EPM as supplied .
EPMBOOK.ZIP - Documentation in INF format. It contains the EPM User's
Guide that I can't understand why it is not included with OS/2 as this is
the complete EPM guide. It also includes the EPM Technical Reference.
CUSTEPM.ZIP - A customized version of EPM written by IBMers. Fully
recommended if you want to study E Language macros.  My main source of
inspiration when writing the HTML extensions.


HTML Info
If you are interested in HTML documentation, look in the Web. Some
useful places are :
http://www.ncsa.uiuc.edu/demoweb/html-primer.html
http://www.w3.org/hypertext/WWW/MarkUp/MarkUp.html
http://info.cern.ch/hypertext/WWW/Provider/Style/Introduction.html
http://info.cern.ch/hypertext/WWW/MarkUp/SGML.html
http://kuhttp.cc.ukans.edu/lynx_help/HTML_quick.html



UPDATE NOTES for 0.96 version

- fixes some conflicts in the accelerator keys and some misplacements of
the cursor after inserting tags.
- the popup menus will pop now in the same position in the screen.
- includes HTML+ style paragraphs (suggested by Terry Hamilton)
- includes a rough 'preview' option (ideated by Ken Arway) to view the
file with the WebExplorer.
- Hightlight of HTML keywords. It can be turned on/off from the menu. When ON
the tags inserted from the menu will be hightlighted. If you insert your
own tags manually you can hightlight them by selecting 'Sintax hightlight
On' from the menu. I have included the option for three colors: one to
make the tags barely visible (LIGHT GREY on WHITE paper) and others (RED &
BLUE) to make them more evidents.

 - Those  using EPM 6.x should recompile the source file: The
popup menu would appear on Alt-Click2 instead of just Click2 to avoid
conflicts with the standard popup menu of version 6.x


UPDATE NOTES for 0.97 version
- includes a compiled version for 5.51 users (OS/2 2.1)
- fixes some conflicts with the selection keys
- simplifies the Hightlight of HTML tags: now they're put in inverse video no matter what
your background and text colors are. The menu item is ticked.
- some new tags are included (most HTML 2.0 tags are now available)
- fixes some misplacements of the cursor
- users of version 6.x of EPM should recompile the macros using the
source code included as I haven't been able to get the EPM 6.x version.

-------------------------------------------------------------------

June 26th,1995
Eduardo Areitio
Bilbao, Spain
internet: areitio@ibm.net

