Confluence Contributors Summary Macro(贡献者概要宏)
将贡献者概要宏添加到页面以显示有关为此页面、指定页面或一组页面做出贡献的人员的统计信息。贡献者包括以下人员:
跟踪对高价值页面的贡献。
- 页面的创建者或编辑者
- 页面的评论者
- 为页面添加标签的用户
- 关注页面的用户
这个宏非常适合:
- 协作排行榜
- 识别高频的文档贡献者
- 跟踪高价值页面的贡献者
截图:带有两个贡献者概要宏的页面,一个按用户显示,另一个按页面显示。
在页面中添加宏
在页面中添加Contributors Summary宏:
- 从编辑器工具栏中,选择插入(Insert) > 其它宏(Other Macros)。
- 从Confluence content类别中选择Contributors Summary。
- 选择是按用户还是按页面显示贡献
- 设置参数以优化您的查询
- 点击Insert。
然后,您可以发布您的页面以查看宏的效果。
截图:在Contributors Summary宏中设置参数
修改宏参数
宏参数用于设置宏的行为。
要更改宏参数:
- 在编辑器中,点击宏占位符并选择“编辑(Edit)”。
- 根据需要设置参数,然后选择“插入(Insert)”。
这是此宏中可用的参数列表。
参数 | 默认值 | 描述 |
---|---|---|
Group By | contributors | 指定分组统计的维度:
|
Columns to Display | edits,comments,labels | 设置应出现在表格中的列。显示的统计信息或信息类型取决于使用Group By参数设置的分组基础。可以计算以下统计数据:
|
Sort By | edits | 设置用于对表中的内容进行排序的标准。排序的内容取决于使用Group By参数设置的分组基础。排序标准是:
|
Reverse Sort | false | 反转表中内容的排序顺序。(仅与Sort By参数结合使用。) |
Maximum Number of Items | no limit | 将表中的贡献者或页数限制为指定的值。如果未指定数字,则包括所有内容。 |
Show Anonymous Contributions? | false | 包括页面的匿名贡献者。 |
Show Zero Counts? | false | 设置是否包括统计为零的贡献者或页面。 |
Page Name | current | 设置要统计数据的页面。 如果没有指定Page Name和Space(s)的值,则假定为当前页面。 |
Label(s) | none | Restricts the contribution-based statistics to the specified labels only. You can specify one or more labels, separated by commas. 限制为仅统计包含有指定标签的内容。 您可以指定一个或多个标签,以逗号分隔。 |
Space(s) | current | 指定包含指定页面名称的Confluence空间的关键字,或者指定要搜索的空间。 空间关键字区分大小写。 此参数还采用特殊值,包括:
您可以指定一个或多个空间关键字或特殊值,以逗号分隔。 如果未指定Page Name和Label(s),则包括指定空间集中的所有页面。 |
Content Type | both pages and blog posts | 将页面类型限制为页面(pages)或博文(blogposts)。如果在宏浏览器中未指定任何值,则页面和博文都包含在内。 可用值为 |
Blog Post Date | none | 指定博文的发布日期。日期格式为:YYYY/MM/DD。 |
Include Page Hierarchy | 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}
此示例指定的内容类型为页面:
{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}