1. 程式人生 > >Confluence 6 自定義空間佈局

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