# Confluence 贡献人摘要（Contributors Summary）宏

**URL:** <https://www.isharkfly.com/t/confluence-contributors-summary/6041>\
**Category:** 文档交付\
**Tags:** confluence\
**Created:** [February 13, 2014, 1:49am UTC](https://www.isharkfly.com/t/confluence-contributors-summary/6041 "2014-02-13T01:49:28Z")\
**Posts on this page:** 1\
**Page:** 1

<div class="post-metadata">

**Author:** ![honeymoose](https://www.isharkfly.com/user_avatar/www.isharkfly.com/honeymoose/32/20796_2.png) [@honeymoose](https://www.isharkfly.com/u/honeymoose)\
**Post date:** [February 13, 2014, 1:49am UTC](https://www.isharkfly.com/t/confluence-contributors-summary/6041/1 "2014-02-13T01:49:28Z")

</div>

贡献人摘要（Contributors Summary）宏在一系列页面根据贡献的状态将贡献人显示为列表。这个贡献的状态可以根据单独的页面或者单独的贡献人分组。

这个宏默认使用的区域为一个独立页面，但是可以扩展到这个页面的子页面或者这个页面的所有下级页面。

贡献的状态可以包括有下面的状态：  
[list]  
[_]对页面进行编辑的  
[_]向页面添加了评论的  
[_]向页面添加了标签的  
[_]关注了页面的  
[/list]

下面的实例显示了本页面的贡献人摘要。这个摘要显示了贡献人对本页面进行了编辑，添加评论，添加标签的情况。

使用实例：本页的贡献人摘要  
[table=98%]  
[tr][td]User  
[/td][td]Edits  
[/td][td]Comments  
[/td][td]Labels  
[/td][/tr]  
[tr][td][color=#3b73af][HoneyMoose](http://cwiki.ossez.com/display/~huyucheng)[/color][/td][td]9[/td][td]0[/td][td]0

[/td][/tr]  
[/table]

在上面的实例中，我们只使用的默认的参数。

有关这个宏中可以使用的参数和有关参数的说明，请参考本页中的 参数 部分的说明。

[p=20, null, left][color=rgb(51, 51, 51)]宏参数的定义为，你可以使用这些参数在宏输出的内容和格式上进行定义。

[/color][/p][p=20, null, left][color=rgb(51, 51, 51)]Confluence 使用的存储格式或者 wikimarkup 格式中使用的参数和在宏浏览器中使用的标签是不同的，这些将会在下面在括号内容中列出(example)。[/color][/p]  
[color=rgb(51, 51, 51)]  
[table]  
[tr][td][align=left]参数[/align]  
[/td][td][align=left]默认值[/align]  
[/td][td][align=left]说明[/align]  
[/td][/tr]  
[tr][td]按什么进行分组（Group By）  
(groupby)   
[/td][td]贡献人  
[/td][td]指定在内容显示的时候按照什么方式进行分组：  
[list]  
[\*]contributors — 按照贡献人进行分组  
[\*]pages — 按照页面进行分组  
[/list][/td][/tr]  
[tr][td]显示的列（Columns to Display）  
(columns)   
[/td][td]编辑，评论，标签  
[/td][td]为贡献人摘要列表中显示列的内容。可用的类型信息可以通过按照什么进行分组的参数进行选择。  
[align=left]可用的显示列如下：[/align][list]  
[_]edits — 贡献人对页面进行编辑的数量。  
[_]edited — 贡献人编辑的页面列表。  
[_]comments — 贡献人对页面进行添加评论的数量。  
[_]commented — 贡献人评论的页面列表。  
[_]labels — 贡献人对页面进行添加标签的数量。  
[_]labeled — 贡献人标签的页面列表。  
[_]labellist — 一个每个贡献人的标签列表或者每个页面的标签列表。  
[_]watches — 对页面进行关注的数量。  
[_]watching — 一个对页面进行关注的的列表。  
[_]lastupdate — 贡献人最后对页面进行贡献的时间。

你可以在实际使用的时候使用一个或者多个参数。  
[/list][/td][/tr]  
[tr][td]按什么进行排序（Sort By）  
(order)   
[/td][td]edits  
[/td][td]指定贡献人的排序方式。这个参数会和分组方式（Group By）同时进行使用。  
[align=left]可用采用的排序方式如下：[/align][list]  
[_]edits — 按照对页面编辑的数量来进行排序。  
[_]name — 按照对页面进行编辑的贡献人的字母进行排序，或者是页面的字母。  
[_]editTime — 按照对页面进行编辑的时间进行排序（页面被编辑的时间）。  
[_]update — 按照对页面进行更新的时间进行排序（页面被更新的时间）。  
[/list][/td][/tr]  
[tr][td]逆向排序（Reverse Sort）  
(reverse)   
[/td][td]false  
[/td][td]在贡献人列表中采用逆向排序。这个参数必须要和排序方式参数组合使用。单独设置这个参数而不设置排序方式的参数的话，系统将会忽略这个参数设置。  
[/td][/tr]  
[tr][td]显示的最大数量（Maximum Number of Items）  
(limit)   
[/td][td]没有限制  
[/td][td]限制贡献人列表中显示的人员数量。如果没有为这个设定任何值，那么所有的贡献人将会被显示出来。  
[/td][/tr]  
[tr][td]是否显示匿名用户的贡献（Show Anonymous Contributions）  
(showAnonymous)   
[/td][td]false  
[/td][td]是否在页面中显示匿名用户的贡献。  
[/td][/tr]  
[tr][td]是否显示 0 数量（Show Zero Counts）  
(showZeroCounts)   
[/td][td]false  
[/td][td]设置贡献人摘要宏中是否显示贡献人数量为 0 的贡献人。  
[/td][/tr]  
[tr][td]页面名称（Page Name）  
(page)   
[/td][td]current  
[/td][td]当你指定页面后，生成的贡献人列表将会从你指定的页面内进行过滤。  
[align=left]如果页面名称和空间名称是空的话，那么默认认为你选择的是当前页面。[/align][/td][/tr]  
[tr][td]标签（Label）  
(labels)   
[/td][td]none  
[/td][td]当你指定标签后，系统将会对指定标签包含的页面中的贡献人进行过滤。你可以指定一个或者多个标签，如果是多个标签的话，标签之间采用逗号分隔符。  
[/td][/tr]  
[tr][td]空间（Space）  
(spaces)   
[/td][td]current  
[/td][td]通过指定 Confluence 空间的 Key 来为页面名称设定一个确定的空间。可选的，你可以通过查找来找到空间的 Key。空间的关键字是大小写敏感的。  
[align=left]这个参数也可以使用一些特殊的值，包括：[/align][list]  
[_]@global — 所有的站点空间。  
[_]@personal — 所有的个人空间。  
[\*]@all — Confluence 内的所有空间。  
[/list][align=left]你可以使用一个或者多个空间关键字。空间关键字直接采用逗号分隔符。

如果没有页面名称或者标签值，指定的空间将会包括所有的页面。[/align][/td][/tr]  
[tr][td]内容类型（Content Type）  
(contentType)   
[/td][td]页面和博客页面  
[/td][td]当创建贡献人内容列表的时候限制使用的内容类型，可用的值为 pages 和 blogposts。  
[list]  
[\*]pages — 页面  
[\*]blogposts — 博客  
[/list][align=left]如果在宏流浪器中没有指定这个值，那么将会同时读取页面和博客页面。[/align][/td][/tr]  
[tr][td]博客页面日期（Blog Post Date）  
(publishDate)   
[/td][td]none  
[/td][td]为一个博客页面指定发布的日期。可以接受的日期格式为：YYYY/MM/DD。  
[/td][/tr]  
[tr][td]如何包含子页面内容（Include Page Hierarchy）  
(scope)   
[/td][td]仅特定页面  
[/td][td]当创建列表的时候指定特定的一些其他页面：  
[list]  
[\*]children — 仅仅是指定页面的子页面  
[\*]descendants — 指定页面的所有下级页面  
[/list][align=left]如果没有指定值，那么只包含你指定的页面，不包括子页面。[/align][/td][/tr]  
[/table][/color]

来源：[http://cwiki.ossez.com/pages/viewpage.action?pageId=2393251](http://cwiki.ossez.com/pages/viewpage.action?pageId=2393251)
