将贡献者概要宏添加到页面以显示有关为此页面、指定页面或一组页面做出贡献的人员的统计信息。贡献者包括以下人员:

跟踪对高价值页面的贡献。

  • 页面的创建者或编辑者
  • 页面的评论者
  • 为页面添加标签的用户
  • 关注页面的用户

这个宏非常适合:

  • 协作排行榜
  • 识别高频的文档贡献者
  • 跟踪高价值页面的贡献者

截图:带有两个贡献者概要宏的页面,一个按用户显示,另一个按页面显示。

在页面中添加宏

在页面中添加Contributors Summary宏:

  1. 从编辑器工具栏中,选择插入(Insert) > 其它宏(Other Macros)
  2. Confluence content类别中选择Contributors Summary
  3. 选择是按用户还是按页面显示贡献
  4. 设置参数以优化您的查询
  5. 点击Insert。 

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

截图:在Contributors Summary宏中设置参数


修改宏参数

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

要更改宏参数:

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

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

参数

默认值

描述

Group By
(groupby

contributors

指定分组统计的维度:

  • contributors — 按贡献者统计
  • pages — 按页面统计

Columns to Display
(columns

edits,comments,labels

设置应出现在表格中的列。显示的统计信息或信息类型取决于使用Group By参数设置的分组基础。可以计算以下统计数据:

  • edits — 每个贡献者编辑页面的次数或对每个页面所做的编辑次数。
  • edited — 每个贡献者编辑过的页面列表或编辑过每个页面的贡献者列表。
  • comments — 每个贡献者向页面添加评论的次数或对每个页面的评论数量。
  • commented — 每个贡献者添加了评论的页面列表或对每个页面发表评论的贡献者列表。
  • labels — 每个贡献者在页面上添加标签的次数或对每个页面添加标签的数量。
  • labeled — 每个贡献者添加了标签的页面列表或为每个页面添加了标签的贡献者列表。
  • labellist — 每个贡献者添加的标签列表或在每个页面上添加的标签列表。
  • watches — 每个贡献者正关注的页面数或关注每个页面的贡献者数量。
  • watching — 每个贡献者正关注的页面列表或关注每个页面的贡献者列表。
  • lastupdate — 每个贡献者最后一次更新时间或每个页面上次更新的时间。有效的更新可以包括对页面的编辑、评论或标签修改。

    可以使用一列或多列。

Sort By
(order

edits

设置用于对表中的内容进行排序的标准。排序的内容取决于使用Group By参数设置的分组基础。排序标准是:

  • edits — 根据贡献者或页面所做的编辑总次数对表格中的内容进行排序。
  • name — 按字母顺序对表格中的内容进行排序,可以是贡献者也可以是页面名称。
  • editTime — 根据贡献者上次编辑页面(或一组指定页面)的时间或页面上次编辑的时间对表格中的内容进行排序。
  • update — 根据贡献者上次对页面(或一组指定的页面)做出任何贡献的时间或页面上次对其做出任何贡献的时间,对表中的内容进行排序。

Reverse Sort
(reverse

false

反转表中内容的排序顺序。(仅与Sort By参数结合使用。)

Maximum Number of Items
(limit

no limit

将表中的贡献者或页数限制为指定的值。如果未指定数字,则包括所有内容。

Show Anonymous Contributions?
(showAnonymous

false

包括页面的匿名贡献者。

Show Zero Counts?
(showZeroCounts

false

设置是否包括统计为零的贡献者或页面。

Page Name
(page

current

设置要统计数据的页面。 如果没有指定Page NameSpace(s)的值,则假定为当前页面。

Label(s)
(labels

none

Restricts the contribution-based statistics to the specified labels only. You can specify one or more labels, separated by commas.

限制为仅统计包含有指定标签的内容。 您可以指定一个或多个标签,以逗号分隔。

Space(s)
(spaces

current

指定包含指定页面名称的Confluence空间的关键字,或者指定要搜索的空间。 空间关键字区分大小写。

此参数还采用特殊值,包括:

  • @global — 全部网站空间
  • @personal — 全部个人空间
  • @all — 全部空间

您可以指定一个或多个空间关键字或特殊值,以逗号分隔。

如果未指定Page NameLabel(s),则包括指定空间集中的所有页面。

Content Type
(contentType

both pages and blog posts

将页面类型限制为页面(pages)或博文(blogposts)。如果在宏浏览器中未指定任何值,则页面和博文都包含在内。

可用值为pagesblogposts

Blog Post Date
(publishDate

none

指定博文的发布日期。日期格式为:YYYY/MM/DD。

Include Page Hierarchy
(scope

specified page only

包括指定页面的第一级子页面children或多级子页面descendants。如果宏浏览器中未指示任何值,则仅包含指定的页面。

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

其它添加方式

用键盘输入添加宏

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

通过wiki标记添加宏

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

Macro name: contributors-summary

Macro body: None.

此示例指定的内容类型为博文:

{contributors-summary:limit=10|spaces=ds,@personal|reverse=true|showAnonymous=true|order=update|labels=chocolate,cake|columns=edits,comments,labels,lastupdate|groupby=pages|contentType=blogposts|showZeroCounts=true|publishDate=2012/06/07}
CODE

此示例指定的内容类型为页面:

{contributors-summary:limit=10|spaces=ds,@personal|reverse=true|showAnonymous=true|scope=descendants|order=update|page=ds:Advanced Topics|labels=chocolate,cake|columns=edits,comments,labels,lastupdate|groupby=pages|contentType=pages|showZeroCounts=true}
CODE