xwiki管理指南-皮肤

XWiki皮肤可以用于定制 皮肤由以下组成:

• Velocity templates
• CSS files (stylesheets)
• Javascript files
• Images

所有这些组件存储在XWiki Enterprise实例所在的服务器容器上, 位于 webapps/xwiki/ 文件夹。每个XWiki皮肤都有自己的目录。

默认XWiki皮肤

一个XWiki Enterprise实例默认包含一些皮肤：

• Flamingo Skin
• Colibri skin (从6.2-m2废弃)
• Toucan skin (从4.4-rc1开始废弃)

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
• 现在对于该用户，所有页面都被应用为新的皮肤