Confluence Contributors Macro（贡献者宏）
将贡献者宏添加到页面以显示对这个页面、另一个页面或一组页面做出贡献的Confluence用户列表。贡献者包括以下人员：
- 页面的创建者或编辑者
- 页面的评论者
- 为页面添加标签的用户
- 关注页面的用户
这个宏适用于：
- 文档控制和合规管理
- 提供页面的相关联系人列表
截图：显示打印机操作方法页面贡献者的页面。
在此示例中，Display Format参数已设置为list。
在页面中添加宏
在页面中添加Contributors宏：
- 从编辑器工具栏中，选择插入(Insert)
> 其它宏（Other Macros）。 - 从Confluence content类别中选择Contributors。
- 输入您要显示的贡献者类型，并设置参数。
- 点击Insert。
然后，您可以发布您的页面以查看宏的效果。
截图：在Contributors宏中设置参数
修改宏参数
宏参数用于设置宏的行为。
要更改宏参数：
- 在编辑器中，点击宏占位符并选择“编辑（Edit）”。
- 根据需要设置参数，然后选择“插入（Insert）”。
这是此宏中可用的参数列表。
参数 | 默认值 | 描述 |
|---|---|---|
Contribution Type | authors | Filters by either the type of contribution made to a page (and optionally its descendant pages), or the watches on the page. Contribution types are:
|
Sort By | count | 指定对贡献者进行排序的标准。排序标准是：
|
Reverse Sort | false | 颠倒列表中贡献者的排序顺序。必须与Sort By参数结合使用。 |
Maximum Number of Contributors
| no limit | 限制列表中的贡献者数量。 如果未指定数字，则包括所有贡献者。 |
Display Format | inline | 设置贡献者列表的格式：
|
Show Anonymous Contributions? | false | 设置是否包括匿名贡献者。 |
Show Count? | 设置是否显示每个人对指定Contribution Type做出贡献的次数。 | |
Show Last Contribution Time? | false | 设置是否显示每个人最后一次做出指定Contribution Type的时间。 |
Page Name | current | 指定生成贡献者列表时要使用的页面。 如果Page Name和Space(s)留空，则假定为当前页面。 |
Label(s) | none | 将贡献者列表过滤为在页面创建指定标签的人。您可以指定一个或多个标签，以逗号分隔。 |
Space(s) | current | 指定在Page Name中设置的页面的Confluence空间的关键字，或者指定要搜索的空间。空间关键字区分大小写。 此参数还采用特殊值，包括： |
Content Type | both pages and blog posts | 限制生成贡献者列表时使用的内容类型：
|
Blog Post Date | none | 指定博文的发布日期。日期格式为：YYYY/MM/DD。 |
Include Page Hierarchy | specified page only | 指定生成贡献者列表时要包含的其它页面：
|
Show Selected Pages | false | 设置是否显示用于生成贡献者列表的页面列表。 |
Custom "None Found" Message | default message | 指定未找到贡献者时显示的默认提示。 |
如果Confluence存储格式或wiki标记中使用的参数名称与浏览器中使用的参数名称不同，则会在参数名下方用括号列出，例如（example）。
其它添加方式
用键盘输入添加宏
通过wiki标记添加宏
当您想在编辑器之外添加宏时，这非常有用。例如作为侧边栏、空间页眉或页脚中的自定义内容。
Macro name: contributors
Macro body: None.
此示例指定的内容类型为博文：
{contributors:limit=10|spaces=ds,@personal|reverse=true|labels=chocolate,cake|showPages=true|noneFoundMessage=Oh dear, no contributors found|showCount=true|contentType=blogposts|include=authors,comments,labels,watches|mode=list|showAnonymous=true|order=update|showLastTime=true|publishDate=2012/06/30}此示例指定的内容类型为页面：
{contributors:limit=10|spaces=ds,@personal|reverse=true|scope=descendants|labels=chocolate,cake|showPages=true|noneFoundMessage=Oh dear, no contributors found|showCount=true|contentType=pages|include=authors,comments,labels,watches|mode=list|showAnonymous=true|order=update|page=ds:Advanced Topics|showLastTime=true}