最近使用的标签(Recently Used Labels)宏用于在 Confluence 页面中显示你最近在页面和博客页面中使用的标签。
你可以定义标签的显示数量和使用这些标签的位置(在当前空间,你的个人空间,站点空间或者全局空间)。
使用最近使用的标签宏
希望在页面中使用最近使用的标签宏:
- 打开你希望编辑 Confluence 页面,然后单击 编辑(Edit)按钮。页面的编辑模式将会被打开。
- 下一步,在编辑工具栏中单击宏浏览器图标。这时候宏浏览器将会在屏幕的中间打开。
- 在宏浏览器中,在窗口的右上角的对话框中输入你希望插入的宏的名称。当找到与你输入的宏名称接近的宏后将会在中间的面板上显示。单击需要的宏然后来查看可用进行配置的宏选项,在这里你可以对需要插入的宏设置相关参数,然后单击 插入(insert)来将需要的宏插入到页面中。
参数
宏参数的定义为,你可以使用这些参数在宏输出的内容和格式上进行定义。
Confluence 使用的存储格式或者 wikimarkup 格式中使用的参数和在宏浏览器中使用的标签是不同的,这些将会在下面在括号内容中列出(example
)。
参数 | 默认值 | 说明 |
---|
参数 | 默认值 | 说明 |
---|
标签显示的数量(Number of Labels to Display)
(count ) | 10 | 指定在列表中显示标签的数量。默认的标签显示数量是 10。 |
获取标签的位置(Scope for Retrieving Labels)
(scope ) | global | 指定标签获取的位置,可以使用的值如下: - global — 覆盖 Confluence 安装的所有的站点空间(不包括个人空间)。
- space — 当前空间。
- personal — 你所拥有的个人空间。
|
列表样式(List Style)
(style ) | list | - list – 按照水平列表方式显示。
- table – 包含有其他一些信息,包括有页面添加的标签和谁添加了这些标签。
|
表格标题(Table Title)
(title ) | none | 在表格样式的顶部添加一个标题。标题只有在 列表样式(List Style)参数被设置为表格(table)的时候可见。 |
代码示例
下面的代码是提供给希望进一步编辑 Confluence 页面的高级用户使用的。
宏名称: recently-used-labels
宏内容: None
存储格式示例
< ac:structured-macro ac:name = "recently-used-labels" >
< ac:parameter ac:name = "title" >My title</ ac:parameter >
< ac:parameter ac:name = "scope" >space</ ac:parameter >
< ac:parameter ac:name = "style" >table</ ac:parameter >
< ac:parameter ac:name = "count" >20</ ac:parameter >
</ ac:structured-macro >
|
Wiki 标记格式示例
{recently-used-labels:title=My title|scope=space|style=table|count= 20 }
|