Confluence 6 使用 Decorator 宏

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

原文地址:http://blog.51cto.com/ossez/2114656

时间: 2024-07-30 10:41:41

Confluence 6 使用 Decorator 宏的相关文章

Confluence 6 识别慢性能的宏

Page Profiling 给你了有关页面在载入的时候操作缓慢的邪教,你可以将下面的内容添加到调试(debug)级别: Version 3.1 及其后续版本 设置包名字为 com.atlassian.renderer.v2.components.MacroRendererComponent 到 DEBUG 级别.你可以在 管理(Administration) >> Logging and Profiling 中进行设置. 3.1 之前的版本 下载 WikiMarkupParser.class

Confluence 6 用户宏示例 - Hello World

下面示例显示了如何创建一个用户宏,在这个用户宏中显示文本 'Hello World!' 和任何用户在宏内容中输入的内容. Macro name helloworld Visibility Visible to all users in the Macro Browser Macro Title Hello World Description Displays "Hello World" and the macro body. Categories Confluence Content

Confluence 6 用户宏示例 - NoPrint

这个示例演示了如何创建一个用户宏,这个宏包括了在查看页面中显示的内容,但是不被打印. Macro name noprint Visibility Visible to all users in the Macro Browser Macro Title No Print Description Hides text from printed output. Categories Confluence Content Icon URL You can leave this field blank

Confluence 6 创建一个用户宏

如果你想创建自定义的宏的话,用户宏能够帮你完成这个任务.这个可以在你系统中应用特定的操作,比如说应用自定义格式等. 用户用是在 Confluence 创建和和管理的,你需要有一定的编码基础才可以. 你需要具有系统管理员权限来创建和应用用户自定义宏. 希望创建一个新的用户宏: 进入  > 基本配置(General Configuration) > 用户宏(User Macros) 选择 创建一个用户宏(Create a User Macro) 输入宏的一些详细信息(请查看下面列表) 单击 添加(

Confluence 6 用户宏示例 - Formatted Panel

下面的用演示了如果还写一个用户宏,并在这个宏中创建一个格式化的面板,并且指定颜色.将会创建下面的面板: (Title) 注意:这个面板的标题为空,如果你没有给这个面板标题参数的话. Macro name formpanel Visibility Visible to all users in the Macro Browser Macro Title Formatted Panel Description Creates a panel preformatted with specific co

Confluence 6 用户宏示例 - Color and Size

这个示例定义了如何向你宏中传递参数.我们将会创建一个字体样式宏,在这个宏中有 2 个参数,允许用户在这 2 个参数中指定宏中包含的字体的颜色大小. Macro name stylish Visibility Visible to all users in the Macro Browser Macro Title Stylish Description Applies colour and size to text. Categories Confluence Content Icon URL

Confluence 6 用户宏最佳实践

这个页面为你在创建用户宏的最佳实践中包含了一些小技巧和建议. 为你的宏添加一个简短的描述 我们鼓励你为你的宏在 模板(Template )添加一个备注的描述,可以参考下面的显示的内容: ## Macro title: My macro name ## Macro has a body: Y or N ## Body processing: Selected body processing option ## Output: Selected output option ## ## Develop

Confluence 6 在你用户宏中使用参数

你可以为你的用户宏指定参数.这样的话,用户可以使用参数来决定 Confluence 页面的显示情况. 如何在 Confluence 页面中使用你的宏参数 当添加一个宏到 Confluence 页面中的时候,宏浏览器将会为每一个选择的宏显示输入字段,这个输入字段就是你需要指定的参数. 定义参数 在模板中的参数定义为: @param 参数的名称 一系列属性(可行). 格式: ## @param MYNAME:title=MY TITLE|type=MY TYPE|desc=MY DESCRIPTIO

Confluence 6 访问你的宏正文(body)

请查看 Writing User Macros 页面获得有关如何写用户宏的介绍. 这个页面介绍你可以在用户宏中可以使用的的代码信息. 访问你的宏正文(body) 在你用户宏模板中的 $body 对象可以访问访问到传递到你宏正文中的内容. 当你的宏有指定的正文的时候,$body 对象是可用的(换句话说,如果你没有选择 No macro body 的话). 示例:让我们假定你的宏的名称为  helloworld. 在下面的模板中输入下面的内容: Hello World: $body 当编辑 Conf