home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format 98 / af098sub.adf / gallery.LZX / Gallery / Gallery.doc < prev    next >
Text File  |  1990-06-03  |  5KB  |  155 lines
  1. Gallery - (c) 1996,97 by Markus Hillenbrand
  2. ===========================================
  3.  
  4.  
  5.  
  6. PURPOSE
  7.  
  8.     This program is intended for creating nice looking HTML pages with small 
  9.     thumbnails of pictures. It creates a gallery where you can click through 
  10.     (in order to see the pictures). 
  11.     This piece of software is written in a forthcomming C++ class library for 
  12.     the Amiga, which is easy to use and intuitive. If you are interested in 
  13.     this class library, feel free to contact me. 
  14.     
  15.  
  16. REQUIREMENTS
  17.  
  18.     Amiga Operating System v 39
  19.     GfxCon 1.7 (included in the package)
  20.     web browser which can handle tables and frames (only in order to see the results)
  21.     
  22.     
  23. INSTALLATION
  24.  
  25.     You only have to click on the «install» icon. If you want to install it 
  26.     by hand, just copy the executable «Gallery» to any place on your hard disk
  27.     (if you want to use it from shell, this place must be in your path), and 
  28.     make shure that «GfxCon_68020» is in your path.
  29.     
  30.     
  31. USAGE FROM CLI
  32.  
  33.     Synopsis:
  34.     
  35.       Gallery STARTDIR/A,MAXENTRIES/N,BGPATTERN
  36.         
  37.     Arguments:
  38.     
  39.       STARTDIR:  The directory to scan. All subdirectories will be scanned, 
  40.                  too. This directory will then contain a file named 
  41.                  «index.html» which will be the starting point for your web 
  42.                  browser.
  43.                  
  44.       MAXENTRIES:The number of lines each gallery will have, and each line
  45.                  has four pictures. Values between four and 200 are accepted.
  46.                  
  47.       BGPATTERN: A file name of a picture that will be used as default back-
  48.                  ground pattern in all generated html files. This file name 
  49.                  must be relative to STARTDIR. NEVER use a absolute file name 
  50.                  for this argument, your web browser won't work properly.
  51.         
  52.     Examples:
  53.  
  54.       1.> Gallery Pictures:StarTrek trek.gif
  55.         
  56.       This will create a gallery in Pictures:StarTrek named index.html. 
  57.       The background pattern will be Pictures:StarTrek/trek.gif.
  58.     
  59.       2.> Gallery dh5: 6
  60.     
  61.       This will create a gallery for the whole dh5: partition. There won't 
  62.       be a pattern, but if there are more than 4 * 6 = 24 pictures in any
  63.       subdirectory, more galleries will be created
  64.         
  65.         
  66. USAGE FROM WORKBENCH
  67.  
  68.     Just click on the program's icon and the window will pop up.
  69.     Any function the window offers is described in the botton line
  70.     of the window. Just move the mouse around.
  71.  
  72.         
  73.         
  74. HISTORY
  75.     
  76.     Gallery 39.2:
  77.       Galleries are now shown in frames
  78.       GfxCon is now called correcty with '"' for filenames
  79.       MAXENTRIES has a minumum of 3 now
  80.       There are five rows now instead of four
  81.       
  82.     Gallery 39.1:
  83.       Graphical user interface added
  84.       MAXENTRIES added
  85.       Gallery entries will be sorted by name
  86.       changed version numbering to style guide
  87.               
  88.     Gallery 1.0:
  89.       First release for aminet
  90.             
  91.             
  92. FUTURE
  93.  
  94.     These features might be added to future versions:
  95.     
  96.     - more control of generated html files
  97.  
  98.         
  99.         
  100. COPYRIGHT
  101.  
  102.     Gallery (c) 1996,97 by Markus Hillenbrand
  103.     
  104.     Permission is granted to make and distribute verbatim copies of this
  105.     manual provided the copyright notice and this permission notice are
  106.     preserved on all copies.
  107.  
  108.     No guarantee of any kind is given that the program described in this
  109.     document is 100% reliable. You are using this material at your own risk.
  110.     The author *can not* be made responsible for any damage which is caused
  111.     by using these programs.
  112.  
  113.     This package is freely distributable, but still copyright by
  114.     Markus Hillenbrand. This means that you can copy it freely as long as you
  115.     don't ask for more than nominal copying fee.
  116.  
  117.     Permission is granted to include this package in Public-Domain collections.
  118.     The distribution file may be uploaded to Bulletin Board Systems or FTP 
  119.     servers. If you want to distribute this program you must use the unmodified
  120.     distribution archive.
  121.  
  122.     Gallery must NOT be included or used in commercial programs unless by
  123.     written permission from the author. 
  124.  
  125.     Gallery must NOT be used on any machine which is used for the research,
  126.     development, construction, testing or production of weapons or other
  127.     military applications. This also includes any machine which is used for
  128.     training persons for *any* of the above mentioned purposes.
  129.  
  130.  
  131. REGISTRATION
  132.  
  133.     Well, this package is not crippled anyhow. But please tell me if you use
  134.     the program. So I can decide whether to continue this work or not.
  135.     Just send me an e-mail or a post card.
  136.     
  137.  
  138.  
  139. AUTHOR
  140.  
  141.     The author can be reached as:
  142.     
  143.       Markus Hillenbrand
  144.       Mannheimer Straße 28
  145.       67655 Kaiserslautern
  146.       GERMANY
  147.         
  148.       E-Mail: Markus.Hillenbrand@t-online.de
  149.               m_hillen@informatik.uni-kl.de
  150.                         
  151.       Internet: http://www.student.uni-kl.de/~hillenbr
  152.         
  153.       Telephone:    (+49) 631/696561
  154.  
  155.