****************************************
*!HTMLbar version 1.22 - 8th June 2020 *
****************************************

!HTMLbar is a buttonbar that lets you enter HTML tags into a text editor with a click of a button. Many other programs do the same thing, but what's different about !HTMLbar is that it is designed to cover most of the HTML tags, displaying the majority of them at once, while using a minimal amount of screen space.


<<HOW TO USE IT>>

* Double click to load onto the iconbar.

* Click the iconbar icon to open the buttonbar at the top of the screen.

* Click SELECT (left mouse button) on a button to insert the tag on the button into whichever window has the input focus (highlighted title bar). Click ADJUST (right mouse button) to insert the closing tag.

 
<<Notes>>
 
* The text on the button is the text that will be inserted, with a few exceptions for space reasons e.g. <blockquote> is shortened to <b'q> on the button, but the button prints <blockquote> when clicked. The small button size may cause display problems with fans of very chunky desktop fonts, but are okay with Homerton medium, DejaVuSans and system fonts.

* Similar tags are grouped and highlighted with colour, which helps with quickly locating a particular tag.

* Where there is no closing tag, clicking ADJUST may give an extended version of the tag.
e.g. <hr> gives <hr> with SELECT and <hr clear="all"> with ADJUST

* The behaviour of the bar is slightly unusual as it cannot be moved off the screen. This is to make maximum use of space (the bar is usually the whole width of the screen), but also to ensure that no button is ever off the screen.

 The result is that the bar can only be moved up or down, which leads to quicker manipulation since you don't need accurate horizontal control. The bar can either be left at the top of the screen/window you're using or be moved down as the text fills the window - so it is always a short mouse step from the text.

:::::::::::::
Customisation
:::::::::::::

!HTMLbar is easily customised, since different people have different preferences regarding HTML tags - <P> versus <p>, for instance. 


1) Tag text
-----------

To alter the text of any tag, simply click MENU (middle mouse button) over the button and follow the Change tag arrow. The window that opens shows the current text for the button. Alter this text as desired and click OK. If an * is included in the text (e.g. <ul>*) it has the same effect as pressing Return.

At this stage any changes are only preserved until !HTMLbar is quit. To permanently change the tag definitions, click the MENU button over the buttonbar or iconbar icon and choose Save tags.

The tags are saved as a simple list in a textfile called 'tags' within the !HTMLbar directory. This list can be directly edited if desired.


2) Buttons/buttonbar
--------------------

Different templates are provided:

800col - Default template, coloured buttons, width 800
1024col - Coloured buttons, width 1024

Version 1.20 provided the following other templates but these are no longer included from version 1.21 onwards as they have not been updated for HTML5:

800plain - Uncoloured buttons, width 800
800thin - Thinner buttons in Homerton font, width 800
800trinity - As above with Trinity.bold.italic font
1024plain - Uncoloured buttons, width 1024
1024thin - Uncoloured thinner buttons, width 1024, Homerton font
1024trinity - As above with Trinity.bold.italic font

To use a different template if available, simply click menu on the iconbar icon and choose the Change bar option. A window will open displaying the available buttonbars. Click on the one you want to change to and click OK. To save your choice as the default, displayed when the program is first loaded, click on the Save button.

If you have a template editor such as !WinEdit, you can alter the appearance, order and layout of the buttons as desired, as long as the icon number for each tag is preserved ie. icon 0 is always the first tag in the list of tags. If the icon numbers are altered, the tags file will also have to be altered. 

The simplest alteration is to change the text on an existing button icon if it's one you never use (e.g. <pre>), to one you might (e.g. <time>)

If you add more buttons the maximum number is 100. Once you've added a button in the template, run !HTMLbar then follow the normal procedure above to change the tag text with select and adjust from the defaults.

_____________________________________________________________________________

!HTMLbar is FREEWARE and can be used and distributed by anyone.

Thanks to Ray Favre for Dr Wimp, without which this application probably wouldn't exist.

See additional document in application directory called howitworks for explanation on the coding.

By Matt Bellamy, M.Bellamy@soton.ac.uk

Version 1.21 by Ewen Pring 2020-06-04 - updated the 800col bar for HTML5 (tags no longer contain style information best handled by CSS). Removed other bars. Updated to use DrWimp version 5. Increased tag$ array size from 50 to 100 to allow more buttons. Added dummy entries to tags file to make it easier for users to add extra buttons to templates in future. Permission obtained from Matt Bellamy to re-distribute.

Version 1.22 by Ewen Pring 2020-06-08 - added back the 1024col bar taken away in version 1.21. Added Help... option on icon bar menu. Used !Linker to combine DrWimp library with source BASIC !Runimage. Then compacted !Runimage with !StrongBS.
_____________________________________________________________________________