home *** CD-ROM | disk | FTP | other *** search
/ Techno Guide - Aspettando Windows 98 / TechnoGuide.iso / grafica / htmlimg / readme.txt < prev    next >
Text File  |  1997-09-26  |  11KB  |  325 lines
  1. README.TXT for HTML Imager 1.2a [27 September 1997]
  2. ==============================
  3.  
  4. Welcome to HTML Imager!
  5.  
  6. Author:    Eric G.V. Fookes
  7. E-mail:    fookes@sc2a.unige.ch
  8. Status:    Freeware
  9. Plateform: Windows 95, NT, or higher
  10.  
  11. Contents
  12. --------
  13.   * Introduction
  14.   * Key Features
  15.   * Installation
  16.   * Uninstalling
  17.   * How to Use HTML Imager
  18.   * Viewing Pictures Contained In The Cache
  19.   * The Next Major Version
  20.   * Updates and Other Programs
  21.   * Legal
  22.   * Distribution License
  23.   * Comments and Suggestions
  24.   * Version History
  25.  
  26.  
  27. Introduction
  28. ------------
  29. HTML Imager produces web pages showing all GIF and/or
  30. JPG pictures from the directory you select. Each
  31. picture is shown together with its file name
  32. (alphabetical order) and  size. You can also select
  33. different background colors or patterns to test the
  34. appearance of each image under the chosen conditions.
  35.  
  36. HTML Imager makes it easy to catalogue large
  37. collections of web design pictures or to produce on-
  38. line photo albums. It can also be used to view
  39. pictures stored in the cache produced by browsers such
  40. as Netscape or MS Internet Explorer.
  41.  
  42.  
  43. Key Features
  44. ------------
  45. * No need to understand HTML to use this program.
  46. * Creates HTML document based on images (GIF and/or
  47.   JPG) in selected directory.
  48. * Options let you define a background color or pattern
  49.   to use in the HTML document.
  50. * Click the View button, and you will see the HTML
  51.   document in your web browser.
  52. * Option to change the base URL (local by default) to
  53.   that of your web server. This makes it easy to
  54.   publish the resulting document on the web.
  55.  
  56.  
  57. Installation
  58. ------------
  59. There is no special procedure to follow. Just place
  60. the program and its associated files in the Windows
  61. directory or in a dedicated directory of your choice.
  62.  
  63. - Windows 3.1 / NT 3.5 users:
  64. If you want to add HTML Imager to one of your Program
  65. Manager groups, the easiest way to do it is with File
  66. Manager. Just select the file HTML-IMG.EXE and drag it
  67. from File Manager to the group where you would like
  68. its icon to appear. You can also run the program by
  69. double-clicking on it from File Manager. 
  70.  
  71. - Windows 95 / NT 4 users:
  72. The easiest way to set the HTML Imager icon on your
  73. desktop is to use Explorer. Just select the file HTML-
  74. IMG.EXE and drag it from Explorer to an unoccupied
  75. space on your desktop. You can also add a shortcut to
  76. it in your Start menu by choosing Settings / Taskbar.
  77.  
  78.  
  79. Uninstalling
  80. ------------
  81. If you have dedicated a folder for the program, just
  82. delete that folder and all its files (except files you
  83. may have saved there and want to keep!).
  84.  
  85. Otherwise, just delete HTML-IMG.EXE, HTML-IMG.INI,
  86. BKCOLORS.TXT, and this README.TXT file. All these
  87. files are located in the same directory as HTML
  88. Imager.
  89.  
  90. If you have executed HTML Imager from a CD-Rom and
  91. saved option settings, you will find the HTML-IMG.INI
  92. file in the Windows directory.
  93.  
  94. There is no need to delete items from Windows' system
  95. registry or INI files as the program does not store
  96. any information in them.
  97.  
  98.  
  99. How to Use HTML Imager
  100. ----------------------
  101. Almost every button and input field in the program
  102. offers hint information. Whenever you place the mouse
  103. cursor over a dialog box element, its hint text is
  104. displayed in the programs status bar (at the bottom of
  105. the main program window).
  106.  
  107. The first field in the program window lets you specify
  108. which type of files you would like to include in the
  109. web page. When you run HTML Imager for the first time,
  110. the default choice is GIF and JPG files. Of course,
  111. you can also specify any other graphic file type that
  112. is compatible with your browser or refine the
  113. selection of files with other wildcard criteria.
  114.  
  115. In the next step, you must select the directory that
  116. contains the files you want to view. The list box is
  117. just below the first field. You can change drive by
  118. selecting it from the drive combo box.
  119.  
  120. Use the field called "HTML Output Name" to specify the
  121. name to use for the resulting HTML file. If you leave
  122. this field blank, HTML Imager will create a temporary
  123. file that will be automatically deleted once you exit
  124. the program. If you don't specify a path name, the
  125. file will be created in the chosen directory
  126. containing the images.
  127.  
  128. If you want to use a background pattern for your web
  129. page, just enter the name in the "Background Pattern"
  130. field. Use the button on the right side of the field
  131. to browse your disk for the appropriate file. Use the
  132. next field if your prefer to have a background color
  133. rather than a pattern. Please note that you cannot
  134. have both a background pattern and a color.
  135.  
  136. Then, once you are satisfied with your settings, click
  137. on the "Filter" button. The web page will be created
  138. if the program finds files that match your search
  139. criteria (the count is displayed in the grey "Found"
  140. field). BTW, this step usually takes just a fraction
  141. of a second.
  142.  
  143. Finally, click on the "View" button to display your
  144. web page in your default browser. If nothing happens,
  145. your browser is probably not Netscape or MS Internet
  146. Explorer, or it is an old version, or it has not been
  147. installed correctly. In this case, you will have to
  148. click on the "Options" button and specify the path and
  149. file name of your browser in the "Web Browser Name"
  150. field. Note, however, that you should leave this field
  151. blank if the feature works correctly.
  152.  
  153.  
  154. Viewing Pictures Contained In The Cache
  155. ---------------------------------------
  156. Follow the procedure described above and select your
  157. browser's cache directory as the location to search
  158. for the images.
  159.  
  160. The following indicates the default directory used by
  161. some of the browsers...
  162.  
  163. Netscape Communicator:
  164. .....................
  165. C:\Program Files\Netscape\Users\???\Cache
  166. (NB: replace "???" with the appropriate name)
  167.  
  168. Netscape Navigator:
  169. ..................
  170. C:\Program Files\Netscape\Navigator\Cache
  171.  
  172. MS Internet Explorer:
  173. ....................
  174. C:\Windows\Temporary Internet Files\Cache1
  175. C:\Windows\Temporary Internet Files\Cache2
  176. C:\Windows\Temporary Internet Files\Cache3
  177. C:\Windows\Temporary Internet Files\Cache4
  178.  
  179.  
  180. The Next Major Version
  181. ----------------------
  182. Great features are planned for the next version which
  183. will hopefully be released before the end of 1997. The
  184. HTML pages produced will be fully customizable and
  185. several ready-made output formats will be included in
  186. the package. Because of the work this will involve and
  187. to support my family, I plan to make the upcoming
  188. version available as Shareware for a modest $5 USD. It
  189. will probably be sold through ideaMarket at...
  190.  
  191.    http://www.ideamarket.com/
  192.  
  193.  
  194. Updates and Other Programs
  195. --------------------------
  196. You can find updates of HTML Imager and other great
  197. Freeware/Shareware programs by visiting the 
  198. following web site...
  199.  
  200. http://www.unige.ch/sciences/terre/geologie/fookes/
  201.  
  202. This site is also the home of Super NoteTab, an award-
  203. winning Freeware text editor. It includes the popular
  204. "Editor Clipbook" tool which makes inserting HTML tags
  205. and other text items a breeze. Super NoteTab is a
  206. PC Magazine Shareware Awards 1997 finalist and is much
  207. appreciated by webmasters around the World. Try it
  208. out!
  209.  
  210.  
  211. Legal
  212. -----
  213. The author of this program accepts no responsibility
  214. for damages resulting from its use and makes no
  215. warranty or representation, either express or implied,
  216. including but not limited to, any implied warranty of
  217. merchantability or fitness for a particular purpose.
  218. This component is provided "AS IS", and you, its user,
  219. assume all risks when using it.
  220.  
  221.  
  222. Distribution License
  223. --------------------
  224. I encourage you to freely copy and distribute this
  225. Freeware version of HTML Imager to any and all who are
  226. interested in obtaining a copy, including distributing
  227. it on BBS's or Shareware distribution libraries. The
  228. package is subject to the following restrictions:
  229.  
  230. HTML Imager must be distributed as a complete package
  231. including the following 4 files:
  232.  
  233.  1. README.TXT     - this file
  234.  2. FILE_ID.DIZ    - standard ID file
  235.  3. HTML-IMG.EXE   - the program
  236.  4. BKCOLORS.TXT   - text file with color names and
  237.                      codes
  238.  
  239. If any of these files are missing, then the package is not complete and distribution is forbidden.
  240.  
  241. + The package - including all related program files
  242.   and documentation files CANNOT be modified in any
  243.   way and must be distributed as a complete package,
  244.   without exception.
  245. + You may charge a distribution fee for the package,
  246.   but you must not represent in any way that you are
  247.   selling the software itself.
  248. + You shall not use, copy, rent, lease, sell, modify,
  249.   decompile, disassemble, otherwise reverse engineer,
  250.   or transfer the licensed program except as provided
  251.   in this agreement. Any such unauthorized use shall
  252.   result in immediate and automatic termination of
  253.   this distribution license.
  254.  
  255. All rights not expressly granted here are reserved by
  256. Eric G.V. Fookes.
  257.  
  258.  
  259. Comments and Suggestions
  260. ------------------------
  261. Do not hesitate to send me your comments and
  262. suggestions. I can be reached by E-mail at:
  263.  
  264.          fookes@sc2a.unige.ch
  265.  
  266. or by snail mail at the following address:
  267.  
  268.          Eric G.V. Fookes
  269.          av. EugΦne-Pittard 22Ter
  270.          CH - 1206 Geneva
  271.          Switzerland
  272.  
  273. If you really like this program, why not contact the
  274. editors of your favorite computer magazine or
  275. newspaper, or web sites that review software, and tell
  276. them about it! That's a great way to make this
  277. software better known.
  278.  
  279.  
  280. Note: this program was written with Delphi and uses
  281. components from a Shareware VCL package called the
  282. "Super Labeled Input Controls". The package, which I
  283. developed, is available for downloading from my web
  284. site at the following URL:
  285.  
  286. www.unige.ch/sciences/terre/geologie/fookes/delphi.htm
  287.  
  288. Delphi is a trademark of Borland International, Inc.
  289.  
  290.  
  291. Version History
  292. ===============
  293.  
  294. New in Version 1.2a
  295. -------------------
  296. * HTML files produced by the program are no longer
  297.   deleted on closing.
  298. * Hidden directories are now also displayed in the
  299.   list. This makes it easier to look into the cache
  300.   produced by MS Internet Explorer.
  301. * Items added to the combo boxes and the last used
  302.   directory are now remembered between sessions.
  303. * Instructions added to this Readme file.
  304.  
  305. New in Version 1.2
  306. ------------------
  307. * Can be executed from a CD-Rom or a write-protected
  308.   disk.
  309.  
  310. New in Version 1.1
  311. ------------------
  312. * Can use registry information to communicate with
  313.   your browser (through DDE). The advantage of this
  314.   method is that HTML Imager can detect if the browser
  315.   is already open. This avoids the problem of opening
  316.   multiple instances each time you press the View
  317.   button. To enable the registry feature, you must
  318.   leave the "Web Browser Name" field empty (in the
  319.   Options dialog box). If your browser is not
  320.   compatible with this method, you will have to fill
  321.   in the "Web Browser Name" field with a fully
  322.   qualified browser name (path and program file name).
  323. * If you leave the "HTML Output Name" field blank, the
  324.   program will create a temporary file.
  325.