Confluence 从模板创建宏

从模板创建宏用于在页面显示按钮，然后通过按钮链接到特定的模板。

当用户单击按钮后，宏将会在编辑器中打开，然后可以开始准备添加一个新页面，新的页面通过给定的模板进行进行新增内容。

当添加这个宏到页面的时候，你可以可以指定一个蓝图或者这个宏创建的模板。你也可以为显示的按钮进行命名和定义新增页面所在的空间。

示例

屏幕截图：一个有三个按钮的页面，所有的按钮都是通过 '从模板创建宏' 创建的



参数

宏参数的定义为，你可以使用这些参数在宏输出的内容和格式上进行定义。

Confluence 使用的存储格式或者 wikimarkup 格式中使用的参数和在宏浏览器中使用的标签是不同的。

?

这些将会在下面在括号内容中列出(example)。

参数是否是必须默认值说明按钮文本（Button Text）?'Create from Template'当用户查看到这个宏的时候，宏显示的文本。模板名字（Template Name）?None选择新页面使用的模板或者蓝图。在当前空间中可用的全局或者用户新建的模板（除非你指定了空间的关键字字段）。模板标题（Template Title）?空白为新建的页面指定默认的标题（可选的）。你可以在标题中使用 @currentDate，@spaceName 和 @spaceKey 变量。空间关键字（Space Key）?新建的空间默认使用的是当前的空间支持唯一的空间定义（空间关键字），来确定新页面在那个空间中进行创建。

存储格式可以使用的参数与宏浏览器中使用的参数是不同的，具体请参考下面的表格：

参数名称是否必须默认值参数描述和可以接受的值templateId用户创建的模板是必须需要的(None)用户创建模板的 ID。这个 ID 是唯一的 ID，Confluence 使用这个 ID 来为你指定模板，例如：299630593。
为了找到这个 ID，编辑你需要的模板，然后在你的浏览器中的地址栏中查看你的 URL。模板 ID 在 URL 中的参数 entityId 中。blueprintModuleCompleteKey需要蓝图(None)?templateNameYes(None)用户创建模板的 ID（例如：299630593）或者符合要求的名字，这个名字是在蓝图插件中定义的，（例如：com.atlassian.confluence.plugins.[color=#3b73af !important]confluence-shared-files-plugin:file-list-blueprint）。buttonLabelYes'Create from Template'在页面中使用这个宏应该显示的名字。spaceKeyYes空间的名字，默认是当前空间空间的唯一定义，为了指定新页面在那个空间中创建。TitleNo(None)新建页面使用的标题，你可以在标题中使用 你可以在标题中使用 @currentDate，@spaceName 和 @spaceKey 变量。这个变量将会覆盖蓝图模板中使用的标题。

来源：http://cwiki.ossez.com/pages/viewpage.action?pageId=2393253