Note Colors

Tinderbox Icon

Look at the content of this note in Map view for a better display of the colors. Colors illustrated in this section listed with their 'primary' color first and then their modifier, for clarity. To use the names as color values in Tinderbox you must start with the modifier, i.e. use "dark light blue" not "light blue dark". Online, view a grid of default defined colors [276 kb, new window]. This is a useful reference to the descriptions below. The list shows examples of border and pattern types as shown in the picture followed by the hex values of all the named Tinderbox color and their 7 default shades (set automatically) - in HTML view use the above linked graphic to see the color listings.

There are 17 defined 'primary' colors plus 2 'magic' colors that may hold varying color values: normal and automatic. The Colors menu, the Style/Colors sub-menu and the note new/rename dialog color pop-up all list 16 primary colors (all except white) and normal.

Each primary color can be assigned 3 darker or 3 lighter shades: dark, darker, darkest and light, lighter, lightest. The shades, whose hex RGB values are listed in this section are created dynamically from the base primary color.

The most normal application of this color is to set the on-screen color of Outline view list items and Map note icons. This is done by setting the selected note's Color attribute. Incidentally, the color of note text on Map icons is set automatically for black or white so as to give best contrast with the chosen Color setting; this can be over-ridden by setting an explicit NameColor value.

The user can alter a primary color's actual value or add new primary colors by means of the Attributes dialog's Colors pane. As you add or edit a color Tinderbox shows you a swatch with the primary color and its six automatically generated shades. To add a new primary color you simply give it a new color name and a hexadecimal color value and then click the 'change' button. Users wanting a customised set of colors available by default in all their TBXs should investigate use of configuration files, specifically a colors.xml file; such changes will affect any TBXs created after the custom colors.xml file has been created and the app re-started. This method does not allow the user to customise the color of 'normal' either at app or TBX level.

Custom color schemes are also possible; this allows a custom color set to be shared from one TBX to another and even with other users.

New primary colors can be used by name as you would a default primary color except you should note the new colors are not added to the Colors menu, the Colors menu, the Style/Colors sub-menu and the note new/rename dialog color pop-up (unless you also edit the menus.xml configuration file. To set a new note with a non-standard primary, select any value on the note creation dialog then once created use a quick stamp to set the 'Color' attribute' to the desired named color, or set it manually via the note's Info view.

When exported to HTML, literal (named) colors are exported as Hex RGB strings, i.e. 'red' exports as '#FF0000'. Hex values are case insensitive in TBXs, i.e. "#ff0000" = "#FF0000".

Note that the color 'gray' must use the American spelling with an 'a'. A color with the English spelling of 'grey' will be treated as a different color.

Up: Visual Styling
Previous: Text Markups   

[Last updated: 3 Dec 2008]

Google search aTbRef for:  

Licensed under Creative Commons Attribution-Noncommercial-Share Alike 3.0 License
[See aTbRef CC licence Attribution/Waiver info info]

Creative Commons License

Made with Tinderbox