Colourization of the pager display on your project's website is facilitated by a simple configuration file and a special rebuild option. This page describes how to set and change those colours.
General principles | Colour definitions | Colour bindings | Colour defaults
The colours of your project website are given in the file
00lib/p3colours.txt
, which you can open and edit with
Emacs. First, choose your colour
palate with the colour
definitions options. Then decide which colours to associate
with each element of your portal and/or corpus with the colour bindings options.
Here is a sample p3colours.txt
file:
colour-def-dark #333366 colour-def-mid #777b9d colour-def-light #ffcc00 colour-def-very-light #fefefe colour-def-bright #33627d colour-def-pale #ffcc00 colour-def-gray #3c3c3c colour-bind-dark banner-bg colour-bind-mid border bborder colour-bind-light banner-fg heading-bg colour-bind-very-light colour-bind-bright hover-bg colour-bind-pale hover-fg colour-bind-gray heading-fg href-fg
The colours of some elements are set to defaults. These are listed at the end of this page.
You can update the colours any time you change the colour configuration simply by saying:
oracc colours
Then you need to reload the page you are viewing in your browser.
Each project may use a palate of up to seven different colours. You do not need to use all seven but you will find it helpful to use at least four, or your website will be difficult for visitors to use.
As
you can see from the sample file above, each colour definition is
entered on a single line. The first part specifies the type of colour
— dark, mid, light, very light, bright, pale and grey —
in the format, e.g., colour-def-very-light
. Then there is white
space followed by a hashmark and three or six digits, the HTML/CSS notation for
colours.
In this scheme,
#fff
(or #ffffff
) is white;
#000
(or #000000
) is black. There are
several colourr maps and wheels on the web, of which one of the nicer
examples is Jemima
Pereira's [http://ficml.org/jemimap/style/color/wheel.html] which is also locally cached on the
Oracc server [/doc/downloads/jemimap/wheel.html].
Once you have chosen the colour palette, you then need to decide which elements of your website will use each colour. Again, there are up to seven lines, one for each colour. But instead of the hexadecimal colour codes, you specify the element(s) to be coloured. These are listed below.
Colour specification for regions is always done in pairs, with both
text/foreground (-fg
) and background (-bg
)
elements being required. Border colours are given as singletons.
Links may involve six colour specifications because they have
foreground and background for unvisited, visited and hover states.
Each link set name described below thus expands to six options, formed
on the pattern NAME-STATE-FGBG
. The name
logo
implies the existence of logo-unvisited-bg logo-unvisited-fg logo-visited-bg
logo-visited-fg logo-hover-bg logo-hover-fg
.
There are some elements that are coloured consistently across Oracc. You cannot change them within a project. The most important of theses are as follows:
Eleanor Robson & Steve Tinney
Eleanor Robson & Steve Tinney, 'Website Colours', Oracc: The Open Richly Annotated Cuneiform Corpus, Oracc, 2019 [http://oracc.museum.upenn.edu/doc/help/managingprojects/configuration/webcolours/]