home *** CD-ROM | disk | FTP | other *** search
/ Kosovo Orphans' Appeal Charity CD / KosovoOrphansAppeal.iso / internet / browsers / _webster / docs / fetchers < prev    next >
Text File  |  1995-08-20  |  6KB  |  118 lines
  1. <HTML><HEAD><title>Fetchers, Proxies and Posters</title>
  2. </HEAD><BODY>
  3. <center>
  4. <A HREF="example.html"><IMG WIDTH=67 HEIGHT=39 ALT="Prev" SRC="ToPrev"></A> <a HREF="../!Help.html#index"><IMG WIDTH=67 HEIGHT=39 ALT="Index" SRC="ToIndex"></a> <a HREF="files.html"><IMG WIDTH=67 HEIGHT=39 ALT="Next" SRC="ToNext"></a><BR>
  5. <h1><a NAME="usage">Fetchers, Proxies and Posters</a></h1>
  6. </center>
  7. Below is information on the following subjects
  8. <ul>
  9. <LI><a href="#fetchers">Fetchers</a>
  10.  <ul>
  11.  <LI><a HREF="#Webster">Original Webster Standard</a>
  12.   <ul>
  13.   <LI><A href="#examples">Examples</a>
  14.   </ul>
  15.  <LI><a HREF="#ArcWeb">Archimedes Standard</a>
  16.  </ul>
  17. <LI><a href="#proxies">Proxies</a>
  18. <LI><a href="#poster">The Local Poster</a>
  19. </ul>
  20.  
  21. <h2><a name="fetchers">Fetchers</a></h2>
  22. Fetchers are the programs that fetch HTML pages, Gopher menus, FTP Directory lists etc. from remote sites.
  23.  
  24. There are two types of Fetchers supported
  25. <ul>
  26. <LI><a HREF="#Webster">Original Webster Standard</a>
  27. <LI><a HREF="#ArcWeb">Archimedes Standard</a>
  28. </ul>
  29.  
  30. <a href="#Proxies">Proxies</a> should be supported with the Original Webster Fetchers. With KA9Q it should be just a simple variation of the Fetchers command line parameters (See <a HREF="#proxies">Below</a>).
  31.  
  32. <h3><a name="Webster">Webster Standard</a></h3>
  33.  
  34. <P>The Following Fetchers are supplied in the <Webster$Fetch> directory.
  35. <ol>
  36. <li><em>Directory</em> which <em>fetches</em> directory listings from the local disk.
  37. <li><em><a href="http.html">!http</a></em> which <em>fetches</em> from http servers using the telnet part of KA9Q.
  38. <li><EM>RNMail</EM> Which sends mail via ReadNews (for the <quote>mailto</quote> method). Provided by Julian Wright
  39. <LI><em>RNNews</em> Which reads news via ReadNews (for the <quote>news</quote> method). Provided by Julian Wright
  40. <li><EM><a href="nbmail.html">NBMail</a></EM> Which sends mail via NewsBase (for the <quote>mailto</quote> method). Provided by <a href="author.html">me</a>.
  41. <li><EM>FTP</EM> Which, with the assistance of TCPIP v2.04 Allows you to <quote>Browse</quote> FTP sites.
  42. </ol>
  43. 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 <quote>WimpSlot</quote> value within the <quote>Fetchers</quote> sections of the Choices windows.
  44.  
  45. <p>A fetcher can be used by putting an appropriate command for 'Call Command Below' in the <quote>Fetchers</quote> section of the <quote>Choices</quote> window (accessable from the <a href="menus.html#iconbar">Iconbar Menu</a>)
  46. <P>The substitutions that are automatically carried out on this command as follows...
  47. <ul>
  48. <li>%0 is replaced by the machine name in dot notation.
  49. <li>%1 is replaced with the Directory or filename to be retrieved from the indicated machine.
  50. <li>%2 is replaced with the name of a file to which the output should be written.
  51. The fetcher should stamp this file with the correct file type for the data that was fetched.
  52. <li>%3 is replaced with the value of any inpage jump. (Any bit after a hash)
  53. </ul>
  54. <h4><a name="examples">Examples</a></h4>
  55. <pre>
  56.  For HTTP
  57.        <Webster$Fetch>.!HTTP %0 %1 %2
  58.  
  59.  For HTTP via a proxy
  60.        <Webster$Fetch>.!HTTP www.demon.co.uk:80 http://%0%1 %2
  61.  
  62.  For FTP
  63.        <Webster$Fetch>.FTP %0 %1 %2
  64.  
  65.  For FTP via a proxy
  66.        <Webster$Fetch>.!HTTP www.hensa.ac.uk:8080 ftp://%0%1 %2
  67.  
  68.  For RNMail
  69.        <Webster$Fetch>.RNMail %0 %1%2
  70.  
  71.  For RNNews
  72.        <Webster$Fetch>.RNNews %0
  73.  
  74.  For NBMail
  75.        <Webster$Fetch>.NBMail %0 %1%2
  76.  
  77.  For Telnet
  78.        <Webster$Fetch>.Telnet %0
  79. </pre>
  80. <dl>
  81. <dt>NOTES
  82. <dd>You can miss any % values out if required and include any other command line parameters.
  83. <DD>The port for the Proxy may be differant. The examples use 8080, but 80 may also be used, or indeed any other number.
  84. <DD>For the Proxies the second to last field should always result in the original URL when decoded.
  85. </DL>
  86. 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 <a href="http.html">HTTP fetcher</a> will attempt to remove this, but it has only been tested on a small number of MIME headers.
  87.  
  88. <h3><a name="ArcWeb">Archimedes Standard</h3>
  89.  
  90. These fetchers and their protocol may become a 'standard' on the Archimedes.
  91.  
  92. <p>This type of fetcher is the same (or will be) as that used for other Non-Comercial Archimedes Browsers.
  93. <p>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 <a href="choice/fetchers.html"><quote>Fetchers</quote></a> section of the <a href="choices.html"><quote>Choices</quote> window</a> (accessable from the <a href="menus.html#iconbar">Iconbar Menu</a>). Which of the options you need depends on the Fetcher you are using, so you should read the Fetchers installation note
  94.  
  95. <H2><A NAME="proxies">Proxies</A></H2>
  96. You should now be able to use proxies by use of the command line fetchers (See the <a href="#examples">Examples</a> above).
  97. <P>
  98. 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 <a href="http.html">HTTP fetcher</a> is required if you can use proxies for everything else)
  99.  
  100. <h2><a name="Poster">The Local Poster</a></h2>
  101.  
  102. This is designed so I can implement searching etc. for the documentation.
  103. <P> To use this facility You must specify the following in the <a href="codes#forms">Forms</a> tag.
  104. <ul>
  105. <LI>use an <quote>Action</quote> value of the code to be called.
  106. <LI>use a <quote>Method</quote> of <quote>POST</quote>
  107. </ul>
  108. <P>
  109. This code will be called with two parameters.
  110. <ol>
  111. <LI>The ACSII value of a file handle for a file to put the response in
  112. <LI>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.
  113. </ol>
  114. A small example program is supplied in the Docs directory. It is used by the first example form on the <a href="example.html">Examples</a> page.
  115.  
  116. <HR><address><A HREF="author.html">Andrew Pullan</A>, Sun 20th August 1995</address>
  117. </BODY></HTML>
  118.