<
From version < 25.2 >
edited by Sorin Burjan
on 2011/04/07
To version < 25.3 >
edited by Sorin Burjan
on 2011/04/07
>
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -11,12 +11,12 @@
11 11  
12 12  = XWiki Skins =
13 13  
14 -{{id name="s1"/}}
14 +
15 15  == What is a XWiki Skin used for? ==
16 16  
17 17   A XWiki Skin is used to customize the interface of a XWiki Enterprise instance.
18 18  
19 -{{id name="s2"/}}
19 +
20 20  == What are the components that define a XWiki Skin? ==
21 21  
22 22   A XWiki Skin is composed of:
... ... @@ -26,42 +26,43 @@
26 26  * [[Javascript files>>platform:DevGuide.JavaScriptAPI]]
27 27  * Images
28 28  
29 - All these components are stored on the server that hosts the XWiki Enterprise instance, inside the (% class="sectionblockcodecolored directory" %)webapps/xwiki(%%) folder.
29 + All these components are stored on the server that hosts the XWiki Enterprise instance, inside the webapps/xwiki/ folder.
30 30  
31 -{{id name="s3"/}}
32 32  == How to change the Skin ==
33 33  
34 -{{id name="3a"/}}
33 +
35 35  === A. The default XWiki Skins ===
36 36  
37 37  A XWiki Enterprise instance contains several skins by default (See the [[Extensions wiki>>extensions:Main.WebHome]]), such as:
38 38  
39 -* the (% class="sectionblockcodecolored" %)[[albatross>>extensions:Extension.Albatross Skin]](%%) Skin
40 -* the (% class="sectionblockcodecolored" %)[[toucan>>extensions:Extension.Toucan Skin]](%%) Skin
41 -* the (% class="sectionblockcodecolored" %)[[colibri>>extensions:Extension.Colibri Skin]](%%) Skin and
42 -* other skins ( the full list of XWiki Skins that are included in your XWiki Enterprise instance can be found on the server filesystem, inside the (% class="sectionblockcodecolored directory" %)webapps/xwiki/skins(%%) folder )
38 +* the [[Albatross>>extensions:Extension.Albatross Skin]] Skin
39 +* the [[Toucan>>extensions:Extension.Toucan Skin]] Skin
40 +* the [[Colibri>>extensions:Extension.Colibri Skin]] Skin
41 +* other skins ( the full list of XWiki Skins that are included in your XWiki Enterprise instance can be found on the server filesystem, inside the webapps/xwiki/skins folder )
43 43  
44 -{{id name="3b"/}}
45 45  === B. The usage level for a XWiki Skin ===
46 46  
47 47  A Skin can be used at different levels:
48 -* for the entire XWiki Enterprise (% class="sectionblockcodecolored" %)instance(%%) ( if there is no Skin set other levels, the pages will use the global (% class="sectionblockcodecolored" %)instance(%%) Skin )
49 -* for a (% class="sectionblockcodecolored" %)space(%%) inside the XWiki Enterprise instance ( it has a higher priority then the (% class="sectionblockcodecolored" %)instance(%%) level Skin )
50 -* for a specific (% class="sectionblockcodecolored" %)user(%%) (it has a higher priority then the (% class="sectionblockcodecolored" %)space(%%) level Skin) and
51 -* for other (% class="sectionblockcodecolored" %)custom(%%) levels that can be created by modifying the Velocity templates from inside the Skin ( for example, a Skin can be set for a specific page, for a specific group of users and so on )
46 +* for the entire XWiki Enterprise instance ( if there is no Skin set other levels, the pages will use the global instance Skin )
47 +* for a space inside the XWiki Enterprise instance ( it has a higher priority then the instance level Skin )
48 +* for a specific user (it has a higher priority then the space level Skin) and
49 +* for other custom levels that can be created by modifying the Velocity templates from inside the Skin ( for example, a Skin can be set for a specific page, for a specific group of users and so on )
52 52  
53 -{{id name="3c"/}}
54 -===C. Changing the Skin===
51 +
52 +=== C. Changing the Skin ===
53 +
55 55  {{warning}}To change the Skin, the user must have administrating rights. In the case that you have these rights, make sure that you switch to the Advanced mode in your profile, to enable the advanced options on the top main menu.{{/warning}}
56 56  
57 -{{id name="3c1"/}}
58 -====1. How to preview a Skin applied on a page====
59 - To check how a page looks on changing the Skin, you can add a parameter named (% class="sectionblockcodecolored" %)skin(%%) to the page URL. For example, to preview the wiki main page on using the (% class="sectionblockcodecolored" %)toucan(%%) Skin, use the following URL: http://localhost:8080/xwiki/bin/view/Main/WebHome/?skin=toucan . If you want to preview the page on using a Skin document named (% class="sectionblockcodecolored" %)MySpace.MySkinDoc(%%), use the following URL: http://localhost:8080/xwiki/bin/view/Main/WebHome/?skin=MySpace.MySkinDoc .
60 60  
61 -{{id name="3c2"/}}
62 -====2. Changing the Skin at (% class="sectionblockcodecolored" %)instance(%%) level====
63 - Each XWiki Enterprise instance contains a document ( (% class="sectionblockcodecolored" %)Skin Document(%%) ) that stores the Skin for the instance. To find out which document is used to store the current Skin, the user has to follow these steps:
57 +==== 1. How to preview a Skin applied on a page ====
64 64  
59 +To check how a page looks on changing the Skin, you can add a parameter named skin to the page URL. For example, to preview the wiki main page on using the toucan Skin, use the following URL: http://localhost:8080/xwiki/bin/view/Main/WebHome/?skin=toucan . If you want to preview the page on using a Skin document named MySpace.MySkinDoc, use the following URL: http://localhost:8080/xwiki/bin/view/Main/WebHome/?skin=MySpace.MySkinDoc .
60 +
61 +
62 +==== 2. Changing the Skin at instance level ====
63 +
64 +Each XWiki Enterprise instance contains a document Skin Document that stores the Skin for the instance. To find out which document is used to store the current Skin, the user has to follow these steps:
65 +
65 65  |(% style="width: 60%; color: rgb(34, 34, 34);" %)(((
66 66  1. go into the (% class="sectionblockcodecolored" %)Administration(%%) interface
67 67  1. go into the (% class="sectionblockcodecolored" %)Presentation(%%) section
... ... @@ -70,7 +70,7 @@
70 70  [[[[image:1.png||style="border: 3px solid rgb(221, 221, 221);" width="99%"]]>>attach:1.png]]
71 71  )))
72 72  
73 -{{id name="3c2steps"/}}
74 +
74 74  To change the current Skin, follow these steps:
75 75  
76 76  |(% style="width: 60%; color: rgb(34, 34, 34);" %)(((
... ... @@ -84,12 +84,13 @@
84 84  [[[[image:2.png||style="border: 3px solid rgb(221, 221, 221);" width="99%"]]>>attach:2.png]]
85 85  )))
86 86  
87 - You can now open any page inside the wiki instance and you will notice the layout difference.
88 +You can now open any page inside the wiki instance and you will notice the layout difference.
88 88  
89 -{{id name="3c3"/}}
90 -====3. Changing the Skin at (% class="sectionblockcodecolored" %)space(%%) level====
91 - A XWiki space can use it's own Skin. For example, if you want to set as Skin for the space (% class="sectionblockcodecolored" %)Main(%%) as being the (% class="sectionblockcodecolored" %)albatross(%%) Skin, follow these steps:
92 92  
91 +==== 3. Changing the Skin at space level ====
92 +
93 +A XWiki space can use it's own Skin. For example, if you want to set as Skin for the space (% class="sectionblockcodecolored" %)Main(%%) as being the (% class="sectionblockcodecolored" %)albatross(%%) Skin, follow these steps:
94 +
93 93  |(% style="width: 60%; color: rgb(34, 34, 34);" %)(((
94 94  1. go on any page inside the (% class="sectionblockcodecolored" %)Main(%%) space ( for example, go on the home page: http://localhost:8080/xwiki/bin/view/Main/ )
95 95  1. from the top right menu, choose (% class="sectionblockcodecolored" %)Administration -> Administer space: Main(%%) to open the (% class="sectionblockcodecolored" %)Administration(%%) interface for the space (% class="sectionblockcodecolored" %)Main
... ... @@ -99,9 +99,8 @@
99 99  [[[[image:3.png||style="border: 3px solid rgb(221, 221, 221);" width="99%"]]>>attach:3.png]]
100 100  )))
101 101  
102 - You can now open any page inside the (% class="sectionblockcodecolored" %)Main(%%) space and you will notice the layout difference.
104 +You can now open any page inside the (% class="sectionblockcodecolored" %)Main(%%) space and you will notice the layout difference.
103 103  
104 -{{id name="3d"/}}
105 105  
106 106  == More about XWiki Skins ==
107 107  

Get Connected