home *** CD-ROM | disk | FTP | other *** search
/ MacFormat 1996 January / macformat-033.iso / mac / Shareware City / Comms / Tricks Folder / readme.txt < prev    next >
Encoding:
Text File  |  1995-09-30  |  5.3 KB  |  118 lines  |  [TEXT/ttxt]
  1. ----------------------------------------------------------------------------
  2. ----------------------------------------------------------------------------
  3.  
  4.          Welcome
  5.  
  6. ----------------------------------------------------------------------------
  7.  
  8.      This is the read me file for the HTML version of Teaching a New
  9.      Dog Old Tricks.
  10.  
  11. ----------------------------------------------------------------------------
  12.  
  13. Welcome, and I hope you enjoy Teaching a New Dog Old Tricks !
  14.  
  15. This is the read me file for the HTML version of this book. It describes how
  16. you can get it up and running on your computer.
  17.  
  18. Shareware
  19.  
  20. Teaching a New Dog Old Tricks is intended to be distributed as freely as
  21. possible. At the same time, in order to demonstrate the use of this
  22. technology, this distribution contains a few pieces of shareware. If you use
  23. this software for your own use, then you are expected to pay the shareware
  24. fees. The instructions concerning these fees is described in their
  25. individual online documentation.
  26.  
  27. Requirements
  28.  
  29. To read this book, all you really need is an HTML browser. If you are in a
  30. hurry, then, assuming you haven't moved any files around inside the
  31. distribution, you can begin reading right away. The file you want to
  32. initially open with your browser is named 0030-toc.html and it resides in
  33. the manuscript folder of the teaching folder.
  34.  
  35. If you want to read the book and use the scripts it includes, then you need
  36. to have AppleScript installed, an HTTP server running that handles CGI
  37. scripts, and finally install a few more files from the distribution.
  38. Installation instructions follow.
  39.  
  40. Contents
  41.  
  42. The distribution consists of the following files and folders:
  43.  
  44.    * Tricks Folder
  45.        1. Teaching folder - contains the manuscript, appendicies, lists of
  46.           Internet resources, graphics, and scripts used to make most of the
  47.           book happen
  48.        2. OSAX Folder - items to be installed in the Scripting Additions
  49.           Folder of your Extensions Folder of your system folder
  50.        3. robust-search.cgi - a TR-WWW search engine
  51.        4. robust-search.config - a TR-WWW configuration file
  52.        5. simple-search.cgi - a TR-WWW search engine
  53.        6. simple-search.config - a TR-WWW configuration file
  54.        7. readme.html - this file
  55.        8. readme.txt - an plain text version of this file
  56.        9. Table of contents - an alias to the table of contents page
  57.  
  58. Installation instructions
  59.  
  60. In order to demonstrate this book's full potencial and use the scripts it
  61. contains (including the pop-up menu in the table of contents), then you need
  62. to have an HTTP server (like MacHTTP or WebSTAR) installed and running on
  63. your computer. Otherwise there is no need to read this section as the
  64. present time. If this is you, then read the text, get a server, and come
  65. back to these instructions later.
  66.  
  67. If you have gotten this far, then it is assumed you have an HTTP server on
  68. your computer. Here is what you have to do to get this book up and running:
  69.  
  70.   1. Copy all the files and folders from the Tricks Folder into the root
  71.      folder of your HTTP server. In other words, but all items from this
  72.      distribution into the same folder as MacHTTP (or WebSTAR). If the
  73.      folder named "teaching" is not in the same folder as your server
  74.      application, then you may get unpredictable results.
  75.  
  76.   2. Run your server application. If you are not connected to the Internet
  77.      and/or any other network, then read Appendix B: Running servers without
  78.      the Internet.
  79.  
  80.   3. Install the OSAX. Put all the files in the OSAX Folder into the
  81.      Scripting Additions Folder of your Extensions Folder of your system
  82.      folder. Those files (Parse CGI and TCP Scripting addition) allow you to
  83.      run the pop up menu from the book's table of contents as well use the
  84.      comment form at the bottom of every page.
  85.  
  86.   4. Configure the pop up menu. The script at the other end of the pop up
  87.      menu has to know where to redirect its output. This is done by editing
  88.      the FORM in the file named 0030-toc.html. More specifically, you must
  89.      change the VALUE of the ipaddress variable. If your server is on the
  90.      Internet, then change the VALUE to "0". Otherwise, change the VALUE to
  91.      the IP address you assigned yourself in the MacTCP control panel
  92.      document. By default, the distribution comes configured as if you are
  93.      not on the Internet and your IP address is 192.0.1.2.
  94.  
  95.   5. Use AppleSearch to index the folder named manuscript inside the
  96.      teaching folder. I know, I know. You probably don't own AppleSearch
  97.      because it costs too much money. Even if you did, then you are probably
  98.      serving other files with AppleSearch. Unfortunately, the "Search this
  99.      book" feature is configured in such a way that only one index can be
  100.      served from the AppleSearch server. In short, even if you wanted to,
  101.      you most likely can not use the "Search this book" feature. "Bummer,
  102.      there goes 'searchability.'"
  103.  
  104. Now that you have installed and configured the distribution, then you too
  105. can begin reading Teaching a New Dog Old Tricks.
  106.  
  107. Feel free to mirror this distibution, support the shareware, and don't
  108. hesitate to tell me what you think.
  109.  
  110. Eric Lease Morgan
  111. eric_morgan@ncsu.edu
  112. http://www.lib.ncsu.edu/staff/morgan/
  113.  
  114. ----------------------------------------------------------------------------
  115.  
  116. Eric last edited this page on September 29, 1995. Please feel free to send
  117. comments.
  118.