home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 12 / CD_ASCQ_12_0294.iso / maj / 2321 / generate.txt < prev    next >
Text File  |  1994-01-01  |  40KB  |  707 lines

  1.            This is the instruction manual for HyperRead and
  2.         HyperRead Generator. It is also a demonstration HyperRead
  3.         file. You can flip through this document one page at a time
  4.         using the <PgUp> and <PgDn> keys. You can move one line at
  5.         a time by holding down the Ctrl key as you press <PgUp> or
  6.         <PgDn>. You can also move through the document by pressing
  7.         the up or down cursor key. If the screen cursor gets to the
  8.         top or bottom of the screen and you continue pressing the
  9.         cursor key, the text will scroll. You can move to the top
  10.         of the document by pressing the <Home> key on your
  11.         keyboard, or go to the end of the document by pressing the
  12.         <End> key.
  13.            You also can jump around in the document using the link
  14.         words or phrases. Link phrases look like this. To jump to a
  15.         section of text containing more information on a link
  16.         phrase, use the cursor keys to move the screen cursor to
  17.         the link phrase, then press the <J> key on the keyboard.
  18.         You may do this repeatedly, going from one link word to
  19.         another. You can backtrack along this path by pressing the
  20.         <B> key on the keyboard. There is more information on this
  21.         "jumping" later in this document.
  22.            You can also control HyperRead Generator using a mouse
  23.         if you have one installed. This will be explained later (or
  24.         you can jump to this subject now by jumping from the word
  25.         "mouse" and then backtracking to this page when you are
  26.         done).
  27.            You may now read the manual. Enjoy, and feel free to
  28.         experiment with the link phrases.
  29.  
  30.            Every few years, a new concept comes along that offers a
  31.         whole new use for personal computers. Typical examples have
  32.         been word processing, telecommunications and BBS's,
  33.         spreadsheets, and desktop publishing. The latest new idea
  34.         is hypertext.
  35.            What is hypertext? It is an indexing system that allows
  36.         people to use their computers to read computer text files
  37.         quickly and easily. It does this by allowing them to jump
  38.         from one part of the file to another, following whatever
  39.         train of thought they want.
  40.            In an ordinary printed document, the reader must read
  41.         the document linearly. That is, the person must read from
  42.         the beginning to the end, one page at a time. Sometimes the
  43.         person can jump around a little by using the index or the
  44.         table of contents, but this is very limited. The index can
  45.         only list a few key words, and the pages listed for those
  46.         words are usually simply where the word is defined or first
  47.         mentioned. The table of contents points only to broad areas
  48.         of the document where a general subject is discussed. In
  49.         any case, flipping through the pages is time-consuming and
  50.         tedious.
  51.            With hypertext, the author of a document can create
  52.         "tunnels" or links within a document that allow the reader
  53.         to jump from one area of the document to another. The
  54.         reader uses a computer to read the text on the screen. When
  55.         he or she finds an important word or phrase in the text
  56.         that needs clarifying, the computer can jump to the part of
  57.         the text that explains the term or gives more information.
  58.         For example, suppose you are reading a story about the
  59.         history of the electric light bulb. The story mentions that
  60.         it was invented by Thomas Edison. If you get curious about
  61.         Edison, you can jump directly from that part of the text to
  62.         the part that tells you more about Edison. That part of the
  63.         text might mention some of Edison's other inventions. If
  64.         you see one that looks interesting, you can jump directly
  65.         to the part of the text that describes this invention. This
  66.         can vastly increase the speed at which you can find
  67.         information.
  68.            HyperRead Generator and HyperRead are programs that
  69.         allow you to create and distribute hypertext documents.
  70.         HyperRead Generator allows you to convert an ordinary ASCII
  71.         text file into a hypertext document, which you may then use
  72.         or distribute. This program is shareware. It can be
  73.         downloaded from various Bulletin Board Systems or ordered
  74.         directly from Leithauser Research or a qualified
  75.         distributor. HyperRead is the program that allows you to
  76.         read the hypertext documents. This program is freeware, and
  77.         you may distribute it freely with any HyperRead files you
  78.         create. Both programs can be used with or without a mouse.
  79.            Before explaining how to use HyperRead Generator, an
  80.         explanation of how to operate HyperRead will be helpful.
  81.         This is partly because the person who reads the document
  82.         will be using HyperRead, so a thorough understanding of
  83.         HyperRead is important to anyone who plans to use
  84.         HyperRead Generator to create HyperRead files. It is also
  85.         helpful to understand HyperRead because HyperRead
  86.         Generator operates almost identically to HyperRead,
  87.         except that it has some extra functions and is missing a
  88.         few minor ones from HyperRead.
  89.  
  90.         Using HyperRead
  91.  
  92.            To read a HyperRead file, you need only run HyperRead
  93.         and load the desired HyperRead document. There are two ways
  94.         you can do this. You can simply type the program name (HR5)
  95.         at the DOS prompt. If there are more than one HyperRead
  96.         files in the current default directory, the computer will
  97.         then display a list of HyperRead files and ask you which
  98.         file to load (Otherwise it simply loads the one file). Type
  99.         the name of the file and press the ENTER key. Note: All
  100.         HyperRead documents actually consist of two files. There is
  101.         a text document file that can have any name and extension.
  102.         There is also a control file that has the extension HRF. It
  103.         is not necessary to type this extension to load the file.
  104.         For example, to load the file GENERATE.HRF, just enter the
  105.         name GENERATE.
  106.            Another way to run HyperRead and load a file is to type
  107.         the program name (HR5) followed by the name of the file to
  108.         load at the DOS prompt. For example, this file is called
  109.         GENERATE.HRF. You can run the program and load this file at
  110.         the same time by typing HR5 GENERATE at the DOS prompt (it
  111.         is not necessary to include the extension). This feature
  112.         makes it easy to create a batch file that automatically
  113.         runs the HyperRead program and loads a HyperRead file.
  114.            When the program has loaded the file, it will display
  115.         the first page of the file. At the bottom of the screen,
  116.         you will see a list of options. These options are PgUp,
  117.         Home, Help, Load, Quit, Jump, Backtrack, Search, Print,
  118.         End, and PgDn. For the PgUp, PgDn, Home, and End options,
  119.         press these keys on the keyboard. For the other options,
  120.         press the first letter of the option. These options are
  121.         explained below.
  122.  
  123.         PgDn
  124.  
  125.            Pressing the <PgDn> key moves the page of text on the
  126.         screen to the next page. That is, it scrolls down 23 lines.
  127.         If you hold down the <Ctrl> key while pressing the <PgDn>
  128.         key, however, the screen will scroll only one line.
  129.  
  130.         PgUp
  131.  
  132.            Pressing the <PgUp> key scrolls the text up 23 lines. If
  133.         you hold down the <Ctrl> key while pressing this key,
  134.         however, the text will scroll only one line.
  135.  
  136.         Home
  137.  
  138.            Pressing the <Home> key moves you directly to the first
  139.         page of the document. If you are in the middle of a long
  140.         document, this can be a faster way to get to the beginning
  141.         than repeatedly pressing <PgUp>.
  142.  
  143.         End
  144.  
  145.            Pressing the <End> key moves you to the last page of the
  146.         document. If you want to get to a page near the end, you
  147.         can press <End> and then <PgUp> a few times. This is
  148.         sometimes faster than pressing <PgDn> repeatedly.
  149.  
  150.         Cursor Keys
  151.  
  152.            You can move the screen cursor with the cursor keys and
  153.         also scroll through the document by moving beyond the top
  154.         or bottom of the screen.
  155.  
  156.         Help
  157.  
  158.            This option displays a Help screen. This screen gives a
  159.         short summary of the other options and how to use them.
  160.         After viewing this help screen, you can press the space bar
  161.         to return to the HyperRead document.
  162.  
  163.         Load
  164.  
  165.            This loads a document file into memory. The computer
  166.         will display a list of HyperRead documents in the current
  167.         directory. Type the name of the file and press ENTER. It is
  168.         not necessary to include the extension. This option allows
  169.         you to read several documents without returning to DOS to
  170.         reload HyperRead and load a new document.
  171.  
  172.         Quit
  173.  
  174.            This option ends the programs and returns you to DOS.
  175.  
  176.         Jump
  177.  
  178.            This is the function that allows you to move directly to
  179.         another area of the document that is pointed to by a link
  180.         word or phrase. If you have a color screen, the default color
  181.         for link words is blue on a black background. If you have a
  182.         monochrome screen, default color for link words is black on
  183.         a white background. You can change these at program startup.
  184.            To select a link word, use the keyboard cursor keys to
  185.         move the flashing screen cursor until it is somewhere on
  186.         the link word. Then press the <J> key. The computer will
  187.         then display the page of text pointed to by the link word.
  188.         Once you have moved to this page, you can move normally
  189.         through the document using the <PgUp> and <PgDn> keys. You
  190.         also can jump to other areas of the document from there
  191.         using other link words. For example, suppose you jumped to
  192.         a page using the link word "Thomas Edison" and that page
  193.         contained the link word "light bulb." You could then jump
  194.         directly to the page pointed to by "light bulb."
  195.            If the link word is the name of a PCX picture file,
  196.         "jumping" to it displays that picture on the screen. For
  197.         example, moving the screen cursor to the word SATURN.PCX
  198.         and pressing the <J> key will display a sketch of Saturn.
  199.         Pressing any keyboard key (except control keys like Shift,
  200.         Ctrl, or Alt) or either mouse button will return you to the
  201.         document text.
  202.            If the link word is an executable file name with an EXE,
  203.         COM, or BAT extension, "jumping" to it will cause
  204.         HyperRead to run that program (assuming that it exists in
  205.         the current directory). For example, jumping from the word
  206.         NOTHING.COM will run the NOTHING.COM program. When the
  207.         program or batch file finishes running, HyperRead will
  208.         come back and display the page it was on before you ran the
  209.         program.
  210.  
  211.         Backtrack
  212.  
  213.            This function allows you to reverse the effects of the
  214.         Jump function. When you press the <B> key, the computer
  215.         will take you back to the page containing the most recently
  216.         used link word. For example, if you jumped to a destination
  217.         page using the link word "Thomas Edison," pressing the <B>
  218.         key would take you back to the page containing "Thomas
  219.         Edison."
  220.            You can use the backtrack function repeatedly. For
  221.         example, suppose you jumped to a page pointed to by "Thomas
  222.         Edison" and that page contained the link word "light bulb."
  223.         You then used the "light bulb" link word to jump to another
  224.         page. Pressing the <B> key twice would jump back to the
  225.         page containing "light bulb" and then to the page
  226.         containing "Thomas Edison." You can repeat this process
  227.         until you reach the page containing the first link word you
  228.         used.
  229.  
  230.         Search
  231.  
  232.            This option allows you to search the document for a
  233.         specific text string, such as a name. It is handy if you
  234.         want to find information on a subject, and there is no link
  235.         word on the screen that would take you to that subject.
  236.            When you pick this option, the computer will ask you for
  237.         the string of text to search for. Type the string and press
  238.         ENTER. If you have already used this option, the default
  239.         will be the last string you searched for. This allows you
  240.         to easily continue the search if you want more information
  241.         on the string.
  242.            The computer will always begin the search at the line
  243.         the screen cursor is on in the document. It does not find
  244.         any appearances of the string that occur before this in the
  245.         document.
  246.            The search is case-insensitive. That is, it disregards
  247.         capitalization. If you asked the computer to search for
  248.         "home," it would find "home," "Home," and "HOME."
  249.            The program searches each line of text for the search
  250.         string. It will not find the string if it is broken by the
  251.         end of a line. For example, if the string were "George
  252.         Washington," the program would not find it if the text
  253.         contained the word George on one line and Washington on the
  254.         next. For this reason, it is best if you limit your search
  255.         string to one word if possible.
  256.            When the program finds the search string, it displays
  257.         the page of text containing the string. The line containing
  258.         the string will be at the top of the screen. If the
  259.         document does not contain the string after the current
  260.         screen cursor position, the program will display a message
  261.         saying "String not found. Press space bar to continue."
  262.         When you press the space bar, the text will be at the same
  263.         point where you started the search.
  264.  
  265.         Print
  266.  
  267.            The Print function will send a copy of the document to
  268.         the printer. If the document contains page feed characters,
  269.         HyperRead will use those to format the document.
  270.         Otherwise, HyperRead will create its own formatting. It
  271.         will print out the document with margins at the top and
  272.         bottom of the page and a page number at the bottom of each
  273.         page.
  274.            To use this feature, set the printer at the top of a
  275.         page of formfeed paper, turn it on, and press the <P> key
  276.         on the keyboard. This is intended primarily for people who
  277.         are distributing HyperRead instructions for their Shareware
  278.         or public domain programs. This makes it unnecessary to
  279.         include a separate ASCII file of the instructions to print.
  280.  
  281.         Mouse Support
  282.  
  283.            If you have a mouse driver installed, HyperRead will
  284.         support the mouse. If you have a mouse driver installed,
  285.         you will have two cursors on the screen. One is controlled
  286.         by the mouse and one is controlled by the keyboard cursor
  287.         keys. The mouse cursor is somewhat darker in color. You
  288.         might need to move the mouse around a bit to help you find
  289.         the mouse cursor.
  290.            You can use the mouse to operate the HyperRead
  291.         navigation functions. Moving the mouse cursor to the word
  292.         PgUp at the bottom of the screen and pressing the left
  293.         mouse button (known as "clicking on it") has the same
  294.         effect as pressing the <PgUp> key. Clicking on PgUp with
  295.         the left mouse button has the same effect as <Ctrl-PgUp>.
  296.         Clicking on PgDn at the bottom of the screen with the left
  297.         mouse button has the same effect as pressing <PgDn>.
  298.         Clicking on it with the right mouse button has the same
  299.         effect as <Ctrl-PgDn>. Clicking on Home or End at the
  300.         bottom of the screen with either mouse button has the same
  301.         effect as pressing the <Home> or <End> buttons.
  302.            Clicking on a link word with the left mouse button
  303.         causes HyperRead to jump to the information referenced by
  304.         that link word, just as pressing the <J> key does. Pressing
  305.         the right mouse button causes HyperRead to backtrack
  306.         through the links just like pressing the <B> key does,
  307.         regardless of where the mouse cursor is located.
  308.            Other functions, such as Load, Quit, and Search, cannot
  309.         be controlled using the mouse. In some cases this is to
  310.         prevent you from accidentally activating the function (like
  311.         Quit) with the mouse. In other cases it is because the
  312.         function requires keyboard input anyway, such as the word
  313.         to search for.
  314.  
  315.         Using HyperRead Generator
  316.  
  317.            HyperRead Generator creates the HyperRead control file
  318.         that allows HyperRead to read a HyperRead file. First,
  319.         you must create the document you want to convert to
  320.         hypertext on your own word processor or text editor. Almost
  321.         any word processor will do, provided it can create and save
  322.         a file with the following characteristics:
  323.  
  324.         1) The file must be saved in plain ASCII.
  325.         2) There must be a carriage return at the end of each line
  326.         3) Each line of the file must be less than 80 characters
  327.         long.
  328.         4) The document may contain page feed characters (ASCII
  329.         character 12) to force page feeds. However, it must not
  330.         contain tab characters (ASCII character 9). Convert any
  331.         such characters in your document to a series of spaces.
  332.         5) The lines of the document may not contain any embedded
  333.         line feeds other than those that accompany carriage returns.
  334.         6) The document may not contain any nonprinting characters,
  335.         such as bells or Esc characters. It may contain printable
  336.         ASCII characters, such as graphic characters (ASCII 129 and
  337.         above).
  338.         What all this really amounts to is that the document must
  339.         be pure ASCII. If your document does not satisfy these
  340.         requirements, HyperRead Generator will offer to convert it
  341.         to an acceptable format for you.
  342.            When you run HyperRead Generator (HRG5.EXE) or select the
  343.         Load option, HyperRead Generator will give you three choices:
  344.         You can load a new text file, load an existing HyperRead 
  345.         document, or load an encoded text file. 
  346.            A new file would be an ASCII document that you have not 
  347.         yet created a HyperRead control file for. If you press 1, 
  348.         HyperRead Generator will display a directory of all documents 
  349.         in the correct directory and ask you which one to load. Type 
  350.         the full name and press ENTER. HyperRead Generator will then 
  351.         load the file.
  352.            If the file does not satisfy the requirements for a
  353.         HyperRead text file (for example, it contains lines that are
  354.         too long or has control characters), HyperRead Generator will
  355.         inform you of this and ask if you want it to convert the 
  356.         file. If you press Y, HyperRead Generator will save your 
  357.         original file with a BAK extension and convert the file. It
  358.         will then load the converted file. During the conversion,
  359.         HyperRead Generator will allow you set the left and right 
  360.         margins (expressed as a number of spaces for the document and 
  361.         choose how many spaces to replace a tab character with. The 
  362.         default is no margins and 3 spaces for tab characters.
  363.            The second type of file you can load into HyperRead 
  364.         Generator is an existing HyperRead file. This means a document
  365.         which you have already worked on and have a HyperRead control
  366.         file (the file with an HRF extension). If you press 3 when the 
  367.         program asks you what type of file to load, HyperRead 
  368.         Generator will display a list of HyperRead control files. Type 
  369.         the name of the file you want to load and press ENTER. You can 
  370.         then add new links to the old document.
  371.            The third type of file you can load into HyperRead 
  372.         Generator is an encoded text file. This is a file that 
  373.         HyperRead Generator will create at the same time as it creates 
  374.         the control file if you press Y when it asks if you want to
  375.         create an encoded text file. This is special file designed to 
  376.         allow you to edit the text of your document after you have 
  377.         created hypertext links in your text file. This will be 
  378.         explained later in this manual.
  379.            Once you have loaded a file, HyperRead Generator
  380.         operates very much like the HyperRead program. You load
  381.         and view files the same way as with HyperRead. HyperRead
  382.         Generator simply has several additional options that allow
  383.         you to create the link words and save the new document to
  384.         disk. The Print and Help HyperRead options are omitted
  385.         from HyperRead Generator. You do not need these options
  386.         with HyperRead Generator, anyway. You do no need the Help
  387.         option, since you can print out the manual using
  388.         HyperRead. You also can use your copy of HyperRead to
  389.         print the file, if you want to see how it looks printed out
  390.         by HyperRead.
  391.            The additional options for HyperRead Generator are Mark,
  392.         Unmark, and Disk. These options are explained below.
  393.  
  394.         Mark
  395.  
  396.            This is the option to create the HyperRead links that
  397.         allow the reader to jump from one part of the document to
  398.         another. You can create up to 1000 links in each document.
  399.         If you try to create more, the computer will just beep at
  400.         you.
  401.            To create a link, move the document with the <PgUp> and
  402.         <PgDn> keys so the word or phrase you want to turn into a
  403.         link phrase is on the screen. Then use the cursor keys to
  404.         move the screen cursor to the beginning of the word or
  405.         phrase. Press the <M> key. Use the right cursor key to move
  406.         the cursor to the end of the desired link word or phrase.
  407.         You will notice that the word becomes blue (or reverse
  408.         video with a monochrome display) as you move the cursor.
  409.         You can use the left cursor key to backtrack if you go too
  410.         far.
  411.            When you have marked the entire link word or phrase,
  412.         press the ENTER key. That ends the marking. Now move the
  413.         document to the part of the document that you want the link
  414.         word to point to (called the destination page). You can use
  415.         all the normal movement techniques, such as PgUp, PgDn,
  416.         Home, and End, to move within the document. You can even
  417.         use the Search or Jump options.
  418.            When you have found the beginning of the destination
  419.         page, move the screen cursor (with the cursor keys) to the
  420.         desired first line of the destination page. That is, the
  421.         line that you want to be at the top of the screen when the
  422.         user selects the link word. With the cursor on that line,
  423.         press the <M> key again. The link is now established. The
  424.         computer will then go back to the page with the link word.
  425.            You can abort the marking process at any time until you
  426.         have marked the destination page. Just press the <Esc> key
  427.         to abort marking.
  428.            The entire link word or phrase must be on one line. That
  429.         is, once you have marked the beginning of the link phrase
  430.         with the <M> key, you cannot move to the next line. Suppose
  431.         you want to mark a phrase that is split at the end of a
  432.         line. To do this, first mark the phrase up to the end of
  433.         the first line. Hit the ENTER key, go to the destination
  434.         page, and mark it with the <M> key just as you normally
  435.         would. Then go back to the link phrase, mark the rest of
  436.         the phrase starting at the beginning of the second line.
  437.         Point this link phrase at the same destination page. What
  438.         you are actually doing is creating two link phrases that
  439.         point at the same page. It will act, however, as if the
  440.         link phrase extended over several lines.
  441.            If you want to create a link to a PCX file so that
  442.         jumping from that link displays the file, simply include
  443.         the name of the file in your ASCII document. Then mark the
  444.         entire file name including the .PCX extension. After you have
  445.         marked the word and pressed ENTER, simply press M to link
  446.         the word to itself. If the link word ends in ".PCX", HyperRead
  447.         automatically assumes that it is a PCX file and tries to load 
  448.         it. For example, the file name SATURN.PCX has been included 
  449.         in this document and linked. Clicking on it with the left 
  450.         mouse button or pressing the <J> key while the screen cursor 
  451.         is on it will display the picture. If the program cannot find 
  452.         this PCX file, it will display an error message.
  453.            If you want to create a link to an EXE, COM, or batch file 
  454.         so HyperRead will run that program, simply put the name of the 
  455.         program in your ASCII text document. You must include the 
  456.         ".EXE", ".COM", or ".BAT" extension in the name. You may 
  457.         include command-line parameters. Mark the full name of the file 
  458.         (including command-line parameters) and link the word to 
  459.         itself. For example, NOTHING.COM has been marked in this 
  460.         document. If HyperRead cannot find the file when you try to 
  461.         jump to it, HyperRead will return to its original state with 
  462.         no error message.
  463.  
  464.         Unmark
  465.  
  466.            This function allows you to remove a link. Use the
  467.         keyboard cursor keys to move the screen cursor to the link
  468.         phrase you want to remove. Then press the <U> key. The
  469.         phrase will no longer be a link phrase.
  470.  
  471.         Disk
  472.  
  473.            Pressing the <D> key causes the program to save the
  474.         HyperRead control file on disk. If this is the first time
  475.         you have saved this file, HyperRead Generator saves the
  476.         file with the same name as the original ASCII text file,
  477.         but with the HRF extension replacing whatever extension
  478.         your ASCII file had. If you loaded a document that already
  479.         had a control file, HyperRead Generator will use the same
  480.         name the control file had when you loaded it. You should
  481.         always save the control file before ending the program if
  482.         you have made any changes in it (marked or unmarked any
  483.         link words).
  484.            After saving the HRF file, HyperRead Generator will ask
  485.         if you also want to save an encoded text file. You would
  486.         save this file only if you want to be able to edit the text
  487.         file later without destroying the hypertext links. This will
  488.         be explained later. Normally, you would press the <N> key to
  489.         indicate that you do not want to save this file. If you do
  490.         want to save this file, press the <Y> key.
  491.            HyperRead Generator does not modify the original ASCII
  492.         document file in any way. Only the control file (and
  493.         optionally the encoded text file) is changed or created.
  494.  
  495.         PCX graphics
  496.  
  497.            For HyperRead or HyperRead Generator to display a
  498.         graphic, it must be in the 16 color, 640 by 350 pixel
  499.         format. There are basically two ways to generate such
  500.         pictures. You can use a scanner to scan existing hard copy
  501.         pictures, or you can create such pictures using a paint
  502.         program such as Windows Paintbrush. If you use the scanner,
  503.         you must be careful to set the scanning program to generate
  504.         the proper type of file. If you use a paint program, you
  505.         must be sure to set the palette and picture properties
  506.         correctly. The easiest way to do this is to load the
  507.         BLANK.PCX file provided with HyperRead Generator into the
  508.         paint program. This will automatically configure the paint
  509.         program to the proper settings. You can then draw on the
  510.         blank screen. When you are finished, save the picture using
  511.         the Save As option and give the picture a different name.
  512.         If you do not change the name, you will overwrite the
  513.         BLANK.PCX file, making it harder to create pictures in the
  514.         future.
  515.            Note: Some paint programs, including Windows Paint,
  516.         create pictures that are slightly distorted (thinner) when
  517.         viewed by HyperRead. To compensate for this, you might
  518.         want to draw the pictures a little thicker horizontally
  519.         than you want them to appear on the screen. The pictures
  520.         will then look correct when displayed by HyperRead. You
  521.         might want to create a few sample pictures of circles and
  522.         squares and load these into HyperRead to check this out
  523.         before you create any elaborate pictures with your paint
  524.         program.
  525.  
  526.         Modifying HyperRead documents
  527.  
  528.            Once you have created a HyperRead control file for a
  529.         document, you should not change the ASCII text file. Doing
  530.         so can mess up your link pointers or cause other
  531.         undesirable results. In particular, any change that
  532.         decreases the total number of lines in the file will cause
  533.         HyperRead to crash when trying to load the file. If you
  534.         add lines, the new lines will not be read in when you load
  535.         the document into HyperRead. If you add lines in the
  536.         middle of a document, all links after the added lines will
  537.         be in the wrong places. Adding text in a line will cause
  538.         all links on that line after the added text to be wrong.
  539.            To make changes in the text of a document after you have
  540.         created links in the document, load your existing HypeRead
  541.         file into HyperRead Generator. Once the file is displayed on
  542.         the screen. Press the <D> key. When the program asks you if
  543.         you want to save an encoded text file also, press the <Y>
  544.         key. Then exit HyperRead Generator by pressing the <Q> key.
  545.            The encoded text file has the same name as your text file, 
  546.         but has the ETF extension. You can load this file into most
  547.         text editors. Simple text editors, such as the EDIT function
  548.         that comes with DOS 5.0 and above, generally work best. Some
  549.         fancier text editors may be confused by the control codes 
  550.         that HyperRead Generator embeds in the text.
  551.             The encoded text file will look much like your original
  552.         text file, except you will see some odd looking control
  553.         characters, like faces, houses, and foreign letters. When 
  554.         editing the encoded text file in your text editor you must
  555.         obey a few simple rules:
  556.         1) Throughout the file you will see many smiling faces of
  557.         various colors. Each face is followed by two other odd
  558.         looking characters, usually foreign letters or graphic 
  559.         characters. Do not delete or edit this string of three 
  560.         characters. You will also see some characters that look like 
  561.         little houses. Do not delete these either. Deleting the 
  562.         faces, the two characters after them, or the houses will 
  563.         destroy hypertext links. If you delete entire lines 
  564.         containing the characters, the links will automatically be 
  565.         deleted by HyperRead Generator.
  566.         Note: The faces and houses may look like boxes if you are
  567.         viewing the file in a Windows program, such as Windows Write.
  568.         The foreign characters may look different, too.
  569.         2) In editing the file, you should not create lines that are
  570.         too long (over 79 characters, not counting the faces or 
  571.         houses) for HyperRead generator. The same rules apply to this 
  572.         file as the original text files.
  573.            Once you have modified the encoded text file with your text
  574.         editor, save it as an ASCII text file. You may then run
  575.         HyperRead Generator and load the encoded text file (select 3
  576.         in the menu that lists types of files to load). When HyperRead
  577.         Generator loads the file, it will translate the code 
  578.         characters into HyperRead links and save a new control file
  579.         with an HRF extension. It will also create a new version of
  580.         the original text file that contains the text changes you made
  581.         in the encoded text file. Since this overwrites both the text
  582.         file and the control file, you might want to save these in
  583.         another directory just in case you want to go back to the
  584.         original file.
  585.            HyperRead Generator has considerable power to decipher the
  586.         changes you make in the encoded text file and create a new 
  587.         ASCII text file and HyperRead control file. On rare 
  588.         occassions, you may have changed the text file in such as way
  589.         that HyperRead Generator is unable to accept the new file. For
  590.         example, you may have created lines that are too long (over 79 
  591.         characters) or erased parts of links without erasing the whole
  592.         link. If this happens, HyperRead Generator will display an 
  593.         error message and terminate the program run, returning you to
  594.         DOS. The original ASCII text file and control file will not 
  595.         be altered. You may then go back to the encode text file and 
  596.         repair it. If some lines are too long, shorten them. It there 
  597.         are partially deleted links, erase the remaining link fragment
  598.         (usually one of the house characters) in the line indicated 
  599.         when HyperRead Generator terminated and try to load the ETF
  600.         again.
  601.             Once HyperRead Generator has loaded the encoded file, it
  602.         will display the file as it normally does. You can then add
  603.         or remove links from the file and save it, just as if you
  604.         had loaded the file from a control file (selection 3 in the
  605.         menu that lists types of files to load).
  606.  
  607.         Mouse support
  608.  
  609.            HyperRead Generator uses the mouse the same way as
  610.         HyperRead.
  611.  
  612.         System Requirements
  613.  
  614.            Both HyperRead and HyperRead Generator should run on
  615.         any IBM compatible computer with at least 256 K of memory.
  616.         The text portion of the document  will display on any
  617.         display system, even an old MDA card with a monochrome
  618.         display. To display the PCX files, you must have an EGA or
  619.         better graphic card. The Print option will work with any
  620.         type of printer, even a daisy-wheel.
  621.  
  622.         Distributing HyperRead Documents
  623.  
  624.           To distribute a HyperRead Document, you need to include
  625.         in the package the following items:
  626.  
  627.         1) Your original ASCII text file.
  628.         2) The HyperRead control file for that document with the
  629.         HRF extension.
  630.         3) The HyperRead program. This is a freeware program, so
  631.         you can distribute unlimited copies. It is suggested but
  632.         not required that you include the READER.DOC and READER.HRF
  633.         files with the program itself so the user can fully
  634.         understand the features of the reader. Otherwise, your
  635.         document itself should include reasonable instructions on
  636.         how to use HyperRead. At the very least, mention that the 
  637.         reader can get some instructions by pressing the <H> key.
  638.         4) Any PCX, COM, EXE, or BAT files that you have linked
  639.         with your document.
  640.  
  641.           Do not distribute the file with the ETF extension created
  642.         by HyperRead Generator. That is for your use only.
  643.  
  644.         Uses for HyperRead
  645.  
  646.            You can use this program to create any type of
  647.         easy-to-read document you like. For example, you can create
  648.         a HyperRead instruction manual. The users can quickly zero
  649.         in on any problems they have by using link words to go to
  650.         more and more specific descriptions of the problem. This
  651.         document is an example of such a file. Instruction manuals
  652.         for shareware programs are a particularly good use for
  653.         HyperRead.
  654.            HyperRead reference "books" can also be easy to use.
  655.         Consider a HyperRead cookbook. The first few pages of the
  656.         HyperRead file could be a list of recipes. The name of each
  657.         recipe could be a link word or phrase. The user could jump
  658.         directly to the recipe by pointing to it with the cursor
  659.         and pressing the <J> key. Within the recipes, some of the
  660.         more unusual ingredients could be link words. These links
  661.         could take the reader to a section at the end of the "book"
  662.         that gives information on the ingredients.
  663.            In a similar fashion, you could make each item in a
  664.         table of contents of any file a link phrase. The reader can
  665.         then jump directly to that page using the link phrase.
  666.            A more entertaining use of the HyperRead function is
  667.         interactive fiction. This is an increasingly popular form
  668.         of literature. In such a book, the reader does not read the
  669.         book from start to finish. Instead, the book offers the
  670.         reader choices on what to read. A typical story might say
  671.         something like, "If you want to explore the cave, turn to
  672.         page 38. If you want to continue on the path, go to the
  673.         next page." With HyperRead, you could have the reader
  674.         select which action to take by selecting the proper link
  675.         phrase. The program would then take the reader to the
  676.         proper page. This is similar to text adventure games.
  677.  
  678.         Registering HyperRead Generator
  679.  
  680.            HyperRead Generator is shareware. You are free to
  681.         experiment with it and create test documents for as long as
  682.         you like. However, before you may distribute any HyperRead
  683.         documents you create with HyperRead Generator, you are
  684.         required to register it by sending $25.00 to:
  685.  
  686.                       Leithauser Research
  687.                       4649 Van Kleeck Drive
  688.                       New Smyrna Beach, FL 32169
  689.  
  690.            This is a one-time fee. Once you have registered
  691.         HyperRead Generator, you may use it on one computer to
  692.         create as many HyperRead documents as you like without
  693.         paying any additional fees.
  694.  
  695.         Registering HyperRead Generator gives you several benefits:
  696.  
  697.         1) You can legally distribute documents created with
  698.            HyperRead Generator.
  699.         2) You will receive the latest version of HyperRead
  700.            Generator when you register.
  701.         3) You will automatically receive fixed versions of
  702.            HyperRead and HyperRead Generator if any bugs are
  703.            discovered.
  704.         4) You will receive announcements of major upgrades and
  705.            have the opportunity to receive these upgrades for
  706.            just $5 S&H.
  707.