Engine Schema

An XML format for describing GTK+ theme engine options. It provides both the documentation of engine options for themers and structured information that can be used by applications to allow the configuration of an engine. Currently the only utility that makes use of schema files is GNOME Color Chooser. Murrine Configurator/GTKConf plan to support them.

A draft for the next version (0.2) has already been finished, including an XSD XML Schema and an engine schema validator for engine authors as well as frontends so that they don't have to check for valid syntax, entries and values on their own.

Types

• color
• boolean
• enumeration
• integer [minimum, maximum]
• real [minimum, maximum, precision (default: 1)]

Option Properties

• mandatory:
  • name
  • type
  • default

Translatable Tags

• long_name
• description
• comment
• label

Download

• current engine schemas: engine_schemas-2008-02-04.tar.gz

Example

<?xml version="1.0" encoding="UTF-8"?>
<engine module_name="murrine" long_name="Murrine" schema_version="0.1">

  <metainfo>
    <version>1.2.3</version>
    <website>http:///fooo</website>
    <author>
      <name>Mr Murrine Author</name>
      <email>murrine@example.com</email>
    </author>
  </metainfo>


  <option name="animation" type="boolean" default="TRUE">
    <long_name>Animation</long_name>
    <description xml:lang="en">Enable or Disable Animations on Progressbars, Radio-, and CheckButtons</description>
  </option>

  <option name="roundness" type="integer" default="3">
    <minimum>0</minimum>
    <maximum>8</maximum>
    <long_name>Roundness</long_name>
    <long_name xml:lang="de">Rundheit</long_name>
    <description xml:lang="en">Change Roundness of Widgets</description>
    <comment xml:lang="en">Clearlooks-like roundness is 3</comment>
  </option>

  <option name="scrollbar_type" type="enumeration" default="1">
    <long_name>Scrollbar Type</long_name>
    <long_name xml:lang="en">Scrollbar Type</long_name>
    <long_name xml:lang="de">Scrollbar Typ</long_name>
    <enumeration value="0">
      <label>Rectangle</label>
      <label xml:lang="en">Rectangle</label>
      <label xml:lang="de">Rechteck</label>
    </enumeration>
    <enumeration value="1">
      <label>Shaped</label>
      <label xml:lang="en">Shaped</label>
      <label xml:lang="de">Geformt</label>
    </enumeration>
  </option>

  <option name="scrollbar_color" type="color" default="#999999">
    <!-- possible values are: all valid gdk colors -->
    <long_name>Scrollbar Color</long_name>
    <description xml:lang="en">Set the Color of Scrollbars</description>
  </option>

</engine>