标签列表(Labels List)宏用于在页面中显示当前空间中的所有标签。单击标记列表宏中的链接,将会在当前空间中显示所有包含有指定标签的页面。
使用标签列表宏
希望在页面中使用标签列表宏:
- 打开你希望编辑 Confluence 页面,然后单击 编辑(Edit)按钮。页面的编辑模式将会被打开。
- 下一步,在编辑工具栏中单击宏浏览器图标。这时候宏浏览器将会在屏幕的中间打开。
- 在宏浏览器中,在窗口的右上角的对话框中输入你希望插入的宏的名称。当找到与你输入的宏名称接近的宏后将会在中间的面板上显示。单击需要的宏然后来查看可用进行配置的宏选项,在这里你可以对需要插入的宏设置相关参数,然后单击 插入(insert)来将需要的宏插入到页面中。
参数
宏参数的定义为,你可以使用这些参数在宏输出的内容和格式上进行定义。
Confluence 使用的存储格式或者 wikimarkup 格式中使用的参数和在宏浏览器中使用的标签是不同的,这些将会在下面在括号内容中列出(example
)。
参数 | 是否是必须 | 默认值 | 参数说明和可接受的值 |
---|
参数 | 是否是必须 | 默认值 | 参数说明和可接受的值 |
---|
限制的空间关键字(Restrict to this Space Key)
(spaceKey ) | No | 当前空间 | 空间的关键字,指定这个关键件字后将会在你指定的空间中进行查找。 |
去除标签(Excluded label(s))
(excludedLabels ) | No | Blank | 列出你不希望在页面中显示的标签。 |
代码示例
下面的代码是提供给希望进一步编辑 Confluence 页面的高级用户使用的。
宏名称:listlabels
宏内容: None
存储格式示例
< ac:structured-macro ac:name = "listlabels" >
< ac:parameter ac:name = "spaceKey" >
< ri:space ri:space-key = "DOC" />
</ ac:parameter >
< ac:parameter ac:name = "excludedLabels" >not-this-label</ ac:parameter >
</ ac:structured-macro >
|
Wiki 标记格式示例
{listlabels:spaceKey=DOC}
|