包含超文本 HTML 宏允许在 Confluence 页面中包含一个外部 HTML 文件。
警告：包含一个未知的 HTML 在页面中是非常危险的
HTML 文件可以包含有 scripting 组件。这样就意味可能在这里包含有脚本，如果你的网站包含有这些脚本，那么很有可能是这些脚本向其他网站通过浏览器发起攻击。下面的代码可能会在 HTML 中使用，例如从用户浏览器中盗取存储在 Cookie 的授权信息，然后使用这些授权信息来攻击 Confluence 服务器或者其他网站。
使用包含超文本 HTML 宏
希望在页面中使用包含超文本 HTML 宏：
- 打开你希望编辑 Confluence 页面，然后单击 编辑（Edit）按钮。页面的编辑模式将会被打开。
- 下一步，在编辑工具栏中单击宏浏览器图标
。这时候宏浏览器将会在屏幕的中间打开。 - 在宏浏览器中，在窗口的右上角的对话框中输入你希望插入的宏的名称。当找到与你输入的宏名称接近的宏后将会在中间的面板上显示。单击需要的宏然后来查看可用进行配置的宏选项，在这里你可以对需要插入的宏设置相关参数，然后单击 插入（insert）来将需要的宏插入到页面中。
参数
宏参数的定义为，你可以使用这些参数在宏输出的内容和格式上进行定义。
Confluence 使用的存储格式或者 wikimarkup 格式中使用的参数和在宏浏览器中使用的标签是不同的，这些将会在下面在括号内容中列出(example)。
参数 | 是否是必须 | 默认值 | 说明 |
|---|---|---|---|
HTML 页面的超链接（HTML Page's URL）(url) | Yes | None | 页面包含 HTML 的链接地址。 |
常见问题
- 包含超文本 HTML 宏仅在你的 Confluence 管理员启用后才可以使用。同时，你的 Confluence 系统管理员可以确定哪些网站的内容是可信的。你可以在页面中看到错误信息，如果你添加的网站不在被信任的白名单列表中的话。
- 在包含超文本 HTML 宏中，你只能使用链接的绝对路径地址，如果你在 包含超文本 HTML 宏 使用了链接的相对地址，那么当你单击这个链接的时候，你可能会得到页面没有找到的错误。有关这个问题的详细解答，请参考下面的链接：CONF-6567。
代码示例
下面的代码是提供给希望进一步编辑 Confluence 页面的高级用户使用的。
宏名称： html-include
宏内容： None.
存储格式示例
|
Wiki 标记格式示例
|