xwiki管理指南-皮肤

冷不防 2022-05-24 04:52 269阅读 0赞

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

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

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

# 默认XWiki皮肤 #

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

*  [Flamingo Skin][]
 *  [Colibri skin (从6.2-m2废弃)][Colibri skin _6.2-m2]
 *  [Toucan skin (从4.4-rc1开始废弃)][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][http_localhost_8080_xwiki_bin_view_Main_WebHome_skin_toucan]。如果你想用在名为文档MySpace.MySkinDoc下预览页面效果，请使用以下URL:[http://localhost:8080/xwiki/bin/view/Main/WebHome/?skin=MySpace.MySkinDoc][http_localhost_8080_xwiki_bin_view_Main_WebHome_skin_MySpace.MySkinDoc]。

### 在全局级别更改皮肤 ###

每个XWiki Enterprise 包含一个*皮肤文件*。为了找出哪些文件是用来存储当前的皮肤，用户必须按照下列步骤操作：

*  点击"Administer Wiki"进入管理页面
 *  点击"Presentation"
    
    ![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzMzODczNDMx_size_16_color_FFFFFF_t_70][]
 *  点击skin部分的**Customize**按钮
    
    ![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzMzODczNDMx_size_16_color_FFFFFF_t_70 1][]
 *  点击Edit进入Objects模式
    
    ![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzMzODczNDMx_size_16_color_FFFFFF_t_70 2][]
 *  有多个文本区域，您可以覆盖你的皮肤的默认行为
 *  点击**Save and View**

### 在空间级别更改皮肤 ###

一个XWiki的空间可以有自己的皮肤。例如，如果你想在你的主空间设置你的皮肤，你应该遵循以下步骤：

*  进入到主空间的任意一个页面
 *  从顶部空间的菜单中，单击“Administer Space”打开主空间的管理界面
 *  点击"Presentation"
    
    ![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzMzODczNDMx_size_16_color_FFFFFF_t_70 3][]
 *  如果您已定义其他的皮肤，你应填写皮肤的目录名。
    
    皮肤的名称是区分大小写的。
 *  点击**Save**
 *  如果你打开主空间的任何页面，你会发现皮肤已经被修改

### 在用户级别更改皮肤 ###

如果你想为特定用户更改皮肤，请按照下列步骤操作：

*  进入到用户的个人资料页面
 *  点击Edit进入页面Objects模式
 *  设置“skin”属性值（在Objects of type XWiki.XWikiUsers下面）来更改皮肤（必须使用小写字母）
    
    ![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzMzODczNDMx_size_16_color_FFFFFF_t_70 4][]
 *  点击**Save and View**
 *  现在对于该用户，所有页面都被应用为新的皮肤

[Flamingo Skin]: http://extensions.xwiki.org/xwiki/bin/view/Extension/Flamingo+Skin
[Colibri skin _6.2-m2]: http://extensions.xwiki.org/xwiki/bin/view/Extension/Colibri+Skin
[Toucan skin _4.4-rc1]: http://extensions.xwiki.org/xwiki/bin/view/Extension/Toucan+Skin
[http_localhost_8080_xwiki_bin_view_Main_WebHome_skin_toucan]: http://localhost:8080/xwiki/bin/view/Main/WebHome/?skin=toucan
[http_localhost_8080_xwiki_bin_view_Main_WebHome_skin_MySpace.MySkinDoc]: http://localhost:8080/xwiki/bin/view/Main/WebHome/?skin=MySpace.MySkinDoc
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzMzODczNDMx_size_16_color_FFFFFF_t_70]: /images/20220524/9d3c6239d1d54df9afe3dd9938fefef9.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzMzODczNDMx_size_16_color_FFFFFF_t_70 1]: /images/20220524/9719515459f2422ea612005ce52235f7.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzMzODczNDMx_size_16_color_FFFFFF_t_70 2]: /images/20220524/ff4e2ac51f5d4376b86afcfd3021417f.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzMzODczNDMx_size_16_color_FFFFFF_t_70 3]: /images/20220524/1d1dee410a974b75b8bddc5cbb8d1422.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzMzODczNDMx_size_16_color_FFFFFF_t_70 4]: /images/20220524/455f6d7e178340debd8ad37a953254a6.png