贡献人摘要（Contributors Summary）宏

按什么进行分组（Group By）
(groupby) 

贡献人

指定在内容显示的时候按照什么方式进行分组：

• contributors — 按照贡献人进行分组
• pages — 按照页面进行分组

显示的列（Columns to Display）
(columns) 

编辑，评论，标签

为贡献人摘要列表中显示列的内容。可用的类型信息可以通过按照什么进行分组的参数进行选择。

可用的显示列如下：

• edits — 贡献人对页面进行编辑的数量。
• edited — 贡献人编辑的页面列表。
• comments — 贡献人对页面进行添加评论的数量。
• commented — 贡献人评论的页面列表。
• labels — 贡献人对页面进行添加标签的数量。
• labeled — 贡献人标签的页面列表。
• labellist — 一个每个贡献人的标签列表或者每个页面的标签列表。
• watches — 对页面进行关注的数量。
• watching — 一个对页面进行关注的的列表。
• lastupdate — 贡献人最后对页面进行贡献的时间。
  
  你可以在实际使用的时候使用一个或者多个参数。

按什么进行排序（Sort By）
(order) 

edits

指定贡献人的排序方式。这个参数会和分组方式（Group By）同时进行使用。

可用采用的排序方式如下：

• edits — 按照对页面编辑的数量来进行排序。
• name — 按照对页面进行编辑的贡献人的字母进行排序，或者是页面的字母。
• editTime — 按照对页面进行编辑的时间进行排序（页面被编辑的时间）。
• update — 按照对页面进行更新的时间进行排序（页面被更新的时间）。

逆向排序（Reverse Sort）
(reverse) 

false

在贡献人列表中采用逆向排序。这个参数必须要和排序方式参数组合使用。单独设置这个参数而不设置排序方式的参数的话，系统将会忽略这个参数设置。

显示的最大数量（Maximum Number of Items）
(limit) 

没有限制

限制贡献人列表中显示的人员数量。如果没有为这个设定任何值，那么所有的贡献人将会被显示出来。

是否显示匿名用户的贡献（Show Anonymous Contributions）
(showAnonymous) 

false

是否在页面中显示匿名用户的贡献。

是否显示 0 数量（Show Zero Counts）
(showZeroCounts) 

false

设置贡献人摘要宏中是否显示贡献人数量为 0 的贡献人。

页面名称（Page Name）
(page) 

current

当你指定页面后，生成的贡献人列表将会从你指定的页面内进行过滤。

如果页面名称和空间名称是空的话，那么默认认为你选择的是当前页面。

标签（Label）
(labels) 

none

当你指定标签后，系统将会对指定标签包含的页面中的贡献人进行过滤。你可以指定一个或者多个标签，如果是多个标签的话，标签之间采用逗号分隔符。

空间（Space）
(spaces) 

current

通过指定 Confluence 空间的 Key 来为页面名称设定一个确定的空间。可选的，你可以通过查找来找到空间的 Key。空间的关键字是大小写敏感的。

这个参数也可以使用一些特殊的值，包括：

• @global — 所有的站点空间。
• @personal — 所有的个人空间。
• @all — Confluence 内的所有空间。

你可以使用一个或者多个空间关键字。空间关键字直接采用逗号分隔符。

如果没有页面名称或者标签值，指定的空间将会包括所有的页面。

内容类型（Content Type）
(contentType) 

页面和博客页面

当创建贡献人内容列表的时候限制使用的内容类型，可用的值为 pages 和 blogposts。

• pages — 页面
• blogposts — 博客

如果在宏流浪器中没有指定这个值，那么将会同时读取页面和博客页面。

博客页面日期（Blog Post Date）
(publishDate) 

none

为一个博客页面指定发布的日期。可以接受的日期格式为：YYYY/MM/DD。

如何包含子页面内容（Include Page Hierarchy）
(scope) 

仅特定页面

当创建列表的时候指定特定的一些其他页面：

• children — 仅仅是指定页面的子页面
• descendants — 指定页面的所有下级页面

如果没有指定值，那么只包含你指定的页面，不包括子页面。

<ac:structured-macro ac:name="contributors-summary">
  <ac:parameter ac:name="limit">10</ac:parameter>
  <ac:parameter ac:name="spaces">
    <ri:space ri:space-key="ds"/>
    <ri:space ri:space-key="@personal"/>
  </ac:parameter>
  <ac:parameter ac:name="reverse">true</ac:parameter>
  <ac:parameter ac:name="showAnonymous">true</ac:parameter>
  <ac:parameter ac:name="order">update</ac:parameter>
  <ac:parameter ac:name="labels">chocolate,cake</ac:parameter>
  <ac:parameter ac:name="columns">edits,comments,labels,lastupdate</ac:parameter>
  <ac:parameter ac:name="groupby">pages</ac:parameter>
  <ac:parameter ac:name="contentType">blogposts</ac:parameter>
  <ac:parameter ac:name="showZeroCounts">true</ac:parameter>
  <ac:parameter ac:name="publishDate">2012/06/07</ac:parameter>
</ac:structured-macro>

<ac:structured-macro ac:name="contributors-summary">
  <ac:parameter ac:name="limit">10</ac:parameter>
  <ac:parameter ac:name="spaces">
    <ri:space ri:space-key="ds"/>
    <ri:space ri:space-key="@personal"/>
  </ac:parameter>
  <ac:parameter ac:name="reverse">true</ac:parameter>
  <ac:parameter ac:name="showAnonymous">true</ac:parameter>
  <ac:parameter ac:name="scope">descendants</ac:parameter>
  <ac:parameter ac:name="order">update</ac:parameter>
  <ac:parameter ac:name="page">
    <ac:link>
      <ri:page ri:content-title="Advanced Topics" ri:space-key="ds"/>
    </ac:link>
  </ac:parameter>
  <ac:parameter ac:name="labels">chocolate,cake</ac:parameter>
  <ac:parameter ac:name="columns">edits,comments,labels,lastupdate</ac:parameter>
  <ac:parameter ac:name="groupby">pages</ac:parameter>
  <ac:parameter ac:name="contentType">pages</ac:parameter>
  <ac:parameter ac:name="showZeroCounts">true</ac:parameter>
</ac:structured-macro>

{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}

{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}