home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1994 #1 / monster.zip / monster / UTILS1 / HYPGEN51.ZIP / READER.TXT < prev    next >
Text File  |  1994-01-01  |  20KB  |  363 lines

  1.            This is the instruction manual for HyperRead. It is
  2.         also a demonstration HyperRead file. You can flip through
  3.         this document one page at a time using the <PgUp> and
  4.         <PgDn> keys. You can move one line at a time by holding
  5.         down the Ctrl key as you press <PgUp> or <PgDn>. You also
  6.         can move through the document by pressing the up or down
  7.         cursor key. If the screen cursor gets to the top or bottom
  8.         of the screen and you continue pressing the cursor key, the
  9.         text will scroll. You can move to the top of the document
  10.         by pressing the <Home> key on your keyboard, or go to the
  11.         end of the document by pressing the <End> key.
  12.            You also can jump around in the document using the link
  13.         words or phrases. Link phrases look like this. To jump to a
  14.         section of text containing more information on a link
  15.         phrase, use the cursor keys to move the screen cursor to
  16.         the link phrase, then press the <J> key on the keyboard.
  17.         You may do this repeatedly, going from one link word to
  18.         another. You can backtrack along this path by pressing the
  19.         <B> key on the keyboard. There is more information on this
  20.         "jumping" later in this document.
  21.            You also can control HyperRead using a mouse if you
  22.         have one installed. This will be explained later (or you
  23.         can jump to this subject now by jumping from the word
  24.         "mouse" and then backtracking to this page when you are
  25.         done).
  26.            You can get a quick explanation of the commands by
  27.         calling for the HELP screen. Just press the <H> key at any
  28.         time.
  29.            You may now read the manual. Enjoy, and feel free to
  30.         experiment with the link phrases.
  31.  
  32.            Every few years, a new concept comes along that offers a
  33.         whole new use for personal computers. Typical examples have
  34.         been word processing, telecommunications and BBS's,
  35.         spreadsheets, and desktop publishing. The latest new idea
  36.         is hypertext.
  37.            What is hypertext? It is an indexing system that allows
  38.         people to use their computers to read computer text files
  39.         quickly and easily. It does this by allowing them to jump
  40.         from one part of the file to another, following whatever
  41.         train of thought they want.
  42.            In an ordinary printed document, the reader must read
  43.         the document linearly. That is, the person must read from
  44.         the beginning to the end, one page at a time. Sometimes the
  45.         person can jump around a little by using the index or the
  46.         table of contents, but this is very limited. The index can
  47.         only list a few key words, and the pages listed for those
  48.         words are usually simply where the word is defined or first
  49.         mentioned. The table of contents points only to broad areas
  50.         of the document where a general subject is discussed. In
  51.         any case, flipping through the pages is time-consuming and
  52.         tedious.
  53.            With hypertext, the author of a document can create
  54.         "tunnels" or links within a document that allow the reader
  55.         to jump from one area of the document to another. The
  56.         reader uses a computer to read the text on the screen. When
  57.         he or she finds an important word or phrase in the text
  58.         that needs clarifying, the computer can jump to the part of
  59.         the text that explains the term or gives more information.
  60.         For example, suppose you are reading a story about the
  61.         history of the electric light bulb. The story mentions that
  62.         it was invented by Thomas Edison. If you get curious about
  63.         Edison, you can jump directly from that part of the text to
  64.         the part that tells you more about Edison. That part of the
  65.         text might mention some of Edison's other inventions. If
  66.         you see one that looks interesting, you can jump directly
  67.         to the part of the text that describes this invention. This
  68.         can vastly increase the speed at which you can find
  69.         information.
  70.            HyperRead Generator and HyperRead are programs that
  71.         allow you to create and distribute hypertext documents.
  72.         HyperRead Generator allows you to convert an ordinary ASCII
  73.         text file into a hypertext document, which you may then use
  74.         or distribute. This program is shareware. It can be
  75.         downloaded from various Bulletin Board Systems or ordered
  76.         directly from Leithauser Research or a qualified
  77.         distributor. HyperRead is the program that allows you to
  78.         read the hypertext documents. This program is freeware, and
  79.         you may distribute it freely with any HyperRead files you
  80.         create. Both programs can be used with or without a mouse.
  81.  
  82.         Using HyperRead
  83.  
  84.            To read a HyperRead file, you need only run HyperRead and
  85.         load the desired HyperRead document. There are two ways you
  86.         can do this. You can simply type the program name (HR5) at the
  87.         DOS prompt. If there is more than one HyperRead document in the
  88.         current directory, the computer will display a list of HyperRead
  89.         files and ask which file to load (Otherwise it runs the one
  90.         file). Type the name of the file and press ENTER. Note:
  91.         All HyperRead documents actually consist of two files. There
  92.         is a text document file that can have any name and extension
  93.         and a control file that has the extension HRF. It is not
  94.         necessary to type this extension to load the file. For example,
  95.         to load the file READER.HRF, just enter the name READER.
  96.            Another way to run HyperRead and load a file is to type
  97.         the program name (HR5) followed by the name of the file to
  98.         load at the DOS prompt. For example, this file is called
  99.         READER.HRF. You can run the program and load this file at
  100.         the same time by typing HR5 READER at the DOS prompt (it is
  101.         not necessary to include the extension). This feature makes
  102.         it easy to create a batch file that automatically runs the
  103.         HyperRead program and loads a HyperRead file.
  104.            When the program has loaded the file, it will display
  105.         the first page of the file. At the bottom of the screen,
  106.         you will see a list of options. These options are PgUp,
  107.         Home, Help, Load, Quit, Jump, Backtrack, Search, Print,
  108.         End, and PgDn. For the PgUp, PgDn, Home, and End options,
  109.         press these keys on the keyboard. For the other options,
  110.         press the first letter of the option. These options are
  111.         explained below.
  112.  
  113.         PgDn
  114.  
  115.            Pressing the <PgDn> key moves the page of text on the
  116.         screen to the next page. That is, it scrolls down 23 lines.
  117.         If you hold down the <Ctrl> key while pressing the <PgDn>
  118.         key, however, the screen will scroll only one line.
  119.  
  120.         PgUp
  121.  
  122.            Pressing the <PgUp> key scrolls the text up 23 lines. If
  123.         you hold down the <Ctrl> key while pressing this key,
  124.         however, the text will scroll only one line.
  125.  
  126.         Home
  127.  
  128.            Pressing the <Home> key moves you directly to the first
  129.         page of the document. If you are in the middle of a long
  130.         document, this can be a faster way to get to the beginning
  131.         than repeatedly pressing <PgUp>.
  132.  
  133.         End
  134.  
  135.            Pressing the <End> key moves you to the last page of the
  136.         document. If you want to get to a page near the end, you
  137.         can press <End> and then <PgUp> a few times. This is
  138.         sometimes faster than pressing <PgDn> repeatedly.
  139.  
  140.         Cursor Keys
  141.  
  142.            You can move the screen cursor with the cursor keys and
  143.         also scroll through the document by moving beyond the top
  144.         or bottom of the screen.
  145.  
  146.         Help
  147.  
  148.            This option displays a Help screen. This screen gives a
  149.         short summary of the other options and how to use them.
  150.         After viewing this help screen, you can press the space bar
  151.         to return to the HyperRead document.
  152.  
  153.         Load
  154.  
  155.            This loads a document file into memory. The computer
  156.         will display a list of HyperRead documents in the current
  157.         directory. Type the name of the file and press ENTER. It is
  158.         not necessary to include the extension. This option allows
  159.         you to read several documents without returning to DOS to
  160.         reload HyperRead and load a new document.
  161.  
  162.         Quit
  163.  
  164.            This option ends the programs and returns you to DOS.
  165.  
  166.         Jump
  167.  
  168.            This is the function that allows you to move directly to
  169.         another area of the document that is pointed to by a link 
  170.         word or phrase. If you have a color screen, the default color
  171.         for link words is blue on a black background. If you have a
  172.         monochrome screen, default color for link words is black on
  173.         a white background. You can change these at program startup.
  174.            To select a link word, use the keyboard cursor keys to
  175.         move the flashing screen cursor until it is somewhere on
  176.         the link word. Then press the <J> key. The computer will
  177.         then display the page of text pointed to by the link word.
  178.         Once you have moved to this page, you can move normally
  179.         through the document using the <PgUp> and <PgDn> keys. You
  180.         also can jump to other areas of the document from there
  181.         using other link words. For example, suppose you jumped to
  182.         a page using the link word "Thomas Edison" and that page
  183.         contained the link word "light bulb." You could then jump
  184.         directly to the page pointed to by "light bulb."
  185.            If the link word is the name of a PCX picture file,
  186.         "jumping" to it displays that picture on the screen. For
  187.         example, moving the screen cursor to the word SATURN.PCX
  188.         and pressing the <J> key will display a sketch of Saturn.
  189.         Pressing any keyboard key (except control keys like Shift,
  190.         Ctrl, or Alt) or either mouse button will return you to the
  191.         document text.
  192.            If the link word is an executable file name with an EXE,
  193.         COM, or BAT extension, "jumping" to it will cause
  194.         HyperRead to run that program (if it exists in the
  195.         current directory). For example, jumping from the word
  196.         NOTHING.COM will run the NOTHING.COM program. When the
  197.         program or batch file finishes running, HyperRead will
  198.         come back and display the page it was on before you ran the
  199.         program.
  200.  
  201.         Backtrack
  202.  
  203.            This function allows you to reverse the effects of the
  204.         Jump function. When you press the <B> key, the computer
  205.         will take you back to the page containing the most recently
  206.         used link word. For example, if you jumped to a destination
  207.         page using the link word "Thomas Edison," pressing the <B>
  208.         key would take you back to the page containing "Thomas
  209.         Edison."
  210.            You can use the backtrack function repeatedly. For
  211.         example, suppose you jumped to a page pointed to by "Thomas
  212.         Edison" and that page contained the link word "light bulb."
  213.         You then used the "light bulb" link word to jump to another
  214.         page. Pressing the <B> key twice would jump back to the
  215.         page containing "light bulb" and then to the page
  216.         containing "Thomas Edison." You can repeat this process
  217.         until you reach the page containing the first link word you
  218.         used.
  219.  
  220.         Search
  221.  
  222.            This option allows you to search the document for a
  223.         specific text string, such as a name. It is handy if you
  224.         want to find information on a subject, and there is no link
  225.         word on the screen that would take you to that subject.
  226.            When you pick this option, the computer will ask you for
  227.         the string of text to search for. Type the string and press
  228.         ENTER. If you have already used this option, the default
  229.         will be the last string you searched for. This allows you
  230.         to easily continue the search if you want more information
  231.         on the string.
  232.            The computer will always begin the search at the line
  233.         the screen cursor is on in the document. It does not find
  234.         any appearances of the string that occur before this in the
  235.         document.
  236.            The search is case-insensitive. That is, it disregards
  237.         capitalization. If you asked the computer to search for
  238.         "home," it would find "home," "Home," and "HOME."
  239.            The program searches each line of text for the search
  240.         string. It will not find the string if it is broken by the
  241.         end of a line. For example, if the string were "George
  242.         Washington," the program would not find it if the text
  243.         contained the word George on one line and Washington on the
  244.         next. For this reason, it is best if you limit your search
  245.         string to one word if possible.
  246.            When the program finds the search string, it displays
  247.         the page of text containing the string. The line containing
  248.         the string will be at the top of the screen. If the
  249.         document does not contain the string after the current
  250.         screen cursor position, the program will display a message
  251.         saying "String not found. Press space bar to continue."
  252.         When you press the space bar, the text will be at the same
  253.         point where you started the search.
  254.  
  255.         Print
  256.  
  257.            The Print function will send a copy of the document to
  258.         the printer. If the document contains page feed characters,
  259.         HyperRead will use those to format the document.
  260.         Otherwise, HyperRead will create its own formatting. It
  261.         will print out the document with margins at the top and
  262.         bottom of the page and a page number at the bottom of each
  263.         page.
  264.            To use this feature, set the printer at the top of a
  265.         page of formfeed paper, turn it on, and press the <P> key
  266.         on the keyboard. This is intended primarily for people who
  267.         are distributing HyperRead instructions for their Shareware
  268.         or public domain programs. This makes it unnecessary to
  269.         include a separate ASCII file of the instructions to print.
  270.  
  271.         Mouse Support
  272.  
  273.            If you have a mouse driver installed, HyperRead will
  274.         support the mouse. If you have a mouse driver installed,
  275.         you will have two cursors on the screen. One is controlled
  276.         by the mouse and one is controlled by the keyboard cursor
  277.         keys. The mouse cursor is somewhat darker in color. You
  278.         might need to move the mouse around a bit to help you find
  279.         the mouse cursor.
  280.            You can use the mouse to operate the HyperRead
  281.         navigation functions. Moving the mouse cursor to the word
  282.         PgUp at the bottom of the screen and pressing the left
  283.         mouse button (known as "clicking on it") has the same
  284.         effect as pressing the <PgUp> key. Clicking on PgUp with
  285.         the left mouse button has the same effect as <Ctrl-PgUp>.
  286.         Clicking on PgDn at the bottom of the screen with the left
  287.         mouse button has the same effect as pressing <PgDn>.
  288.         Clicking on it with the right mouse button has the same
  289.         effect as <Ctrl-PgDn>. Clicking on Home or End at the
  290.         bottom of the screen with either mouse button has the same
  291.         effect as pressing the <Home> or <End> buttons.
  292.            Clicking on a link word with the left mouse button
  293.         causes HyperRead to jump to the information referenced by
  294.         that link word, just as pressing the <J> key does. Pressing
  295.         the right mouse button causes HyperRead to backtrack
  296.         through the links just like pressing the <B> key does,
  297.         regardless of where the mouse cursor is located.
  298.            Other functions, such as Load, Quit, and Search, cannot
  299.         be controlled using the mouse. In some cases, this is to
  300.         prevent you from accidentally activating the function (like
  301.         Quit) with the mouse. In other cases it is because the
  302.         function requires keyboard input anyway, such as the word
  303.         to search for.
  304.  
  305.         Uses for HyperRead
  306.  
  307.            You can use this program to create any type of
  308.         easy-to-read document you like. For example, you can create
  309.         a HyperRead instruction manual. The users can quickly zero
  310.         in on any problems they have by using link words to go to
  311.         more and more specific descriptions of the problem. This
  312.         document is an example of such a file. Instruction manuals
  313.         for shareware programs are a particularly good use for
  314.         HyperRead.
  315.            HyperRead reference "books" can also be easy to use.
  316.         Consider a HyperRead cookbook. The first few pages of the
  317.         HyperRead file could be a list of recipes. The name of each
  318.         recipe could be a link word or phrase. The user could jump
  319.         directly to the recipe by pointing to it with the cursor
  320.         and pressing the <J> key. Within the recipes, some of the
  321.         more unusual ingredients could be link words. These links
  322.         could take the reader to a section at the end of the "book"
  323.         that gives information on the ingredients.
  324.            In a similar fashion, you could make each item in a
  325.         table of contents of any file a link phrase. The reader can
  326.         then jump directly to that page using the link phrase.
  327.            A more entertaining use of the HyperRead function is
  328.         interactive fiction. This is an increasingly popular form
  329.         of literature. In such a book, the reader does not read the
  330.         book from start to finish. Instead, the book offers the
  331.         reader choices on what to read. A typical story might say
  332.         something like, "If you want to explore the cave, turn to
  333.         page 38. If you want to continue on the path, go to the
  334.         next page." With HyperRead, you could have the reader
  335.         select which action to take by selecting the proper link
  336.         phrase. The program would then take the reader to the
  337.         proper page. This is similar to text adventure games.
  338.  
  339.         Creating your own HyperRead documents
  340.  
  341.            To create your own HyperRead documents, you need the
  342.         HyperRead Generator. This is a shareware program that you
  343.         can download from many Bulletin Board Systems. If you
  344.         cannot find it anywhere else, you can order the shareware
  345.         program by sending $5.00 for shipping and handling to:
  346.  
  347.                          Leithauser Research
  348.                          4649 Van Kleeck Drive
  349.                          New Smyrna Beach, FL 32169
  350.  
  351.         However, before you distribute any documents created by
  352.         HyperRead Generator, you are required to register it by
  353.         sending $25.00 to Leithauser Research. You can save the
  354.         $5.00 shipping and handling fee for the shareware program
  355.         by sending the $25.00 to Leithauser research in the first
  356.         place, thereby registering the program at the same time you
  357.         order it.
  358.            The $25.00 is a one-time fee. Once you have registered
  359.         HyperRead Generator, you may use it on one computer to
  360.         create as many HyperRead documents as you like without
  361.         paying any additional fees.
  362.  
  363.