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

 

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章