home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 19 / CD_ASCQ_19_010295.iso / dos / tools / hypcat11 / hcshelp.hyp < prev    next >
Encoding:
Text File  |  1994-10-22  |  35.5 KB  |  851 lines

  1. .TOPIC:
  2. Contents
  3.    HyperCat offers powerful text display and retrieval capabilities,
  4.  multi-level menus, and the best features of a disk based catalog.
  5.  
  6.    Unlike many hypertext applications the text files and menus used with
  7.  HyperCat are easy to create and define.  In a few menu driven steps you
  8.  can create multi-level menus that display text files, execute external
  9.  programs or batch files or display additional menus.  Utilizing the
  10.  powerful hypertext is equally simple.  You don't even have to use
  11.  hypertext unless you want or need to.
  12.  
  13.   The Basic Concept
  14.   Getting around with a keyboard or mouse
  15.  
  16.   Let's make a menu                   In just three easy steps you
  17.   Let's make some HyperText           can be using your own hypertext
  18.   Compile and test it                 application.
  19.  
  20. .TOPIC:
  21. Compile and test it
  22.  
  23.    After your test application has been completed it's time to compile it's
  24.  parts into a single directory for distribution.  Compiling scans your
  25.  project files looking for all included parts, external programs and
  26.  graphics.  It then processes and copies these to a single directory. After
  27.  completion you have a "ready for distribution" product.
  28.  
  29.  Compile Options
  30.  
  31. .TOPIC:
  32. The Basic Concept
  33.    There are basically two things that HyperCat does.  First, it allows
  34.  you to easily create menu items which in turn can execute other programs
  35.  or batch files, additional menus and/or display text or powerful hypertext.
  36.  
  37.    The second idea behind HyperCat is hypertext.  With only a small amount
  38.  of effort you can create powerful hypertext files that simply display text
  39.  or displays text containing links to related parts of your document.
  40.  Hypertext files can also execute external programs, display graphics and
  41.  even open an interactive, customized order form.
  42.  
  43. .TOPIC:
  44. Getting around with a keyboard or mouse
  45.  
  46.    Both the HyperCat Setup program and the HyperCat runtime utilize a
  47.  Windows like interface.  Using a mouse you simple "click" on the item
  48.  you wish to move to or activate.  Using the key board you can press the
  49.  TAB key to move from object to object or the Arrow keys to move from
  50.  Field to field.  Under most circumstances the ESC key will undo an
  51.  operation or clear the screen and the ENTER key will complete or close
  52.  an operation.
  53.  
  54.    When using hypertext the TAB and SHIFT TAB key will move from jump to
  55.  jump while the Home, End, PgUp, PgDn and Arrow keys will scroll any text
  56.  that goes off the screen.  Text can be scrolled both up and down and
  57.  left and right.
  58.  
  59. .TOPIC:
  60. Let's make a menu
  61.  
  62.    The first step in creating a menu is to define a project name.  A
  63.  project is the combination of all menus, hypertext files, setup files,
  64.  external programs, graphics, batch files and any other parts or pieces
  65.  you may include in your HyperCat application.  HyperCat keeps up with
  66.  all the parts associated with the project name and assembles them when
  67.  the application is compiled.
  68.  
  69.    If you've gotten this far you've already had to choose a project.
  70.  HyperCat requires a project name so to began a new project you will need
  71.  to select FILE from the pull-down menus, then NEW PROJECT.  At the NEW
  72.  PROJECT prompt enter a file name for the project you would like to begin.
  73.  Now press ENTER or click the OK button with the mouse.
  74.  
  75.    The next prompt that appears is the LOAD MENU screen.  Since this is a
  76.  new project and there are no menus yet just click the OK button to
  77.  continue.
  78.  
  79.    You should now be looking at the MENU SETUP screen.  There's a lot
  80.  of buttons here but it's really quite simple.  To create your first menu
  81.  item just click the OK button.  You should now see the EDIT MENU ITEM 1
  82.  window.  To continue click on MENU SETUP or press the TAB key then
  83.  press ENTER.
  84.  
  85. .TOPIC:
  86. Menu Setup
  87.  
  88.    From this screen you create the menu items for your application.  The
  89.  Menu Setup screen allows you add, delete and define menu choices.  You
  90.  can also access the Project Setup screen by clicking the Setup button.
  91.  
  92.    When creating a new menu for the first time you simply click OK to open
  93.  the edit window for MENU ITEM 1 or click on the list box to select an
  94.  existing menu.  New menu names are created automatically by the program.
  95.  
  96.   Edit item   Setup    Test     For information on the individual
  97.   Ins         Save     Help     Menu Setup buttons use the TAB key
  98.   Del         Close    New      or click on the topics to the left.
  99.  
  100.  
  101. .TOPIC:
  102. Test
  103.  
  104.    The test button allows you to make changes to your application the see
  105.  the effects immediately.  Clicking Test will execute HyperCat using the
  106.  current settings for the current project.  Remember to save changes before
  107.  testing.
  108.  
  109.  Note: Sometimes, if memory conditions are low, "shelling" to external
  110.  programs will not work when "testing".  They should work fine during
  111.  normal operation.
  112.  
  113. .TOPIC:
  114. Ins
  115.  
  116.    The Insert button will open the menu edit window for a new menu item
  117.  directly below the item currently hi-lited.
  118.  
  119. .TOPIC:
  120. Del
  121.  
  122.    The Delete button will prompt you with an OK / Cancel option before
  123.  deleting the curently hi-lited menu item.
  124.  
  125. .TOPIC:
  126. New
  127.  
  128.    The New button allow you to select or create a new menu set to edit.
  129.  Menu items can load and display multiple menus.  HyperCat always prompts
  130.  you to save or cancel menu item changes before loading or creating a
  131.  new menu.
  132.  
  133. .TOPIC:
  134. Setup
  135.  
  136.    This button displays the Project Setup screen.  The Project Setup
  137.  screen controls many HyperCat application defaults including colors,
  138.  order form defaults and the opening screen.  For more information
  139.  display the Project Setup screen the click the Help button.
  140.  
  141.   Project Setup
  142.  
  143. .TOPIC:
  144. Save
  145.  
  146.    Clicking the Save button will save any changes you have made to any
  147.  menu items.  HyperCat always prompts to save unsaved changes before
  148.  loading new menus or projects.
  149.  
  150. .TOPIC:
  151. Close
  152.  
  153.    The close button closes the Menu Setup screen.  If changes have been
  154.  made that have not yet been saved you will be prompted to save them.
  155.  
  156. .TOPIC:
  157. Help
  158.  
  159.    The Help button on any screen loads context-sebsitive help for the
  160.  current topic.
  161.  
  162. .TOPIC:
  163. Edit Item
  164.  
  165.    Each menu item has four parts, some are required and some are optional.
  166.  The parts are:
  167.  
  168.  Menu item text: This will be first menu item hilited by the scroll bar
  169.                  when the program is started. <Required>
  170.       Item desc: This is a one line description of the menu item.  It is
  171.                  not required but is helpful to the user. <Optional>
  172.    File to load: This is the file to load or execute when this item is
  173.                  selected and is required. <Required>
  174.  Hypertext jump: This is the topic within a hypertext file to display.
  175.                  If left blank the hypertext will default to the first
  176.                  of the document containing the Contents topic. <Optional>
  177.  
  178.    To create a menu choice enter the menu item text then a short
  179.  description of what the menu item does.  If you are displaying a hypertext
  180.  file with this item enter the name of the file.  Be sure to include the
  181.  HYP extension.  If you wish this item to display a new menu enter the name
  182.  if the menu file using the MNU extension.  To execute an external program
  183.  or batch file enter it's name.
  184.  
  185.    If the menu item is to display a hypertext file you can enter in the
  186.  Hypertext jump field the name of the topic to display.  This allows
  187.  different menu choices to display different sections of the same document.
  188.  
  189.    When you're done just click on Save/Exit to return to the Menu Setup
  190.  screen.
  191.  
  192. .TOPIC:
  193. Contents topic
  194.  
  195.    Every hypertext document must have a Contents.  It is the first and
  196.  only required hypertext jump.  To create a contents you need only to
  197.  enter the following text on the first two lines of the document.  Make
  198.  sure both lines begin on the left margin and that the word TOPIC is in
  199.  capital letters.
  200.  
  201.  .TOPIC:
  202.  Contents
  203.  
  204.    That's all it takes.  See any of the sample files for examples.
  205.  
  206. .TOPIC:
  207. Let's make some hypertext
  208.  
  209.    A hypertext document in it's simplest form is a text file that contains
  210.  "links" to other areas of the document.  To turn a text file into
  211.  HyperCat compatible "hypertext" you need only to enter the following text
  212.  on the first two lines of the document and to give the file the HYP
  213.  extension.  Make sure both lines begin on the left margin and that the
  214.  word TOPIC is in capital letters.
  215.  
  216.  .TOPIC:
  217.  Contents
  218.  
  219.    That's all it takes.  A document with the two preceding lines will
  220.  load in the HyperCat program.  To create hypertext that allows jumps and
  221.  the running of external programs select one of the topics below:
  222.  
  223.    Creating hypertext              Displaying the Order Form
  224.    Executing external programs     Displaying Graphics
  225.  
  226. .TOPIC:
  227. Displaying the Order Form
  228.  
  229.    HyperCat incorporates a full featured order form that calculates tax
  230.  by state, adds shipping and handling charges and takes all order info
  231.  including credit card, name & address, and user notes.
  232.  
  233.    To invoke the order form from within a hypertext file and have it
  234.  correctly process the order information requires that you format your
  235.  text in special way.  To invoke the order form requires only that you
  236.  use the word Order followed by a product number within a hypertext link.
  237.  
  238.  For example: <Order #2323>               (Note: The <> characters would
  239.                                           normally be replaced by the
  240.                                           ALT 017 and ALT 016 characters.)
  241.  
  242.  Most Important!
  243.  
  244.    An order form link must always start with the word order and end with
  245.  the # character followed by a code.  The code can be numeric or alpha
  246.  characters.  You can also include additional text between the word Order
  247.  and the # character if you choose.
  248.  
  249.    Somewhere within the document there must also be a matching order number
  250.  followed by the price.  For Example:
  251.  
  252.    #ED234  Educational Software for Kids v1.2  $29.95
  253.            You can include any text, anywhere you choose for the
  254.            description of your products as long there is a line somewhere
  255.            that starts with a product number and ends with a price.  The
  256.            $ sign is also required.
  257.  
  258.    <Order #ED234>  or  <Order Educational Software - Product #ED234>
  259.  
  260.    An alternative method of invoking the order form is to provide all the
  261.  necessary information on a single line.  For example:
  262.  
  263.    #231AC  230w P/S Full Tower case                             $59.00
  264.    #123AC  Mitsumi CD-ROM 150kb 300 mil sec                     $79.00
  265.    #792AC  Multi I/O 2S 1P 1G                                   $19.00
  266.  
  267.    When a user clicks the order link, HyperCat will scan the document to
  268.  match the order number then invoke the order form with all necessary
  269.  information.  You should also review the Order form setup to customize
  270.  the printed order form for your application.
  271.  
  272. .TOPIC:
  273. Order Form Setup
  274.  
  275.    The HyperCat order form can be completely customized to reflect your
  276.  company and policies.  The order form is completely optional and will
  277.  never be seen by the user unless you invoke it in your text.  See the
  278.  help topic Displaying the Order Form for information on invoking the
  279.  order form.
  280.  
  281.  Note: All edit fields in HyperCat use "Hot keys" to move about the text.
  282.  
  283.        HOME        - Moves to the first character on the line.
  284.        END         - Moves to the last character on the line.
  285.        CTRL-HOME   - Moves to the first character in the document.
  286.        CTRL-END    - Moves to the last character in the document.
  287.        ARROW KEYS  - Move one character at the time in any direction.
  288.        PGUP-PGDN   - Scrolls the document one page at the time.
  289.        DEL         - Deletes the character the cursor is on.
  290.        CTRL-I      - Insets the cursor 5 characters.
  291.        SHIFT ARROW - Blocks text for delete.
  292.  
  293.  
  294.  Text to appear on order from preceding customer address:
  295.  
  296.    This field is a multi-line edit box that allows you to enter any number
  297.  of lines of text you choose.  Text entered here will be displayed
  298.  beginning on the first line of the order from and will be followed by
  299.  the user's Name and Address.  Use spaces to center or format your text
  300.  and be sure to press the RETURN key after each line.
  301.  
  302.  Text to appear on order form following purchase totals:
  303.  
  304.    Text entered in this field will be printed immediately following the
  305.  purchase totals.  This a completely flexible field that allows you to
  306.  place any text on the order you choose.  Use spaces to center or format
  307.  your text and be sure to press the RETURN key after each line.
  308.  
  309.  Tax and Miscellaneous
  310.  
  311.    ( ) Do Not Prompt For Taxes
  312.        If this option button is selected the order form tax prompt will
  313.        be dimmed and the user will not have access to it.
  314.  
  315.    ( ) Prompt For Tax on One State/Province
  316.        If this option is selected HyperCat will prompt for a tax rate
  317.        only if the State/Province you enter matches the State/Province
  318.        the user enters.  (It is not case sensitive)
  319.  
  320.    ( ) Prompt For Tax on All States or Provinces
  321.        As the title implies, when this option is selected the user will
  322.        allways be prompted for taxes.
  323.  
  324.        State or Province to tax:
  325.        If you select option 2 above you will need to enter the State or
  326.        province to tax in this field.
  327.  
  328.        Currency Character:
  329.        This is the character that will be displayed to indicate the
  330.        currency type being used.  $, £, etc...
  331.  
  332.  
  333.        Prompt for Shipping Costs:
  334.        Checking this box will cause HyperCat to make the shipping costs
  335.        field available to the user and what they enter will be factored
  336.        into the totals.
  337.  
  338.        Prompt For Credit Card Purchase:
  339.        If you can accept credit cards you can use this option to have
  340.        HyperCat prompt for credit card purchases.  If entered, this
  341.        information will be printed on the order form.
  342.  
  343.        Credit Cards Accepted:
  344.        This is simply a text field that displays with the order form to
  345.        tell customers what credit cards are accepted.
  346.  
  347.  Date Format
  348.  
  349.    Select the format for where your application will primarialy be
  350.  distributed, either the USA or European.
  351.  
  352.  Save/Exit
  353.  
  354.    The Save/Exit button will save the current order form setup information
  355.  and write it to the project file, then exit the Order Form Setup.
  356.  
  357.  Cancel
  358.  
  359.    The cancel button exits the Order Form Setup screen without saving any
  360.  changes.
  361.  
  362.  Help
  363.  
  364.    The Help button on any screen displays context sensitive help for the
  365.  current location within the program.
  366.  
  367. .TOPIC:
  368. Project Setup
  369.  
  370.    For each hypertext application or "project" you create there are many
  371.  settings that can vary from project to project.  HyperCat keeps these
  372.  settings in the .PRJ file.  The Project Setup options allow you to define
  373.  a number of features concerning the "look and feel" and usability of your
  374.  application.
  375.  
  376.  Note: All edit fields in HyperCat use "Hot keys" to move about the text.
  377.  
  378.        HOME        - Moves to the first character on the line.
  379.        END         - Moves to the last character on the line.
  380.        CTRL-HOME   - Moves to the first character in the document.
  381.        CTRL-END    - Moves to the last character in the document.
  382.        ARROW KEYS  - Move one character at the time in any direction.
  383.        PGUP-PGDN   - Scrolls the document one page at the time.
  384.        DEL         - Deletes the character the cursor is on.
  385.        CTRL-I      - Insets the cursor 5 characters.
  386.        SHIFT ARROW - Blocks text for delete.
  387.  
  388.  
  389.  Opening Screen Text
  390.  
  391.    The opening screen is useful for providing your name, address, phone
  392.  number information and "getting started" instructions to the user.  If the
  393.  opening screen is left or right of the menu the user will see it each time
  394.  they return to a menu.
  395.  
  396.    From the Project Setup screen you can enter any amount of text up to
  397.  32k.  The Opening Screen will scroll up and down allowing the user to
  398.  view an unlimited amount of text.
  399.  
  400.    When displaying the opening screen along side the menu items it will be
  401.  sized to allow the maxium width based on the longest menu item.  Try
  402.  different menu items to see how they affect the opening screen.  When the
  403.  menus are centered the opening screen will be almost full-screen.
  404.  
  405.    Use spaces to center text and be sure to press the ENTER key after each
  406.  line of text.
  407.  
  408.  
  409.  [ ] Enable Printing of Text
  410.      HyperCat allows the user to block text using the mouse or keyboard
  411.      then send it to "clipboard".  The Clipboard is an area where text can
  412.      be collected and then later printed to a printer or text file.  If
  413.      you do not want the user to be able to copy or print your data this
  414.      option should be UNCHECKED.
  415.  
  416.  [ ] Enable Opening Screen
  417.      When this option is "checked" you will be able to edit the opening
  418.      data and the opening screen will be displayed when HyperCat is started.
  419.      I "unchecked" the opening screen will be disabled.
  420.  
  421.  [ ] Enable Order Form Display
  422.      When this option is "checked" you will be able to edit the order form
  423.      setup data and the order form options will appear in the HyperCat
  424.      options menu. If "unchecked" the order form will not be available from
  425.      HyperCat and the Order Form Setup will not be accessible from
  426.      HyperCat Setup program.  (This program.)
  427.  
  428.  [ ] Return to previous menu
  429.      When this option is "checked" a menu item is added to each menu you
  430.      create.  The first or Top menu will have as it's last item the option
  431.      to exit the program.  All lower level menus will have as thier last
  432.      menu item, the option to return to the previous menu.
  433.  
  434.      Important!  If you do not enable this option you will need to create
  435.      the menu items that allow users to return to previous menus.  This
  436.      option allows you to define the text that returns to other menus in
  437.      case each menu contains categorized items.
  438.  
  439.  [ ] Enable options menu item
  440.      When this option is "checked" a menu item is added to each menu you
  441.      create.  All menus will have the choice to display the options menu.
  442.      The options menu allows the user to print text from the clipboard,
  443.      change colors, change sound effects and shell to DOS.
  444.  
  445.  [ ] Enable EMS/Disk memory swapping
  446.      HyperCat has the ability to remove itself from memory leaving only a
  447.      5k "place marker".  This feature should be enabled only if you are
  448.      executing external programs that require the extra memory.
  449.  
  450.      HyperCat first seeks to use EMS for memory swapping.  If EMS is not
  451.      available HyperCat will seek to find space on every drive on the
  452.      system.  If it cannot find space it will perform a normal shell.
  453.  
  454.      Note: If memory conditions are low you may experience problems using
  455.            the HyperCat shell feature when testing under the HyperCat
  456.            Setup program.  Under normal operation conditions executing
  457.            external programs should work fine.
  458.  
  459.  ( ) Position Menus Left
  460.      This option causes the opening screen to be displayed on the right of
  461.      the menu.  It will also cause the opening screen to be sized to fit
  462.      in the remaining space right of the menu.
  463.  
  464.  ( ) Position Menus Center
  465.      This option causes the opening screen to be displayed "full-screen"
  466.      when the HyperCat program is first started.  As soon as a key is
  467.      pressed the opening will clear and the main menu will be displayed in
  468.      the center of the screen.  The opening screen will appear only once
  469.      each time the program is executed.
  470.  
  471.  ( ) Position Menus Right
  472.      This option causes the opening screen to be displayed on the left of
  473.      the menu.  It will also cause the opening screen to be sized to fit
  474.      in the remaining space left of the menu.
  475.  
  476.  Color Set
  477.  
  478.    HyperCat provides a number of different color combinations for your
  479.  hypertext application.  Use the up and down arrow keys to scroll the
  480.  different choices or use the mouse to click the arrow then choose from
  481.  the list.
  482.  
  483.  Project Title
  484.  
  485.    This is the title text that will be displayed across the top of your
  486.  HyperCat application.
  487.  
  488.    If your project will encompass multiple issues or updates you should
  489.  name each project consistantly.  Each should begin with a word that
  490.  distinguishes it from the others.  HyperCat sorts these names and allows
  491.  a user to jump from one item to another by pressing the letter that
  492.  matches the first letter of the first word.
  493.  
  494.    Example: April Edition - North Carolina PC users group.
  495.             Feburary Edition - North Carolina PC users group.
  496.             March Edition - North Carolina PC users group.
  497.  
  498.             1st Issue - Computer Animation Newsletter
  499.             2nd Issue - Computer Animation Newsletter
  500.             3rd Issue - Computer Animation Newsletter
  501.  
  502.     When you update a project, all the user has to do, is install the new
  503.  data in the same directory as the old data.  HyperCat will do the rest.
  504.  
  505.  Order Form
  506.  
  507.    The Order Form button displays the Order Form Setup screen.
  508.  
  509.  Sound Effects
  510.  
  511.    HyperCat has three modes for Sound Effects, Off, Fun and Serious. You
  512.  can click this button to set the defaults for your application.
  513.  
  514.  Save
  515.  
  516.    The Save button will write the current project setup to disk so that
  517.  testing the project will reflect the changes you have made.
  518.  
  519.  Close
  520.  
  521.    The Close button closed the project setup screen.  You must save the
  522.  setup before exiting if you wish any changes to take effect.
  523.  
  524.  Test
  525.  
  526.    The text button allows you to make changes to your application the see
  527.  the effects immediately.  Click Test will execute HyperCat using the
  528.  current settings for the current project.  Remember to save changes before
  529.  testing.
  530.  
  531.  Help
  532.  
  533.    The Help button on any screen displays context sensitive help for the
  534.  current location within the program.
  535.  
  536.  
  537. .TOPIC:
  538. Displaying graphics
  539.  
  540.    HyperCat for DOS uses a simple utility called HCPCX.EXE to display
  541.  PCX graphics.  HCPCX will display color graphics in up to 16 color in
  542.  any resolution.  640 x 480 graphic images seem to give the best results.
  543.  The HCPCX program must be present for PCX files to be displayed.  HyperCat
  544.  will automatically copy HCPCX when your application is compiled.
  545.  
  546.    Graphics can be displayed using any of three methods.  Graphics can be
  547.  displayed from within hypertext files and as a menu item.
  548.  
  549.    To display a PCX graphic from within hypertext you need only to enter
  550.  the PCX filename, the word Figure or the word Show within the link.
  551.  
  552.    Figure <FILENAME>  - The word Figure (or Fig) tells HyperCat that the
  553.                         following filename should be displayed as a PCX
  554.                         Graphic file.  Click Fig: Graphic for an example.
  555.    Show <FILENAME>    - The word Show or (Sho) works the same as Figure.
  556.                         Show tells HyperCat that the following filename
  557.                         should be displayed as a PCX Graphic file.  Click
  558.                         Show Graphic for an example.
  559.    <FILENAME>.PCX     - Any filename by itself ending with the PCX
  560.                         extension will be displayed as a graphic file.
  561.                         Click Graphic.PCX for an example.
  562.  
  563.    To display a PCX graphic as a menu item you simply enter the name of
  564.  the PCX file in the FILE TO LOAD field.  Make sure you include the PCX
  565.  extension HyperCat with try to load it as a hypertext file.
  566.  
  567.  
  568. .TOPIC:
  569. Executing external programs
  570.  
  571.    HyperCat hypertext file can not only jump to other locations within the
  572.  document, they can be used to execute programs or batch files and display
  573.  PCX graphics using a special HyperCat utility.
  574.  
  575.    HyperCat uses "keywords" to identify special functions.  Keywords are
  576.  utilized by placing them inside the hypertext link.  The following words
  577.  will cause special actions when clicked on by the user:
  578.  
  579.    Run <FILENAME>     - Placing the word RUN before a filename in a hyper-
  580.                         text link will cause the filename to be executed
  581.                         when the link is clicked.
  582.    <FILENAME>.EXE     - Placing any executable filename by itself inside
  583.                         a link will cause it to be executed when clicked.
  584.    <FILENAME>.COM     - Placing any executable filename by itself inside
  585.                         a link will cause it to be executed when clicked.
  586.    <FILENAME>.BAT     - Placing any executable filename by itself inside
  587.                         a link will cause it to be executed when clicked.
  588.                         Click on DEMO.BAT for an example.
  589.    Figure <FILENAME>  - The word Figure (or Fig) tells HyperCat that the
  590.                         following filename should be displayed as a PCX
  591.                         Graphic file. See Displaying graphics for more
  592.                         information.  Click Fig: Graphic for an example.
  593.    Show <FILENAME>    - The word Show or (Sho) works the same as Figure.
  594.                         Show tells HyperCat that the following filename
  595.                         should be displayed as a PCX Graphic file.  Click
  596.                         Show Graphic for an example.
  597.    <FILENAME>.PCX     - Any filename by itself ending with the PCX
  598.                         extension will be displayed as a graphic file.
  599.                         Click Graphic.PCX for an example.
  600.    Order #1234        - The word Order (or Ord) displays the custom order
  601.                         form. Click Displaying the Order Form for more
  602.                         information.
  603.  
  604. .TOPIC:
  605. Creating hypertext
  606.  
  607.    Creating HyperCat hypertext is easy!   Hypertext files are standard ASCII
  608.  files that can be edited with most text editors including the EDIT program
  609.  that comes with DOS.
  610.  
  611.  To create a new Hypertext file:
  612.  
  613.  1.  Determine what data or information you wish to publish.
  614.  2.  Start any text editor that reads and writes ASCII files using a file
  615.      name that has the HYP extension.
  616.  3.  Create a topic named Contents and type a table of contents below. The
  617.      contents topic is required and can be used as a starting point for
  618.      your hypertext application.
  619.  4.  Every entry in the table of contents should be a link to another topic.
  620.  5.  Create a Hypertext topic for every link in the table of contents.
  621.  6.  Every Hypertext topic can contain links to other Hypertext topics.
  622.  7.  Hypertext topics do not need to be listed in the table of contents.
  623.  8.  Hypertext files can be any length or width but each topic is limited
  624.      to 32k.  This means the document containing your hypertext topics can
  625.      be any size but the content of each jump or topic must not exceed
  626.      32k.
  627.  
  628.    HyperCat distinguishes hypertext topics from ordinary text by requiring
  629.  that all topics are formatted in a specific way.
  630.  
  631.  1.  The word TOPIC must be on a line by itself, preceeded by a period (.)
  632.      and followed by a colon (:).  TOPIC must be in uppercase.
  633.  2.  The period must be the first character on the line.
  634.  3.  Only spaces are allowed after the colon.
  635.  4.  The name of the topic itself must be on the line immediately below the
  636.      .TOPIC: statement.
  637.  5.  The topic text should begin on the line after the name of the topic.
  638.  6.  The HyperCat will not word wrap text.  Use the ENTER key to break text
  639.      into reasonable length lines.  74 character lines work well because
  640.      the hypertext window defaults to 76 characters wide.  Lines that exceed
  641.      76 characters can be scrolled right and left.
  642.  7.  Topics can be located anywhere within the document.
  643.  
  644.    For example, the following would be a valid topic except that the period
  645.  is the second character on the line, not the first.  (It is displayed this
  646.  way so as to not confuse the HCS help system which uses hypertext.)
  647.  
  648.  .TOPIC:
  649. This is a topic name
  650.  This is the first line of this topic.
  651.  Line 2
  652.  Line 3
  653.  Line 4...
  654.  
  655.  This is the last line of this topic.
  656.  
  657.   Creating Links
  658.  
  659. .TOPIC:
  660. Creating Links
  661.  
  662.    Links are hot spots that a hypertext user clicks on to jump to another
  663.  topic.  Links are ordinary text surrounded by special triangle characters
  664.  (ASCII codes 16 and 17).  These characters are entered by pressing and
  665.  holding the ALT then entering the ASCII code.  Try this by holding down
  666.  the ALT key, then using the numeric keypad enter the number 017.  This
  667.  will cause the left triangle character to appear.
  668.  
  669.    Links and Topics must have exactly the same name or HyperCat will not
  670.  be able to find a Topic when a Link is clicked.  Links and topics are
  671.  not case sensitive.  If there is no matching topic when a link is clicked
  672.  a warning message will appear.  For example, click on Invalid Topic to
  673.  see what happens if you create a Link without a matching Topic.
  674.  
  675.    You can view or edit any of the sample or help files used by HyperCat
  676.  for an example of hypertext is created.
  677.  
  678. .TOPIC:
  679. Creating menus
  680.  
  681.    Creating a menu in HyperCat is an easy, menu driven operation.  You can
  682.  even create menu items that load additional menus and execute external
  683.  programs or batch files.
  684.  
  685.   Let's make a menu
  686.  
  687. .TOPIC:
  688. Compile Options
  689.  
  690.    The Compile Option is where you complete your application by assembling
  691.  it's parts into a single directory.  HyperCat will scan your HYP and MNU
  692.  files looking for any external programs or graphics used by your program.
  693.  After Compile has run, all the files used or called by your application
  694.  will reside in one place.
  695.  
  696.    You should always develope your application from the HyperCat directory.
  697.  All associated files should be kept with the PRJ files so HyperCat Setup
  698.  can find them at compile time.
  699.  
  700.  Output Directory:
  701.  
  702.    The Output Directory is the location on your hard or floppy disk where
  703.  you wish to store your completed application.  HyperCat Setup will always
  704.  overwrite any existing files.  If you include a subdirectory name that
  705.  does not exist, as the destination, HyperCat will create it.
  706.  
  707.  Start-up Filename:
  708.  
  709.    The Start-up filename is the name you wish to give the HyperCat EXE
  710.  program.  This will be the name your users start your application with.
  711.  
  712.  ( ) Compress HYP and support files.
  713.  ( ) Compress support files only.
  714.  
  715.    HyperCat will compress and encrypt your HYP files to reduce thier size
  716.  and protect your data.  Compression is recommended.  If you choose to
  717.  compress support files only, your data will remain in it's ASCII state
  718.  and can be accessed by the user.  Sometimes this may be desirable such as
  719.  when you distribute a catalog-on-disk.  Most times you will want your data
  720.  to use less space and be protected from unauthorized copying.
  721.  
  722.    Note: If you do not want your data accessible be sure to disable the
  723.          copy feature in the Setup and compress your HYP files.
  724.  
  725.  Start
  726.  
  727.    The Start button begins the compilation process.
  728.  
  729.  Close
  730.  
  731.    Click the Close button to clear the Compile Options screen.
  732.  
  733.  Help
  734.  
  735.    The Help button on any screen displays context sensitive help for the
  736.  current location within the program.
  737.  
  738. .TOPIC:
  739. About HyperCat
  740.  
  741.  
  742.  
  743.                                HyperCat v1.1
  744.  
  745.                    HyperText Catalog and Authoring System
  746.  
  747.           Copyright 1994 - Michael L. Wester - All Right Reserved
  748.  
  749.  
  750.  
  751.  
  752.  
  753.                         Other Shareware Products
  754.  
  755. .TOPIC:
  756. Other Shareware Products
  757.  
  758.                              Quik Install v2.0
  759.  
  760.      An easy to setup and use application installation program.  Installs
  761.  applications from floppy disks or CD-ROMs to hard disks.  Supports
  762.  multiple disk installations, copies files or installs from EXE archives,
  763.  checks available disk space, creates subdirectories, auto executes
  764.  application after installation, configurable colors, prompt and message,
  765.  stores setup internally (No configuration or script files), only 7k in
  766.  size. Completely menu driven, full mouse support, full context sensitive
  767.  help & more!.  Runs on any PC compatible computer.
  768.  
  769.      Quik install has been reviewed in major magazines including PC-Plus,
  770.  Europe's largest selling computer magazine.
  771.  
  772.      ...extremely easy to setup and use... ...most installation routines
  773.      should take no more than five minutes... ...easily incorporate the
  774.      level of sophistication needed...
  775.                                            Roman Iwaschkin
  776.                                            PC-Plus Magazine
  777.  
  778.      Elegant and fuss-free. No programming required. Occupies less than
  779.      7k of disk space. Fully configurable.
  780.                                            PC-Plus Magazine
  781.                                            Product facts
  782.  
  783.      ...I like that little program, it's just so easy to use...
  784.                                            L. Madison
  785.  
  786.      ...pretty slick programming dude, you done a really good job.
  787.                                            K. James
  788.  
  789. ────────────────────────────────────────────────────────────────────────────
  790.  
  791.                              Read-A-Matic v1.0
  792.  
  793.       Read-A-Matic is an easy to use utility that turns ordinary ASCII
  794.   text files into powerful README.EXE files. (You can name them whatever
  795.   you like.)  The executable text can be scrolled, searched and printed.
  796.   Text colors can be changed throughout the file and a range of text can
  797.   be displayed whenever any of the 12 function keys are pressed.  The
  798.   README.EXE can also be called with parameters that cause it to display
  799.   only selected text.  Creating the EXE is extremely easy and completely
  800.   menu driven with full mouse support.
  801.  
  802.       Registration includes a royalty-free license to create README.EXEs 
  803.   That display YOUR copyright... and it's only $15.00.    
  804.  
  805.  
  806. ────────────────────────────────────────────────────────────────────────────
  807.  
  808.                             Jokes & Quotes v1.4
  809.  
  810.       Jokes & Quotes is a NETWORK ready, daily message display system.
  811.   Nearly 4000 jokes, quotes, stories, maxims and more are selected from
  812.   25 "on-screen" categories.  Users have options to print quotes,
  813.   deselect categories, random select at startup, change colors, enable
  814.   screen blanker, reset category to any record and more.  Network
  815.   features include global messages to all users, special messages to
  816.   selected users, limit number of jokes displayed daily, administrator
  817.   controled categories and more.  Full mouse support and context
  818.   sensitive help.
  819.  
  820.   Just a few of the 40+ joke and quote categories:
  821.  
  822.   THINGS TO THINK ABOUT                QUIPS & WIT
  823.   OXYMORONS                            QUOTED
  824.   ONE LINE WIT                         DISORDER IN THE COURT!  TRANSQUIPS!
  825.   TYPOS                                REAL LIFE IN FANTASY LAND!  TV AXIOMS
  826.   SELECTED SCRIPTURES                  PRACTICAL JOKES
  827.   KID TALK                             DOWN HOME FUN
  828.   POLITICS                             REAL DUMB PEOPLE JOKES
  829.   YOU KNOW YOU'RE GETTING OLD WHEN...  LIMERICKS
  830.  
  831.      Jokes and Quotes has been reviewed in major magazines and is
  832.   carried by most sharware vendors.  It received Public Brand Software's
  833.   four star rating, just short of a trophy.
  834.  
  835.   ...Jokes & Quotes is for anybody who likes to laugh (and who dosen't)...
  836.                                            Public Brand Software
  837.  
  838.   ...I have found it to be a tremendous example of shareware and gladly
  839.      submit the $15.00 registration fee.  ...an outstanding example of
  840.      quality, shareware programming.
  841.                                            M. Ciccarelli
  842.  
  843.   ...one of those programs that brings productivity to a standstill, you
  844.      get started and you just can't stop.
  845.                                            J. Abbott
  846.  
  847.   ...I loved it.  I had to register because I couldn't stop reading.  I
  848.      used up the shareware categories and wanted more.
  849.                                            T. Sorenson
  850.  
  851.