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

05-11 15:57