Copyright: WebCache ® 1996 Davor Zorc


Index
WebCache - User Manual

Version 3.1

Index

Introduction

System Requirements

Installation Guide

Running WebCache

Scanning Cache

Saving Pages

Scanning Bookmarks

Options

Troubleshooting

Contacting the Author

How to Register

Legal Stipulations

Acknowledgements

Revision History

Menus

Go

Scan Cache

Scan Bookmarks

Save Pages

Register

Options

Filter Output

Show

Echo Address


Introduction
Welcome to WebCache

Copyright © 1996 - 1997 by Davor Zorc

Introduction

The Internet provides a huge selection of web sites for "surfers". These sites contain pages brimming with rich graphical content and informative text. Netscape Navigator's File | Save command 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 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 them in a way that permits Navigator 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 along the way.

While Navigator also saves and displays only the last 10 addresses, the number of addresses WebCache displays is unlimited.

WebCache's list may also be used while surfing on-line (when connected to the Internet). Pages displayed from the cache may be named and saved using Navigator's File | Save As option.

Additional Treats!...

Save Pages

•	Wouldn't it be nice if the pages for a particular site could be copied from the cache?  WebCache makes this difficult task easy. Complete pages (with pictures) may be saved permanently on local disk. Once saved, pages may be copied to another disk/ diskette/ computer. This is done from WebCache's Go | Save Pages menu option.

Bookmarks with Detailed Descriptions

•	WebCache's Go | Scan Bookmarks menu option adds a useful dimension to Navigator's bookmark file. It will prepare a "custom" list containing both the site names and addresses of the http or ftp or gopher sites in cache or any combination of site types. (Netscape bookmarks displays only the name.)

WebCache's "server separation" option lists pages at each web site in individual groupings making it easy to revisit any location

We Listen!...

Let us know how you like WebCache. We have tried hard to make it a useful tool that will enhance your use and enjoyment of the Internet and Navigator.

Suggestions, "wish list" requests, and user tips are always welcomed. If we use your idea in a future upgrade and you are a registered user be assured that your contribution will be acknowledged in this manual.


System Requirements

•	IBM-PC 386 or better

•	VGA card with 256 or more colors

•	250 kByte Hard Disk space

•	Windows 3.1x or Windows 95

•	Netscape Navigator 2.0x or 3.0 (Regular or Gold)


Installation
Installation Guide

Win 3.1x

First unzip the distribution file webcaXXX.zip to any directory. Using File Manager - copy WEBCACHE.EXE and WEBCACHE.HLP to the Navigator main directory (this is the directory which contains the CACHE subdirectory, and is usually named \NETSCAPE).

In the Windows 3.1x Program Manager click on the Netscape group to open it. Make the File Manager window small enough to be able to also see the Netscape group. Then Drag and Drop WEBCACHE.EXE from File Manager file list to the Netscape group.

Alternatively, you may use Program Manager's 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's main directory name, for example:
                "c:\netscape".

Win95

First unzip the distribution file webcaXXX.zip to any directory. Then copy WEBCACHE.EXE and WEBCACHE.HLP to the Navigator main directory (this is the directory which contains the CACHE subdirectory, and is usually named \NETSCAPE\NAVIGATOR). Do this using Explorer.

Then Drag and Drop WEBCACHE.EXE from Explorer file list to the Desktop main screen to create a shortcut, or add this file to Navigator group.


Using WebCache
Running WebCache

WebCache has three menu choices: Go, Options and Help.

•	Go:
The Scan Cache, Scan Bookmarks and Save Pages functions may be accessed through this menu OR by using the command buttons on the main screen.

The only difference in the two methods is that when using the command buttons WebCache will automatically close itself after performing the function.  When Scan Cache, Scan Bookmarks and Save pages are accessed through the Go menu WebCache will not autoclose even if Navigator is launched. This is handy if one wants to scan cache and then save pages.

•	Options:
Apply to all three selections on the Go menu. The options are independent of each other and there is no particular order in which they must be used.

•	Help:
Accesses this document

Details:

How to Scan Cache

How to Save Pages

How to Scan Bookmarks

