home *** CD-ROM | disk | FTP | other *** search
/ Shareware Overload / ShartewareOverload.cdr / wp / blmagic.zip / MAGREAD.ZIP / MAGREAD.DOC < prev    next >
Text File  |  1988-10-27  |  8KB  |  180 lines
  1. Greetings,
  2.  
  3. The arc'ed group of files that you have here compromises the Reader
  4. Utilities for Black Magic and some demo files (.MAG Extension). The actual
  5. files in this are listed below:
  6.  
  7.   All the Files on this disk are in the Public Domain, and you are
  8.   free to distribute them, provided no charge is made for distribution.
  9.  
  10.      MAGREAD .EXE           A utility to read Black Magic hypertext files.
  11.                               Operates on systems with EGA, CGA, or HGA
  12.                               graphics support.
  13.      MAGREAD .OVR           Overlay File for low memory overhead
  14.  
  15.      HOWTO   .MAG           An example Hypertext file for general reading
  16.  
  17. For additional demo files the MAGDEMO.ARC file contains the following files.
  18. If you received this on a disk it is likely that you already have MAGDEMO.ARC
  19. and these files have been placed on your hard disk.
  20.  
  21.      TIME    .MAG           A hypertext timeline for the history of the
  22.                               world.
  23.      TIME-1  .MGR           Graphics files for TIME.MAG.
  24.      TIME-2  .MGR            .
  25.      AMER-1  .MGR            .
  26.      AMER-2  .MGR            .
  27.      AMER-3  .MGR            .
  28.      ROME-1  .MGR            .
  29.  
  30.      USA     .MAG           A Graphic Based Almanac of the United States
  31.      USA     .MGR            Graphic of USA
  32.      NEVADA  .MGR            State of Nevada
  33.      NE      .MGR            New England States
  34.      CONN    .MGR            State of Connecticut
  35.      ADVER   .MGR            Advertisment for Black Magic
  36.  
  37.      CHEM    .MAG           Elements of the Periodic Table organized with
  38.                               hypertext.
  39.      TABLE6  .MGR            Graphic of Periodic Table
  40.  
  41.  
  42.                      Hypertext - A Brief Introduction
  43.  
  44. Hypertext is based on the concept of "Expanding Information".  With
  45. hypertext, blocks of information (text or graphics) can be linked to other
  46. blocks of information.  Once two blocks of information have been linked
  47. together, they provide an instant "gateway" to the other.   This is the
  48. expanding information nature of hypertext.  A single block of information
  49. can lead to another and so on.  Information can literally expand at the
  50. user's request.
  51.  
  52.      Black Magic
  53.  
  54. Black Magic is a product to create Hypertext documents similar to the above
  55. description.  With Black Magic documents, information can be linked in
  56. three different ways; with Note Links, Reference Links, and Replacement
  57. Links.
  58.  
  59.      Links
  60.  
  61. A Note Link calls up a small window on screen that contains a
  62. "note" to the user.  A Reference link is used to transport the reader to
  63. Another place in the document.  Replacement Links are used to swap one
  64. block of information for another.   Graphic Links are used to make a
  65. graphic image a Link Originator.
  66.  
  67. Although Graphics can be any of the three types of Link, only one symbol
  68. below is used to indicate this, a light blue circle with an X through the
  69. center.
  70.  
  71. All Links are indicated through the use of colored symbols embedded in the
  72. text.  The symbols surround the Link Originator (See Below).  Hypertext
  73. Links are indicated through the following symbols:             
  74.  
  75.           Note Link                Yellow Diamonds
  76.           Reference Link           Green Triangle              
  77.           Replacement Link         Pink Square                 
  78.           Graphic Link             Blue Circle with a "X" in the Center     
  79.                               
  80.      Terminology               
  81.                                
  82. Link Originator - The starting point to the link.  It is surrounded by the
  83.                symbols to indicate that it is a hypertext link.             
  84. Link End - The other side to a Link originator, where reader is taken       
  85.                after a link is traversed.
  86. Traverse - The act of traveling from a Link originator to its associated
  87.                Link End.            
  88.                                
  89.      Reading A Document        
  90.                                
  91. A Black Magic document is read through the use of the reader program.
  92.  
  93. To Start the Reader, type
  94.  
  95.     MAGREAD filename
  96.  
  97. at the DOS Prompt, or Load a file after entering the Reader with
  98.  
  99.     <F10> F L
  100.     or
  101.     <Shift><F9>
  102.  
  103. Once the document is in the Reader program, it is read using the following
  104. keys:
  105.  
  106.      Traverse Link            <F1>/Left Mouse Button pressed between the
  107.                                   symbols
  108.      Return from Link          <Esc>/Right Mouse Button  pressed anywhere
  109.                                   in the Link
  110.      Movement                  <ArrowKeys>, <PgUp> & <PgDn>/Mouse
  111.  
  112. When you are reading a document, and you come across a hypertext Link in
  113. the text, move the cursor between the symbols and press <F1>.  This will
  114. activate the Link, traversing you to the Link End.  To return from the
  115. Link End press <Esc>.  This will bring you one link back from your current
  116. position.
  117.  
  118. When you come across a hypertext link in a Graphic, move the cursor over
  119. the Graphic Link (Circle with an "X") and press <F1> to traverse the Link.
  120.  
  121. And that's about all you need to know to read a hypertext document.
  122.  
  123.      Advanced Features
  124.  
  125. Among the advanced features that compromise the Black MAgic Reader utilities
  126. are mapping of documents, ASCII cut of text, collapsing of documents, and
  127. bookmarks.  The below keys indicate what controls what.
  128.  
  129.      Map Document             <Ctrl> F2
  130.      Collapse Document        <Alt> <F1>
  131.      ASCII Cut                <Shift> <Arrowkey> + <F9>
  132.      Bookmarks                Query upon exit - <Alt> <F10>
  133.      Hide Markers             <Alt> H
  134.      Jump to Link             <Ctrl> <LeftArrow> or <RightArrow>
  135.  
  136.      Mapping
  137.  
  138. The mapping command is used to generate a "map" of the document.  This
  139. depicts a document as a collection of linked nodes.  Once the map is
  140. displayed, it can be used to travel to any point in the document by using
  141. the arrow keys to move the location, and pressing <Enter> to go to that
  142. spot.
  143.  
  144.      Collapse
  145.  
  146. The collapse command is used to "Fold" a document back into its original
  147. state.  This puts the user back at the beginning of the document. To use it,
  148. simply press <Alt> <F1>.  This will commence the folding operation.
  149.  
  150.      ASCII Cut
  151.  
  152. The ASCII cut capabilities in Black Magic are used give the reader of
  153. hypertext documents the ability to export ASCII text from documents.  To
  154. export ASCII text, it must be first marked as a block.  This is done using
  155. <Shift> <ArrowKey> to highlight the desired text.  Then the save key, <F9>,
  156. is pressed.  This will prompt the user for a filename for the block, and
  157. then write the marked block to disk as an ASCII text file.
  158.  
  159.      Bookmarks
  160.  
  161. Bookmarks are a way to enter a hypertext file at exactly the same point that
  162. you left it.  To place a bookmark in a file, it is necessary to press the
  163. Exit key, <Alt> <F10>.  This will prompt the user as to whether or not a
  164. bookmark is desired.  By answering "Y" or "N" to this question, a bookmark
  165. will either be placed or not be placed onto disk, and then Black Magic
  166. exited.  If a bookmark is specified ("Y") then when the file is next read,
  167. the user will be automatically taken to that location.
  168.  
  169.      Hide Markers
  170.  
  171. The Link Markers that appear on screen may be distracting to some people.
  172. Link Markers can be hidden off the configuration screen or directly by
  173. pressing <Alt> H.
  174.  
  175.      Jump To Link
  176.  
  177. In MAGREAD the normal Jump to next Word has been replaced with a Jump to the
  178. next link.  It will take the cursor to beginning of the next link.  To jump
  179. forward press <Ctrl> <RightArrow>.  To jump backward press <Ctrl> <LeftArrow>.
  180.