你可以通过编辑布局文件来修改 Confluence 的外观和感觉(也可以被称为装饰)。编辑这些文件将会允许你对整个 Confluence 站点的外观和感觉进行修改或者仅仅是一个独立的空间。
当你对一个站点的布局进行编辑的时候,你需要修改每一个空间的默认布局调整文件,除了那些已经被被编辑过的的。请参考 Customize Space Layouts 页面来获得有关编辑单独空间的的相关信息。
同时你还需要具有 System Administrator 的权限来对站点进行修改。
如果你编辑了你的 Confluence 布局,那么每次你升级 Confluence 后你都需要对布局进行重新编辑。越多的自定义修改将会导致在升级的时候需要进行更多的工作。请查看页面 Upgrading Customized Site and Space Layouts 来确定在升级之前需要进行什么工作。
Confluence 是使用开源 SiteMesh 库进行网站页面的全局布局的。
希望对 Confluence 的布局进行调整,你需要编辑这些 decorator 文件。一个 decorator file 文件使用的是扩展文件名.vmd
,这些文件是使用 Velocity 写的。你可以从 Velocity User Guide 中获得更多的使用指南。
一旦你熟悉 Velocity 的使用后,你可以对 decorator 文件进行编辑来对 Confluence 的展示进行自定制。
Confluence 中的 decorator 文件使用下面的一些分类:
- 站点布局(Site layouts):这个被用于在站点页面中控制所有的布局,例如,页头,页脚和主面板。
- 内容布局(Content layouts):这个被用于控制页面和博客页面中的内容。这个不能用来修改页面自己的显示,但是可以调制页面中的评论,附件的显示位置等。
- 导出布局(Export layouts): 这些文件被用来控制空间和页面如何导出成 HTML。
https://www.cwiki.us/display/CONFLUENCEWIKI/Customising+Site+and+Space+Layouts