Confluence HTML 宏

将HTML Include宏添加到页面以在Confluence页面中包含特定URL的内容。这允许您在Confluence页面中嵌入网页。

这是一个遗留宏，出于安全原因，Confluence管理员一般会禁用它。

安全考虑

默认会禁用HTML Include宏

HTML宏只有在管理员启用后才可用。启用这些宏会使您的Confluence站点容易受到跨站脚本攻击。

在页面中添加宏

在页面中添加HTML Include宏：

1. 从编辑器工具栏中，选择插入(Insert) > 其它宏（Other Macros）。
2. 从External content类别中选择HTML Include。
3. 输入要显示的URL。
4. 点击Insert。 

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

修改宏参数

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

要更改宏参数：

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

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

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

启用HTML Include宏

The HTML Include macro is disabled by default. You'll need Confluence Administrator or System Administrator permissions to enable this macro.

 Enabling these macros can make your Confluence site vulnerable to cross-site scripting attacks. You should only turn on these macros if you trust all your users not to attempt to exploit them. We strongly recommend leaving this macro disabled if you allow self-signed up or anonymous users to create content.

To enable the HTML Include macro:

默认情况下禁用了HTML Include宏。您需要Confluence管理员或系统管理员权限才能启用此宏。

启用这个宏会使您的Confluence站点容易受到跨站脚本攻击。如果您信任所有用户不会尝试利用它们，您可以打开这些宏。如果您允许自注册或匿名用户创建内容，我们强烈建议禁用此宏。

要启用HTML Include宏：

从下拉菜单中选择 System 并搜索 Confluence HTML Macros 系统应用程序。
展开列表并启用 html-include (html-include-xhtml) 模块。

管理员还可以选择使用许可名单来限制可以在 HTML Include 宏中显示的 URL。

1. 前往

   Error rendering macro 'excerpt-include'

   User 'null' does not have permission to view the page.

    > 插件（Add-ons）

2. 从下拉菜单中选择System并搜索Confluence HTML Macros系统插件。
3. 展开列表并启用html-include (html-include-xhtml) 模块。

管理员还可以选择使用allowlist来限制可以在HTML Include宏中显示的URL。

Troubleshooting故障排除

• 管理员可以定义受信任URL的许可名单allowlist of trusted URLs。如果某个网址不在许可名单中，您将在HTML Include宏中看到一条错误消息。
• 您在HTML Include宏中只能使用绝对链接。如果您使用了相对链接的HTML页面，您将看到“Page Not Found”错误。 

Macro name: html-include

Macro body: None.

{html-include:url=http://www.example.com}