一個模板是一個在新建新頁面的時候可以使用的預定義的頁面。當你為一個頁面設置通用樣式和格式化的時候非常有用。
在 Confluence 中,有下面 2 個位置來存儲你的頁面模板:
- 空間模板:這些頁面模板只在指定的空間中有效。用戶需要具有空間管理員的權限才能夠從空間管理員界面中定義這些模板。
- 全局模板:這些模板在站點的所有空間內都有效。用戶需要具有系統管理員的權限才能夠從 Confluence 管理員控制台界面中定義這些模板。
添加一個空間模板
空間的模板只在一個空間中有效。
向空間中添加一個模板:
進入空間然后在邊欄中選擇選擇 空間工具 > 內容工具(Space tools > Content Tools)。
這是創建模板的屏幕將會顯示出來,按照下面的描述信息添加內容。
添加一個全局模板
全局模板在你 Confluence 站點中的所有空間可用。
希望添加一個全局模板:
- 在屏幕的右上角單擊 控制台按鈕
,然后選擇 Confluence Admin 鏈接。
- 在左側面板中選擇 全局模板(Global Templates)。
- 選擇 增加新全局模板(Add New Global Template)。
新建模板屏幕將會顯示出來,按照下面的描述信息添加內容。
使用模板編輯器
下面的圖片顯示類模板編輯器的頁面,我們可以在其中看到一些圖片,文字,樣式和變量。
當模板包含變量時的結果
這個屏幕截圖顯示了從包含了有變量的模板創建頁面的情況。請查看頁面 使用一個模板新建一個頁面 中的內容。
向你的模板添加內容
為你的模板添加一個名字。
在你模板的內容輸入文本,然后使用編輯工具欄來應用格式布局和格式。你可以添加鏈接和和格式。你也可以添加鏈接宏。一般來說,你可使用和在 Confluence 頁面中一樣在模板編輯使用。更多的,你可以添加變量到頁面中。
下面我們將說明一些有關模板的特殊應用。
標簽
選擇 標簽(Labels)來在模板中添加一個或者更多標簽。這個標簽將會自動添加到使用這個模板創建的所有頁面中。
圖片和其他附件
你可以附件一個圖片或者其他文件到模板中。可選的是,附件文件到其他頁面中然后將其插入到模板正文中。
例如:
- 你可以附加一個圖片到頁面中然后選擇 插入 > 圖片(Insert > Image)來嵌入圖片到模板中。
- 你可以附件 PDF 文件到頁面中然后選擇 插入 > 其他宏 > PDF (Insert > Other Macros > PDF )來向模板中嵌入 PDF 文件。
從字段顯示變量
你可以向你的模板中添加變量來響應字段。當有人通過這個模板創建一個的時候,Confluence 將會每一個字段顯示一個文本實體對話框。用戶可以在美國字段輸入數據然后這數據將會插入到新頁面中。
每一個變量必須有一個唯一的名字。如果在模板中添加變量超過一次的話,Confluence 將會確定他們有相同的變量當用戶保存頁面的時候。這個在你需要同樣的信息在同一個頁面中顯示多次的話非常有用。
插入一個變量到一個模板:
- 將鼠標在模板中移動到你希望插入變量的地方。
- 從編輯工具欄中選擇 模板 > 新變量(Template > New Variable)。可選的,你可以選擇一個已經存在變量的名字,如果你希望同一變量的在頁面顯示多次的話,你可以選擇已經存在的變量名。
- 輸入變量的名稱。
- 單擊 輸入(Enter)。默認的情況,這個將會創建一個單一行輸入字段。
- 希望修改變量的類型,單擊占位符。變量屬性對話框將會顯示出來。選擇一個變量類型:Text, Multi-line Text, 或者 List。 查看 下面 為每一個類型的描述。
使用自動完成加快變量輸入:輸入 $ 和變量的名稱,然后輸入回車來添加新的變量或者從建議列表選擇已經存在的變量。建議的的輸入將會從模板中選擇輸入。
可用的變量類型:
變量類型 | 描述 |
文本(Text) |
創建一個單一行的輸入文本。 屏幕截圖:一個稱為 |
多行文本(Multi-line text) |
創建一個多行行的輸入文本。 默認的情況下,這個文本輸入 5 行和 100 字符框。你可以修改通過在屬性框中輸入變量的數字來進行調整。 屏幕截圖:一個多行變量和屬性對話框 |
列表(List) |
創建一個下拉列表。 你必須為下拉列表中設置特定的變量。這個變量:
屏幕截圖:一個列表變量。 ![]() |
介紹文本
介紹文本允許你在模板占位符內添加內容。這個文本值在編輯界面的時候顯示,當用戶進行輸入內容的時候,這個內容將會消失。
希望在模板中插入介紹文本:
- 移動你的光標到你希望顯示介紹文本的地方。
- 在編輯器工具欄中選擇 模板 > 介紹文本(Template > Instructional Text)。
- 開始輸入 - 介紹文本將會按照斜體顯示,同時還有灰色的背景色。
你可以修改占位符類型,從文本到其他類型。包括一些觸發器,比如說,提到或者新建一 JIRA 問題。
下面介紹了可用的文本類型:
介紹文本類型
|
說明
|
---|---|
文本 | 創建一個一行文本,這個文本只在頁面進行編輯的時候顯示,文本顯示的是斜體和灰色的背景色。 |
提到用戶 | 創建一個一行文本,這個文本只在頁面進行編輯的時候顯示。當單擊的時候將會觸發 @mentions 對話框。 |
JIRA 問題 | 創建一個一行文本,這個文本只在頁面進行編輯的時候顯示。當單擊的時候將會觸發 JIRA 宏對話框。用戶可以在對話框中查找和新建 JIRA 問題。search for or create a new issue. |
在你的模板中添加一個描述信息
模板的描述信息將會在新建對話框中進行顯示,通常這個描述信息用於向用戶解釋這個模板的用戶。
添加一個描述信息到模板:
- 進入空間或者全局模板頁面(請參考本頁面上面提到的)。
- 選擇 編輯(Edit)按鈕,這個按鈕位於 描述(Description)列中。
- 輸入你的描述信息然后保存。
轉換一個存在的頁面為模板
如果你希望將一個已經存在的頁面轉換為模板,你可以拷貝頁面的內容然后張貼到模板編輯器中。Confluence 沒有提供自動轉換功能。
有關頁面中使用的附件,請參考 上面 章節有關的說明。
說明
- 你不能通過編輯對話框中的插入 Wiki 標記選項來插入變量。
-
頁面模板僅僅在添加一個頁面的時候使用。對於一個已經完成的頁面或者已經有內容的頁面,你不能將這個模板重新應用到這個頁面中。一旦使用一個模板新建一個頁面完成后,這個頁面與模板之間的聯系就已經斷開了。在對頁面進行后續編輯的時候,就好像這個模板從來沒有被使用過一樣。其中有一些插件將會被使用來提高模板的功能。你可以搜索 Atlassian 市場 (Marketplace) 來獲得更多有關模板的插件。
- 當你在模板中使用一個 內容列表(Table of Contents)宏 的時候,你將會在模板預覽的時候看到錯誤信息。但是這個宏在用戶使用模板創建頁面后可以正常工作 —— 內容列表在頁面保存后能夠正常顯示內容的列表。(這是因為模板沒有定義成頁面,但是內容列表宏只能在頁面中正常工作)。
- 模板編輯器在 Confluence 4.3 或者后續版本中可以用,請參考官方提供的早期文檔,如果你使用的 Confluence 版本過低的話。
- Confluence 同時也提供了一些系統模板,這些系統模板包含了一些歡迎信息和默認的空間內容,請參考管理站點模板中有關這部分內容的說明。
來源:http://cwiki.ossez.com/pages/viewpage.action?pageId=2393389