home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 5 / DATAFILE_PDCD5.iso / utilities / h / htmacrol / !HTMacroL / !Help next >
Encoding:
Text File  |  1996-01-22  |  5.5 KB  |  107 lines
  1. Name     : !HTMacroL
  2. Purpose  : A macro insertion tool to make HTML even easier!
  3. Author   : Richard Goodwin
  4. Status   : Freeware
  5. Version  : 1.02 (January 1996)
  6. Features : User definable macros on 51 buttons;
  7.            Buttons for long "styles", short commands and 20 characters;
  8.            Open extreme top right of any mode with right mouse button click.
  9.  
  10. This application, along with all files contained within, © Richard Goodwin
  11. 1995/6.  This application may be freely distributed by any means AS LONG AS
  12. * all files remain intact, with the possible except of "User" (see below)
  13. * wherever possible the default "User" file is distributed,
  14.   rather than customised ones (aimed more at PD libraries etc. than users)
  15. * no unreasonable charge is made.
  16.  
  17. This help file contains:
  18.   Preamble
  19.   Use
  20.   Editing Macros
  21.   Versions
  22.  
  23. Preamble:
  24. ~~~~~~~~~
  25. Anyone can create World Wide Web pages on the Acorn range of computers; all you
  26. need is a text editor, such as !Edit, and preferably a web browser to test your
  27. pages - there are at the time of writing this two PD browsers, ArcWeb and
  28. Webster, which can be downloaded from Demon, taken from the Acorn User CD 1 or
  29. probably from a good PD library.
  30.  
  31. However, the most annoying thing about doing it this way is the repition of
  32. having to type in common commands over and over again.  I tried using macro
  33. insertion tools, but they just didn't quite work how I wanted - too slow,
  34. couldn't see enough buttons, forever having to define or load definitions etc.
  35. So, I wrote one myself!
  36.  
  37. Use:
  38. ~~~~
  39. Pretty simple really.  Just load it, and click on the icon bar icon to produce
  40. the main window.  The left mouse button opens it wherever it was last left, on
  41. startup the default is on the left side just above the icon bar (if your screen
  42. is tall enough).  Clicking with the right mouse button however opens it at the
  43. extreme top right of the screen, regardless of mode.
  44.  
  45. On the window are 51 buttons, marked with various functions.  When clicked upon
  46. !HTMacroL will send a stream of characters to the keyboard buffer, the upshot
  47. being that if you have an active cursor in something like Edit, StrongEd, Zap,
  48. Impression etc. your selected command will very quickly be typed in for you.
  49. While it is not possible to alter what these buttons say without resorting to a
  50. template editor, if you alter the text file "!HTMacroL.User" you can alter the
  51. action of every button to insert macros of up to 255 characters.
  52.  
  53. Editing Macros
  54. ~~~~~~~~~~~~~~
  55. Looking at the "User" file you can see that everything is pretty self
  56. explanitary; altering the text after "HEAD=" will define the header, altering
  57. stuff after "POUND=" will redefine what happens after pressing the pound sign.
  58. You will have to be careful where linefeeds go, as !HTMacroL assumes that any
  59. linefeeds are the end of a definition.  However, you can in fact insert
  60. linefeeds into you definitions; the backslash character, "\", will be
  61. interpreted as a request for a new line.
  62.  
  63. If the "User" file is accidentally deleted, there's no need to worry.  Firstly,
  64. !HTMacroL defines all macros internally when it is first loaded (although some
  65. will be blank), it then checks to see if the "User" file is present.  If it is,
  66. it will go through it and try to decypher any definitions.  Note that
  67. definitions /don't/ have to be in the same order, the names /don't/ have to be
  68. in capital letters, and /don't/ have to be all there - !HTMacroL checks for any
  69. macro names, and if it finds any it converts them to capitals automatically
  70. then matches them up with the correct program variable.  Secondly you can
  71. always copy the file "Proper" and use this as a "User" file.
  72.  
  73. The "Proper" file is almost an exact copy of the default "User" file; it's
  74. mainly just a refence file in case you get a bit confused with your
  75. definitions.  However, the reason it's called "proper" is because it actually
  76. defines better HTML than the "User" one, i.e. you're supposed to use "£"
  77. rather than "£" to get the pound sign because it will have wider
  78. support.  However, I think that this makes documents harder to read, so in the
  79. "User" file I've swapped most of the characters from numbers to named effects;
  80. there are cases in both files where I've not stuck to either of these formats
  81. due to compatibility, as I wanted the characters to work in both Webster and
  82. ArcWeb (Webster seems to have the better support, but many Argonet users will
  83. be using a thinly-disguised copy of ArcWeb).  Also I've tweaked things like the
  84. IMAGE definition (to add directory information), and made the horizontal RULEr
  85. a chubby, quarter page wide job just to show what can be achieved.
  86.  
  87. Have fun!
  88.  
  89. Rich, Nov. '95.
  90.  
  91. Versions:
  92. ~~~~~~~~~
  93. 1.00: first version
  94. 1.01: when I actually got round to using it in a real situation, realised I'd 
  95.       forgotten to include <center> and </center>.  Oh well...
  96. 1.02: added polling after each character insert so that characters didn't get 
  97.       lost and line feeds didn't screw up the text underneath.  Slows it down a 
  98.       little, but not too much.  Tested in StrongEd, Edit and Zap
  99.  
  100.           .-''-.          
  101.     nnn (? (o|o)) nnn     
  102. .---UUU------''---UUU--------------------------------------------------------.
  103. | House of Mabel               Richard Goodwin,                              |
  104. |  for all your                22 Wray Close, St. Anns, Nottingham NG3 2FS.  |
  105. | Acorn computer               Telephone (0115) 9507466                      |
  106. | graphic needs.               mabel@argonet.co.uk                           |
  107. '----------------------------------------------------------------------------'