Using Options


Using Scan Cache
How to Scan the Cache

Scanning...

•	Run WebCache immediately before browsing pages off-line. This will permit WebCache to obtain the current list of addresses in the cache.

Click Go | Scan_Cache and wait for the message "Now you may surf off-line!. Click on 'Ok'.

Loading...

•	Run Navigator

•	Temporarily change the Verify Documents setting in Navigator's  Option's | Network_Preference | Cache to NEVER. This will force Navigator to fetch a document from cache rather than attempt to establish a connection.

•	Click File | Open and navigate to the CACHE.HTM file. Select it and click the OK button. Navigator will load the file, providing a hypertext list of the the sites you have surfed to (addresses in cache).

Using...

•	Click an address for off-line browsing. Surf the page the same way as when on-line browsing. Navigator will display the links you click. If the link was not visited during the on-line session or Navigator did not save any information while there it will attempt to establish an on-line connection.

•	Return to the CACHE.HTM file using Navigator menu: Go | * Local cache *.

Tips...

•	A good on-line browsing technique would be to quickly visit all pages and the links on them 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 Navigator's Network_Options.

•	Pages displayed from cache may be named and saved using Navigator's File|Save As option.

•	If you "forgot" to make a bookmark while on-line make one while cache surfing. (Bookmarks | Add_a_Bookmark). Use Navigator's Bookmarks|Go to Bookmarks | Items | Properties to edit it.

•	You may wish to add CACHE.HTM, since it is an index to the cache, to bookmarks to access it as any other location. The CACHE.HTM list is sorted alphabetically by page addresses.

NOTE:

When more than 2000 addresses are extracted, or if the length of an address is longer than 150 characters then address checking for duplicates and address sorting is skipped (for those addresses). These addresses appear at the top of the listing.

How to Save Pages

How to Scan Bookmarks

Using Options

Troubleshooting


Using Save Pages
How to Save Pages

Saving...

Navigator's cache contents is of a temporary nature. Each time a site is visited Navigator updates (if required) the copy of the page in its cache. When the cache becomes full it deletes older pages to make room for the new ones.

Therefore if one wants to save page(s) permanently, the selected pages and their pictures must first be copied and saved in a separate directory (folder). Then addresses on these pages must be localized to point to the local files instead of remote sites. Localized addresses are easily identified by an asterisk *.

The original (home) address of the page is saved under "reload" link at the end of a localized page (if the Show | addresses option is checked).

•	Use Go | Save_Pages to save complete pages. Type the 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 the exact address, or what is available in the cache, first use WebCache to Scan cache. Then in Navigator, click on the desired address with the right mouse button and choose: Copy this link location. Close Navigator and open Save pages in WebCache. Place the cursor in the address field and press the Shift-Ins keys (at the same time) to paste the address. Then edit this address for the page(s) you want to save.

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
   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 multiple pages (GreeceMap AND CroatiaMap) - type GreeceMap,CroatiaMap - NOTE the comma separating the pages.

WebCache can also 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. The number of entries is not limited but the total length of addresses can be no more than 250 characters.

A shortcut address which will save EVERYTHING in the cache is '/' (without the quote marks). Check free disk space first.

NOTE:  Always close Navigator before saving pages

•	Next type-in the name of the local directory the files are to be copied to.

If this directory exists and is not empty, the user will be asked if they wish to delete the existing files or to use the directory as is.

If the old files had an index named _INDEX0a.HTM and the files are not deleted, WebCache will create a new index named  _INDEX0b.HTM.

NOTE: It is recommended that the number of files saved in a single directory be no more than 1000. A larger number will lengthen the required time to save the files and may create problems naming the local files or within the DOS file system.

•	There are two optional features when saving pages:

 Follow other links  - includes the pages whose addresses are contained on the desired pages - if you visited them (they are in the cache).

 Delete existing files - if the local directory exists and contains files, using this option will delete them, otherwise WebCache will give you the choice to use this directory as is, or to cancel.

Before saving files you might want to select the contents and descriptions that will be displayed on the _INDEX0?.HTM file - which will be found in the Localization directory. Do it by using Options | Filter output and Options | Show menus.

