home *** CD-ROM | disk | FTP | other *** search
/ Otherware / Otherware_1_SB_Development.iso / amiga / utility / text / htext.lzh / hypertext / Documentation / HT.Doc < prev    next >
Encoding:
Text File  |  1990-12-23  |  8.0 KB  |  176 lines
  1. \font courier 15
  2. \title HT - Documentation, an introduction.
  3. \help Ht.help
  4. \center
  5. \ital HT - A HyperText Program for the Amiga Computer \ital
  6.  
  7. \underline Introducution :\underline
  8.  
  9. \format
  10.     The program you are using, HT, is a complete Amiga hypertext system.
  11. HT works with text files which contain "links" to many other types of
  12. objects and media.  HT has been designed on and for the Amiga, and
  13. therefore takes advantage of the unique features the Amiga provides.
  14.  
  15.     HT uses ASCII text files and allows words and phrases to be linked to
  16. other Text, Sound, Pictures, Arexx, or even arbitrary programs.  HT offers
  17. many features for the user that make it an excellent learning tool and a
  18. breeze to use.    HT also provides a sophisticated development environment
  19. for hypertext authors.
  20.  
  21.  
  22. \ITALIC HT \ITALIC is easy to use, but lets make sure the basics are clear.
  23.  
  24.      To scroll through the text you are reading, you can use the arrow keys
  25. on your keyboard, the scrollbar on the right side of the window, or the
  26. arrow gadgets in the bottom right corner of the window.  If you happen to
  27. be a fan of an editor called \Link { Emacs.txt } Emacs\endlink you can also
  28. use the 'n' and 'p' keys to scroll to the next and previous lines.
  29.  
  30. \center
  31. In \ITALIC HT, \ITALIC links are show in inverse video like this:
  32.  
  33. \center
  34. \link { Using } Click here to learn more about using HT.\endlink
  35.  
  36.     Double Clicking the left mousebutton on the highlighted text will bring
  37. up the reference/link.    You can click there now to try it out.
  38.  
  39.      That covers most of the things you need to get yourself started using
  40. \ITALIC HT.  \ITALIC There is more, but for now that covers the basics.
  41.  
  42.  
  43.     From here, there are several place you can jump off to for more
  44. information on HT.
  45.  
  46. \center
  47. \link { Ideas } Ideas for HyperText documents. \endlink
  48. \link { Using } Using HT - Interface features \endlink
  49. \link { Creating } Creating HyperText documents. \endlink
  50. \link { TechInfo } Behind the scenes - how does HT work? \endlink
  51.  
  52.  
  53.  
  54. \ITALIC Some general information on HT and hypertext. \ITALIC
  55.  
  56.     \ital HT \ITALIC allows your words to come alive on the screen.  The
  57. benefits of a hypertext document as opposed to normal text files are
  58. immense.  It is similar to the difference between a Ford Escort and a
  59. Lamborghini.  A Lamborghini is a turbo-charged monster which will get you
  60. where you want to be \ital fast. \ital    Similarly HT is a stream-lined
  61. program that lets you get to the information you need \ital fast.\ital
  62.  
  63.     As a user, HT can provide you with a great many facilities that you
  64. just can't get any other way.  Imagine being able to pick up a diskette
  65. that has a complete set of references and actual articles on a topic you
  66. are interested in.  Now imagine if that was all fully cross-referenced and
  67. linked.  And it had pictures, sounds, and animations that were relevant.
  68. You can easily see that the difference is large and the benefits are many.
  69.  
  70.     All the standard forms of communication are possible with an HT
  71. document.  In addition, there are facilities for getting hard copies,
  72. taking notes, and even editing the notes you have taken.  The HT interface
  73. is designed \bold not to get in the way.\bold  You concentrate on the
  74. content matter of what you are reading, not some baroque or ornate
  75. interface.  The text scrolling is designed to be smooth and fast, and key
  76. repeats do not haunt you by scrolling for hours after you have let go.
  77.  
  78.     It is possible to have other applications use HT as a help server.
  79. What good does that do you?  You could quickly get on-line help with a
  80. program you are having trouble with.  Wouldn't it be much better to simply
  81. pop up an HT window with the help you need in it, than to flip through a
  82. 600 page manual?  Using HT you could take notes on the important section,
  83. print them out if needed, or save them for future reference.
  84.  
  85.     For programmer types, it is possible to have the entire \ital Amiga
  86. Includes and AutoDocs \ital on-line and easily accessible.  No more
  87. flipping through pages and pages of documentation.  And since HT lets you
  88. import notes you have taken directly into your text editor, you can simply
  89. cut and paste code you need right from the documentation!
  90.  
  91.     HT fits nicely into everyone's existing system without major hassle.
  92. You can instantly start using HT with the files you already have.  HT gives
  93. you a small, easy to use on-line hypertext system.  For a user, this means
  94. that you have quick access to large amounts of information at any time.
  95.  
  96.  
  97. \ital How easy is authoring Hypertext documents? \ital
  98.  
  99.     For authors, HT provides a fantastic environment. You don't have to
  100. learn another editor, simply continue using what you already know. Vanilla
  101. text files load directly into HT.  If necessary, you can take advantage of
  102. the markup language to improve the appearance of your documents.  There are
  103. facilities for formatting, setting fonts, changing the text style, and even
  104. providing help files for the user.  You can also set window colors, titles,
  105. position, etc.    The markup language is very easy to use, and with
  106. additional tools (based on ARexx) it becomes even easier.
  107.  
  108.     The ARexx based tools allow you to have a smooth working system for
  109. easily letting your creativity flow.  The tools allow seamless integration
  110. of your text editor and HT.  You can take advantage of the "Link Requestor"
  111. (which is written in ARexx) to completely specify any link in a point and
  112. click fashion.    And you can preview your documents at the press of a key.
  113.  
  114.     This approach to hypertext development is ideal because it is designed
  115. to be small, fast, and efficient.  Instead of a single piece of "do
  116. everything" software which requires monstrous resources, it is preferable
  117. to work with well designed flexible tools.  As an example, the entire HT
  118. program and documentation was written, tested, and debugged on a 1 meg, 2
  119. floppy, Amiga 500 computer.
  120.  
  121.     HT will work with text files you \bold already have.\bold  There is no
  122. proprietary format on \ital your \ital data.  ASCII text files of all sorts
  123. will load directly into HT \bold without \bold modification.  You can
  124. integrate HT into your current system without a single change to how
  125. anything else works.  HT is small enough to not require gobs of disk space,
  126. making it usable even if you don't have a hard disk.
  127.  
  128.     As an author in the HT environment, your message can contain multiple
  129. media types to help demonstrate what you are trying to say in whatever way
  130. is most appropriate.  You could use an animation to demonstrate an effect
  131. that would take pages to explain.  You can link into your documents pieces
  132. of music and speech which would be too difficult to describe any other way.
  133. Imagine not only being able to write about J.F.K., but also being able to
  134. view famous pictures of him, and hear him proclaim : "Ask not what your
  135. country can do for you, but what \ital you \ital can do for your country".
  136. These examples only begin to scratch the surface of what is possible with
  137. \ITALIC HT.\ITALIC
  138.  
  139.  
  140.     As mentioned before, HT provides a rich environment for both the
  141. Hypertext user and author.  The links HT provides are :
  142.  
  143. \freeformat
  144. \ital
  145.         Links to:
  146. \ital
  147. \bold
  148.           o Words/phrases in other text files
  149.           o Pictures   (IFF format)
  150.           o Animations (ANIM format)
  151.           o Digitized sounds
  152.           o Songs       (SMUS format)
  153.           o ARexx  (both into and out of HT)
  154.           o External programs of any type
  155. \bold
  156.  
  157. \format
  158.     The links provided, cover the gamut of media types offered on a home
  159. computer.  The ability to run any external program leaves a wide open door
  160. of possibilities (full motion video via a laser disk, computer controlled
  161. robotic arms, sound/video digitizers, etc).  The ARexx links allow for easy
  162. integration of many diverse applications.  In addition, via the ARexx port,
  163. any other ARexx compatible program now has the potential for a complete
  164. on-line hypertext help system.
  165.  
  166.  
  167.     HT provides a complete solution to hypertext use and development.  It
  168. doesn't get in the way and works well with existing tools. From here, there
  169. are two main areas you can head to :
  170.  
  171. \freeformat
  172.      \link { Using    } Using the HT system\endlink
  173.      \link { Creating } Hypertext Development \endlink
  174.  
  175.  
  176.