添加相关标签宏,让人们可以导航到您网站中的相关内容。

它的工作原理是查找页面共有的标签。它获取当前页面上使用的标签,并搜索使用此标签的其它页面,然后列出在这些页面上找到的任何其它标签。

这个宏非常适用于:

  • 知识库文章
  • 流程和程序文档 

基本上任何您想要网站中相关页面地图的情况。随着时间的推移在页面上添加和删除标签,列表会自动更新。

截图:相关标签宏引导人们访问知识库中的相关文章。

在页面中添加宏

在页面中添加Related Labels宏:

  1. 从编辑器工具栏中,选择插入(Insert) > 其它宏(Other Macros)
  2. Confluence content类别中选择Related Labels
  3. 输入宏应查找的指定标签,或不填以使用页面上的任何标签。
  4. 点击Insert。 

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

截图:在宏浏览器中配置相关标签宏。

修改宏参数

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

要更改宏参数:

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

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

参数

默认值

描述

Restrict to these Labels
(labels

none

指定要查看的相关标签。例如:documentation、how-to

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

其它添加方式

用键盘输入添加宏

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

通过wiki标记添加宏

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

Macro name: related-labels

Macro body: None.

{related-labels:labels=choc,cake}
CODE