xwiki管理指南-皮肤
XWiki皮肤可以用于定制
皮肤由以下组成:
- Velocity templates
- CSS files (stylesheets)
- Javascript files
- Images
所有这些组件存储在XWiki Enterprise实例所在的服务器容器上, 位于 webapps/xwiki/ 文件夹。每个XWiki皮肤都有自己的目录。
默认XWiki皮肤
一个XWiki Enterprise实例默认包含一些皮肤：
XWiki所有皮肤位于XWiki Enterprise所在servlet容器的webapps/xwiki/skins文件夹下。
XWiki 皮肤使用级别
皮肤可以用在不同的级别：
- 对于整个XWiki Enterprise。如果没有皮肤设置为其他级别，页面会使用全局的皮肤。
- 对于XWiki Enterprise 中的空间。它的优先级高于全局的级别。
- 对于特定用户。它的优先级高于空间的级别。欲了解更多详细信息，请检查教程。
- 对于其它定制级别，可以通过修改皮肤内的Velocity模板来创建（例如，可以为特定的页面或者特定用户组等设置皮肤）。
更换皮肤
要改变皮肤，用户必须有administrating的权限。在拥有这些权限的情况下，请确保在您的个人资料里切换到高级模式，以使顶部main 菜单上的出现高级选项。
如何预览皮肤
想要看一个页面更换皮肤后的效果，你可以URL后面添加一个skin的参数。例如，在wiki主页面预览新创建的皮肤，使用下面的URL:http://localhost:8080/xwiki/bin/view/Main/WebHome/?skin=toucan。如果你想用在名为文档MySpace.MySkinDoc下预览页面效果，请使用以下URL:http://localhost:8080/xwiki/bin/view/Main/WebHome/?skin=MySpace.MySkinDoc。
在全局级别更改皮肤
每个XWiki Enterprise 包含一个皮肤文件。为了找出哪些文件是用来存储当前的皮肤，用户必须按照下列步骤操作：
- 点击"Administer Wiki"进入管理页面
- 点击"Presentation"
- 点击skin部分的Customize按钮
- 点击Edit进入Objects模式
- 有多个文本区域，您可以覆盖你的皮肤的默认行为
- 点击Save and View
在空间级别更改皮肤
一个XWiki的空间可以有自己的皮肤。例如，如果你想在你的主空间设置你的皮肤，你应该遵循以下步骤：
- 进入到主空间的任意一个页面
- 从顶部空间的菜单中，单击“Administer Space”打开主空间的管理界面
- 点击"Presentation"
- 如果您已定义其他的皮肤，你应填写皮肤的目录名。皮肤的名称是区分大小写的。
- 点击Save
- 如果你打开主空间的任何页面，你会发现皮肤已经被修改
在用户级别更改皮肤
如果你想为特定用户更改皮肤，请按照下列步骤操作：
- 进入到用户的个人资料页面
- 点击Edit进入页面Objects模式
- 设置“skin”属性值（在Objects of type XWiki.XWikiUsers下面）来更改皮肤（必须使用小写字母）
- 点击Save and View
- 现在对于该用户，所有页面都被应用为新的皮肤