Export positions, games, matches and sessions in HTML
-----------------------------------------------------

gnubg can export the current position, game, match or session in HTML if
you wish to publish it on the web. A sample match
(http://home.online.no/~oeysteij/wc2002/final.html) with the World Cup
Final 2002 from Monte Carlo is available for viewing (FIXME: put a
match on gnu.org or gnubg.org instead).

gnubg exports in validating XHTML 1.0 (http://www.w3.org/TR/xhtml1/)
with the use of CSS (http://www.w3.org/TR/REC-CSS1) style sheets. You
may add your own style sheet to the exported HTML files if you wish to
override the default layout, e.g., change colors or fonts.

The board is made up from hundreds of pictures. Currently, you can
choose between three different sets of pictures: (a) the BBS images used
by Kit Woolsey's GammOnLine (http://www.GammOnLine.com) e-magazine,
Danish Backgammon Federation's (http://www.dbgf.dk/) web-based
discussion group and others, (b) the fibs2html images used by the
Joseph Heled's program fibs2html (http://fibs2html.sourceforge.net/),
and (c) images generated by gnubg itself. The images generated by gnubg
will have the same design as your current design, and honours your
settings on clockwise or anti-clockwise movement and board numbering
(on, off, dynamic).

If you export a match or session to HTML gnubg will write the
individual games to separate files. For example, if you export to file
`foo.html' the first game is exported to `foo.html', the second game to
`foo_002.html', the third game to `foo_003.html' and so forth.

The output from the HTML export can be customised. For example, it's
possible to leave out the analysis or parts of the analysis. Also, you
may enter a specific URL to the pictures used to compose the board
which is useful for posting positions on web-based discussion groups
such as Kit Woolsey's GammOnLine (http://www.GammOnLine.com), the
Danish Backgammon Federation's (http://www.dbgf.dk/) Debat Forum
(http://www.dbgf.dk/Debat/), or you may opt to use a default set of
images available from the gnubg web site at FIXME Add images to
www.gnubg.org! (http://www.gnubg.org/html-images/).

*Note Export::, for full details regarding the options available for
HTML export.

Description of the CSS stylesheet
.................................

As mentioned above gnubg writes a CSS stylesheet along with the
generated XHTML file. The CSS stylesheet may be written verbatim in the
header section of the XHTML file, to an external file named
`gnubg.css', or inside the tags using the `style' attribute. If you
wish to make any modifications to the stylesheet without modifying the
actual source code of gnubg you have to choose one of the first two
methods. Note that the special export for Kit Woolsey's GammOnLine
(http://www.GammOnLine.com) uses the third method since the XHTML is
pasted into a web page without the possibility to modify the header
section of the page where the style sheet is defined. Thus, it's not
possible to modify the style of the generated XHTML for GammOnLine
without modifications of the source code or extensive _search and
replace_ in the geneated XHTML.

Below follows a description of the CSS classes used in the XHTML export:

Class                  Description
.movetable             Style applied to the entire table used for
                       the move analysis
.moveheader            The header of the move analysis table
.movenumber            The rank number of a move in the move
                       analysis
.moveply               The column indicating the number of plies
                       or rollout
.movemove              The formatted move, e.g., 13/7 8/7.
.moveequity            The column with the equity or MWC.
.movethemove           Special style for row that contains the
                       actual move chosen by the player
.moveodd               Special style for the odd rows. Can be
                       used to give an alternating color for the
                       rows.
.percent               Style for the game winning probabilities
                       and equities in the move analysis.
.blunder               Emphasize blunders, e.g., ``Alert: missed
                       double'' or ``Alert: bad move''.
.joker                 Emphasize very good or bad rolls, e.g.,
                       ``Alert: unlucky roll''.
.stattable             The style applied to the entire table with
                       game, match, and session statistics
.stattableheader       The header row of the statistics table
.result                Style for the text indicating the outcome
                       of the game or match, e.g., ``Joern
                       Thyssen wins 16 points''.
.tiny                  Currently unsued.
.cubedecision          The style applied to the entire cube
                       decision table
.cubedecisionheader    Style for the header row of the cube
                       decision table
.cubeequity            Style for any equity or MWC in the cube
                       decision table
.cubeaction            Style for the text indicating the correct
                       cube action
.cubeply               Style for the text that states the level
                       of evaluation
.cubeprobs             Style for the game winning probabilities
                       in the cube decision table
.comment               The style applied to the entire table used
                       for annotations or comments, e.g., the
                       kibitzing from imported SGG files
.commentheader         The style applied to the header row of the
                       annotations' table
.number                Currently unsued
.fontfamily            Style applied to the entire body of the
                       XHTML document.
.block                 Style applied to the images in the export
                       to avoid gaps between individual pictures
                       both horisontally and vertically.
.positionid            Style for the Position ID and match ID.