home *** CD-ROM | disk | FTP | other *** search
/ Hot Shareware 35 / hot35.iso / ficheros / 9INET / 6PACKV3.ZIP / SEARCHLI.ZIP / README.TXT < prev    next >
Text File  |  1998-02-16  |  11KB  |  224 lines
  1. //////////////////////////////////////////////////////////////
  2. Please Load the file SeaDemo1.html into your web browser!
  3. You may redistribute these shareware files. 
  4. Searchlink Demo V 3.0 This is a Demonstration Version Only!
  5. ////////////////////////////////////////////////////////////// 
  6. PLEASE READ THE HTML VERSION OF THIS DOCUMENT!!
  7.                                 SearchlinkV3
  8.       ⌐Searchlink Search Engine description and instructions
  9. Working Demonstration
  10. Part1 General Description
  11. Part2 Creating the Search links file
  12. Part3 Setting Up Searchlink on your page
  13. Part4 Common problems and solutions
  14.  
  15.  
  16.  
  17.  
  18.      Part1 General Description
  19.      Searchlink can be included on any html webpage and does not require a Java server. Web site guests use Searchlink in
  20.      a similar way to other Internet search engines, once a list is returned the links can then be followed with a single click
  21.      over the appropriate link name. The links themselves are stored and formatted in a text file, this allows easy editing and
  22.      fast access. Like many other search engines Searchlink allows for ôall wordö or ôany wordö searches. These keywords
  23.      are compared with the keywords you supply when creating the links text file. (The links text file will be discussed in
  24.      much greater detail later) 
  25.  
  26.      Part2 Creating the Search links file
  27.      Before setting up Searchlink on your page it is advised that you are familiar with the example Search2.txt links file.
  28.      Creating your own links file is as easy as creating an html file. 
  29.      1: Open a new text file in your favorite text editor "word processor". 
  30.      2: Each link must occur on itÆs own line within the links file. 
  31.  
  32.      <Full Url><Name to appear as link>any keywords which may be appropriate 
  33.  
  34.      3: Use one line per link and format as follows. ( you must start from the very first line of the file) 
  35.      Example of a links file Search2.txt 
  36.  
  37.      <http://www.microsoft.com><Microsoft>windows 95 office excel 
  38.      <http://www.yahoo.com><Yahoo >Search engine find lookup 
  39.      <http://silk.webware.co.nz/><Silk Webware>java programming webpage graphics applets 
  40.  
  41.  
  42.      Note that the URL and the Name are included within < > each respectively and the keywords follow afterwards. It is
  43.      very important that the links are formatted in this way, Search link will not understand any other format. 
  44.      <http://silk.webware.co.nz><Silk Webware>applets java webpage design 
  45.  
  46.      4: When selecting your keywords forget about case, it is irrelevant. Try to use the longest version of the words.
  47.      Example, rather than using the word "design" use "designing" or "designer" these words still contain the word "design"
  48.      which Searchlink will find, as well as the longer words if required. 
  49.      5: Continue to fill each line with a new link in the format discussed. Note:Searchlink searches from the top of the list of
  50.      links first so when your adding new links add them to the top of the list so they will show first in the search. 
  51.      6: You can now name and save this file as a text (.txt) file, the name you give it must be used later in the applet
  52.      parameters (More about that later). 
  53.  
  54.      Part3 Setting Up Searchlink on your page
  55.      Searchlink is easy to set up and use, if you have any trouble please do not hesitate to email us at
  56.      support@silk.webware.co.nz. Without a RegistrationID, Searchlink will display "unregistered version", this message is
  57.      not displayed if you have a correct RegistrationID. 
  58.      1: Simple setup: RegistrationID and the links file Note sample files afSearchlink.html and Search2.txt are included
  59.      SearchDemo.html 
  60.  
  61.      <applet
  62.      code=afSearchlink.class
  63.      width=300
  64.      height=200 >
  65.      <param name=RegistrationID value="Q7182">
  66.      <param name=ListName value="Search2.txt">
  67.      </applet> 
  68.  
  69.      In the simplest setup these html tags are included on the page that you wish Searchlink to be on. Within the same
  70.      directory as this html file you must include the two files afSearchlink.class and afSearch2.class and the links file (ie
  71.      Search2.txt) which contains the link names, urls and keywords; (A full description of how to construct this file was given
  72.      earlier, you may wish to open the search2.txt file in a text editor ôword processorö to get a general idea of its format) 
  73.  
  74.      Once you have purchased your RegistrationID enter it in as a parameter; Note: Each RegistrationID is unique and is to
  75.      be used in accordance with the Single site License Searchlink will display Unregistered version if the incorrect
  76.      RegistrationID is used, when on the internet
  77.  
  78.      "if your RegistrationID is du8765 then the following will work" 
  79.      <param name=RegistrationID value="du8765"> 
  80.  
  81.  
  82.      2: Simple setup: Height Width parameters The height of searchlink must always be set to 200, however if you wish
  83.      to increase or decrease the width you can. 
  84.  
  85.      <applet
  86.      code=afSearchlink.class
  87.      width=500
  88.      height=200 >
  89.      <param name=RegistrationID value="RegistrationID">
  90.      <param name=ListName value="Search2.txt">
  91.      </applet>
  92.  
  93.  
  94.      3:Optional setup: Frame parameter With this version of Searchlink we have included the option of allowing the
  95.      ôLinkedö page to be opened in the frame of your choice. If you decide to ignore this option, Searchlink will open the
  96.      page in the current frame . The following are the values which are currently accepted. Searchlink follows the current
  97.      standard HTML conventions with respect to frames. 
  98.  
  99.      "_self" ---show in the current frame <default> 
  100.      "_parent" -----show in the parent frame 
  101.      "_top" -----show in the top most frame 
  102.      "_blank" ------show in a new unnamed top-level window 
  103.      <other> -----show in new top-level window named <other> 
  104.  
  105.      Example:
  106.  
  107.      This will cause Searchlink to open the "linked" page in a new unnamed top-level window. 
  108.  
  109.      <applet
  110.      code=afSearchlink.class
  111.      width=300
  112.      height=200 >
  113.      <param name=RegistrationID value="RegistrationID">
  114.      <param name=ListName value="Search2.txt">
  115.      <param name=Frame value="_blank"> </applet>
  116.  
  117.      4:Optional setup: BackImage parameter Some designers have asked that we include a background image, this
  118.      allows you to improve the general appearance of Searchlink. You may wish to set this parameter to the current
  119.      background of the page. Please experiment with BackImage as certain colors and patterns can enhance the general look
  120.      dramatically. Please note that only .jpg and .gif formats are acceptable. Hint: keep the patterns and colors within the
  121.      graphics files as soft as possible. Searchlink will automatically "wallpaper" the Search Engine, so the size of the image is
  122.      not important, however larger images take longer to load. 
  123.  
  124.      <applet
  125.      code=afSearchlink.class
  126.      width=300
  127.      height=200 >
  128.      <param name=RegistrationID value="RegistrationID">
  129.      <param name=ListName value="Search2.txt">
  130.      <param name=Frame value="_self">
  131.      <param name=BackImage value="marble2.gif">
  132.      </applet>
  133.  
  134.      5:Optional setup: GreenList parameter 
  135.  
  136.      If you set GreenList to true the displayed list will be green, if set to false it will be red. The default color is green. 
  137.  
  138.      <applet
  139.      code=afSearchlink.class
  140.      width=300
  141.      height=200 >
  142.      <param name=RegistrationID value="RegistrationID">
  143.      <param name=ListName value="Search2.txt">
  144.      <param name=Frame value="_self">
  145.      <param name=BackImage value="marble2.gif">
  146.  
  147.      <param name=GreenList value="true">
  148.  
  149.      </applet>
  150.  
  151.      6:Full Setup Example This sample setup shows all the HTML tags required show the marble2.gif both as the
  152.      background of the the html page and as the background of Searchlink. 
  153.  
  154.      <html>
  155.      <head>
  156.      <title>Searchlink Search Engine</title>
  157.      </head>
  158.      <body background="marble2.gif">
  159.      <br><br><br><br><br>
  160.      <center>
  161.  
  162.      <applet
  163.      code=afSearchlink.class
  164.      width=300
  165.      height=200 >
  166.      <param name=RegistrationID value="RegistrationID">
  167.      <param name=ListName value="Search2.txt">
  168.      <param name=Frame value="_self">
  169.      <param name=BackImage value="marble2.gif">
  170.      <param name=GreenList value="true">
  171.  
  172.      </applet>
  173.  
  174.      </center>
  175.      </body>
  176.      </html> 
  177.  
  178.      Part4 Common Questions and Remedies; 
  179.      The most Common mistake webpage designers make when using Searchlink is incorrect "case". Follow the
  180.      sample html files using uppercase and lowercase respectively. 
  181.  
  182.  
  183.      Q1: Why canÆt I see the Searchlink on my page? 
  184.      a: You may have made a mistake in the HTML tags used to embed Searchlink on your page. Check both the Spelling
  185.      and the Case. 
  186.      b: Have you included the appropriate .class files in the same directory as the page containing Searchlink The following
  187.      are both required.
  188.  
  189.      afSearchlink.class
  190.      afSearch2.class
  191.  
  192.      c: Are you using a Java enabled browser? Find out how to get one. Most browsers released today are Java enabled. 
  193.  
  194.      Q2: Why wonÆt my ôlinkedö page open? 
  195.      a:Have you referred to your links text file with the exact same name in your parameters? ie.If your links file is called
  196.      Search2.txt then the following is correct 
  197.  
  198.      <param name=ListName value="Search2.txt"> 
  199.  
  200.      b: Does the formatting of the links file follow these strict rules?......1 link per line....... ......<> around both the URL
  201.      ôaddress of the linkö and the name of the link...........the keywords should not be surrounded by any ôbracketsö.....there
  202.      should be no lines left blank. 
  203.      c Is the link still valid? 
  204.      Q3: Why does Searchlink display "Unregistered version!"
  205.      a:Do you have a correct RegistrationID, check the sequence and case.
  206.      b:Is the Version of Searchlink afSearchlink "Searchlinkv3" this is the only version that accepts RegistrationID, "Older
  207.      versions that accept UserCodes will not accept RegistrationID" 
  208.      c: If you have a RegistrationID and Searchlink still displays Unregistered version!, Email us at
  209.      support@silk.webware.co.nz, we will check out the problem for you. 
  210.  
  211.      Q4: Why is there no background image? 
  212.      a: Check your Html parameters, spelling and case 
  213.      b: The image you are referring to may be a .gif not a .jpg (vs/vs) 
  214.      c: Is the image file in the same directory? 
  215.  
  216.      Q5: I have just changed the parameters of the Searchlink, Search engine but it appears the same as before. 
  217.      a: You must reload the page in a new browser window, and completely clear the cache.
  218.  
  219.  
  220.                If you have any questions regarding the correct setup of Searchlink, please email us at
  221.           support@silk.webware.co.nz For more exciting webpage enhancements please visit Silk Webware
  222.                                             at Silk Webware
  223.  
  224.