Wiki source code of Skin
Version 12.1 by Raluca Stavro on 2009/12/09
Hide last authors
| author | version | line-number | content |
|---|---|---|---|
 |
6.2 | 1 | #startfloatingbox() |
| 2 | *Contents* | ||
| 3 | #toc ("2" "3" "") | ||
| 4 | #endfloatingbox() | ||
| 5 | |||
| |
1.37 | 6 | 1 Skins |
| 7 | |||
| 8 | A skin is a set of images, [CSS files], [a layout>CSS Layout] and XWiki templates allowing to change the layout of the wiki. | ||
| 9 | |||
| 10 | A skin is usually developped by administrators and graphics designers and can be used to change the look of a XWiki installation for: | ||
| 11 | - one page | ||
| 12 | - one user | ||
 |
2.3 | 13 | - one [space>xwiki:FAQ.WhatIsASpace] |
| |
1.37 | 14 | - the whole wiki |
| 15 | |||
| 16 | A skin can have multiple Stylesheets which are switchable by the users and can stay active using a cookie. | ||
| 17 | |||
| 18 | 1.1 Changing the skin | ||
| 19 | |||
| 20 | There are several levels and ways to change the skin. Here's the order in which XWiki looks for a skin: | ||
| |
1.38 | 21 | # First XWiki checks if the request has a "skin" parameter. Thus to quickly apply a skin to a page, append ~~?skin=\<skin name\>~~ to the end of a XWiki URL. The default skin is named "default". |
| |
1.37 | 22 | # Then the user's preference is checked for a "skin" element. This allows to have a different skin per user. Right now there's no inline view for that element so you'll need to edit your user's profile in "Edit Objects" mode (only available when using the Advanced View). For example to edit the objects for the JohnSmith user you would use the following URL: ~~http://\<server\>/xwiki/bin/edit/XWiki/JohnSmith?editor=object~~ |
| 23 | # Then the Space preferences are checked for a "skin" element. This can be changed by using the "Administration" link. | ||
 |
6.1 | 24 | # Then the global preferences are checked for a "skin" element. This can be changed by using the "Administration" link. Simply replace XWiki.DefaultSkin with the name of the skin you wish to use. If your skin is in your /skins directory, simply type its name in the field ("toucan" or "albatross" for instance.) |
| |
1.37 | 25 | # Then the default base skin name is used if defined. It's defined in ~~xwiki.cfg~~ under the ~~xwiki.defaultbaseskin~~ property. |
| 26 | # Then the default skin is used if defined. It's defined in ~~xwiki.cfg~~ under the ~~xwiki.defaultskin~~ property. | ||
| 27 | # Then the skin named "default" is used. This is skin on the file system in the XWiki webapp, in the ~~skins/~~ directory | ||
| 28 | |||
| 29 | #info("The Default Base Skin is the skin used when you create a new skin using the XWiki.XWikiSkins objects (as explained below) and when you don't specify the 'base skin' field.") | ||
| 30 | |||
 |
12.1 | 31 | To learn more about XWiki Skins, check the [Skins tutorial>DevGuide.Skins] from inside the XWiki Developer Guide. |
| |
1.37 | 32 | |
 |
5.1 | 33 | 1.1 Useful tools |
| 34 | |||
| |
7.1 | 35 | * [Firebug>http://www.getfirebug.com/] is very useful for customizing quickly an XWiki skin |
| |
8.1 | 36 | * On a Mac with OS X and Safari 4 the Web Console works similar to Firebug but it seems to be more precise when highlighting the space allocated by an element. |
| |
5.1 | 37 | |
| |
7.1 | 38 |
