具有系統管理員權限的用戶可以對整個 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 文件:
進入空間后,然后從邊欄的底部選擇空間工具(Space tools)>外觀和感覺(Look and Feel)。
選擇布局(Layout)(Layout僅僅在你是 Confluence 系統管理員的時候才會顯示)。
你可以看到空間的布局列表
單擊創建自定義(Create Custom)來編輯默認的 vmd 文件。
這個將會把 vmd 文件在編輯器模式中打開。如果你僅僅希望查看 vmd 文件,單擊查看默認(View Default)。
進行必要的修改后,然后單擊更新(Update)。