<?xml version="1.0" encoding="utf-8"?>
<section id="S__theme"><title>Themes</title>
  <para>This module provides a common interface to specify custom colors and icons
  for transformations to presentation-oreinted formats.  This allows similar
  output for different types of input documents.  Theme information may either
  be passed in as XSLT parameters or specified in a theme file.</para>
  <remark>Describe the format of theme files.</remark>
  <variablelist><title>Parameters</title><varlistentry><term><link linkend="P__theme_color_background"><parameter>theme.color.background</parameter></link></term><listitem><para>The background color</para></listitem></varlistentry><varlistentry><term><link linkend="P__theme_color_link"><parameter>theme.color.link</parameter></link></term><listitem><para>The color of links</para></listitem></varlistentry><varlistentry><term><link linkend="P__theme_color_link_visited"><parameter>theme.color.link_visited</parameter></link></term><listitem><para>The color of visited links</para></listitem></varlistentry><varlistentry><term><link linkend="P__theme_color_text"><parameter>theme.color.text</parameter></link></term><listitem><para>The normal text color</para></listitem></varlistentry><varlistentry><term><link linkend="P__theme_color_text_light"><parameter>theme.color.text_light</parameter></link></term><listitem><para>The light text color</para></listitem></varlistentry><varlistentry><term><link linkend="P__theme_color_blue_background"><parameter>theme.color.blue_background</parameter></link></term><listitem><para>The blue background color</para></listitem></varlistentry><varlistentry><term><link linkend="P__theme_color_blue_border"><parameter>theme.color.blue_border</parameter></link></term><listitem><para>The blue border color</para></listitem></varlistentry><varlistentry><term><link linkend="P__theme_color_gray_background"><parameter>theme.color.gray_background</parameter></link></term><listitem><para>The gray background color</para></listitem></varlistentry><varlistentry><term><link linkend="P__theme_color_gray_border"><parameter>theme.color.gray_border</parameter></link></term><listitem><para>The gray border color</para></listitem></varlistentry><varlistentry><term><link linkend="P__theme_color_red_background"><parameter>theme.color.red_background</parameter></link></term><listitem><para>The red background color</para></listitem></varlistentry><varlistentry><term><link linkend="P__theme_color_red_border"><parameter>theme.color.red_border</parameter></link></term><listitem><para>The red border color</para></listitem></varlistentry><varlistentry><term><link linkend="P__theme_color_yellow_background"><parameter>theme.color.yellow_background</parameter></link></term><listitem><para>The yellow background color</para></listitem></varlistentry><varlistentry><term><link linkend="P__theme_color_yellow_border"><parameter>theme.color.yellow_border</parameter></link></term><listitem><para>The yellow border color</para></listitem></varlistentry><varlistentry><term><link linkend="P__theme_icon_admon_path"><parameter>theme.icon.admon.path</parameter></link></term><listitem><para>The default path to the admonition icons</para></listitem></varlistentry><varlistentry><term><link linkend="P__theme_icon_admon_size"><parameter>theme.icon.admon.size</parameter></link></term><listitem><para>The size of the admonition icons</para></listitem></varlistentry><varlistentry><term><link linkend="P__theme_icon_admon_bug"><parameter>theme.icon.admon.bug</parameter></link></term><listitem><para>The path for the bug admonition icon</para></listitem></varlistentry><varlistentry><term><link linkend="P__theme_icon_admon_caution"><parameter>theme.icon.admon.caution</parameter></link></term><listitem><para>The path for the caution admonition icon</para></listitem></varlistentry><varlistentry><term><link linkend="P__theme_icon_admon_important"><parameter>theme.icon.admon.important</parameter></link></term><listitem><para>The path for the important admonition icon</para></listitem></varlistentry><varlistentry><term><link linkend="P__theme_icon_admon_note"><parameter>theme.icon.admon.note</parameter></link></term><listitem><para>The path for the note admonition icon</para></listitem></varlistentry><varlistentry><term><link linkend="P__theme_icon_admon_tip"><parameter>theme.icon.admon.tip</parameter></link></term><listitem><para>The path for the tip admonition icon</para></listitem></varlistentry><varlistentry><term><link linkend="P__theme_icon_admon_warning"><parameter>theme.icon.admon.warning</parameter></link></term><listitem><para>The path for the warning admonition icon</para></listitem></varlistentry><varlistentry><term><link linkend="P__theme_watermark_path"><parameter>theme.watermark.path</parameter></link></term><listitem><para>The default path to the watermark graphics</para></listitem></varlistentry><varlistentry><term><link linkend="P__theme_watermark_blockquote"><parameter>theme.watermark.blockquote</parameter></link></term><listitem><para>The path for the blockquote watermark graphic</para></listitem></varlistentry><varlistentry><term><link linkend="P__theme_watermark_code"><parameter>theme.watermark.code</parameter></link></term><listitem><para>The path for the code block watermark graphic</para></listitem></varlistentry></variablelist><refentry id="P__theme_color_background"><indexterm><primary>theme.color.background</primary></indexterm><refnamediv><refname><parameter>theme.color.background</parameter></refname><refpurpose>The background color</refpurpose></refnamediv><refsection><title>Description</title>
  <para>This parameter specifies the default background color.</para>
  </refsection></refentry><refentry id="P__theme_color_link"><indexterm><primary>theme.color.link</primary></indexterm><refnamediv><refname><parameter>theme.color.link</parameter></refname><refpurpose>The color of links</refpurpose></refnamediv><refsection><title>Description</title>
  <para>If set, this parameter specifies the color for unvisited links.</para>
  </refsection></refentry><refentry id="P__theme_color_link_visited"><indexterm><primary>theme.color.link_visited</primary></indexterm><refnamediv><refname><parameter>theme.color.link_visited</parameter></refname><refpurpose>The color of visited links</refpurpose></refnamediv><refsection><title>Description</title>
  <para>This parameter specifies the color for visited links.</para>
  </refsection></refentry><refentry id="P__theme_color_text"><indexterm><primary>theme.color.text</primary></indexterm><refnamediv><refname><parameter>theme.color.text</parameter></refname><refpurpose>The normal text color</refpurpose></refnamediv><refsection><title>Description</title>
  <para>This parameter specifies the default color for normal text.</para>
  </refsection></refentry><refentry id="P__theme_color_text_light"><indexterm><primary>theme.color.text_light</primary></indexterm><refnamediv><refname><parameter>theme.color.text_light</parameter></refname><refpurpose>The light text color</refpurpose></refnamediv><refsection><title>Description</title>
  <para>This parameter specifies the color for light text.  The light text
  color is used to make bold headings and certain parenthetical text less intense.</para>
  </refsection></refentry><refentry id="P__theme_color_blue_background"><indexterm><primary>theme.color.blue_background</primary></indexterm><refnamediv><refname><parameter>theme.color.blue_background</parameter></refname><refpurpose>The blue background color</refpurpose></refnamediv><refsection><title>Description</title>
  <para>This parameter specifies the blue background color.  The blue
  background color may be used by certain types of block elements.</para>
  </refsection></refentry><refentry id="P__theme_color_blue_border"><indexterm><primary>theme.color.blue_border</primary></indexterm><refnamediv><refname><parameter>theme.color.blue_border</parameter></refname><refpurpose>The blue border color</refpurpose></refnamediv><refsection><title>Description</title>
  <para>This parameter specifies the blue border color.  The blue
  border color may be used by certain types of block elements.</para>
  </refsection></refentry><refentry id="P__theme_color_gray_background"><indexterm><primary>theme.color.gray_background</primary></indexterm><refnamediv><refname><parameter>theme.color.gray_background</parameter></refname><refpurpose>The gray background color</refpurpose></refnamediv><refsection><title>Description</title>
  <para>This parameter specifies the gray background color.  The gray
  background color may be used by certain types of block elements.</para>
  </refsection></refentry><refentry id="P__theme_color_gray_border"><indexterm><primary>theme.color.gray_border</primary></indexterm><refnamediv><refname><parameter>theme.color.gray_border</parameter></refname><refpurpose>The gray border color</refpurpose></refnamediv><refsection><title>Description</title>
  <para>This parameter specifies the gray border color.  The gray
  border color may be used by certain types of block elements.</para>
  </refsection></refentry><refentry id="P__theme_color_red_background"><indexterm><primary>theme.color.red_background</primary></indexterm><refnamediv><refname><parameter>theme.color.red_background</parameter></refname><refpurpose>The red background color</refpurpose></refnamediv><refsection><title>Description</title>
  <para>This parameter specifies the red background color.  The red
  background color may be used by certain types of block elements.</para>
  </refsection></refentry><refentry id="P__theme_color_red_border"><indexterm><primary>theme.color.red_border</primary></indexterm><refnamediv><refname><parameter>theme.color.red_border</parameter></refname><refpurpose>The red border color</refpurpose></refnamediv><refsection><title>Description</title>
  <para>This parameter specifies the red border color.  The red
  border color may be used by certain types of block elements.</para>
  </refsection></refentry><refentry id="P__theme_color_yellow_background"><indexterm><primary>theme.color.yellow_background</primary></indexterm><refnamediv><refname><parameter>theme.color.yellow_background</parameter></refname><refpurpose>The yellow background color</refpurpose></refnamediv><refsection><title>Description</title>
  <para>This parameter specifies the yellow background color.  The yellow
  background color may be used by certain types of block elements.</para>
  </refsection></refentry><refentry id="P__theme_color_yellow_border"><indexterm><primary>theme.color.yellow_border</primary></indexterm><refnamediv><refname><parameter>theme.color.yellow_border</parameter></refname><refpurpose>The yellow border color</refpurpose></refnamediv><refsection><title>Description</title>
  <para>This parameter specifies the yellow border color.  The yellow
  border color may be used by certain types of block elements.</para>
  </refsection></refentry><refentry id="P__theme_icon_admon_path"><indexterm><primary>theme.icon.admon.path</primary></indexterm><refnamediv><refname><parameter>theme.icon.admon.path</parameter></refname><refpurpose>The default path to the admonition icons</refpurpose></refnamediv><refsection><title>Description</title>
  <para>This parameter specifies a default path where admonition icons can be found.
  This is only a default path.  It has no effect on admonition icons for which
  the corresponding parameter has been specified explicitly.</para>
  </refsection></refentry><refentry id="P__theme_icon_admon_size"><indexterm><primary>theme.icon.admon.size</primary></indexterm><refnamediv><refname><parameter>theme.icon.admon.size</parameter></refname><refpurpose>The size of the admonition icons</refpurpose></refnamediv><refsection><title>Description</title>
  <para>This parameter specifies the size of the icons given in <parameter><link linkend="P__theme_icon_admon_bug">theme.icon.admon.bug</link></parameter>,
  <parameter><link linkend="P__theme_icon_admon_caution">theme.icon.admon.caution</link></parameter>, <parameter><link linkend="P__theme_icon_admon_important">theme.icon.admon.important</link></parameter>, <parameter><link linkend="P__theme_icon_admon_note">theme.icon.admon.note</link></parameter>,
  <parameter><link linkend="P__theme_icon_admon_tip">theme.icon.admon.tip</link></parameter>, and <parameter><link linkend="P__theme_icon_admon_warning">theme.icon.admon.warning</link></parameter>.  The value of this parameter
  should be a single integer specifying both the width and the height in pixels.  Icon
  sizes are assumed to be square.</para>
  </refsection></refentry><refentry id="P__theme_icon_admon_bug"><indexterm><primary>theme.icon.admon.bug</primary></indexterm><refnamediv><refname><parameter>theme.icon.admon.bug</parameter></refname><refpurpose>The path for the bug admonition icon</refpurpose></refnamediv><refsection><title>Description</title>
  <para>This parameter specifies the icon used for bug admonitions.</para>
  </refsection></refentry><refentry id="P__theme_icon_admon_caution"><indexterm><primary>theme.icon.admon.caution</primary></indexterm><refnamediv><refname><parameter>theme.icon.admon.caution</parameter></refname><refpurpose>The path for the caution admonition icon</refpurpose></refnamediv><refsection><title>Description</title>
  <para>This parameter specifies the icon used for caution admonitions.</para>
  </refsection></refentry><refentry id="P__theme_icon_admon_important"><indexterm><primary>theme.icon.admon.important</primary></indexterm><refnamediv><refname><parameter>theme.icon.admon.important</parameter></refname><refpurpose>The path for the important admonition icon</refpurpose></refnamediv><refsection><title>Description</title>
  <para>This parameter specifies the icon used for important admonitions.</para>
  </refsection></refentry><refentry id="P__theme_icon_admon_note"><indexterm><primary>theme.icon.admon.note</primary></indexterm><refnamediv><refname><parameter>theme.icon.admon.note</parameter></refname><refpurpose>The path for the note admonition icon</refpurpose></refnamediv><refsection><title>Description</title>
  <para>This parameter specifies the icon used for note admonitions.</para>
  </refsection></refentry><refentry id="P__theme_icon_admon_tip"><indexterm><primary>theme.icon.admon.tip</primary></indexterm><refnamediv><refname><parameter>theme.icon.admon.tip</parameter></refname><refpurpose>The path for the tip admonition icon</refpurpose></refnamediv><refsection><title>Description</title>
  <para>This parameter specifies the icon used for tip admonitions.</para>
  </refsection></refentry><refentry id="P__theme_icon_admon_warning"><indexterm><primary>theme.icon.admon.warning</primary></indexterm><refnamediv><refname><parameter>theme.icon.admon.warning</parameter></refname><refpurpose>The path for the warning admonition icon</refpurpose></refnamediv><refsection><title>Description</title>
  <para>This parameter specifies the icon used for warning admonitions.</para>
  </refsection></refentry><refentry id="P__theme_watermark_path"><indexterm><primary>theme.watermark.path</primary></indexterm><refnamediv><refname><parameter>theme.watermark.path</parameter></refname><refpurpose>The default path to the watermark graphics</refpurpose></refnamediv><refsection><title>Description</title>
  <para>This parameter specifies a default path where watermark graphics can be found.
  This is only a default path.  It has no effect on watermark graphics for which
  the corresponding parameter has been specified explicitly.</para>
  </refsection></refentry><refentry id="P__theme_watermark_blockquote"><indexterm><primary>theme.watermark.blockquote</primary></indexterm><refnamediv><refname><parameter>theme.watermark.blockquote</parameter></refname><refpurpose>The path for the blockquote watermark graphic</refpurpose></refnamediv><refsection><title>Description</title>
  <para>This parameter specifies the graphic file used for blockquote watermarks.  Note
  that the default graphic is translatable.  If you set this parameter, you should
  ensure that your graphic uses a suitable quote character for the language your
  document is written in.</para>
  </refsection></refentry><refentry id="P__theme_watermark_code"><indexterm><primary>theme.watermark.code</primary></indexterm><refnamediv><refname><parameter>theme.watermark.code</parameter></refname><refpurpose>The path for the code block watermark graphic</refpurpose></refnamediv><refsection><title>Description</title>
  <para>This parameter specifies the graphic file used for code block watermarks.</para>
  </refsection></refentry></section>
