最近更新信息面板(Recently Updated)宏用于在页面中显示 Confluence 近期的更新情况。
[table]
[tr][td][align=left]参数[/align]
[/td][td][align=left]默认值[/align]
[/td][td][align=left]说明[/align]
[/td][/tr]
[tr][td]作者 - 按用户名(Author(s) by username)
(author)
[/td][td]如果不指定值的话将会显示所有的。
[/td][td]按照指定的作者对结果进行过滤。如果你在这里赋值了,页面将会显示你指定作者。
你可以指定一个或者多个作者,使用逗号分隔符。
例如: jsmith,jbrown[align=left]如果希望包含一个作者,然后剔除其他作者,请使用下面的格式: jsmith,!jbrown [/align][/td][/tr]
[tr][td]空间(Space)
(spaces)
[/td][td]@self
[align=left]在这里,指定这个宏在那些空间内进行查找。[/align][/td][td]按照指定的空间,在空间中进行查找。如果你在这里赋值了,那么系统将会在你指定的空间内查找。
你可以指定一个或者多个空间, 使用逗号分隔符进行分隔。
[list]
[]如果希望不包含某一个空间,可以在空间名前面加一个横线(-)。例如:如果你不希望包含有一个空间 BADSPACE,那么你可以使用 -BADSPACE 定义。
[]如果希望你的结果必须从某一个空间里面来,那么你可以在空间名字的前面加一个加号(+)。例如:如果你指定一个空间名字为 +GOODSPACE ,你将会仅仅得到从 GOODSPACE 中来的内容。(请注意:这个功能不是必须的,因为每一个博客必须得属于一个空间。如果这个加号标记在一个空间名字前同时也在其他空间名字前面,那么这个标记将会被忽略)。
[/list][align=left]特殊的值:[/align][list]
[]@self — 当前空间
[]@personal — 所有的个人空间
[]@global — 所有的站点空间
[]@favorite — 所有你标记为关注的空间
[]@favourite — 与上面 @favorite 是一样的
[]@all — Confluence 站点的所有空间
[] — 与上面 @all 是一样的
[/list][align=left]当你指定一个个人空间的时候,请记住在个人空间名字前加一个波浪符(~)例如 ~jblogs 或者 ~[email protected] 。[/align][/td][/tr]
[tr][td]标签(Label)
(labels)
[/td][td]没有特定值,显示所有内容。
[/td][td]按照指定的标签对结果进行过滤。如果你在这里赋值了,页面将会显示含有你指定标签页面。
你可以指定一个或者多个标签值,使用逗号分隔符进行分隔。
[list]
[*]如果你希望扩展标签的的匹配内容,你可以在标签名字前加一个横线(-)。例如:如果你指定一个标签的名字为 -badpage 那么你将会找到所有没有标记为 ‘badpage’ 标签的页面。
[*]如果你希望某一个页面必须包含有某一个标签值,你需要在标签值之前加一个加号(+)。例如:如果你指定一个标签 +superpage,+goodpage 你将会找到页面至少包含有 2 个标签,而且这些页面的标签中都包含有字符 ‘superpage’ 和 ‘goodpage’。
[/list][/td][/tr]
[tr][td]表格宽度(Width of Table)
(width)
[/td][td]100%
[/td][td]指定宏显示的宽度,使用基于页面宽度的百分比。
[/td][/tr]
[tr][td]仅包含指定的类型(Include these Content Types Only)
(types)
[/td][td]所有类型
[/td][td]这个参数允许你通过内容类型过滤内容。这个宏将会显示你指定的类型。
你可以指定一个或多个类型,使用逗号分隔符进行分隔。
如果不包含特定的内容类型,在内容类型钱添加一个减号(-)。例如,如果你指定了内容类型 -blogpost ,你将会得到除了博客页面的页面和所有其他内容。[align=left]可用的值[/align][list]
[]page — [color=#3b73af]页面[/color]
[]blogpost 或r news — [color=#3b73af]博客页面[/color],同时也可以说是新闻项目
[]comment — 页面或者博客页面的评论。
[]attachment — 附件。
[]status — 其他用户做的状态更新。
[/list][/td][/tr]
[tr][td]结果的最大数量(Maximum Number of Results)
(max)
[/td][td]15
[/td][td]指定宏的最大显示结果。如果这个参数被省略的话,默认的最大显示结果是 15。
[align=left]理论上来说,你可以在这里将值设置为 2 的 31 次方减 1(或者2147483647),从系统性能考虑,你不能设置超过 200 的值。请参考 [color=#3b73af]https://jira.atlassian.com/browse/CONF-19096[/color]的说明。[/align][/td][/tr]
[tr][td]主题(theme)
(theme)
[/td][td]concise
[/td][td]选择宏在页面中的显示样式:
[list]
[]concise — 这个是默认的显示主题,江湖i显示页面的名字,同时包括更新或者备注的用户信息和时间。
[]social —列出最近的修改,反向时间顺序,利用他们的用户群成短的时间段进行分组。.一个子列表显示在每个用户的时间段之内,显示其更新或评论时间这些修改发生时的页面的名称。
[]sidebar —列出了最近更新的逆顺序,显示其被更新或评论和时间的页面修改发生时的页面的名称。这个主题不显示作者。
[/list][/td][/tr]
[tr][td]显示用户属性图片(Show User Profile Pictures)
(showProfilePic)
[/td][td]false
[/td][td]指定 showProfilePic=true 来显示更新了内容的的属性图片。
[/td][/tr]
[tr][td]隐藏标题(Hide Title)
b[/b]
[/td][td]False[/td][td]确定这个宏在标题栏中是显示还是隐藏 ‘最近更新’ 。仅在存储格式和 Wiki 标记格式中可用。
[align=left]可接受的值:[/align][list]
[]true – 隐藏标题
[]false – 显示标题
[/list][/td][/tr]
[/table]
最近更新信息面板(Recently Updated Dashboard)宏 和这个宏是类似的,只是最新更新信息面板宏被用于在 Confluence 面板中显示。
如果你希望修改 最近更新信息面板(Recently Updated)宏 的显示,请参考 modifying the Confluence interface text 的内容。
来源:http://cwiki.ossez.com/pages/viewpage.action?pageId=2394746