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