Since there are many pages which do not strictly follow the HTML standard, there can be no guaranty that all pages or all pictures on a page will be completely localized.

Viewing...

Use Navigator's File | Open menu.

Navigate to the desired directory and 'click' _INDEX0a.HTM (or _INDEX0b or _INDEX0c etc.).

Tips...

•	Save pages immediately after closing Navigator because on the next Navigator session some items might be changed or deleted.

•	When you save all pages it is recommended that you "Clear disk cache now" in Navigator - Options | Network Preferences | Cache | Clear Disk Cache Now command. (Working with a small cache is faster and more accurate.)

•	Add the _INDEX0a file to Navigator's Bookmarks menu to quickly access them.

•	Use Go | Scan Cache first (with  Show | addresses checked) to determine the names and correct spelling of the addresses in cache.

How to Scan the Cache

How to Scan Bookmarks

Options


Using Scan Bookmarks
How to Scan Bookmarks

Scanning...

Navigator saves its bookmarks in the file BOOKMARK.HTM.

WebCache Menu - Go | Scan_Bookmarks enables filtering of BOOKMARK.HTM into three categories http, ftp and gopher.

First visit Option|Filtering and select the category(s) of files to be listed.

Next click Go | Scan_Bookmarks and WebCache will prepare  BOOKLIST.HTM which provides a viewable and printable site name and address  - (if Show | page_titles and Show | address are checked).

NOTE: All options apply to Scan_Bookmarks except - server separation.

Viewing...

To VIEW the list in Navigator click File | Open file BOOKLIST.HTM. (There a slight differences in the way Win 3.1x and Win95 ask you to insert the file name.)

Printing...

To PRINT the list in Navigator click File | Print.

Tips...

•	You may wish to add BOOKLIST.HTM to Bookmarks in order to access it as any other location. (Click Bookmarks | Add Bookmark in Netscape.)

How to Scan the Cache

How to Save Pages

Using Options


Options
Using Options

All_options apply to Scan Cache, Scan Bookmarks and Save Pages except server separation which does not apply to Scan Bookmarks. Place a check (click it) on those you want BEFORE scanning or saving addresses.

•	Filter Output - This option permits the user to customize the type(s) of addresses that WebCache prepares for off-line browsing. Click (check) the types that are to be included.

  http

  ftp

  gopher

  List pictures - includes .gif and .jpg pictures in CACHE.HTM, BOOKLIST.HTM and _INDEX0?.HTM. (They are automatically included on CACHE.HTM pages - this allows viewing them separately )

•	Show - This option permits the user to customize what information and how WebCache groups it for the addresses on the list. Click (check) the desired boxes.

  titles - displays the page titles in the output list.

  addresses - displays addresses in the output list.

  server separation - lists the cache addresses in separate groups, by server, in both CACHE.HTM and _INDEX0?.HTM.

•	Echo Address - displays the URL addresses while scanning.


TroubleShooting
TroubleShooting & Dialogue Messages

Troubleshooting

What If It Doesn't Work?

•	Perhaps you used WebCache while Navigator was active. BEFORE using WebCache to Scan Netscape's cache you first should quit Navigator, wait 15 seconds for Navigator to update the cache in background and then start Webcache.

If Navigator was active, at best you will get an incomplete CACHE.HTM or Webcache will report an unaccessible input file.

Do not turn-off your computer while Navigator is running.

•	Perhaps the cache is empty or the size is set to zero.

•	Make sure WEBCACHE.EXE is in the Navigator main directory.

•	Make sure the Navigator main directory has a subdirectory named CACHE. (check this in: Options|Network Preferences|Cache - the Disk Cache Directory description should look similar to: C:\Netscape\Cache).

•	The Working directory for WebCache should be correctly declared in Program Manager.

•	Did you set Verify Documents to NEVER?

•	Have you recently reinstalled or upgraded Navigator? New versions should be installed over the old one in the same directory. The same goes for WebCache updates.

•	Clicking on context sensitive items such as maps does not work off-line. (The Web Site must do the work.)

It Works but !...

