home *** CD-ROM | disk | FTP | other *** search
/ World Wide Web Designer's Toolkit / WWW.ISO / progs / searrt / readme.txt < prev    next >
Text File  |  1995-12-28  |  14KB  |  335 lines
  1.  
  2.                           SEARCH.EXE VERSION 1.30A06
  3.                                        
  4. Written By Robert Thivierge
  5.  
  6.    
  7.    
  8.    SEARCH.EXE is a freeware Windows 3.1 program that produces HTML Web
  9.    pages consisting of small in-line GIF images. These images can be
  10.    clicked on in a Web browser (like Netscape or Mosaic) to see the full
  11.    sized JPEG picture. The output can be customized to suit your tastes.
  12.    
  13.      _________________________________________________________________
  14.    
  15.    Note: After you have read the legal stuff, downloaded the ZIP File,
  16.    installed the program, and run it, please take the time to tell me
  17.    how it worked out.  Contact me at
  18.  
  19.      thivier1@canuck.com or thivier1@freenet.calgary.ab.ca
  20.    
  21. Table of Contents
  22.  
  23.    
  24.    
  25.      * SEARCH.EXE News
  26.      * Current Features
  27.      * Planned Features
  28.      * Program Stability
  29.      * Obtaining the Program
  30.      * Legal Issues and Credits
  31.           + Ownership
  32.           + Freeware Status
  33.           + Credits
  34.           + Disclaimer
  35.      * System Requirements
  36.      * Installation Procedures
  37.      * A Picture of SEARCH.EXE
  38.      * Known Bugs
  39.      * Contacting the Author
  40.        
  41.    
  42.    
  43. SEARCH.EXE News
  44.  
  45.    
  46.    
  47.    Version 1.3 of Search means that all the features of Search can now be
  48.    accessed with user friendly dialog boxes. Within a dialog box you can
  49.    now change any of the descriptive text that is to appear on outputted
  50.    web pages. You can attach meaningful descriptive text to individual
  51.    pictures. You can use pre-defined or user-defined fields to describe
  52.    pictures. For instance if your site consists of pictures of people,
  53.    you can have the name of the subject and/or photographer appear next
  54.    to the picture.
  55.    
  56.    The information on pictures can easily be layed out in an infinate
  57.    number of ways, such as in tables (which is the default layout). And
  58.    you can group pictures however you wish, to make them easy for people
  59.    to find the one(s) their interested in, and not feel the need to
  60.    download everything, wasting bandwidth.
  61.    
  62.    Also, the informative text you attach to pictures is not only shown
  63.    next to the picture on the web page, but is contained inside the JPEG
  64.    file. So someone downloading pictures from your site can view the
  65.    descriptive text before and after they download the pictures that
  66.    interest them.
  67.    
  68. Current Features
  69.  
  70.    
  71.    
  72.   WEB FEATURES
  73.      * For every JPEG file in your site, it creates a smaller GIF
  74.        version.
  75.      * It generates one or more HTML files which contain links to these
  76.        pictures. If you choose to have a sophisticated multi-page site
  77.        (which you don't have to) a browser of your site will be able to
  78.        traverse through all the pages by following links.
  79.      * Your site can have one more pages in any directory and any number
  80.        (zero, one, or many) sub-directories and any level of
  81.        sub-directories.
  82.      * You can have SEARCH.EXE organize pictures in different pages based
  83.        on their file names. You can use this feature in combination with
  84.        sub-directories or without sub-directories.
  85.      * You can have SEARCH.EXE automatically generate a layout for your
  86.        pictures with the "AutoOrg" button. It recognizes repeated file
  87.        name patterns (ie. cc01.jpg, cc02.jpg, etc...), and groups them
  88.        for you. Optionally you can edit this default layout.
  89.      * All text outputted in pages can be changed. You can make changes
  90.        globally that effect all pages, make changes that effect a certain
  91.        type of page, make changes that effect only a particular
  92.        directory, or effect only a particular page. You can also specify
  93.        certain text to go next to individual pictures. For instance, next
  94.        to the photo you can have the name of the subject and a
  95.        description. People using text-only browsers will especially
  96.        appreciate this. The text you specify may contain any HTML tags
  97.        you wish. Pretty much, anything that can be done in HTML can be
  98.        done with SEARCH.EXE.
  99.      * You can have any number of pictures appear on a row in a table.
  100.      * You can control the display width and height of images. SEARCH.EXE
  101.        (by default) uses the WIDTH and HEIGHT tag to tell the browser the
  102.        dimensions of a picture. This speeds up the display of your page
  103.        for browser users.
  104.      * As an optional alternative to having the Directory Index Pages
  105.        link directly to the anchor image, you can have them link to a
  106.        picture Detail Page. This detail page can optionally show the full
  107.        sized image or the reduced size image. Typically this page will
  108.        show additional information about the picture.
  109.      * You can choose from a pre-defined list of sample layouts.
  110.      * Support for the new progressive-JPEG file format. Progressive-JPEG
  111.        files take less disk space and have a fade in effect when viewed
  112.        by Netscape. You can also convert old JPEG files to the new
  113.        format.
  114.      * Customizable file extensions for HTML Web Page files produced.
  115.      * New! - You can use the Configure Layout dialog box to specify
  116.        descriptive text to appear on pages and next to pictures.
  117.        Information describing a picture (such as subject name, etc...) is
  118.        stored in the JPEG file, and can be accessed by a browser user
  119.        before and after downloading the file.
  120.        
  121.    
  122.    
  123.    If there's anything you can't get SEARCH.EXE to do when making Web
  124.    Pages, please let me know.
  125.    
  126.   OTHER FEATURES
  127.      * Inside SEARCH.EXE, if you click on a particular JPEG file you will
  128.        see the image dimensions of the file shown.
  129.      * SEARCH.EXE can be used to produce a listing of all files matching
  130.        a pattern in a directory and its sub-directories. You can limit
  131.        the listing to files that contain a string inside them. Of course
  132.        this includes comments inside of JPEG files.
  133.      * SEARCH.EXE will decode JPEG files from saved uuencoded articles
  134.        off the UseNet. Unlike most decoders SEARCH.EXE will read
  135.        information such as the "Subject" line and will store this
  136.        information in the JPEG file. This information can be used to have
  137.        SEARCH.EXE organize your pictures into logical groups.
  138.      * Without running another program, you can preview GIF images inside
  139.        of SEARCH.EXE. As well, you can double click on any file and
  140.        launch the associated program to view/edit that file.
  141.        
  142. Planned Features
  143.  
  144.    
  145.    
  146.    These are features I would like to implement if I get feedback on
  147.    their usefullness.
  148.      * Provide an easy built-in way to package files to be uploaded to a
  149.        UNIX box.
  150.      * Allow finer control over the size of GIF files created.
  151.      * Let the user choose between GIF and JPEG format for in-line
  152.        images.
  153.      * Allow the user to use GIF files as anchor files.
  154.      * Allow the user to group picture files onto different pages based
  155.        on the values in user defined fields. Pictures with the same value
  156.        in a given field would go on the same page.
  157.        
  158.    
  159.    
  160.    
  161.    
  162.    
  163.    
  164. Program Stability
  165.  
  166.    
  167.    
  168.    This program still has bugs that I am working out. However, it seems
  169.    to work OK for me and other users. Remeber you are using my program at
  170.    your own risk. There is no warranty.
  171.    
  172.    
  173.    
  174. Obtaining the Program
  175.  
  176.    
  177.    
  178.    If you are viewing this document on the Web, just load this anchor to
  179.    disk and follow the installation procedures later in this file.
  180.    Otherwise you should go to http://www.canuck.com/~thivier1/search.html
  181.    to view the on-line version of this document or mail me at
  182.    thivier1@freenet.calgary.ab.ca or thivier1@canuck.com.
  183.    
  184.    
  185.    
  186. Legal Issues and Credits
  187.  
  188.    
  189.    
  190.   OWNERSHIP
  191.   
  192.    
  193.    
  194.    SEARCH(c) 1995
  195.    The Picture Page Generator
  196.    Written by Robert Thivierge
  197.    All rights reserved by Robert Thivierge
  198.    
  199.    Any attempt by a person other than myself to reverse compile, sell, or
  200.    to represent the program as their own is prohibited. You may give a
  201.    copy of the the program to someone else free of charge, provided you
  202.    include all the files you received yourself. They then should notify
  203.    me of receipt of it.
  204.    
  205.    However, any person or organization may distribute my program as
  206.    freeware. They may charge a fee for the service of distribution (such
  207.    as on-line charges, charge for distribution media, etc...). An
  208.    acceptable form of distribution is including my program on CD-ROMs
  209.    containing freeware/shareware, where there is a charge for the CD-ROM.
  210.    However, it must be understood that they are not selling my program.
  211.    And absolutely nobody, but me, may imply or suggest that they authored
  212.    this program or that it is their property. I must always be given full
  213.    credit.
  214.    
  215.   FREEWARE STATUS
  216.   
  217.    
  218.    
  219.    This program is freeware. I do not require financial payment for use
  220.    of this product. Since users benefit from my time I think its fair to
  221.    ask for some feedback. I like to know everytime someone gets my
  222.    software and every time someone uses it for the first time. I also
  223.    like suggested improvements, and friendly constructive criticism. I
  224.    also appreciate being sent the URLs of sites made with the program.
  225.    There is a special form to collect user responses, located at
  226.    http://www.canuck.com/~thivier1/survey.html. You are always encouraged
  227.    to let me know by e-mail what you're doing with and how its going with
  228.    my program at thivier1@freenet.calgary.ab.ca or thivier1@canuck.com.
  229.    Remember, one of my main rewards for making this program is seeing
  230.    sites made with it.
  231.    
  232.    
  233.    
  234.   CREDITS
  235.   
  236.    
  237.    
  238.    I appologize to all the people who have helped with suggestions, for
  239.    not taking the time to give individual credit where due. I hope to
  240.    attempt to do so when I have some more time. Your help is very much
  241.    appreciated.
  242.    
  243.      * This software is based in part on the work of the Independent JPEG
  244.        Group. They are kind enough to allow programmers to use their code
  245.        library without financial charge.
  246.      * The Graphics Interchange Format(C) is the Copyright property of
  247.        CompuServe Incorporated. GIF(SM) is a Service Mark property of
  248.        CompuServe Incorporated.
  249.      * The actual compression method used in GIF is copywrited by Unisys
  250.        Corporation. I thank them for allowing freeware authors to use
  251.        their compression method without obtaining a license or paying
  252.        royalties. See the Unisys FAQ on GIF for further details.
  253.      * The tabbed dialogs in SEARCH.EXE were made with the source code
  254.        for TabDlg.DLL. TabDlg.DLL is Copyright (c) 1994 Edward McCreary
  255.        
  256.    
  257.    
  258.   DISCLAIMER
  259.   
  260.    
  261.    
  262.    Use my program at your own risk. There are bugs I know of, there are
  263.    bugs I don't know of. I assume no liability for any losses incurred by
  264.    use of my program. I myself half accidently overwritten files and
  265.    deleted files with SEARCH.EXE. So, if I can loose stuff, you can too.
  266.    
  267.    
  268.    
  269. System Requirements
  270.  
  271.      * Operating System: It was designed for Windows 3.1. Users have also
  272.        run it on Windows 95 and Windows NT OK.
  273.      * Memory: The amount required is semi-proportional to the size of
  274.        the largest JPEG picture you wish to compress.
  275.        
  276.    
  277.    
  278. Installation Procedures
  279.  
  280.    To install, do the following:
  281.     1. Make a directory for the program (such as C:\SEARCH). It is very
  282.        important that you have a directory set aside exclusively for
  283.        SEARCH.EXE. Never use the same directory for the program that you
  284.        use for your Web Site.
  285.     2. Copy the ZIP File into it.
  286.     3. Unzip it with PKUNZIP or a compatible program.
  287.     4. If you're upgrading, you may wish to keep your old *.txt files and
  288.        SEARCH.INI file, in order to preserve your layout and settings.
  289.        The only files that should always be updated is SEARCH.EXE and
  290.        SEARCH.HLP.
  291.     5. Make sure all the files are in the same directory, with no other
  292.        files present. Never use this directory to put your pictures or
  293.        HTML files in.
  294.     6. Double click on SEARCH.EXE in the File Manager or create an icon
  295.        for it in the Program Manager. To create an icon in the Program
  296.        Manager, simply drag the file from the File Manager to the Program
  297.        Manager.
  298.     7. Click on the "Settings" button and make sure they are all as you
  299.        wish.
  300.        
  301. A Picture of SEARCH.EXE
  302.  
  303.    
  304.        
  305.        If you are viewing this document on the web you can view a picture
  306.        of SEARCH.EXE running.
  307.        
  308.        
  309.        
  310. Known Bugs
  311.  
  312.    
  313.        
  314.        Please tell me of any bugs not on this list.
  315.          1. Periodically Search will cause a General Protection Fault. If
  316.             this happens let me know all the details of how it happened.
  317.          2. Although Search will now let you use the "html" file
  318.             extension for output, it still can only read the old 8.3 file
  319.             name format. So, it's best to have the "Always Purge HTML
  320.             First" setting selected, in order to remove any long file
  321.             names that may cause a problem.
  322.    
  323.        
  324. Contacting the Author
  325.  
  326.    
  327.        
  328.        You are welcome to contact me with your comments, suggestions, and
  329.        bug reports at either thivier1@freenet.calgary.ab.ca or
  330.        thivier1@canuck.com.
  331.        
  332.        
  333.        
  334.        Visit my Home Page at http://www.canuck.com/~thivier1
  335.