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

将Team Calendar宏添加到页面以在Confluence页面上显示日历，从而轻松跟踪和管理事件。

这个宏非常适用于：

  • 在项目和团队空间中显示团队事件、项目时间表和里程碑
  • 在迭代计划或回顾页面上共享Jira问题截止日期和迭代日期
  • 发布时间表和定时任务，每个人都可以看到它们

Screenshot: The Team Calendar macro showing important project dates.截图：显示重要项目日期的团队日历宏。


关于创建日历或订阅日历的文档，请参阅Team Calendars。

在页面中添加宏

在页面中添加Team Calendar宏：

  1. 从编辑器工具栏中，选择插入(Insert) > 其它宏（Other Macros）。
  2. 从Reporting类别中选择Team Calendar。
  3. 选择Add Existing Calendar。
  4. 搜索日历名称
  5. 点击Add。

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

截图：在宏浏览器中配置团队日历宏。

修改宏参数

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

要更改宏参数：

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

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

参数

必填

默认值

描述

CalendarYesblank要显示的日历的名称。 

View
(defaultView)

Nomonth

显示日历的格式。 可用值：

  • month
  • week
  • list
  • timeline

Width
(width)

Nonone日历的宽度（以像素为单位）。留空时，日历将填满可用空间。
HeightNonone日历的最大高度（以像素为单位）。 仅适用于时间线视图。
Calendar legendNonone

月视图和周视图中日历图例的位置。图例显示所选日历中存在的事件类型。 可用值：

  • Right
  • Bottom
  • None

Calendar ID
(id)

Yes (Wiki markup only)blank

一个或多个日历 ID，以逗号分隔。仅在使用wiki标记添加宏时才需要此参数。

要查找日历的ID：

从 Confluence 标题或空格侧边栏中选择日历
单击日历旁边的 并选择嵌入
将出现一个对话框，其中包含指向日历的链接。

链接的最后一部分包含日历的 ID。 例如：

  1. 从Confluence顶部菜单或空间侧边栏中选择Calendars
  2. 点击日历旁边的并选择Embed
    将出现一个对话框，其中包含指向日历的链接

链接的最后一部分包含日历的ID。例如：

http://<your_site_url>/calendar/previewcalendar.action?subCalendarId=890143d3-5c7d-4f17-ad4b-70d8a4a4d345

其它添加方式

用键盘输入添加宏

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

通过wiki标记添加宏

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

Macro name:  calendar

Macro body: None.

{calendar:id=4f5f9524-f588-468e-a48c-668ea480a77c,49221951-cca9-424f-b1ee-42ec44452bcc|defaultView=month|width=400}
CODE