本文翻译自官方文档：https://confluence.atlassian.com/pages/viewpage.action?pageId=145566

将“标签内容”宏添加到您的页面，以显示具有特定标签的页面、博文或附件的列表。

此宏适用于将相关页面收集在一起并过滤掉您不想看到的内容。你可以：

  • 列出包含'Blueprint'一词并具有'feature-shipped'标签的所有页面
  • 列出您被@提及并具有'meeting-notes'标签的所有页面

截图：标签内容宏显示包含标签“printer”的所有页面。

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

在页面中添加宏

在页面中添加Content by Label宏：

  1. 从编辑器工具栏中，选择插入(Insert) > 其它宏（Other Macros）。
  2. 从Confluence content类别中选择Content by Label。
  3. 输入想要查询的标签。
  4. 添加其它筛选规则以进一步缩小查询范围。这些筛选规则可以使用CQL语法。
  5. 点击Show，可以设置宏参数。这些参数是可选的。 
  6. 点击Insert。 

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

截图：在两个空间中使用Content by Label宏按CQL搜索具有指定标签的内容

修改宏参数

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

要更改宏参数：

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

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

参数默认值描述
Sort byModified

Sort the list by title, the date it was created, or the date it was last modified. If you don't select an option, CQL default ordering by relevancy is used.

按标题、创建日期或上次修改日期对列表进行排序。如果您不选择选项，则默认按相关性排序。

Reverse sortFalse对列表进行降序而不是升序排序（Z - A，最前 - 最后）
Maximum number of pages15限制列表中的内容数量。这可以是不超过500的数值。
List titleBlank可以为宏设置一个附加的标题
Show labels for each pageTrue显示或隐藏每个条目的标签
Show space name for each pageTrue显示或隐藏每个条目的空间名称
Display excerptsFalse

Allows you to include a short excerpt under each page in the list. Choose between:

允许您在列表中的每个页面下包含一个简短的摘要。选择：

无 - 不显示摘录。
简单 - 显示任何返回页面的摘录宏中包含的第一行文本。 如果页面上没有摘录宏，则不会显示任何内容。
丰富的内容 - 显示摘录宏的内容，或者如果页面上没有摘录宏，则页面内容的第一部分，作为格式化文本，包括图像和一些宏。

  • None - 不显示摘要。
  • Simple - 显示页面的摘要宏中包含的第一行文本。如果页面上没有摘要宏，则不会显示任何内容。
  • Rich content - 显示摘要宏的内容，或者如果页面上没有摘要宏，则页面内容的第一部分，包含文本，图片和一些宏。
Exclude current pageFalse允许您从列表中排除出现宏的页面。在当前页面与要包含在列表中的页面都有相同的标签时，这很有用。

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

其它添加方式

用键盘输入添加宏

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

通过wiki标记添加宏

您不能使用wiki标记来添加此宏。