skinconf.xml

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 dependend 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:

<DAISY_HOME>/daisywiki/webapp/daisy/sites/skinconf.xml

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

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>
  <pageNavigationInMenu>true</pageNavigationInMenu>
  <menuOnTop>true</menuOnTop>
</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 (you will likely still need to create this path):
  

  <DAISY_HOME>/daisywiki/webapp/daisy/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)
• pageNavigationInMenu: (default false) instructs to put the page navigation and the variants list, which by default are put in the right column, in the global menu instead
• menuOnTop: (default false) instructs to put the global menu completely at the top of the screen

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