Confluence 6 使用 Decorator 宏

Posted 2020-11-03

Decorator 宏（Macros）是 Velocity  宏。这个宏可以被用来在页面编辑 Custom decorators 中创建复杂或者可变的部分，例如菜单，页面其他部分等。Decorator 宏可以在你的模板中的任何位置插入。

这个宏可以用下面的方法插入到模板页面中： #macroName（"argument1" "argument2" "argument3"）。在参数直接不需要逗号进行分割。除非有特殊的说明，这个宏不需要参数。

注意：这个宏只能在自定义模板文件中使用 main.vmd。在其他的 decorators 中，这个宏可能没有效果。Decorator 宏在 Confluence 页面中不可用。

#breadcrumbs()	创建 "You are here" 的列表，像在默认模板中的上面页面的名字。
#includePage(pageTitle)	在 Confluence 页面中包含指定 title。如果你有 2 个或者多个页面有相同的页面标题在多个空间的话，这个宏将会只包含当前你查看的空间中的页面。
#searchbox()	在页面插入查找对话框，例如默认模板上右侧的查找连接。
#globalnavbar(type)	插入全局导航栏，例如默认模板右侧的导航。这个导航栏可以用2中方式显示。
#globalnavbar("table")	在默认模块中显示导航栏，例如将鼠标移动到上面显示的彩色背景。
#globalnavbar("text")	显示导航栏以一些链接进行分割。
#usernavbar()	显示创建用户指定的导航栏，这个导航栏有用户的属性和历史或者登录注册页面（如果用户没有登录的话）。
#helpicon()	在 Confluence 帮助页面显示帮助图标提供连接。。
#printableicon()	在页面的可打印版本中可见，将会画一个页面可打印的图标连接到页面打印的版本，否则将不会创建任何内容。
#pagetitle(class)	当你在 Confluence 空间中查看一个页面，创建页面所在的空间名。否则将会创建字符 "CONFLUENCE"。"class"参数是 CSS 的类名称，这个类被用来创建标题的样式。除非你有自定义的 CSS 文件被创建了，你应该使用 "spacenametitle" 进行调用，同时使用宏名称：#pagetitle（"spacenametitle"）
#poweredby()	输出 "Powered by Confluence" 和在 Confluence 默认页面的底部显示版本号。
#bottomshadow()	在默认模板中的底部显示阴影。
#dashboardlink()	插入一个连接到主面板页面中。

 

https://www.cwiki.us/display/CONFLUENCEWIKI/Working+With+Decorator+Macros