Confluence 添加一个模板

一个模板是一个在新建新页面的时候可以使用的预定义的页面。当你为一个页面设置通用样式和格式化的时候非常有用。

 

在 Confluence 中，有下面 2 个位置来存储你的页面模板：

• 空间模板：这些页面模板只在指定的空间中有效。用户需要具有空间管理员的权限才能够从空间管理员界面中定义这些模板。
• 全局模板：这些模板在站点的所有空间内都有效。用户需要具有系统管理员的权限才能够从 Confluence 管理员控制台界面中定义这些模板。

 

添加一个空间模板

空间的模板只在一个空间中有效。

向空间中添加一个模板：

进入空间然后在边栏中选择选择 空间工具 > 内容工具（Space tools > Content Tools）。

 

 

这是创建模板的屏幕将会显示出来，按照下面的描述信息添加内容。

本页面的内容：

• 添加一个空间模板
• 添加一个全局模板
• 使用模板编辑器
  • 当模板包含变量时的结果
• 向你的模板添加内容
  • 标签
  • 图片和其他附件
  • 从字段显示变量
  • 介绍文本
• 在你的模板中添加一个描述信息
• 转换一个存在的页面为模板
• 说明

相关页面：

• 使用一个模板新建一个页面
• 使用模板
• 标签列表（Labels List）宏
• 使用宏
• 使用内容编辑器
• Confluence 用户手册

添加一个全局模板

全局模板在你 Confluence 站点中的所有空间可用。

希望添加一个全局模板：

 

1. 在屏幕的右上角单击 控制台按钮  ，然后选择 Confluence Admin 链接。
2. 在左侧面板中选择 全局模板（Global Templates）。
3. 选择 增加新全局模板（Add New Global Template）。

 

新建模板屏幕将会显示出来，按照下面的描述信息添加内容。

使用模板编辑器

下面的图片显示类模板编辑器的页面，我们可以在其中看到一些图片，文字，样式和变量。

当模板包含变量时的结果

这个屏幕截图显示了从包含了有变量的模板创建页面的情况。请查看页面 使用一个模板新建一个页面 中的内容。

向你的模板添加内容

为你的模板添加一个名字。

在你模板的内容输入文本，然后使用编辑工具栏来应用格式布局和格式。你可以添加链接和和格式。你也可以添加链接宏。一般来说，你可使用和在 Confluence 页面中一样在模板编辑使用。更多的，你可以添加变量到页面中。

下面我们将说明一些有关模板的特殊应用。

标签

选择 标签（Labels）来在模板中添加一个或者更多标签。这个标签将会自动添加到使用这个模板创建的所有页面中。

图片和其他附件

你可以附件一个图片或者其他文件到模板中。可选的是，附件文件到其他页面中然后将其插入到模板正文中。

例如：

• 你可以附加一个图片到页面中然后选择 插入 > 图片（Insert > Image）来嵌入图片到模板中。
• 你可以附件 PDF 文件到页面中然后选择 插入 > 其他宏 > PDF （Insert > Other Macros > PDF ）来向模板中嵌入 PDF 文件。

 

从字段显示变量

你可以向你的模板中添加变量来响应字段。当有人通过这个模板创建一个的时候，Confluence 将会每一个字段显示一个文本实体对话框。用户可以在美国字段输入数据然后这数据将会插入到新页面中。

每一个变量必须有一个唯一的名字。如果在模板中添加变量超过一次的话，Confluence 将会确定他们有相同的变量当用户保存页面的时候。这个在你需要同样的信息在同一个页面中显示多次的话非常有用。

插入一个变量到一个模板：

1. 将鼠标在模板中移动到你希望插入变量的地方。
2. 从编辑工具栏中选择 模板 > 新变量（Template > New Variable）。可选的，你可以选择一个已经存在变量的名字，如果你希望同一变量的在页面显示多次的话，你可以选择已经存在的变量名。
3. 输入变量的名称。
4. 单击 输入（Enter）。默认的情况，这个将会创建一个单一行输入字段。
5. 希望修改变量的类型，单击占位符。变量属性对话框将会显示出来。选择一个变量类型：Text， Multi-line Text， 或者 List。 查看 下面 为每一个类型的描述。

使用自动完成加快变量输入：输入 $ 和变量的名称，然后输入回车来添加新的变量或者从建议列表选择已经存在的变量。建议的的输入将会从模板中选择输入。

可用的变量类型：

变量类型	描述
文本（Text）	创建一个单一行的输入文本。 屏幕截图：一个称为 $purpose 的模板变量和属性框
多行文本（Multi-line text）	创建一个多行行的输入文本。 默认的情况下，这个文本输入 5 行和 100 字符框。你可以修改通过在属性框中输入变量的数字来进行调整。 屏幕截图：一个多行变量和属性对话框
列表（List）	创建一个下拉列表。 你必须为下拉列表中设置特定的变量。这个变量： 必须使用逗号分隔符。 可以使用文本，数字，特殊字符和空格。 不能包含逗号（除了列表分隔符）Cannot include commas (except as the list separation character). 屏幕截图：一个列表变量。

介绍文本

介绍文本允许你在模板占位符内添加内容。这个文本值在编辑界面的时候显示，当用户进行输入内容的时候，这个内容将会消失。

希望在模板中插入介绍文本：

1. 移动你的光标到你希望显示介绍文本的地方。
2. 在编辑器工具栏中选择 模板 > 介绍文本（Template > Instructional Text）。
3. 开始输入 - 介绍文本将会按照斜体显示，同时还有灰色的背景色。

你可以修改占位符类型，从文本到其他类型。包括一些触发器，比如说，提到或者新建一 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