home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format CD 28 / amigaformatcd28.iso / -seriously_amiga- / comms / other / aemail151 / files.lha / ARexx.lha / html.readme < prev    next >
Text File  |  1998-03-10  |  4KB  |  94 lines
  1. html.readme
  2.  
  3. THIS SCRIPT WILL RUN ON BOTH REGISTERED AND UNREGISTERED COPIES OF AEMAIL
  4.  
  5. The html.aem script is used to read html attachments in email.  The script
  6. uses your browser to read the html file.  This specific script uses IBrowse
  7. to read and display the html document.  The script will have to be modified 
  8. to use a different browser.
  9.  
  10. Also in this directory is an alternate mailcap file which is required for
  11. displaying the html document.  You will notice in the mailcap file the 
  12. first line which is as follows:
  13.  
  14.     text/html; "run >NIL: rx html.aem %s"
  15.  
  16. This line calls the html.aem script to display the html attachment with
  17. your browser.  The script, html.aem, should be moved to your REXX:
  18. directory.  Notice that the call line says "run".  This is required to
  19. allow the script to become detached from AEMail so that ARexx commands can 
  20. be directed back to AEMail.  If the "run" is not present, AEMail will become
  21. frozen when you attempt to display the document.
  22.  
  23.                              HOW TO IMPLEMENT
  24.                              ----------------
  25.  
  26. Copy the mailcap file over your existing mailcap file.
  27.  
  28. Move the html.aem script to either your program directory or the REXX:
  29. directory.
  30.  
  31. The script is designed specifically for IBrowse and must be modified if
  32. another browser is used.
  33.  
  34. Since IBrowse doesn't normally create an assignment for it's program 
  35. directory, you will either have to add an assignment for the IBrowse
  36. program directory to your startup sequence or change the following
  37. statement:
  38.  
  39.     ADDRESS COMMAND "Run >NIL: IBROWSE:Ibrowse"
  40.  
  41. so that IBROWSE: points to the full path of your IBrowse program directory.
  42. If you wish to use another browser, you will also have to modify the
  43. following statements:
  44.  
  45.     IF ~ SHOW("PORTS","IBROWSE") THEN
  46.     ADDRESS COMMAND "WaitForPort IBROWSE"
  47.  
  48. The ARexx port name of your browser will have to be substituted for
  49. "IBROWSE".
  50.  
  51.     ADDRESS IBROWSE INFO SCREEN
  52.  
  53. This obtains the public screen name for your browser.  If your browser
  54. requires MUI, all you will have to do with this statement is change
  55. "IBROWSE" to the ARexx port name for your browser.  The next statement:
  56.  
  57.     ADDRESS AEMAIL1 SCREENTOFRONT result
  58.  
  59. is a call to AEMail to switch your browser's screen to the front.  "result"
  60. is the screen named obtained through MUI of the browser's public screen.
  61. If your browser does not use MUI you may have to change this statement and
  62. the previous statement so that you can obtain the public screen name of
  63. your browser.
  64.  
  65. The statement:
  66.  
  67.     ADDRESS IBROWSE GOTOURL "file://localhost/t:amtemp.html"
  68.  
  69. is an ARexx call to your browser to display the html document.  The
  70. document is stored in the file "T:AMtemp" by AEMail which is changed to
  71. "T:AMtemp.html" by earlier statements in the script.  If you are using a
  72. different browser you will have to change this statement to reflect the
  73. correct ARexx call for that browser.
  74.  
  75.                                 HOW TO USE
  76.                                 ----------
  77.  
  78. When you get an email with an html attachment (or text body) call up your
  79. attachment requester, select the appropriate attachment (it will say
  80. "text/html"), and click on VIEW.  Your browser will be loaded (if it is not
  81. already loaded) and the page will be displayed.  You should have an open
  82. connection to your Internet server when you call your browser since many
  83. html attachments obtain information over the internet (such as graphic
  84. images).
  85.  
  86. When you are done viewing the html document you should either close the
  87. browser or switch it's screen to the back to re-display the AEMail screen.
  88.  
  89. If for any reason your browser can not be loaded, multiview will be called
  90. to display the document as a text document.
  91.  
  92.  
  93.  
  94.