Confluence 6 自定义空间布局

你能够经过编辑布局文件来对 Confluence 的外观和表现进行编辑。这个页面将会告诉你如何来为空间自定义布局文件。你须要系统管理员的 全局权限（global permission） 和你但愿进行修改空间的 空间管理员权限（space administrator）。

具备系统管理员权限的用户能够对整个 Confluence 布局进行自定义和编辑。有关更多的信息，请参考页面 Customizing Site and Space Layouts 中的内容。在 Confluence 站点中针对全局布局的修改将会应用到全部使用默认布局的空间中。

任何空间布局的自定义修改将会覆盖全局配置的设置。

若是你经过下面的这些指南对 Confluence 的外观和布局进行修改，你须要在 Confluence 升级后对修改的内容从新进行编辑和修改。你对 Confluence 进行越深度的修改，那么在升级后须要修改的东西就越多，那么升级起来也就更加复杂和困难。

请在对 Confluence 进行定制和修改的时候将这个工做量考虑进去。

有关针对自定义进行更新的更多信息，请参考 Upgrading Customized Site and Space Layouts 页面中的内容。

Confluence 是使用开源的 SiteMesh 库进行构建的，一个 Web 页面布局可以在整个站点中提供完整和一致的外观和布局。SiteMesh 是经过 'decorators' 进行工做的，这个被定义在页面的布局和结构中。

但愿对 Confluence 的布局进行修改，你须要修改这些 decorator 文件。一个decorator 文件是使用 .vmd 为后缀名的，这些文件是使用很是简单的程序语言进行编辑的。这个程序语言被称为 Velocity。有关Velocity 的更多的内容，请参考 more about Velocity 页面。一旦你对 Velocity 比较熟悉之后，你能够对 decorator  文件进行编辑，来让 Confluence 中显示更多的个性化内容。

Confluence 中的 decorator 文件按照下面的方式进行分类：

• 站点布局（Site layouts）：这些文件被用来针对全局站点定义每个页面的控制和布局。例如，若是你但愿对页头和页脚进行修改，你须要修改这些文件。

• 内容布局（Content layouts）：这个文件被用来对页面中的内容和博客页面的内容进行修改和控制。这个不会修改页面本身的显示方式，可是可以容许对包含的评论和附件的显示方式进行修改。

• 导出布局（Export layouts）：这个控制空间和页面导出为 HTML 格式的显示方式，若是你使用 Confluence 建立静态网站的话，你须要对这些布局文件进行修改。

有关更多布局的修改，请参考 decorators 中的内容。

但愿编辑 decorator 文件：

1. 进入空间后，而后从边栏的底部选择 空间工具（Space tools） > 外观和感受（Look and Feel） 。
2. 选择 布局（Layout ）（Layout 仅仅在你是 Confluence 系统管理员的时候才会显示）。
   你能够看到空间的布局列表
3. 单击 建立自定义（Create Custom）来编辑默认的 vmd 文件。
   这个将会把 vmd 文件在编辑器模式中打开。若是你仅仅但愿查看 vmd 文件，单击 查看默认（View Default）。
4. 进行必要的修改后，而后单击 更新（Update）。

https://www.cwiki.us/display/CONF6ZH/Customize+Space+Layouts