将热门标签宏添加到页面以突出显示整个Confluence站点或空间内使用的最流行的标签。热门标签是已添加到许多页面的标签。

这非常适合显示在您的站点中流行的标签,例如在知识库中。

截图:热门标签宏显示了20个最流行标签的热图。


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

在页面中添加宏

在页面中添加Popular Labels宏:

  1. 从编辑器工具栏中,选择插入(Insert) > 其它宏(Other Macros)
  2. Reporting类别中选择Popular Labels
  3. 输入参数并选择您希望标签的显示方式。
  4. 点击Insert

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

截图:指定空间关键字、标签数量和热图显示样式。

修改宏参数

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

要更改宏参数:

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

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

参数

默认值

描述

Number of Labels to Display
(count

100

指定要在热图中显示的标签总数。

Restrict Labels to this Space Key
(spaceKey

none

将热门标签列表限制在指定的空间内。

Style of Labels
(style

list

  • list – 将热门标签显示为列表,按流行程度排序(从高到低)。
  • heatmap – 根据标签的流行度,为每个标签使用不同的字体大小显示热门的标签,按标签名称排序。

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

其它添加方式

用键盘输入添加宏

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

通过wiki标记添加宏

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

Macro name: popular-labels

Macro body: None.

{popular-labels:style=heatmap|count=20|spaceKey=ds}
CODE