[comp.sys.amiga.misc] Hypertext -- REVIEW

MBS110@psuvm.psu.edu (04/24/91)

I downloaded Hypertext.lzh off of ab20 and was, needless to say, VERY
impressed. Hypertext is nothing less than a complete, speedy, and fully
functional hypertext system. The general idea is that you take an ordinary
text file, but there are "buttons" inside the text file which link you to
other text files, IFF pictures, SMUS music, audio samples, or ANY external
program. Even better, if the external program has ARexx hooks, Hypertext
can take advantage of them (amazing opportunities for expansion here...)

The authoring system is similarly easy: if you are using an ARexx
compatible editor, functions and menu items are added (for example, to
create a link you highlight its word and select LINK.) If you don't
have one of those, you merely put control commands in the text file
(/startlink This is a link. /endlink)

All in all, a quite impressive program which I thought I had to pitch
to everyone, just so you'll know it's there... (I didn't write it, BTW,
but kudos to whoever did! Just can't remember the name at the moment.)

/ Mark "Remixed for Common Household Appliances" Sachs - MBS110@psuvm.psu.edu \
| DISCLAIMER: It's NOT MY FAULT. Kei and Yuri                 ||   //        ||
|             forced me to say it.                            || \X/  AMIGA  ||
\========= "Oh, I'm just a NO-OP in the instruction set of Life..." ==========/

swarren@convex.com (Steve Warren) (04/26/91)

In article <91114.015549MBS110@psuvm.psu.edu> MBS110@psuvm.psu.edu writes:
>I downloaded Hypertext.lzh off of ab20 and was, needless to say, VERY
>impressed. Hypertext is nothing less than a complete, speedy, and fully

WHere on ab20?  I went in and looked around, but I couldn't find it
anywhere.
            _.
--Steve   ._||__      DISCLAIMER: All opinions are my own.
  Warren   v\ *|     ----------------------------------------------
             V       {uunet,sun}!convex!swarren; swarren@convex.com
--

jonabbey@cs.utexas.edu (Jonathan David Abbey) (04/26/91)

HT - An Amiga Hypertext program is in the amiga/utilities hierarchy on ab20,
I think.

HT is a really nice little program, and I really lust to use it for keeping
track of a whole bunch of stuff that I may have to deal with.  It has wonderful
AREXX support (although, not having AREXX myself, it's somewhat hard to
say this with any authority.. 8-), great multitasking layout,... it's very
nice.

Unfortunately, it has a couple of bugs, a number of misfeatures, and a lot
of things missing which could make this program truly wonderful.

The author of the program provides no means of contact whatsoever,
unfortunately.  The only identification is in the program, and that is:

Dominic Giampolo
(c) 1990 Homeboy Software

I sort of suspect that this might have been brought up to ab20 from someone
besides the author.. public bulletin board perhaps?   In any case, if any
one knows how to get in touch with the author, please relay these comments if
it would not be too much trouble.

Okay, let's get this started of right:

_BUGS_

1.  The program puts your Amiga into fireworks mode if you are so foolish as
    to specify a proportional font for your document.  I believe it does the
    same with monospaced fonts thinner than topaz 8.

2.  If your line is too long and wraps around such that a formatting code is
    at or near (?) the end of the line, the program loses proper track of
    it's position for word wrap and repeats words on the next line.  To add
    insult to injury, if it is in a style mode at wrap point, that style
    will continue on to the wrapped line.  It may then proceed to re-read the
    style toggle, turning it off for the text you wanted it on for, and
    eventually leaving the rest of your document underlined or some such.

_(that's not a bug, that's a) MISFEATURES_

1.  If you have spaces between \underline toggles, the spaces are underlined
    on screen.  This is maddening when you want to have a line of headers,
    as surrounding each column header with \underline makes impossible to align
    your headers.  More on this later.

2.  There is no 80 column mode, unless you can take your amiga into overscan
    with morerows or some such.  This is a large pain, as I would like to
    enter a meeting agenda into HT as is, but if it is more than 73ish
    columns, it wraps.  As the agenda has columns, this is a real problem.
    This one alone makes HT almost unusable for what I would like to use it
    for.

3.  When you print the text of your document, it puts a line of ----'s at the
    end.  This is, I think, to allow you to distinguish between documents
    in a file or some such.  Unfortunately, I can't use HT to print out said
    agenda without getting the line of dashes at the bottom.

4.  HT does on-screen formatting for whatever font and window size you have,
    but when you print, it uses the on-screen formatting, rather than
    printing out at the printer's default text line size.

5.  In HTConfig, you can't save to s: and to the local directory, because
    the configuration program exits once you save the configuration to either.
    It would be nice to select both as a toggle, or for it not to exit without
    the user hitting the exit configuration gadget.

6.  If you resize the window, the text is not re-arranged for the new
    window configuration.

7.  Emacs compatible movement keys (up-line/down-line) are available, but
    bizarrely changed. (p, n rather than ^p,^n).  No vi keys.  (Whine, whine)
    BIG GOOD THING: PgUp/PgDn support on keypad.

8.  The color-coded link option doesn't seem to work. (i.e., the links are
    the same color as the rest of the document.)

