将标签列表宏添加到页面,可以创建空间中使用的所有标签的目录。然后,人们可以单击标签以查看带有该标签的所有页面的列表。

这个宏提供了另一种查找空间内容的方式,尤其是当您使用Confluence处理流程、程序或其它文档时。


截图:带有标签列表宏的页面,可帮助人们查找指定主题的帮助指南


关于在Confluence中使用标签的文档,请参阅Add, Remove and Search for Labels

在页面中添加宏

在页面中添加Labels List宏:

  1. 从编辑器工具栏中,选择插入(Insert) > 其它宏(Other Macros)
  2. Confluence content类别中选择Labels List
  3. 输入一个空间关键字,以及您可能想要排除的任何标签。
  4. 点击Insert。 

然后,您可以发布您的页面以查看宏的效果。

截图:标签列表宏配置为显示IT Help空间中的标签,并排除标签“test”和“testing”。


修改宏参数

宏参数用于设置宏的行为。

要更改宏参数:

  1. 在编辑器中,点击宏占位符并选择“编辑(Edit)”。
  2. 根据需要设置参数,然后选择“插入(Insert)”。

这是此宏中可用的参数列表。

参数名

必填

默认值

描述

Restrict to this Space Key
(spaceKey

No

Current space

要显示其标签的空间的关键字。

Excluded label(s)
(excludedLabels
NoBlank您不想出现在列表中的标签。

如果Confluence存储格式或wiki标记中使用的参数名称与浏览器中使用的参数名称不同,则会在参数名下方用括号列出,例如(example)。

其它添加方式

用键盘输入添加宏

输入左大括号{,然后输入宏名称的几个起始字符,就可以看到一个相关的宏列表。

通过wiki标记添加宏

当您想在编辑器之外添加宏时,这非常有用。例如作为侧边栏、空间页眉或页脚中的自定义内容。

Macro name: listlabels

Macro body: None.

{listlabels:spaceKey=DOC}
CODE