home *** CD-ROM | disk | FTP | other *** search
/ ARM Club 3 / TheARMClub_PDCD3.iso / programs / comms_networking / countmake / !Help
Encoding:
Text File  |  1997-08-27  |  7.4 KB  |  112 lines

  1. Name     : Counter Maker
  2. Purpose  : Make creating web counter code easy
  3. Author   : Richard Goodwin
  4. Status   : Freeware
  5. Version  : 1.01 (August 1997)
  6. Features : All colours and functions of the counter supported with easy-to-use
  7.            buttons and a preview of how the counter will look; if Voyager is 
  8.            found the default name for the counter will be based on user's main
  9.            email address.
  10.  
  11. This program is © Richard Goodwin 1997 but may be freely distributed as long as:
  12.  
  13. * All files remain intact (see it fail if you change the sprite file greatly!)
  14. * No unreasonable charge is made
  15. * It is for the use of ArgoNet users only - Argo may not like external requests
  16.   for its web counter!
  17.  
  18. Disclaimer:
  19. ~~~~~~~~~~~
  20. * If it doesn't work, tough.
  21. * The colours are probably not accurate, so please don't complain if you match
  22.   your HTML to my program's display, only to find they don't match in reality.
  23. * NOT supported by ArgoNet - any bugs, suggestions etc. contact me.
  24.  
  25. Quick User Guide:
  26. ~~~~~~~~~~~~~~~~~
  27. Click on OK, move the caret to where you want it in your text editor, click on OK again.
  28.  
  29. You might want to click on the Big/Small buttons and the colour buttons to change the options, and the counter name can be changed in the white box at the top of the window.
  30.  
  31. Starting up:
  32. ~~~~~~~~~~~~
  33.  
  34. When you first load the program, you should see a window that looks a little something like this:
  35.  
  36. .--------------------------------------------------.
  37. | .-- Options -----------------------------------. |
  38. | |                     ______________________   | |
  39. | |      Counter name: |___youremailaddress1__|  | |
  40. | |                                              | |
  41. | |      Counter size:   * Big    o Small        | |
  42. | |                     ____                     | |
  43. | |    Numeral colour: |____|                    | |
  44. | | Background colour: |____|                    | |
  45. | |     Border colour: |____|                    | |
  46. | '----------------------------------------------' |
  47. | .-- Test --------------------------------------. |
  48. | |               0 0 0 0 0 1 3 3                | |
  49. | '----------------------------------------------' |
  50. |                           .--------.  .========. |
  51. |                           | Cancel |  ||  OK  || |
  52. |                           '--------'  '========' |
  53. '--------------------------------------------------'
  54. The 'Counter name' is the "code name" of the counter - each name must be unique for each counter, because if you use the same name as someone else then their web counter will go up whenever someone visits your page, and likewise a visit to the other web page will increase your counter.
  55.   It's suggested you use your email address for this - after all, no-one else has the same address or they'd be getting your mail! - and so the program will ask Voyager what the main email address is for your account (if that's possible), and add the '1' to the end of it (in case you want more than one counter, you can simply change this to a 2, 3 etc.).  You can use whatever 'Counter name' you want though.
  56.   Note that if you hit the RETURN key after typing in the 'counter name' box, it's the same as clicking the "OK" box.
  57.  
  58. Because the web counter supports two sizes, large and small, the 'Counter size' section has two bottons which will switch between the two.  You can see the test version change at the bottom of the window as you do this.
  59.  
  60. The three colour boxes - 'Numeral colour', 'Background colour' and 'Border colour' - not only show what colour is currently selected for that part of the counter, but can be clicked on to bring up a colour palette of all 24 possible colours.  You can select a colour from this palette, and the test counter at the bottom of the main window will change accordingly to show how this will affect your counter.  There's more about the palette window later.
  61.  
  62. At the bottom of the window is a test area - an example counter will change colour and size according to your choices in the top half of the window (don't worry about the fact that they display different numbers!) - and the 'Cancel' and 'OK' buttons.  Clicking on 'Cancel' will quit the program, and 'OK' will begin the process of entering your web counter (as will pressing RETURN if the window has input focus).
  63.  
  64. The Next Step:
  65. ~~~~~~~~~~~~~~
  66. Once you've OK'ed the settings for your counter, the main window will be removed and another window will appear:
  67. .--------------------------------------------------.
  68. | .- One last thing... --------------------------. |
  69. | |                                              | |
  70. | |      Before you click on the "OK" button     | |
  71. | |   you must position the caret in the place   | |
  72. | |     you want the counter code to appear.     | |
  73. | |                                              | |
  74. | |For instance, if you're editing your web pages| |
  75. | |  in a text editor, click on the text editor  | |
  76. | |    window as if you were going to type the   | |
  77. | |                HTML in by hand.              | |
  78. | |                                              | |
  79. | |          Ready?  Now click on "OK"!          | |
  80. | '----------------------------------------------' |
  81. |                           .--------.  .--------. |
  82. |                           | Cancel |  |   OK   | |
  83. |                           '--------'  '--------' |
  84. '--------------------------------------------------'
  85. Basically, this program works by pushing the text that makes up the web counter into the keyboard buffer.  The upshot of this is that any program that accepts keyboard input - for instance, your text editor - thinks that you're typing the code in yourself very quickly.  However, if you don't click on the text editor just before the program tries to send this code out, there may be no-where for it to go and it will appear that nothing has happened.
  86.   So, before hitting 'OK' make sure your text editor has what is known as "input focus" - that is, the bar at the very top of the text editor window will be a light yellow colour, and if you type something yourself it will appear in the text editor window.
  87.   If you hit 'Cancel' you'll be taken straight back to the main window.
  88.  
  89. Once you've clicked OK and the code has been typed out, the main window will come back up ready for you to change the counter or create a new one.  Just close teh window or click on "Cancel" to quit the program.
  90.  
  91. The Palette Window:
  92. ~~~~~~~~~~~~~~~~~~~
  93. The palette window basically consists of 24 colours (all named), a long bar at the bottom which shows the currently-selected colour, and the 'Cancel' and 'Use' buttons.
  94.   Clicking on one of the colours will change the colour of the long bar at the bottom of the screen - just so you can get a better idea of what it looks like - but will NOT yet set the colour of the counter.  You can try as many colours as you want, but a colour will not be applied to the counter until you click on the 'Use' button.  Once the 'Use' button has been pressed the colour will be properly selected, and you will be able to see on the main window how your new colour will look when applied to the counter.  The 'Cancel' button takes you straight back to the main window without making any changes.
  95.  
  96. Versions:
  97. ~~~~~~~~~
  98. 1.00: July 1997
  99.       First released version, still pretty much a beta release as I'm the only
  100.       one to have tested it!
  101. 1.01: August 1997
  102.       Changed code so windows will re-open where the user moves them, not
  103.       always in the centre of the screen!
  104.  
  105. Contact Details:
  106. ~~~~~~~~~~~~~~~~
  107. Richard Goodwin,
  108. mailto:rich.goodwin@argonet.co.uk
  109. http://www.argonet.co.uk/rich.goodwin/
  110.  
  111. Cheers,
  112. Rich.