_RELATIVELY EASY TO ADD FEATURES THAT I'D REALLY LIKE TO SEE 8-)_

1.  A full-screen, honest, simple 80 column display.  No window borders, no
    proportional gadget.  Text the way God intended it.  Put a row of icons
    at the top or bottom for page up/down, text search, screen front/back.
    It could even have a shaded color scheme, perhaps with a 8 or 16 color 640
    by 200 mode.  Interlace custom screen option.
    Second best option: horizontal scroll bar.

2.  An iconify button.  HT is something I'd like to be able to leave running
    at all times, but it currently requires you to have a window open, except
    when it is RESIDENT as an AREXX client.

3.  Some way of specifiying that a text link will leave you in the same window,
    rather than each text link always opening a new window.  This would be
    a nice user menu option, particularly if coupled with a way of going
    back to the file you linked from.

4.  HT has a menu item that allows you to edit the plain text of the document,
    but if you want to edit the hypertext codes you have to go out for another
    editor.  A menu with edit hypertext / save hypertext would be nice.

5.  Being able to specify color changes in the text.

6.  An option to place text flush with the right side of the window.

7.  The correction of the aforementioned bugs and misfeatures. 


_HARD THINGS TO IMPLEMENT THAT WOULD MAKE THIS PROGRAM WORTH PAYING FOR_

    "Julia, this category is for those things that this program really should
  have, but which the judges felt would be too difficult to implement without
  seriously changing the program's basics."
    "Right, Richard.  These are the things that could make this program a
  truly wonderful, useful tool in our judges lustful, biased view.  However,
  they do realize that these are not trivial things."
    "In fact, Julia, the judges have mentioned that these mods would make the
  program well worth a $15-$20 shareware donation, if the author should provide
  any means of getting in contact with him."
    "And the winners are..."

1.  It would be nice to have some sort of link map built up as you go.  At
    the least, a file stack to keep track of where you have linked from would
    be very nice if link to same window is implemented.  

2.  Spawn a child process to handle the printing of a document.

3.  The big one.  Change the file format.  Currently, it uses back-slash
    keywords in text to mark links and style changes, as well as centering,
    indentation and the like.  While easy to use and aesthetically pleasing,
    these keywords make it extremely difficult to get good control over the
    placement of your text.  Agreed that it is nice to be able to edit your
    documents in any editor, but having the files in a straight text format
    is not *that* big a win, as you can do little more than read it with those
    '\' codes in the text.  The ideal would be for the file format to be
    a modified FORM FTXT, with a chunk to indicate links in the file.  You
    could bring old-style HT files into HT and write it out as FORM FTXT.
    You could bring either FTXT or straight text into HT and add links to it.
    If you like, the text or FTXT could contain the '\' codes for links, but
    HT would remove them from the text, and place them in the (HYPT?) chunk.
    This would give HT an easy path to clipboard capability (the notes feature
    is nice, but not a substitute for clipboard support), the glamor of IFF
    support, and the creation of a registered chunk that other
    programs could use.  Import WordPerfect, ProWrite files.

    This above all else (except 80 col. support) would make this worth using.

4.  Implicit in 3, I guess -- full text editing within HT, including link
    editing (when in edit mode, double click on link.. up pops a requestor,
    asking you what type of link it is.  Click on text.  Up pops a list of
    known link destinations, along with a file requester button).

    (Ok, THIS above all else, (except 80 col. support, and including 3.))

