home *** CD-ROM | disk | FTP | other *** search
/ Acorn User 3 / AUCD3.iso / airport / browsers / arcweb190 / !ArcWeb / PublicHTML / arcweb < prev    next >
Text File  |  1997-05-31  |  5KB  |  115 lines
  1. <head>
  2. <title>ArcWeb User Manual</title>
  3. <body>
  4. <h1><img src="#!arcweb">ArcWeb User Manual</h1>
  5.  
  6. This document constitutes a brief user manual for ArcWeb.  It assumes that
  7. you have read the instructions file supplied and the Problems file for
  8. troubleshooting etc.  When reporting bugs to me, please read the <a
  9. href="bugreports">bug report</a> instructions.
  10. <p>
  11. These instructions will help you get more out of ArcWeb, as they explain
  12. features which may not be mentioned elsewhere.  You should have read the
  13. ReadMe file and the Instruct file that came with ArcWeb.
  14.  
  15. <ul compact>
  16. <li><a href="#access">Blocking sites from being accessed</a>
  17. <li><a href="#abor">Aborting a fetch/render</a>
  18. <li><a href="#import">Sending ArcWeb URLs from external applications</a>
  19. <li><a href="#auth">User authentication</a>
  20. <li><a href="#ka9q">Usage with KA9Q</a>
  21. </ul>
  22.  
  23. You can configure the various aspects of ArcWeb's configuration at run-time
  24. by using the Configure menu on the ArcWeb icon bar menu.  When you make
  25. these changes, they last for <em>that session only</em> and you need to
  26. choose <em>Save options</em> in order to make the changes permanent.  The
  27. only exception is the <strong>Font</strong> configuration, and those changes
  28. only take effect after a save, and reloading the browser.
  29.  
  30. <hr>
  31.  
  32. <h3 id=access>Blocking sites from being accessed</h3>
  33.  
  34. ArcWeb will allow you to set up simple blocks on specific sites so that
  35. people using it cannot access these.  The access controls are specified
  36. by two files, one called <em>Block</em> and one called <em>Allow</em>.
  37. These can be found inside the <img src="#!arcweb" align=middle> !ArcWeb
  38. directory.  These files use the same format as each other, which is:
  39. a # signifies the start of a comment which lasts under the end of the line;
  40. comments, lines containing only whitespace and blank lines are ignored; all
  41. other lines contain either a single asterix (*) character, or a domain name
  42. with no wildcards in it.  domains are matched as end matched substrings,
  43. so if there is a line in the file:<bq>sex.org</bq>then this would match
  44. any URL with a hostname ending in sex.org eg. www.sex.org sex.org
  45. ftp.sex.org would all be covered by this, but sex.org.uk wouldn't,
  46. because it doesn't end with the match string.  NOTE that the example given
  47. would also block www.essex.org because of the match.  To defeat this, you
  48. need to give the separator too, ie.<bq>.sex.org</bq> which will be the
  49. same except it won't trap essex.org <strong>OR</strong>sex.org itself.
  50. A line containing a single asterix character will match anything, thus a
  51. Block file containing a line with a * on it will not allow through anything.
  52. This would be useless, except that the Allow file overrides the Block file.
  53. So, you can block everything, and then list the exceptions to that in the
  54. Allow file.  Since it is the target site which is matched, you don't have
  55. to allow access to the proxy (since access to that is assumed) which means
  56. that requests cannot be bounced off the proxy indirectly.
  57. <p>
  58. This is not a totally secure way of doing things.  For example, the files
  59. can be edited (changes don't take affect until ArcWeb is reloaded), but
  60. it is better than nothing.
  61. <p><strong>NOTE:</strong> the <em>Allow</em> file overrides the <em>Block</em>
  62. file so if you use an Allow file containing the single asterix wildcard, then
  63. no block entries will be used.
  64.  
  65. <h3 id=abor>Aborting a fetch or render</h3>
  66.  
  67. You may abort a document fetch, image fetch or document render at any time
  68. by double-clicking the left mouse button on the web icon at the top of the
  69. page.  The response may not be immediate for several reasons, but you should
  70. regain control fairly quickly.  Note that all ArcWeb does, is to abort the
  71. render and broadcast a message to all applications that current fetches
  72. should be aborted and no completion messages sent.
  73.  
  74. <h3 id=import>Sending URLs from external applications</h3>
  75.  
  76. There are several ways of entering URLs into ArcWeb's dialogue boxes or
  77. windows:
  78. <ol>
  79.  
  80. <li>On the icon bar menu, use the <em>Open</em> dialogue to type in a URL, and
  81. then press RETURN or click on the button to open the URL.
  82.  
  83. <li>Use the same dialogue box on the page menus on
  84. the menu as <em>Navigate-->Open</em>.
  85.  
  86. <li>Drag a text file from a Filer window and drop it on the icon bar icon or
  87. on the URL icon at the top of a page.
  88.  
  89. <li>Use a <em>Save</em> or <em>Save Selection</em> dialogue box from another
  90. application and drag the text file to the icon bar icon or on to the URL icon
  91. at the top of a page.
  92.  
  93. </ol>
  94.  
  95. Note that this does mean that you cannot drag text files to the icon bar icon
  96. to have them rendered by ArcWeb.  Any text file which doesn't look as if it
  97. contains a URL will be ignored.  There must be no leading spaces.
  98.  
  99. <h3 id=auth>User Authentication</h3>
  100.  
  101. Some pages you attempt to access may be protected by password.  For more
  102. information on how this is done and how it is handled by ArcWeb,
  103. look at the <a href="authorise">explanation of authentication</a> which
  104. was posted to demon.ip.support.archimedes by me on July 13th 1995.
  105.  
  106. <h3 id="ka9q">Usage with KA9Q (!TCPIP)</h3>
  107.  
  108. Usage over KA9Q is not supported in this version of ArcWeb, although it
  109. may work.  I cannot provide any support for this type of usage.
  110.  
  111.  
  112. <hr>
  113. Stewart Brodie<br>
  114. 20th February 1996
  115.