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

将博文宏添加到页面以显示博文的精选列表。您可以选择仅显示标题、博文摘录或每篇博文的全部内容。

当您想为以下内容提供相关的博文列表时，此宏非常有用：

  • 公司公告
  • 新成员介绍
  • 项目信息更新
  • 变更管理  

因为您可以显示来自任何空间、具有任何标签或作者的博文，所以您可以在多个页面上显示相同的博文链接。这减少了重复工作，并帮助用户随时找到想要的信息。

截图：博文宏，配置为显示每篇博文的摘录。

关于Confluence中的博客文档，请参考Blog Posts。

在页面中添加博文宏

在页面中添加博文宏：

  1. 从编辑器工具栏中，选择插入(Insert) > 其它宏（Other Macros）。
  2. 从Confluence content类别中选择Blog Posts。
  3. 使用以下参数确定您希望博文显示的方式，并按时间范围、空间、作者或标签缩小查询范围。
  4. 点击Insert. 

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

截图：在博文宏中输入显示类型、时间范围和标签参数。

修改宏参数

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

要更改宏参数：

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

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

参数

必填

默认值

描述

Content Type to Display

(content)

No

titles

可用值：

  • titles — 显示每篇博文的标题、创建者、空间和创建日期。
  • excerpts — 显示每篇博文的简短摘录。如果帖子包含摘录宏，博客帖子宏将显示在摘录宏中定义的内容。如果帖子不包含摘录宏，博客帖子宏将显示帖子的前几句话。
  • entire - 显示每篇博文的全部内容。

Time Frame
(time)

No

no limit

指定Confluence应该在多长时间内查找要显示的博客文章。

可用值：

  • m — 分钟数
  • h — 小时数，例如“12h”显示在过去12小时内创建的博文。
  • d — 天数，例如“7d”显示在过去7天内创建的博文。
  • w — 周数

Restrict to these Labels
 (label)

No

None

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

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

  • 要排除与给定标签匹配的内容，请在该标签值的前方放置一个减号 (-)。例如：如果您指定 -badpage 的标签值，您将仅获得不含“badpage”标签的内容。
  • 要结果必须与给定的标签值匹配，请在该标签值的前方放置一个加号 (+)。例如：如果您指定标签值 +superpage,+goodpage，您将只获得至少有两个标签的内容，分别是“superpage”和“goodpage”。

Restrict to these Authors
(author) 

No

None

按作者过滤结果。该宏将仅显示由您在此处指定的作者撰写的博文。

Restrict to these Spaces
 (spaces) 

No

@self，即当前页面所属的空间

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

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

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

特殊值：

  • @self — 当前空间
  • @personal — 所有个人空间。
  • @global — 所有网站空间。
  • @favorite — 您收藏的空间。
  • @favourite — 和前面的@favorite一样。
  • @all — Confluence中的所有空间。
  • * — 和前面的@all一样。

Maximum Number of Blog Posts
 (max)

No

15

指定要显示的最大结果数。请注意，会先对结果进行排序，然后按参数值显示结果。

Sort By
 (sort)  

No

creation

指定结果的排序方式。如果未指定此参数，则排序顺序默认为基于创建日期的降序（最新在前）。

值：

  • title — 按标题的字符顺序排序。
  • creation — 按创建日期排序。
  • modified — 按更新日期排序。

Reverse Sort
 (reverse) 

No

false

实现反向排序的参数（最旧的在前）。将此参数与Sort By参数结合使用。如果未指定Sort By参数，则忽略此参数。

在存储格式和wiki标记中，值为true会更改排序顺序。

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

其它添加方式

用键盘输入添加宏

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

通过wiki标记添加宏

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

Macro name: blog-posts

Macro body: None.

{blog-posts:content=titles|spaces=@self,ds|author=jsmith|time=4w|reverse=true|sort=creation|max=10|label=chocolate,cookies}
CODE