5.11 Daisy Wiki Skinning

Customising the look and feel of the Daisy Wiki is possible through:

• configuration of an existing skin, via the skinconf.xml
• creation of a custom skin

Daisy ships with one skin called default.

The skin to use is configurable on the level of a site in the siteconf.xml file. Thus different sites can use different skins.

Pages not belonging to a particular site (such as the login screen, the sites index page, etc.) use a globally configured skin, defined in the global siteconf.xml file:

<wikidata directory>/sites/siteconf.xml

If this file does not exist, the skin called default will be used. The content of the global siteconf.xml file should be like this:

<siteconf xmlns="http://outerx.org/daisy/1.0#siteconf">
  <skin>default</skin>
</siteconf>

5.11.1 skinconf.xml

5.11.1.1 Introduction

The skinconf.xml file is simply an XML file which is merged in the general XML stream and is available to the XSLT stylesheets, most specifically the layout.xsl. This allows to pass configuration information to XSLT stylesheets. The actual supported configuration will be dependent on the XSLT, and thus on the skin. The supported configuration for the default skin is given below.

A skinconf.xml file can be put in the site directory, or in the global sites directory:

<wikidata directory>/sites/skinconf.xml

If a site doesn't have its own skinconf.xml file, it will fall back to using the global one.

5.11.1.2 default skin skinconf.xml

<skinconf>
  <logo>resources/local/mylogo.png</logo>
  <daisy-home-link>Daisy Home</daisy-home-link>
  <site-home-link>Site Home</site-home-link>
</skinconf>

Each of the parameters (= XML elements) is optional.

The parameters quite speak for themselves:

• logo: the path of the logo to put in the left-top corner. If you don't create a custom skin, you can for example put it at the following location:
  

  <wikidata directory>/resources/local

• daisy-home-link: alternative text for the "Daisy Home" link (in the top-right corner)
• site-home-link: alternative text for the "Site Home" link (in the top-right corner)

It can take up to 10 seconds before changes made to a skinconf.xml file are noticed.