Confluence 包含页面宏

将包含页面宏添加到页面以在此页面中显示另一个页面或博文的内容。

这个宏适用于：

• 唯一来源的说明或文档
• 在多个空间共享的信息
• 任何内容引用的情形

您可以将多个包含页面宏添加到您的页面，并将它们与文本、图像、表格和其它宏组合在一起。

因为您只是包括其它页面的内容，而不是复制它，所以对原始页面的更改都会自动更新引用该页面的任何地方。

包含页面宏遵守空间权限和页面限制，因此请务必检查哪些人可以查看您要包含的页面。

截图：会议纪要页面，顶部带有可重复使用的警告。

在页面中添加宏

在页面中添加Include Page宏：

1. 从编辑器工具栏中，选择插入(Insert) > 其它宏（Other Macros）。
2. 从Confluence content类别中选择Include Page。
3. 输入要包含的页面的标题。它可以在当前空间，也可以在另一个空间。
4. 点击Insert。

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

截图：包含页面宏嵌套在编辑器中的提示宏中。

修改宏参数

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

要更改宏参数：

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

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

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

限制

这个宏有一些你需要注意的限制：

• 该宏遵守空间权限和页面限制。它不会向没有足够权限查看包含页面的人显示内容。
• 该宏将包含整个页面内容。如果您只想引用页面的一部分，请改用Confluence 包含摘要宏 。
• 该宏只能显示当前站点中存在的页面。您不能使用包含页面宏来显示其它Confluence站点中的页面内容。

其它添加方式

用键盘输入添加宏

通过wiki标记添加宏

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

Macro name: include

Macro body: None.

{include:DOC:My chocolate page}