home *** CD-ROM | disk | FTP | other *** search
/ Otherware / Otherware_1_SB_Development.iso / amiga / utility / text / htext.lzh / hypertext / Documentation / Using < prev   
Encoding:
Text File  |  1990-12-23  |  10.2 KB  |  227 lines
  1. \help Ht.help
  2. \fgcolor 2
  3. \center
  4. \bold \ital Using HT - What's involved? \ital \bold
  5.  
  6. \format
  7.      The user interface to \it HT \it is very simple.  The interface is
  8. clean and smooth, and not loaded down by intricacies.  There are no silly
  9. distractions, and you can concentrate on what you are reading, not HT.
  10.  
  11.      Basic usage of \it HT \it is trivial.  Scrolling through the text
  12. you are reading is done by using the arrow keys, the mouse and the scroll
  13. bar on the right side of the window, or the arrow Gadgets in the bottom
  14. right corner.  To move down through the file you are viewing, press the
  15. arrow key that has the down arrow on it. To move up press the key with the
  16. up arrow on it.  Using the scroll bar is a matter of clicking the left
  17. mousebutton on it, and dragging it to wherever in the file you would like
  18. to be.    The arrow Gadgets work the same as the same key press, but use the
  19. mouse instead.    You can hold down the left mouse button to scroll
  20. continuously.
  21.  
  22.      If you would like to get somewhere quickly, you can also use the \bold
  23. shift \bold and \bold control \bold keys with the arrow keys to speed
  24. things up.  When you press the \bold shift \bold key and an arrow key (up or
  25. down), you will move one screenfull at a time through the file.  The \bold
  26. control \bold key with an up or down arrow will move to the beginning or
  27. end of a file.
  28.  
  29.      So far, so good.  However there is a lot more you can do with HT.
  30. There are several subtle features you can take advantage of that will make
  31. using HT even better.
  32.  
  33.      A quick hint first.  If you are stuck, and don't know what to do or
  34. where to go next, pressing the \bold Help \bold key may be of assistance.
  35. If the author of your document has defined help for this window
  36. (which he/she/it should have \link { SetUpCommands \HELP } using the
  37. \\help keyword) \endlink then that help file will be brought up.  If
  38. (unfortunately) there is no help, you'll be told and that will be that.
  39. Remember though, \it each \it window can have its own help file defined, so
  40. although one window may not have help, another may.
  41.  
  42.  
  43.  
  44. \center
  45. \under The "Electronic Notes" Feature \under
  46.  
  47.      With HT, it is possible to "take notes" on the document you are
  48. reading in much the same way you highlight sections of a book.    Doing it
  49. electronically however gives you a lot more options.  You can Print, Edit,
  50. and Save your notes all very easily.  This makes it easy to look up
  51. documentation, highlight the section you need, and print it.
  52.  
  53.      You do this by clicking the left mouse button and dragging the mouse
  54. to highlight the region of text you would like to "highlight".  When you
  55. have finished highlighting the section you want, let go of the left mouse
  56. button.  HT will flash the highlighted area to let you know those are your
  57. notes, and then everything will go back to normal - mostly.
  58.  
  59.      HT remembers which sections you have "highlighted", so that you can
  60. edit, save, or print the notes that you have taken.  If you decide that you
  61. don't want to take notes after you have started, simply hit the \ital space
  62. bar \ital or \ital ESC \ital key to tell HT to stop taking notes.
  63.  
  64.      Go ahead and try it now.  Point the mouse at the top of this page,
  65. then click the left mouse button and drag the mouse down.  See how HT
  66. inverts the area you cover?  When you let go of the mouse button, HT will
  67. flash the area to let you know everthing is o.k. and then you can continue.
  68.  
  69.      Of course you can take notes on many different sections of the file
  70. you are reading, exactly the same way you would highlight/underline parts
  71. of a book can now be done with HT.
  72.  
  73. \ital Good, now that I've taken these "notes" what can I do? \ital
  74.  
  75.      Once you have taken your notes, you can do one of three things with
  76. them.  You can save the notes as a smaller document for later retrieval,
  77. you can edit the notes directly, or you can print the notes (assuming you
  78. have a printer attatched to your computer).  Read on and see how this is
  79. all done.
  80.  
  81.  
  82.  
  83. \center
  84. \underline Printing the Document you are Viewing\underline
  85.  
  86.      \it HT \it also allows you to get a printout of parts or all of the
  87. file you are viewing.  This is especially useful if you need to save it for
  88. later or need to show someone else the information you are reading.
  89.  
  90.      Most likely you will be interested in getting a copy of the notes you
  91. have taken.  Rather simply, all you have to do is choose Print/Notes from
  92. the Special menu.  HT will boogie for a second or two, and then you should
  93. hear your printer start up, and voila, instant hardcopy (with a little bit
  94. of dramatization :-)
  95.  
  96.      If you only want to print the current page, you just have to choose
  97. Print Page from the Special menu, and then what you see on the screen will
  98. be printed out.  Note, that screen fonts aren't printed out, only the text,
  99. styles (if your printer does them), and formatting.
  100.  
  101.      Supposing you would like a hardcopy of the whole file you are reading,
  102. HT accomodates your greediness with a Print/All menu function from the
  103. Special menu.  This will simply dump the whole file out to your printer.
  104.  
  105.      HT will try to convert style changes to something your printer will
  106. handle so that what you get on paper will be reasonably like what you had
  107. on the screen.    Of course this all operates within the limitations of the
  108. printer you have attatched to your computer.
  109.  
  110.  
  111.  
  112.  
  113. \center
  114. \bold \underline Editing the File you are Viewing\underline \bold
  115.  
  116.      Instead of just being passive about what you are reading, \it HT \it
  117. also allows you to actively take part in it.  Suppose you are reading a
  118. Hypertext document on Medieval history for a history class, and you have
  119. taken notes on several parts of the file.  Now suppose you would like to
  120. use your notes as a quote in your report?  Retype the information in?  Bah
  121. humbug, all you have to do is choose Edit/Notes from the Special menu.
  122.  
  123.      This will launch an editor you have defined (\it c:ed by default\it )
  124. and will save the file directly into the editor (which will be setup to
  125. load it in).  Doing this you can actively work with a document and annotate
  126. it or include it in a report as a reference.
  127.  
  128.      If you would like only to edit the current page of the document, then
  129. choose Edit/Page from the Special menu.  If the document you are using is
  130. just so mind blowing that you want to use the whole thing, choose Edit/All.
  131.  
  132. \freeformat
  133. \center
  134. For this to work, you \bold must \bold have T: assigned somewhere.  T: is
  135. the Amiga "temporary" directory for programs to store transient files.
  136. Usually T: is assigned somewhere in your startup-sequence, so you should
  137. not have to worry about this.
  138.  
  139.  
  140. NOTE :    To accomplish this in a way that is acceptable to most editors
  141.     on the market, a small window will also be opened when the editor
  142.     is run.  This window is where any printed output from the editor
  143.     will go.  For the techies out there, this window is the standard
  144.     I/O channel for the editor.  It is normally unused, but some
  145.     programs, like CED Pro, die if STDIO doesn't exist (and will
  146.     actually crash the entire system if it isn't there!).
  147.  
  148. \format
  149. \center
  150. \underline Saving Parts of Your Current Document. \underline
  151.  
  152.      HT will also let you save your notes or current page as a smaller
  153. document.  What this means is that you can highlight sections of text and
  154. still retain link information and style changes.  This way you can keep
  155. small parts of a larger document for future reference and still be able to
  156. refer back to any original links.
  157.  
  158.      Whenever you have taken notes (just as you would from any of the
  159. above parts), you simply choose Project/Save/Notes from the menu bar (that
  160. means the Notes sub-item from the Save item in the Project menu).  HT will
  161. put up a file requestor asking you for a file name to save the notes in.
  162. HT will append ".notes" to whatever name you give the file.
  163.  
  164.      You can also Save the current page on the screen.    This works the same
  165. exact way as Saving Notes.
  166.  
  167. \center
  168. \bold Remember saving notes will overwrite the existing file!\bold
  169.  
  170.  
  171.  
  172. \center
  173. \underline Other stuff you can make HT do\underline
  174.  
  175.     Using the HTConfig program, you can configure where HT finds things and
  176. what it does.  HT relies on several external programs, so it must know
  177. where to find them.  If you have installed HT on the disk you are using,
  178. with the \bold HTInstall \bold program, then there should be no problems in
  179. finding anything.  If you need to however, you can use the HTConfig program
  180. and completely specify where each needed program exists.
  181.  
  182.     In addition, there are two other features of HT which you can modify
  183. using the HTConfig utility.  The full documentation on HTConfig is in
  184. the file \link { HTConfig.doc } HTConfig.doc.\endlink
  185.  
  186.  
  187. \underline Using a custom screen with HT\underline
  188.  
  189.     HT can open its own custom screen to do all work from.  If you would
  190. like this to happen, you can use the HTConfig program to turn the "Use
  191. custom screen" option on.  This particular option only takes affect each
  192. time you start HT for the first time.
  193.  
  194.     HT will then open a 640x200 custom screen on which all HT windows will
  195. appear.  This can be useful if you don't want to clutter your Workbench
  196. screen.
  197.  
  198.  
  199. \underline Checking before external programs are run: \underline
  200.  
  201.      If you tend to be paranoid that someone might do something devious in
  202. a document (such as \\run { delete dh0: ALL } Click here! \\endlink) you
  203. can set the option ASK FIRST.    If this option is turned on, HT will pop up
  204. a requestor that contains the command about to be executed.  If you
  205. confirm, HT will go ahead and execute the command.  Cancelling the
  206. requestor will simply return things to normal.    This should protect against
  207. most things that someone might do to you.
  208.  
  209.      You can set and unset this option while HT is running and the changes
  210. will take affect immediately.
  211.  
  212.  
  213.  
  214. \center
  215. \underline The End\underline
  216.  
  217.     What you have just read is all there is to know about using HT.  You
  218. should now feel comfortable going through and using HT effectively.  We
  219. covered how to take notes and then print, save, and edit them.    You also
  220. know a little bit about configuring HT.  If all this doesn't seem like
  221. much, play with HT more and you will see that you do have a useful tool.
  222. You'll see that HT is a powerful \ital information navigating tool \ital
  223. which is at your disposal.  With good use, HT can make using your computer
  224. even more enjoyable and easy.
  225.  
  226.  
  227.