_________________________________________________________________ (c) by Davor Zorc, Zagreb, Croatia, 1997. лллллллллл л м м л л л лллллллллл PROGRAM : WebCache л л ллл ллл DOCUMENT: USER'S GUIDE OttoSoft VERSION : 3.10 DATE: 01/11/1997 _________________________________________________________________ SUMMARY: 1. INTRODUCTION 1.1 Description & Purpose 1.2 Hardware & other requirements 1.3 Installation Guide 2. USING THE PROGRAM TO SCAN CACHE 2.1 Limitations 2.2 Troubleshooting 3. OPTIONS 4. USING THE PROGRAM TO SCAN BOOKMARKS 5. USING THE PROGRAM TO SAVE PAGES 6. LEGAL 7. ORDER FORM - REGISTRATION 8. ACKNOWLEDGEMENTS 9. MESSAGE DIALOGUES 10. REVISIONS HISTORY _________________________________________________________________ 1. INTRODUCTION ------------------- 1.1 Description & Purpose ----------------------------- The Internet provides a huge selection of web sites for "surfers". These sites contain pages brimming with rich graphical content and informative text. Netscape's File|Save provides a way to save a page in the computer for later viewing - unfortunately it doesn't save the graphics that would add much more enjoyment to our off-line browsing. WebCache to the rescue!... Making use of a little known or understood Navigator resource called the cache, WebCache recaptures both the text and graphics and saves it in a way that permits Netscape to revisit the web site off-line and at your convenience. Click a link and then navigate the Web site reliving the excitement, saving pages or making bookmarks. WebCache can be used with Netscape Navigator ver. 2.0x and 3.0 as a utility for off-line browsing. When activated it will make CACHE.HTM Web page. This page is the sorted list of all http, gopher and ftp addresses of files which exist in local cache. While Navigator saves and displays only the last 10 addresses, the number of addresses WebCache displays is unlimited. The CACHE.HTM list may also be used while surfing on-line (when connected to Internet). Pages displayed from the cache may be named and saved using Navigator. While CACHE.HTM is just an index of what is currently there in cache, complete pages (with pictures) may be saved permanently on local disk. Once saved, pages may be copied to other disk/ diskette/ computer. This is done with WebCache Go | Save option. Other uses of WebCache include filtering of BOOKMARK.HTM and make it printable with visible addresses. WebCache has 3 menus: Go, Options and Help. Functions Scan Cache, Scan Bookmarks and Save pages may be accessed through Go menu or using buttons on main screen. Only difference is that when using buttons WebCache will close itself after performing function. Options apply to all 3 functions. Functions are independent and there is no particular order in which they are used. 1.2 Hardware & other requirements ------------------------------------- IBM-PC 386 or better running Windows 3.10, 3.11 or Windows 95, VGA card with 256 or more colors, 250 kByte hard disk space and Netscape Navigator ver. 2.0x or 3.0x (regular or Gold). 1.3 Installation Guide --------------------------- Win 3.1x Installation --------------------- First unzip distribution file webcaXXX.zip to any directory. Then copy WEBCACHE.EXE and WEBCACHE.HLP to Navigator main directory (this is directory which contains CACHE subdirectory, usually named NETSCAPE). Do this using File manager. In Windows 3.1x program manager click on Netscape group to open it. Make File manager window small to be able to see Netscape group. Then Drag and Drop WEBCACHE.EXE from File manager file list to Netscape group. Alternatively, you may use Program manager File|New|Program_Item to add this program to Netscape group. In Command_line type WEBCACHE.EXE for example: "c:\netscape\webcache.exe". As working directory type-in Navigator main directory name, for example: "c:\netscape". Win 95 Installation ------------------- First unzip distribution file webcaXXX.zip to any directory. Then copy WEBCACHE.EXE and WEBCACHE.HLP to Navigator main directory (this is directory which contains CACHE subdirectory, usually named NETSCAPE\NAVIGATOR). Do this using Explorer. Then Drag and Drop WEBCACHE.EXE from Explorer file list to Desktop main screen to create shortcut, or add this file to Navigator group. 2. USING THE PROGRAM TO SCAN CACHE -------------------------------------- 1.) Run WebCache before you want to browse pages off-line. Click on 'Go' then 'Scan Cache' and wait for message. Click on 'Ok'. 2.) Run Netscape Navigator. In Navigator use File| Open file to view CACHE.HTM file. Then click on desired address, then you may click further on colored (visited) addresses. Return to CACHE.HTM file using menu: Go|* Local cache *. You may wish to add CACHE file to bookmarks to access it later as any other location. CACHE.HTM list is sorted alphabetically by page addresses. To avoid messages saying that connection is not established, change Navigator NETWORK PREFERENCES. Option should be: - CACHE | Verify documents: NEVER When you want to use Navigator on-line again, restore this option to what it was before. Tips ---- A good on-line browsing technique would be to quickly visit all pages at a web site. Navigator will place a copy of each page in the cache where it will be readily available for later cache browsing. Set a large Cache size (5 or 10 MBytes), in Netscape's Network Options. If you "forgot" to make a bookmark while on-line make one while cache surfing. (Bookmarks | Add a Bookmark) 2.1 Limitations ------------------- If there are more than 2000 addresses extracted, or if length of an address is longer than 150 characters then address checking for duplicates and address sorting is skipped (for those addresses). Those addresses appear on top of the listing. 2.2 Troubleshooting --------------------- a) WHAT IF IT DOES NOT WORK? - maybe you used WebCache while Navigator was active. You should quit Navigator first, wait 15 seconds for Navigator to update cache in background and then start Webcache. If Navigator was active, at best you get incomplete CACHE.HTM or Webcache report unaccessible input file. Do not turn-off computer while Navigator is running. - maybe the cache is empty or size is set to zero. - make sure WEBCACHE.EXE is in Navigator main directory. - make sure Navigator main directory has subdirectory named CACHE, in Navigator check this in: Network preferences | Cache menu. - new Navigator version should be installed over old one in same directory. Same goes for WebCache updates. - Working directory for Webcache should be correctly declared in Program manager. - clicking on context sensitive maps do not work off-line. b) IT WORKS BUT THERE ARE ADDRESSES IN CACHE.HTM WHICH SEEM NOT TO EXIST IN LOCAL CACHE ? - CACHE.HTM may be old. On each run of Navigator some pages are added and many may be deleted. Rerun WebCache! - Pages were partially loaded. Even if page was complete and then it is reloaded partially, it seems that some contents is lost. - Try "Clear disk cache" button in Network preferences| Cache menu to start new cache. - WebCache does not change cache contents in any way. It just show what there is according to Cache bookkeeping file. 3. OPTIONS -------------- All options apply to Scan Cache, Scan Bookmarks and Save pages except Server separation which do not apply to Scan Bookmarks. Check option 'Filter| http' or 'ftp' or 'gopher' before 'Scan Cache', 'Scan Bookmarks' or 'Save Pages' if you wish to include only checked type of service. You may check more than one. Check option 'Filter| List Pictures' before 'Scan Cache', 'Scan Bookmarks' or 'Save Pages' if you wish to have .gif and .jpg pictures listed in CACHE.HTM, BOOKLIST.HTM or _INDEX0?.HTM. In case of Cache scanning or Saving pages, those pictures are already specified in HTML pages but here you may view them separately. Check option 'Show| titles' if you want page titles listed. Check option 'Show| addresses' if you want addresses visible in output list. Check option 'Show| server separation' if you wish that CACHE.HTM or _INDEX0?.HTM list have addresses separated for each server. Click option 'Echo address' if you wish to see URL addresses while scanning. 4. USING THE PROGRAM TO SCAN BOOKMARKS ------------------------------------------ Navigator keep bookmarks in the file BOOKMARK.HTM. Menu Go | Scan Bookmark enables filtering of BOOKMARK.HTM and also it can make bookmarks printable with visible addresses. It produces BOOKLIST.HTM file, which you may view by Navigator menu File | Open file or print by File | Print. All options apply to Scan Bookmark except Server separation. 5. USING THE PROGRAM TO SAVE PAGES ------------------------------------- As you know, cache contents is of temporary nature. If one wants to save page(s) permanently, selected pages and its pictures must be copied into separate directory and then addresses on those pages must be changed (localized) to point to local files instead of remote sites. Always close Navigator before saving pages. Use Go | Save pages to save complete pages. Type address of the page you want to save or only server address if you want all pages from this server to be saved. Any unique part of the address may be entered. If you don't know exact address, or what is available, first use WebCache to Scan cache. Then in Navigator, click on desired address with right mouse button and choose: Copy this link location. Close Navigator and open Save pages in WebCache. When cursor is on address field press Shift-Ins key to paste address. Then you may edit this address to leave only server name, if you wish to save all the pages from this server. For example: assume the web site (server) name is http://www.mapworld.com and the pages you viewed were: http://www.mapworld.com/GreeceMap.htm http://www.mapworld.com/IndonesiaMap.htm and http://www.mapworld.com/CroatiaMap.htm a) To save all pages at this server - type: mapworld b) To save a single page - type: mapworld.com/CroatiaMap (or mapworld.com/GreeceMap or mapworld.com/IndonesiaMap) c) To save GreeceMap AND CroatiaMap - type: GreeceMap,CroatiaMap You may save all or some visited pages from several servers, for example typing: www.yahoo.com,ftp.borland.com,www.tel.fer.hr/index.html NOTE: a comma is used to separate entries. Number of entries is not limited but total length of addresses is 250 characters. A shortcut address which will save EVERYTHING in the cache is '/' (without the quote marks). Check free disk space first. Next type-in name of local directory to be used to copy those files. If this directory exist and is not empty, user will be asked if he wishes to delete existing files or to use it as is. If old files had index _INDEX0a.HTM and files are not deleted, new index will be _INDEX0b.HTM. It is not recommended to put too many files in a single directory (more than 1000): saving will take longer and there may be problems with naming local files or DOS file system. There are two Save options: [] follow other links - to copy also pages which addresses are contained on desired (found) pages (if those pages are also in cache), [] delete exist. files - if desired local directory exists and contains files, using this option will delete it first without asking. Before saving files you might want to alter appearance of _INDEX0?.HTM file which will be found in Localization directory. Do it by changing Options | Filter and Options | Show. SAVING REMARKS - Localized addresses are marked on pages with *. - Original (home) address of the page is saved under "reload" link on the end of localized page (if Show| addresses is checked). - It is best to save pages immediately after closing Navigator because on next Navigator session some items might be deleted. - Since there are many pages which do not follow strictly HTML standard, there is no guaranty that all pages or all pictures on a page will be completely localized. - When you save all that is worth your attention, it is recommended to "Clear disk cache" in Navigator: Network preferences| Cache menu. Working with small cache is quicker and more accurate. 6. LEGAL ------------ This program is tested and believed to be free of bugs. There is however no guarantee that this program will perform expected duty, and that will not harm your machine, data or user in any way. Mentioned hardware and software products are (C) of their producers. This program is SHAREWARE and requires payment to the author. Commercial use requires license by the author. You may re-distribute unmodified package to BBS, Internet, CD-ROM, providing: - no money is charged for this program - you must email the author what version you are going to publish and in what product (so the author is able to send new version). 7. ORDER FORM - REGISTRATION -------------------------------- This program is SHAREWARE and requires payment to the author. It is the full feature version and free to test for 1 month. After 1 month you will have to register to have full version. Feel free to write me comments using e-mail or picture-card. PRICE PER USER: 10 US$ or equivalent in convertible currency. Add 5 US$ if you want to get new/ registered version on diskette. If you find this program useful please send cash in opaque letter or bankers check payable to: Davor Zorc Istarska 51 10 000 Zagreb Croatia e-mail: davor.zorc@fsb.hr Experience shows that personal checks from USA and European Union banks are accepted. According to your satisfaction with program, state of your finances or state of your country, do modify above sum. Money you send will be used for future program improvements. BETTER YET, send music CD or cassette of popular/ethnic/jazz/rock music of YOUR country! (instead of money, to the above address). Registered version and also new versions will be sent to registered users as encoded e-mail or to ftp address you supply or on diskette. Latest version may be found on SimTel repository: ftp://oak.oakland.edu/pub/simtelnet/win3/inet/webcaXXX.zip or WinSite (CICA): ftp://ftp.winsite.com/pub/pc/win3/winsock/webcaXXX.zip or using browser at http://www.winsite.com and search for: webca. There are many mirror sites of those archives around the world. When you send Registration form by mail or e-mail and the money, you will receive Registration Name and Registration Code which you may enter in menu Go | Register to make unlimited registered copy. Once registered, the same menu item will show your name. If you are now in Windows Help program you may click on Edit menu, use mouse to highlight order form, then click Copy. Open Notepad and click Edit | Paste. Fill in form and print it. There is also ORDERFRM.TXT in original archive. <-------------------------- cut here order form --------------------------> ___________________________________________________________________ Registration form for : WebCache webca310.zip View and save pages from Navigator local cache ___________________________________________________________________ Name:____________________________ Address: ________________________ City, State: ____________________________ Country: ________________ Zip:__________________ E-mail/ftp: _______________________________ Windows version:_____ Navigator ver.:______ WebCache ver.:_____ Delivery: 3 1/2" diskette (price US$ 15) [ ] e-mail (US$ 10) [ ] Included US$:_____________ cash [ ] check [ ] Comments, suggestions for future updates, bugs, complaints: ___________________________________________________________________ ___________________________________________________________________ ___________________________________________________________________ Where did you get this file: ___________________________________________________________________ <-------------------------- cut here order form --------------------------> 8. ACKNOWLEDGEMENTS ------------------------ Many thanks to Peter Rader for his suggestions and help on making help file. I also want to thank many users from USA, Germany, Pakistan, Britain, Brasil, Spain, France and other countries for their comments and support. 9. MESSAGE DIALOGUES ------------------------ Here is the list of all message dialogues: 1 XXX Addresses found (successful Scan Cache - happy you!) In Navigator use: File/ Open CACHE.HTM 2 XXX files copied, (successful SAVE Cache - happy you!) Index of saved pages is : LOCAL 3 XXX addresses in output file, (successful Scan Bookmark - happy you!) In Navigator use: File/ Open BOOKLIST.HTM 4 Input file not accessible! (Navigator is running-quit it first) 5 Input file not found! (wrong installation) 6 Cache is empty! (cache cleared or no addresses for given filtering options) 7 Booklist is empty! (no bookmark made or no addresses for given filtering options) 8 Unable to write output file! (no space on hard disk or run from CD-ROM) 9 Error during processing (Not Enough memory)! 10 Unable to create local directory (invalid DOS name or run from CD-ROM) 11 Incomplete entry! (to Save you must Fill Address field) 12 This program is UNREGISTERED shareware (1 month expired-Register now!) 13 List without Titles and Addresses (check [x] Titles, Addresses or both) 14 Duplicate file names (use another Local directory) 15 Delete existing files, if you press No, directory will be used as is 10. REVISIONS HISTORY ------------------------ * 0.96 initial release 0.99 larger sorting array, /n option (registered version) * 1.00 update for win95/ navigator 3.0 1.01 registered version 1.00 * 2.00 windows menu and windows help 2.10 show titles option, user registration, filtering options * 2.20 scan bookmarks, Show and Filter dialogues 2.30 cosmetic changes, relaxed expire limitation, 1500 max sorting * 3.00 save pages, run Navigator from WebCache 3.10 AND Save, better tolerance to page and FAT.DB errors, 2000 max * = published