
Below is information on the following subjects
Fetchers are the programs that fetch HTML pages, Gopher menus, FTP Directory lists etc. from remote sites.
There are two types of Fetchers supported
Proxies should be supported with the Original Webster Fetchers. With KA9Q it should be just a simple variation of the Fetchers command line parameters (See Below).
The Following Fetchers are supplied in the <Webster$Fetch> directory.
- Directory which fetches directory listings from the local disk.
- !http which fetches from http servers using the telnet part of KA9Q.
- RNMail Which sends mail via ReadNews (for the
mailto
method). Provided by Julian Wright
- RNNews Which reads news via ReadNews (for the
news
method). Provided by Julian Wright
- NBMail Which sends mail via NewsBase (for the
mailto
method). Provided by me.
- FTP Which, with the assistance of TCPIP v2.04 Allows you to
Browse
FTP sites.
All fetchers will be external programs to keep the size of the main program down. They should also be multitasking, although the wimpslot can be set by this Application via the WimpSlot
value within the Fetchers
sections of the Choices windows.
A fetcher can be used by putting an appropriate command for 'Call Command Below' in the Fetchers
section of the Choices
window (accessable from the Iconbar Menu)
The substitutions that are automatically carried out on this command as follows...
- %0 is replaced by the machine name in dot notation.
- %1 is replaced with the Directory or filename to be retrieved from the indicated machine.
- %2 is replaced with the name of a file to which the output should be written.
The fetcher should stamp this file with the correct file type for the data that was fetched.
- %3 is replaced with the value of any inpage jump. (Any bit after a hash)
For HTTP
<Webster$Fetch>.!HTTP %0 %1 %2
For HTTP via a proxy
<Webster$Fetch>.!HTTP www.demon.co.uk:80 http://%0%1 %2
For FTP
<Webster$Fetch>.FTP %0 %1 %2
For FTP via a proxy
<Webster$Fetch>.!HTTP www.hensa.ac.uk:8080 ftp://%0%1 %2
For RNMail
<Webster$Fetch>.RNMail %0 %1%2
For RNNews
<Webster$Fetch>.RNNews %0
For NBMail
<Webster$Fetch>.NBMail %0 %1%2
For Telnet
<Webster$Fetch>.Telnet %0
- NOTES
- You can miss any % values out if required and include any other command line parameters.
- The port for the Proxy may be differant. The examples use 8080, but 80 may also be used, or indeed any other number.
- For the Proxies the second to last field should always result in the original URL when decoded.
There do appear to be some problems. Mostly due to the file returned sometimes having MIME data at the begining, even though it has not been requested. The supplied HTTP fetcher will attempt to remove this, but it has only been tested on a small number of MIME headers.
These fetchers and their protocol may become a 'standard' on the Archimedes.
This type of fetcher is the same (or will be) as that used for other Non-Comercial Archimedes Browsers.
These fetchers (Which are separate Multitasking Applications) can be used by selecting the 'Call Standard Fetcher' or 'Call Standard Fetcher (Extended URL)' option for a particular method in the Fetchers
section of the Choices
window (accessable from the Iconbar Menu). Which of the options you need depends on the Fetcher you are using, so you should read the Fetchers installation note
You should now be able to use proxies by use of the command line fetchers (See the Examples above).
Using a proxy may be faster that going direct as many Proxies also Cache pages and files (This is often their main purpose). The proxies also allow FTP, WAIS and Gopher connections without requireing a specific fetcher. (Only an HTTP fetcher is required if you can use proxies for everything else)
This is designed so I can implement searching etc. for the documentation.
To use this facility You must specify the following in the Forms tag.
- use an
Action
value of the code to be called.
- use a
Method
of POST
This code will be called with two parameters.
- The ACSII value of a file handle for a file to put the response in
- The ACSII value of a file handle for a file to contain the completed form. This is preceeded by MIME data specifying a type and stating the size of the data part of the file.
A small example program is supplied in the Docs directory. It is used by the first example form on the Examples page.
Andrew Pullan, Sun 20th August 1995