Confluence 6 創建一個用戶宏
用戶用是在 Confluence 創建和和管理的,你需要有一定的編碼基礎才可以。
你需要具有系統管理員權限來創建和應用用戶自定義宏。
希望創建一個新的用戶宏:
進入 > 基本配置(General Configuration) > 用戶宏(User Macros)
選擇 創建一個用戶宏(Create a User Macro)
輸入宏的一些詳細信息(請查看下面列表)
單擊 添加(Add)
宏名稱(Macro name) | 宏的名字,將會出現在代碼中。 |
可見(Visibility) | 這個選項控制誰可以在宏瀏覽器中查看這個宏或者自動完成功能。選項有:
請註意,如果你選擇僅系統管理員可見的話,用戶任然可以看到用在頁面中輸出的結果,宏的占位符也還是在編輯頁面中出現的,這個僅僅在宏瀏覽器和自動完成的時候隱藏了。 所有宏的信息都是可以找到的,包括宏的標題,描述,參數名稱和其他元數據。盡管宏只能被系統管理員查看到,也請不要在用戶宏中定義任何敏感信和保密信息。 |
宏標題(Macro Title) | 在宏瀏覽器和自動完成功能中出現的宏標題。 |
描述(Description) | 這個描述信息將會出現在宏瀏覽器中。宏瀏覽器的查找將會對查找字段在宏標題和描述中的文字進行匹配。 |
分類(Categories) | 為你的宏在宏瀏覽器中選擇一個或多個分類。 |
圖標 URL(Icon URL) | 如果你希望宏瀏覽器為你的宏顯示圖標的話,輸入絕對地址(例如 http://mysite.com/mypath/status.png )或相對於 Confluence base URL 的相對地址(例如:/images/icons/macrobrowser/status.png ) 。 |
文檔 URL(Documentation URL) | 如果你的宏有文檔的話,請在這裏輸入文檔的 URL。 |
宏內容處理(Macro Body Processing) | 指定 Confluence 應該如何處理你的宏的內容。 宏的內容中包含了在 Confluence 頁面中如何處理的信息。如果你的宏有一個內容,所有宏的內容將會在 處理宏內容字段選項包括有:
|
模板(Template ) | 這裏是你寫的代碼去確定宏應該是什麽樣子的。
請查看 Writing User Macros 要麽獲得更多的信息和示例。 |
希望使用插件完成編輯?
如果你希望將你的自定義宏按照插件進行分發的話,請參考 User Macro plugin module 頁面中的內容。如果你希望使用更加復雜,更加程序化的宏的話,你需要寫成 Macro plugin 宏。
https://www.cwiki.us/display/CONFLUENCEWIKI/Writing+User+Macros
Confluence 6 創建一個用戶宏