Reference - Branding Toolkit for Keyman Developer Professional
- activate.xsl: Product Activation Dialog
- downloadkeyboard.xsl: Download Keyboard Dialog
- elements.xsl: Basic XSL elements
- installkeyboard.xsl: Install Keyboard Dialog
- keyman.xsl: Keyman Desktop Configuration Window
- keyman_addins.xsl: Keyman Desktop Configuration window - Addins tab
- keyman_footer.xsl: Keyman Desktop Configuration window - Footer
- keyman_hotkeys.xsl: Keyman Desktop Configuration window - Hotkeys tab
- keyman_keyboardlist.xsl: Keyman Desktop Configuration window - Keyboards tab
- keyman_addins.xsl: Keyman Desktop Configuration window - Languages tab
- keyman_menu.xsl: Keyman Desktop Configuration window - Menu
- keyman_options.xsl: Keyman Desktop Configuration window - Options tab
- keyman_support.xsl: Keyman Desktop Configuration window - Support tab
- manualactivate.xsl: Manual Activation dialog
- onlineupdate.xsl: Online Update dialog
- proxyconfiguration.xsl: Proxy Configuration dialog
- splash.xsl: Splash dialog
- welcome.xsl: Welcome dialog
Note
You must purchase a licence for the Branding Pack before you can use the Branding Editor or the Distribution Editor in Keyman Developer.
This reference sections details the customisable screens, actions and parameters for each dialog. Some generic parameters and targets are available for every screen.
XML Parameters
XML Parameters are passed in as part of the XML to the XSLT. The parameters are generally easy to use, for example, in the Keyboard Install dialog (installkeyboard.xsl), you can retrieve the descriptive name of the keyboard to be installed with the following code:
<xsl:value-of select="/Keyman/KeymanKeyboardFile/keyboardname" />
The following parameters are passed into every dialog and window:
<templatepath>(path to templates, for img src and includes)</templatepath> <scripttemplatepath>(path to templates for embedding in script)</scripttemplatepath> <defaultlocalepath>(path to default locale file)</defaultlocalepath> <localepath>(path to currently selected locale file)</localepath>
Targets
Keyman Desktop Configuration is controlled by linking to specially formed URLs, for example:
<a href='keyman:link?url=http://www.tavultesoft.com'>Open the Tavultesoft website</a>
This example will open the Tavultesoft website in the user's default browser. Note that if just the http://www.tavultesoft.com URL had been passed, the website would have been opened within Keyman Desktop Configuration, which is probably not the desired behaviour!
| Target | Parameters | Description |
|---|---|---|
| keyman:link | url: url of website to open | Opens website url in user's default web browser. This should be used whenever linking to a website, instead of directly referencing the site, or using target='_blank' as both of these would open within the Keyman Desktop Configuration context. |
