Confluence 6 使用 Decorator 宏

原创

HoneyMoose 2021-08-11 09:44:10 博主文章分类：Confluence ©著作权

文章标签 导航栏 css 自定义 ico 创建用户 文章分类 Java 后端开发

©著作权归作者所有：来自51CTO博客作者HoneyMoose的原创作品，请联系作者获取转载授权，否则将追究法律责任

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()`	插入一个连接到主面板页面中。