User guide for Theme Plugin usage in ConE

-----------------------------------------

Introduction

'''''''''''''

This page describes how to use ConE Theme plugin. Theme plugin extracts the theme content from the

.cpf file. It needs a .thememl file in the implml folder

The thememl syntax is a extension of Configuration markup language (confml). The term in confml for this extension 

is implementation method language (implml), which in thememl case is a xml file. 

Theme elements

''''''''''''''

The root element of the theme file is always thememl, which defines the xml namespace (xmlns) 

to http://www.s60.com/xml/thememl/1 in the current version. 

Theme example

^^^^^^^^^^^^^

.. literalinclude:: theme.thememl

   :language: xml

carbideuiPath

^^^^^^^^^^^^^^

To create a the Theme plugin uses makepackage.bat file which is under the forder described in

carbideuiPath tag. If none is setted the default is then C:\Program Files\Nokia\Carbide.ui Theme Edition 3.4 

themeDir

^^^^^^^^

Theme plugin available themes from this directory setted as confml ref

activeTheme 

^^^^^^^^^^^

One may describe a theme in this tag. You may have them as many as you want.

It may hold one refSetting tag and several platformUID tags 

**activeTheme attributes**

Each flag attribute can have unique hexa values.

  * uid 

refSetting 

^^^^^^^^^^

A ref confml setting key that describes the name of the .tpf file. Tpf file must always locate in the 

content folder

platformUID 

^^^^^^^^^^^

Is a ref in conml it may contain some value, but it will be replaced in the theme plugin to value

given by the .pkg file and setted back to configuration. You may have more than one of these 

Note 

^^^^^

The current implementation of the theme plugin relays the the .tpf file contain a .project file and 

it contains themepackage.pkg file

XSD

'''

Download: :download:`thememl.xsd </xsd/thememl.xsd>`

FAQ

'''

Makepackage error

'''''''''''''''''

This problem is related to installation on Carbide.ui you can get it form

here http://www.forum.nokia.com/info/sw.nokia.com/id/bb173537-4e67-496f-9967-50917d5cfc47/S60_Theme_Studio_for_Symbian_OS.html

Install it. Goes by default to C:\Program Files\Nokia\Carbide.ui Theme Edition 3.4, but if you install it

to a different location then you need to set right path to carbideuiPath tag. Chek that your system supports java

programmin language. OPen command line editor and type java -version should be 1.5 or above 

My theme is not created to image

''''''''''''''''''''''''''''''''

Change the .tpf file extension to zip and extract it to some folder.

View the contents, there should be .project file and themepackage.pkg file, if not

then ConE cannot create you a theme to an image.