Addresses appear in CACHE.HTM which do not seem to be in the 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 are lost.

•	Try the "Clear disk cache" command button in Navigator's Network_Preferences | Cache menu to start a new cache.

•	WebCache does not change or check Navigator's cache contents in any way. It merely shows what the Cache record file has determined is in it.

Message Dialogues

This is a list of all message dialogues and their meaning:

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  Bookmark 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


Contact
Contacting the Author

Comments, suggestions and bug reports are encouraged and appreciated.

Surface Mail
       Davor Zorc
       Istarska 51
       10 000 Zagreb
       Croatia

E-Mail
       davor.zorc@fsb.hr


Registration
Order Form - Registration

This program is SHAREWARE and requires payment to the author. It is the full feature version and is free to test for 1 month. After 1 month you MUST register to maintain the full version. Unregistered copies will not display all Cache addresses.

Feel free to write to me with comments using e-mail or a picture (post) card. You may re-distribute unmodified copies of the webcaXXX.zip package to BBS, Internet, CD-ROM.

Commercial use requires a license - contact the author with details concerning its use for pricing.

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 an opaque envelope or a check made payable to:
       Davor Zorc
       Istarska 51
       10 000 Zagreb
       Croatia

e-mail: davor.zorc@fsb.hr

Our experience shows that personal checks from USA and European Union banks are accepted.

According to your satisfaction with program, the state of your finances or state of your country, do modify the 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 an ftp address you supply or on diskette.

The latest version may be found on:

      SimTel repository:
        ftp://oak.oakland.edu/pub/simtelnet/win3/inet/webcaXXX.zip

       WinSite (CICA):
        ftp://ftp.winsite.com/pub/pc/win3/winsock/webcaXXX.zip

        http://www.winsite.com  - search for: webca.

There are many mirror sites of these archives around the world.
irror sites of those archives around the world.

When you send the Registration form by mail or e-mail and the money, you will receive Registration Name and Registration Code which you should 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 the Windows Help program you may click on the Edit menu, use the mouse to highlight the order form (below), then click Copy. Open Notepad and click Edit | Paste. Fill in the form and print it. There is also a file named ORDERFRM.TXT in the original archive.
<-------------------------- cut here order form -------------------------->
___________________________________________________________________

Registration form for : WebCache
webca300.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 [ ]    e-mail [ ]

Enclosed $US:_____________          cash [ ]     check [ ]

Comments, suggestions for future updates, bugs, complaints:

___________________________________________________________________

___________________________________________________________________

___________________________________________________________________

Where did you get this file:

___________________________________________________________________

<-------------------------- cut here order form -------------------------->


Legal

WebCache is the copyrighted property of Davor Zorc

Copyright © 1996-1997 by Davor Zorc
All Rights Reserved

This program is tested and believed to be free of bugs. There is however no guarantee that this program will perform its expected duty, and that it will not harm your machine, data or user in any way.

Mentioned hardware and software products are the © property 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 e-mail the author what version you are going to publish and in what product (so the author is able to send latest version).


Acknowledgements

Many thanks to Peter Rader for his suggestions and help in making this help file.

I also want to thank the many users from the USA, Germany, Pakistan, Britain, Brasil, Spain, France and other countries who have provided me with their comments and support.


Revision History

     Version

*      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 option
*      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, improved tolerance to page and FAT.DB errors

*  =   published


cache browsing

surfing the Internet free of telephone connection charges using WebCache's navigation map


cache

a location within Netscape where Navigator stores a copy of each website page that it visits


directory

the terms folder and directory are used interchangeably in this document. Win3.1x users are familiar with directory - Win95 calls a directory a folder


folder

the terms folder and directory are used interchangeably in this document. Win3.1x users are familiar with directory - Win95 calls a directory a folder


HTML standard

Hyper Text Markup Language the language programmers use to create Web Pages


localized

the process  used by  WebCache to change a web page's original remote site address  to a LOCAL address in the computer.


off-line browsing

viewing a Web Site from WebCache's navigation map and not connected to the Internet


on-line browsing

viewing a web site page while connected to the Internet with a modem and telephone


unique

names that are not also used in another address