Confluence 6 使用 Decorator 宏

时间 2019-11-12

标签 confluence 使用 decorator 繁體版

原文原文链接

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

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

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

`#breadcrumbs()`	建立 "You are here" 的列表，像在默认模板中的上面页面的名字。
`#includePage(pageTitle)`	在 Confluence 页面中包含指定 title。若是你有 2 个或者多个页面有相同的页面标题在多个空间的话，这个宏将会只包含当前你查看的空间中的页面。
`#searchbox()`	在页面插入查找对话框，例如默认模板上右侧的查找链接。
`#globalnavbar(type)`	插入全局导航栏，例如默认模板右侧的导航。这个导航栏能够用2中方式显示。
`#globalnavbar("table")`	在默认模块中显示导航栏，例如将鼠标移动到上面显示的彩色背景。
`#globalnavbar("text")`	显示导航栏以一些连接进行分割。ide
`#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+Macrosui