|
1 User guide for Theme Plugin usage in ConE |
|
2 ----------------------------------------- |
|
3 |
|
4 Introduction |
|
5 ''''''''''''' |
|
6 This page describes how to use ConE Theme plugin. Theme plugin extracts the theme content from the |
|
7 .cpf file. It needs a .thememl file in the implml folder |
|
8 |
|
9 |
|
10 The thememl syntax is a extension of Configuration markup language (confml). The term in confml for this extension |
|
11 is implementation method language (implml), which in thememl case is a xml file. |
|
12 |
|
13 |
|
14 Theme elements |
|
15 '''''''''''''' |
|
16 |
|
17 The root element of the theme file is always thememl, which defines the xml namespace (xmlns) |
|
18 to http://www.s60.com/xml/thememl/1 in the current version. |
|
19 |
|
20 Theme example |
|
21 ^^^^^^^^^^^^^ |
|
22 .. literalinclude:: theme.thememl |
|
23 :language: xml |
|
24 |
|
25 |
|
26 |
|
27 |
|
28 carbideuiPath |
|
29 ^^^^^^^^^^^^^^ |
|
30 |
|
31 To create a the Theme plugin uses makepackage.bat file which is under the forder described in |
|
32 carbideuiPath tag. If none is setted the default is then C:\Program Files\Nokia\Carbide.ui Theme Edition 3.4 |
|
33 |
|
34 |
|
35 |
|
36 themeDir |
|
37 ^^^^^^^^ |
|
38 Theme plugin available themes from this directory setted as confml ref |
|
39 |
|
40 |
|
41 activeTheme |
|
42 ^^^^^^^^^^^ |
|
43 |
|
44 One may describe a theme in this tag. You may have them as many as you want. |
|
45 It may hold one refSetting tag and several platformUID tags |
|
46 |
|
47 **activeTheme attributes** |
|
48 |
|
49 Each flag attribute can have unique hexa values. |
|
50 |
|
51 * uid |
|
52 |
|
53 |
|
54 refSetting |
|
55 ^^^^^^^^^^ |
|
56 A ref confml setting key that describes the name of the .tpf file. Tpf file must always locate in the |
|
57 content folder |
|
58 |
|
59 |
|
60 platformUID |
|
61 ^^^^^^^^^^^ |
|
62 Is a ref in conml it may contain some value, but it will be replaced in the theme plugin to value |
|
63 given by the .pkg file and setted back to configuration. You may have more than one of these |
|
64 |
|
65 |
|
66 Note |
|
67 ^^^^^ |
|
68 The current implementation of the theme plugin relays the the .tpf file contain a .project file and |
|
69 it contains themepackage.pkg file |
|
70 |
|
71 |
|
72 XSD |
|
73 ''' |
|
74 |
|
75 Download: :download:`thememl.xsd </xsd/thememl.xsd>` |
|
76 |
|
77 |
|
78 FAQ |
|
79 ''' |
|
80 |
|
81 Makepackage error |
|
82 ''''''''''''''''' |
|
83 |
|
84 This problem is related to installation on Carbide.ui you can get it form |
|
85 here http://www.forum.nokia.com/info/sw.nokia.com/id/bb173537-4e67-496f-9967-50917d5cfc47/S60_Theme_Studio_for_Symbian_OS.html |
|
86 Install it. Goes by default to C:\Program Files\Nokia\Carbide.ui Theme Edition 3.4, but if you install it |
|
87 to a different location then you need to set right path to carbideuiPath tag. Chek that your system supports java |
|
88 programmin language. OPen command line editor and type java -version should be 1.5 or above |
|
89 |
|
90 My theme is not created to image |
|
91 '''''''''''''''''''''''''''''''' |
|
92 |
|
93 Change the .tpf file extension to zip and extract it to some folder. |
|
94 View the contents, there should be .project file and themepackage.pkg file, if not |
|
95 then ConE cannot create you a theme to an image. |
|
96 |
|
97 |
|
98 |
|
99 |