|Hyperwise v2.0||- by Jon F. Kaminsky|
Version 2.0 of IBM's Hyperwise is an OS/2 native authoring environment which allows the creation of on-line information. Specifically, Hyperwise can create content for IBM's Information Presentation Facility (IPF: e.g., .INF books or .HLP help files), BookMaster documents, and HTML browsers. Hyperwise can also port information to be viewed under Microsoft Windows 3.1 so if you are creating an application that will be ported to Windows from OS/2 (or vice versa) you only have to write the help file once. And Hyperwise can export to files such as .IPF-tagged source files, .RTF-tagged source files, and BookMaster-tagged source files.
The Tutor/2 application assists in the construction of interactive tutorials so that the target audience learns about a software product while they are using it. In addition, fly-over help is available for many of the features offered in Hyperwise.
I have used Hyperwise to create on-line books such as the Yarn-Souper reference (ZIP, 43k) in the June issue of OS/2 e-Zine!, and help files for several of my OS/2 shareware applications. I have also had great success in creating multimedia entertainment books for my two-year old son. For this review, however, I also wanted to experiment with the HTML features of Hyperwise, which, in my opinion, take a backseat to the aforementioned usages.
The program is started by clicking on the program object which temporarily displays a splash screen while the environment loads. Hyperwise opens up to a desktop (GIF, 11.7k) populated with several sample .WF objects, the "create a new document" object, the document and panel shredder object, and the "change working directory" object. The .WF objects are workfiles which are contained in the working directory, which by default is X:\HWISE\WORK. I created a workfile during the course of this review and exported it to an .INF file for OS/2 e-Zine! readers to download here (ZIP, 4.6k).
Unnamed panels can be named by double-right clicking anywhere in the panel to bring up a properties dialog where Panel Properties (GIF, 9.2k) can be specified. I named my panel "Hyperwise Review Introduction" and linked from it to all the other panels in this demo .INF.
The size of the panel is also specified in Panel Properties. Panel sizes can range from 35% to 80% and the panel's position can also be specified. For example, a small panel created to appear in the upper right corner of an .INF document might be specified as RightTop40%. In addition, footnote panels can be specified. Footnotes can be linked to and from but do not appear in a book's Table of Contents.
Other often used formatting elements include ordered and unordered lists, definition lists, character graphics, example, invisible text (author's notes), or figure captions. Hyperwise handles them all. Pre-formatted notation elements are available including: Warning, Caution, Note, or Danger.
Indexes to on-line documents are easily created by highlighting the text you want included in the index and then linking it to the appropriate panel. Upon compilation, the index button will automatically be added to the bottom of the window displaying the .INF or help file.
For example, on my machine, sounds are kept in the E:MMOS2\sound bites\ directory. When distributing an .INF with embedded sounds, the end user must have a copy of the sound files in the same directory structure on the same drive or they will not be able to hear the .WAV sounds.
In Hyperwise, you only need to identify the panel to be called in response to some event. This is done by name and number which are specified in the Panel Properties dialog. For the application, the developer writes simple code for each object (e.g., a dialog or button) that brings up the appropriate help panel when the F1 function key is pressed. Application code is also written for each of the four menu choices to bring up the Help File Index, Table of Contents (usually general help), the OS/2 generic Using Help file, or the Keys Help if so specified.
href="xxxx.htm"type tags substituted for the hypertext links. The blue color is preserved, however so finding the location of the original link is not too difficult. There also is no element for URL's so all of these need to be edited by hand as well. To demonstrate what the sample .INF book I created looks like as HTML, I have included it here. Note that the entire file becomes one page, and some of the elements do not translate well, particularly the tables and character graphics. Large text apparently does not translate well either.
If you had a large .INF document that you wanted to port to HTML, I could see the utility of using Hyperwise to do so, although it would require some hand editing to clean it up, however. But Hyperwise is far too limited to originate HTML content from scratch, however.
The HTML features are sorely lacking. It is clear to me that HTML export was added as somewhat of an afterthought rather than an intended end use of this product. However, the proliferation of HTML content for the Worldwide Web creates the need for a product occupying this niche to include a rich set of HTML-specific features. For example, the ability to tag panels as URLs and then link to them from a parent panel should be included. In addition, Hyperwise cannot deal with .GIFs or .JPGs which are used heavily in WWW content.
Linking to multimedia objects seems a little lacking. It is not clear how one distributes a document with links to such objects as they do not seem to be embedded after compiling. In other words, when embedding a graphic in a document, you do not have to distribute the graphic to the end-user as it becomes part of the document after Hyperwise compiles it. However, there does not seem to be a way to this with sound files. In this case, the sound files will not play unless your end-user has the sound file you embedded in the exact directory structure the author has.
While Hyperwise is a Presentation Manager application, it is not a Workplace Shell application. Consequently, drag and drop is not well-implemented and most functions are accomplished by menus, dialogs, and lists inside PM windows. Especially in the case of the windowed lists, the number available can cause a large amount of clutter in the work space. At the very least I'd like to see some different right-mouse button functions added (e.g., properties, font changes, elements, etc.) so you don't have to have particular windows open to make changes. In addition, there is no template added for Hyperwise, so to work on a certain file, you must open Hyperwise first and then open or create a file.
Hyperwise also doesn't do a great job with dealing fonts. It has been reported that fonts in a document compiled on one machine might not look right when viewed on another.
And the IPF export isn't too clean. If you are the kind of person that wants to play with your files by hand as well as use Hyperwise, you might find that it messes them up. This is mostly only important if you intend to do future reading and modifying by hand.
I should add that I have experienced a couple random lockups when trying to save large documents, or when an index item became corrupted for some reason or another. In the first case, the error goes unexplained other than being due to improper memory access of one of the Hyperwise .dll's. The work-around seems to be to save often when you routinely make large amounts of changes in your document.
In the second case, the problem seems to stem from index links that are broken after changes are made to a document which break a certain index link. The work-around in the this case seems to be to destroy the panel in question, and recreate it with a different name and then recreating the appropriate index link to that panel.
I run Hyperwise on a Pentium 133 with Warp blue spine and no FixPaks, so your mileage may vary.
[Our Sponsor: House of Technology, Inc. - Your Canadian Source For OS/2 Applications.]
Copyright © 1996 - Falcon Networking
This page is maintained by Falcon Networking. We welcome your suggestions.
Copyright © 1996 - Falcon Networking