本文翻译自官方文档：https://confluence.atlassian.com/pages/viewpage.action?pageId=139519

将最近更新宏添加到页面以显示最近创建或编辑的页面、博客、文件和评论的列表。

这非常适用于：

  • 项目首页或信息导航页面
  • 团队空间主页

它非常灵活，您可以将列表限制为指定的人、空间、内容类型等。

截图：项目首页显示最近创建和更新的页面。

在页面中添加宏

在页面中添加Recently Updated宏：

  1. 从编辑器工具栏中，选择插入(Insert) > 其它宏（Other Macros）。
  2. 从Confluence content类别中选择Recently Updated。
  3. 输入参数。
  4. 点击Insert。

然后，您可以发布您的页面以查看宏的效果。

截图：配置最近更新宏以显示指定空间中指定人员的更新。

修改宏参数

宏参数用于设置宏的行为。

要更改宏参数：

  1. 在编辑器中，点击宏占位符并选择“编辑（Edit）”。
  2. 根据需要设置参数，然后选择“插入（Insert）”。

这是此宏中可用的参数列表。  

参数

默认值

描述

Author(s) by username
(author) 

None specified. That is, display all content

按作者过滤结果。该宏将仅显示您在此处指定的作者最后修改的页面等。

您可以指定多个用户。

Space(s)
(spaces) 

@self

That is, the space which contains the page on which the macro is used

此参数允许您按空间过滤内容。该宏将仅显示属于您在此处指定的空间的页面等。

您可以指定一个或多个空间，用逗号或空格分隔。

  • 要排除指定空间中的内容，请在该空间关键字的前面放置一个减号 (-)。例如：如果您指定一个空间关键字 -BADSPACE，您将只获得不在BADSPACE中的内容。
  • 要表示结果必须来自指定的空间，请在该空间关键字的前面放一个加号 (+)。例如：如果指定+GOODSPACE的空间关键字，您将只获得GOODSPACE中的内容。（请注意，这不是特别有用，因为每个内容项仅属于一个空间。如果您在一个空间关键字旁边放置一个加号并列出其它空间关键字，则其它空间关键字将被忽略。）

特殊值：

  • @self — 当前空间。
  • @personal — 所有personal空间。
  • @global — 所有site空间。
  • @favorite — 您收藏favorite的空间。
  • @favourite — 与上面的@favorite相同。
  • @all — Confluence中的所有空间。
  • * — 与上面的@all相同。

指定个人空间时，记得在用户名前使用波浪号 (~) 符号，例如~jbloggs或 ~jbloggs@example.com。

Label(s)
(labels) 

None specified i.e. display all content

按标签过滤结果。该宏将仅显示用您在此处指定的标签相关的页面等。

您可以指定一个或多个标签值，用逗号或空格分隔。

  • 要排除与指定标签匹配的内容，请在该标签值的前面放置一个减号 (-)。例如：如果您指定-badpage的标签值，您将只获得未标记为“badpage”的内容。
  • 要表示结果必须与给定的标签值匹配，请在该标签值的前面放置一个加号 (+)。例如：如果您指定标签值+superpage,+goodpage，您将只获得同时具有这两个标签的内容，分别是“superpage”和“goodpage”。


标签参数仅适用于页面和博客内容类型。

Width of Table
(width) 

100%

指定显示的宽度，以窗口宽度的百分比表示。

Include these Content Types Only
(types) 

All types

此参数允许您按内容类型过滤内容。该宏将仅显示您在此处指定的类型的内容。

您可以指定一种或多种类型，用逗号或空格分隔。

要排除指定内容类型的内容，请在该内容类型前直接放置一个减号 (-)。例如：如果您指定的内容类型为-blogpost，您将获得页面和除博客文章之外的所有其它内容。

可用值：

  • page — 页面Pages.
  • blogpost or news — 博文Blog posts，也可以叫做新闻。
  • comment — 对页面和博文的评论Comments。
  • attachment — 附件Attachments。

Maximum Number of Results
(max) 

15

指定要显示的最大结果数。如果省略此参数，则最多显示 15 个结果。此参数可以接受的理论最大值是2的31次方减1（或2147483647），但出于性能原因，这在代码中被限制为200。详见说明文档。

theme
(theme) 

concise

设置这个宏的外观：

  • concise — 默认列表，显示被更新或评论的页面名称、进行页面修改的用户和修改发生的时间。
  • social — 按时间倒序列出最近的修改，但按用户和时间段将内容聚合显示。以每个用户的某个时间段呈现一个“子”列表，显示他们更新或评论的页面名称以及这些修改发生的时间。
  • sidebar — 按时间倒序列出最近的更新，显示更新或评论的页面名称以及页面修改发生的时间。此模式中不显示作者身份。

Show User Profile Pictures
(showProfilePic) 

false

指定showProfilePic=true可以显示更新内容的用户的个人资料图片。

Hide Title
 (hideHeading)

False

确定宏是隐藏还是显示文本“最近更新”作为内容列表上方的标题。仅在 wikimarkup 和存储格式中可用。

接受值：

  • true – 隐藏标题。
  • false – 显示标题。

如果Confluence存储格式或wiki标记中使用的参数名称与浏览器中使用的参数名称不同，则会在参数名下方用括号列出，例如（example）。

其它添加方式

用键盘输入添加宏

输入左大括号{，然后输入宏名称的几个起始字符，就可以看到一个相关的宏列表。

通过wiki标记添加宏

当您想在编辑器之外添加宏时，这非常有用。例如作为侧边栏、空间页眉或页脚中的自定义内容。

Macro name: recently-updated

Macro body: None.

{recently-updated:spaces=ds|author=admin|max=10|hideHeading=true|width=50%|theme=sidebar|showProfilePic=true|labels=choc|types=page}
CODE