Home > Customization (Skins) > SKSKIN File

Documentation for the SKSKIN File

The XML file with the .skskin extension is required for the correct display of the skins in the configuration tool and a browser.  There are browser layouts, start page layouts, on-screen keyboard layouts and skins.  For each layout, an .skskin file must exist in the SiteKiosk program files directory in the SKINS folder.

Please note:
Some basic knowledge is necessary to create a separate browser layout. For obvious reasons we cannot (apart from this documentation) provide free support for creating personalized skins.
1. General Structure of the SKSKIN File

To understand the context, it is often easiest look at an existing file. Also take a look at the .skskin file in Notepad or other text editor. Explained below are three examples of the different layout options with the major components of the corresponding SKSKIN file:

<skin name="TX82-Ultra English (floating)" filename="tx82-ultra_english_floating.skskin">
          <touchscreen>
                    <preview>skins\tx82-ultra\english\preview.png</preview>
                    <keydef>skins\tx82-ultra\english\tx82_ultra_english_docked.xml</keydef>
          </touchscreen>
</skin>
SKSKIN file for the "TX82-Ultra English (floating)" on-screen keyboard layout(tx82-ultra_english_floating.skskin).

<skin name="Default Skin" filename="Default.skskin">
          <browserskin name="Default Skin">
                    <preview>skins\Default\preview.png</preview>
                    <skindef>skins\Default\DefaultSkindef.xml</skindef>
          </browserskin>
</skin>
SKSKIN file for the "Default" browser layout (Default.skskin).

<skin name="Desktop Startpage" filename="DesktopStartpage.skskin">
          <startpage name="Desktop Startpage">
                    <preview>skins\Startpages\Desktop\preview.png</preview>
                    <startpagedef>skins\Startpages\Desktop\Desktop.xml</startpagedef>
          </startpage>
</skin>
SKSKIN file for the "Desktop" start page layout (DesktopStartpage.skskin).

2. Documentation for Elements and Attributes
The file consists of several elements which, like the HTML convention, have an opening and a closing tag such as <skin> as an opening and </skin> as a closing tag of the skin element. The associated attributes of the element are between the two tags. These elements can also have their own attributes.  It is also possible, to include data such as name=... to the opening tag.
2.1 skin:
There is a "skin" element in this file, with a "name" attribute which serves to identify the individual elements easier.  The attribute "filename" specifies a unique file name of a skin that is stored in the skins directory of SiteKiosk.
2.2 touchscreen:
Regarding on-screen keyboard layout, there will be a "touchscreen" element that contains the following information:
  1. preview:
    Relative path to the thumbnail "preview.png" in the SiteKiosk installation directory.
  2. keydef:
    Relative path to the definition file for on-screen keyboard layouts in the SiteKiosk installation directory.
2.3 browserskin:
Regarding browser layouts, there will be a "browserskin" element that contains the following information:
  1. preview:
    Relative path to the thumbnail "preview.png" in the SiteKiosk installation directory.
  2. skindef:
    Relative path to the definition file for browser layouts in the SiteKiosk installation directory.
2.4 startpage:
Regarding start page layouts, there will be a "startpage" element that contains the following information:
  1. preview:
    Relative path to the thumbnail "preview.png" in the SiteKiosk installation directory.
  2. startpagedef:
    Relative path to the definition file for start page layouts in the SiteKiosk installation directory.

See also

Manually Configurable Options
Language Files
Browser Layout
Keyboard Layout
Start Page Layout
Remapping Keys


Back To Top