5.  Integration of the HTconfig program with HT.

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

Again, if you know the author, please relay this to him.  I am willing to
put in some programming time to help him with this if he should be so inclined.
I am definitely willing to send him money for something that has some of
these things fixed/added (not even including the really hard stuff.)

Anyone interested in discussing FORM HTXT? 8-)
-- 
-------------------------------------------------------------------------------
Jonathan David Abbey              \"Fortune presents gifts not according to the
the university of texas at austin  \  book" - Dead Can Dance "I've got to
computer science/math?/psychology?  \ jonabbey@cs.utexas.edu  stay Awake..."

GIAMPAL@auvm.auvm.edu (04/26/91)

In article <313@atacama.cs.utexas.edu>, jonabbey@cs.utexas.edu (Jonathan David
Abbey) says:
>
>HT is a really nice little program, and I really lust to use it for keeping
Thank, but do you really lust after it? :-)

>The author of the program provides no means of contact whatsoever,
>unfortunately.  The only identification is in the program, and that is:
>
>Dominic Giampolo
>(c) 1990 Homeboy Software
>
>I sort of suspect that this might have been brought up to ab20 from someone
>besides the author.. public bulletin board perhaps?   In any case, if any
Yes this is exactly the case and since it has caused problems, I will
upload the full version soon.  I noticed HT was on ab20, but didn't really
check it out.  The version I upload will be the "official" version (i.e. with
all the docs).  In case anyone is interested, I'll be uploading it tonight.

