ITPub博客

首页 > 数字化转型 > ERP > Confluence 贡献人摘要(Contributors Summary)宏

Confluence 贡献人摘要(Contributors Summary)宏

ERP 作者:OSSEZTEC 时间:2014-02-13 09:55:53 0 删除 编辑

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

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

贡献的状态可以包括有下面的状态:

  • 对页面进行编辑的
  • 向页面添加了评论的
  • 向页面添加了标签的
  • 关注了页面的



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

使用实例:本页的贡献人摘要

User
Edits
Comments
Labels
HoneyMoose 9 0 0



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

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

宏参数的定义为,你可以使用这些参数在宏输出的内容和格式上进行定义。

Confluence 使用的存储格式或者 wikimarkup 格式中使用的参数和在宏浏览器中使用的标签是不同的,这些将会在下面在括号内容中列出(example)。

参数

默认值

说明

按什么进行分组(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 — 指定页面的所有下级页面
如果没有指定值,那么只包含你指定的页面,不包括子页面。


来源:http://cwiki.ossez.com/pages/viewpage.action?pageId=2393251

来自 “ ITPUB博客 ” ,链接:http://blog.itpub.net/29468687/viewspace-1080582/,如需转载,请注明出处,否则将追究法律责任。

请登录后发表评论 登录
全部评论

注册时间:2014-02-02

  • 博文量
    136
  • 访问量
    207432