Setup data files help
=====================


In general, you should leave this stuff alone. But, if you can't resist the
temptation to frob... :-)



colours
-------
  This is the colour table. Basically:
    <red><green><blue><colour name>
  The colours being 0-255 in hex.


definition
----------
  This file defines certain things in the Ovation Pro DDL. The file format
  is:
    #<keyword>#
    <ddl sequence>
    ##

  Repeating for each keyword, until we reach "#END#".

  Keywords:
    defcolours    Default colours - you can add COL_04 to COL_0f.
    deffonts      Default fonts - you can add FONT_70 onwards.
    genpref       General preferences block.
    styles        Generic style. The heading and preformatted are unused.
    chap_a4       Page layout for standard A4 output.
    chap_a5       Page layout for 'buffy' mode (A5, pamphlet style).
    chap_finish   End of output code(s).

    strikeout     Strikeout - so you can define the line type/colour.
                  Ended automatically with "{strikeout 0}".

    head<num>     Defines six heading styles.
                  Ended automatically with "{bold 0}{font}{textsize <size>}".

  Other styles, like <pre>, <b>, <i>, etc are handled on-the-fly.
  
  There may be in-line macros:
    FGCOL   - Insert the defined foreground (text) colour
    BGCOL   - Insert the defined background (page) colour



entities
--------
  This maps HTML named entities to the character specified. These are
  generally ISO 8859/1 entities, but includes many more than are 'officially'
  defined.
  The format is:
    <char><entity string>
  and the matching is both case sensitive and exact, ie, "ldquo" <> "ldquor".

  Unrecognised entities are output in square brackets, like "[&spades;]".
  Standard numerical entities less then 256 (like &#169; for '') are always
  converted. Unicode style numerical entities are not converted. There's one
  that crops up a lot, like "&#8641;". I'd implement that if I know what
  character it was supposed to be.

  The Euro character is 164, which is also the international currency symbol.
  It seems the location of this character differs from system to system (even
  in RISC OS itself it differs!), with 164 being the most common placing as
  far as I could determine. It is given as both "eur" and "euro", the latter
  being the correct way...
  I am not handling this specially at this stage as the Euro font is built
  in to RISC OS 4; however I may (at a later time) optionally switch to the
  free font "EuroFont" if you are using an earlier OS.



ignoretags
----------
  These are tags that are 'unrecognised' by the OvHTML parser, but are known
  to exist, so we want to ignore them instead of flagging an error.



sidneyent
---------
  Additional maths and 'greek' characters. Not part of the standard ISO, is
  probably a UniCode thing (I reverse-engineered Oregano), so this will swap
  to "Sidney" font for these characters.
  If you don't have Sidney installed, then output will be a regular 'failed
  entity', like "[&spades;]".

  Other entities, like "&Scaron;" ('S' with upside down '^' over it) are not
  handled, neither are "&zwnj;" and similar, due to the likelihood that there
  will not be a compatible character set installed.



translate
---------
  For HTML translations. Please refer to OvHTML's documentation.
  