I'm sorry Jonathan ran into all those bugs (that to the best of my knowledge
were taken care of).  I've replied to him directly to try and work through
those problems (which I honestly hadn't encountered).


--dominic

GIAMPAL@auvm.auvm.edu (04/26/91)

Thanks for the plug!  I wrote HT, but I didn't post the version that is
on ab20.  I will be posting a more "complete" version tonight.  I noticed
that it was on ab20, and saw that it wasn't the complete version.  Like I
said, I'll upload the whole thing tonight, so please don't download it
till tomorrow or so (unless you want a less than complete version).

If anyone has any questions about HT, let me know and I'll try to answer
them.

--dominic

jonabbey@cs.utexas.edu (Jonathan David Abbey) (04/27/91)

For my part, I'd like to apologize for the demanding tone of my post.. upon
reading it on the net it seemed a lot less pleasant than when I wrote it.

HT is neat, and I advise everyone to take a look at it after Dominic puts
the complete distribution up this evening.


-- 
-------------------------------------------------------------------------------
Jonathan David Abbey              \"Fortune presents gifts not according to the
the university of texas at austin  \  book" - Dead Can Dance "I've got to
computer science/math?/psychology?  \ jonabbey@cs.utexas.edu  stay Awake..."

davidm@uunet.UU.NET (David S. Masterson) (04/27/91)

>>>>> On 26 Apr 91 04:53:34 GMT, jonabbey@cs.utexas.edu (Jonathan David Abbey)
>>>>> said:

JDA> HT - An Amiga Hypertext program is in the amiga/utilities hierarchy on
JDA> ab20, I think.

JDA> HT is a really nice little program, and I really lust to use it for
JDA> keeping track of a whole bunch of stuff that I may have to deal with.  It
JDA> has wonderful AREXX support (although, not having AREXX myself, it's
JDA> somewhat hard to say this with any authority.. 8-), great multitasking
JDA> layout,... it's very nice.

JDA> Unfortunately, it has a couple of bugs, a number of misfeatures, and a
JDA> lot of things missing which could make this program truly wonderful.

From this and later descriptions, it sounds like Hypertext is very much like
Thinker (Poor Person Software).  Considering how cheap it is, perhaps you want
to look at Thinker?

--
====================================================================
David Masterson					Consilium, Inc.
(415) 691-6311					640 Clyde Ct.
uunet!cimshop!davidm				Mtn. View, CA  94043
====================================================================
"If someone thinks they know what I said, then I didn't say it!"

nguyent@balboa.eng.uci.edu (Thien Nguyen) (04/28/91)

In article <91116.085637GIAMPAL@auvm.auvm.edu> GIAMPAL@auvm.auvm.edu writes:
>Thanks for the plug!  I wrote HT, but I didn't post the version that is
>on ab20.  I will be posting a more "complete" version tonight.  I noticed
>that it was on ab20, and saw that it wasn't the complete version.  Like I
>said, I'll upload the whole thing tonight, so please don't download it
>till tomorrow or so (unless you want a less than complete version).
>
>If anyone has any questions about HT, let me know and I'll try to answer
>them.         ^^^^^^^^^^^^^^^^^^^^^^
>
>--dominic


How fast is the Text Editor or Reader on it compared to the Amiga Vision
Text editor?  Amiga Vision text editor is tooooooo sloow; it's not usable
even on the 3000.  Also how customizable is the text editor!

Is it possible to have a digital clock on the custom screen that is changing
real time?  

GIAMPAL@auvm.auvm.edu (04/29/91)

In article <281A7F2E.1415@orion.oac.uci.edu>, nguyent@balboa.eng.uci.edu (Thien
>>If anyone has any questions about HT, let me know and I'll try to answer
>>them.         ^^^^^^^^^^^^^^^^^^^^^^
>
>How fast is the Text Editor or Reader on it compared to the Amiga Vision
>Text editor?  Amiga Vision text editor is tooooooo sloow; it's not usable
The AmigaVision text viewer thing is ridiculously slow.  HT is _much_
_much_ faster.  To tell you the truth, I don't know how the AmigaVision
people (IMSATT) got their text viewer to be so slow.  They must have really
tried :-)

 HT's text display is very fast, and speed was one of my prime concerns when
writing HT.  Short of playing funny blitter/cpu tricks, you are not going
to be able to go any faster (considering that HT displays arbitrary fonts
and text styles).  My display code has been re-written several times, and
I think it is quite nice to use (download the program and see it in action!).

Also notice that HT never falls behind on key repeats no matter how big
or long your document is.

>even on the 3000.  Also how customizable is the text editor!
HT is _not_ a text editor.  You can use any text editor you want to write
your HyperText documents, then HT displays them and lets the user follow
your hypertext links and take notes on the document.


>Is it possible to have a digital clock on the custom screen that is changing
>real time?
Sure if you want to run a clock program I don't have a problem with that :)


--dominic

mwm@pa.dec.com (Mike (My Watch Has Windows) Meyer) (04/30/91)

In article <CIMSHOP!DAVIDM.91Apr26185204@uunet.UU.NET> cimshop!davidm@uunet.UU.NET (David S. Masterson) writes:
   From this and later descriptions, it sounds like Hypertext is very much like
   Thinker (Poor Person Software).  Considering how cheap it is, perhaps you
   want to look at Thinker?

Well, they're both hypertext. These comments are based on an earlier
version of HT (haven't looked at the latest version); if they're
wrong, I expect someone will correct me.

Thinker uses a proprietary file format. HT uses ASCII text.

HT uses a stream of bytes. Thinker breaks the stream up into chunks,
and you can manipulate text in a chunk, or the whole chunk.

Thinker provides outliner-type facilities (substatements, elision,
etc). HT is a flat file.

Thinker puts labels on statements, and that's the destination for a
link. HT puts pointers to statements in the text, and that's the
source for a link.

With thinker, a hypertext document is a large, single file with a few
links to other documents. With HT, a hypertext document is a
collection of small files that with links between them.

Thinker lets you choose between following a link in the current
window, or opening a new window. HT always opens a new window (that
was a change request I made at one point).

HT provides better keyboard support. Thinker provides better mouse
support.

They are different, and I can see using them for different projects.
For instance, putting the AutoDOCS into thinker is hard (I know, I did
it once....). I expect putting them into HT would be much easier.

Personally, I use thinker for most hypertext things. Largely, this is
because I've been using it longer, and have a thinker hypertext system
in place for cross-references. However, the ouliner features are a
close second - they're very nice to have.

The bottom line is that HT is free. It'd be crazy not to get it and
play with it before investing in Thinker. If you know outliners, you
can decide if you want them. If you don't know them, then you might
want to find a copy of 'liner (a PD outliner), and play with that (I
don't know much about it though, I had thinker before it became
available).

Someone was supposed to write a review of Thinker for the net, and
it'd be nice to have the two to compare.

	<mike
--
He was your reason for living				Mike Meyer
So you once said					mwm@pa.dec.com
Now your reason for living				decwrl!mwm
Has left you half dead