RSS 宏用于在 Confluence 页面中嵌入一个 RSS 源。这个 RSS 宏 可以显示外部 RSS 源的内容或者 Confluence 内部创建的 RSS 源。
希望显示博客页面或者空间中的页面最新的更新列表，使用 RSS 构建器 来新建一个 Confluence 内部的 RSS 源，然后在页面中使用这个宏。
警告：在页面中包含未知的 HTML 代码是非常危险的
RSS 内部含有的 HTML 源代码可能包含有一些活动的脚本组件。换句话说，这些脚本组件将会以你的网站开始向其他网站发动攻击，就好像攻击是是从你的网站上发出的一样。这些代码会影响到系统的安全，比如说这些代码可能会盗取用户的用户名和密码，如果这些信息存储在 cookie 里面的话。
RSS 宏可以通过 Confluence 的管理员来禁用。同时 Confluence 的系统管理员也可以在系统中定义白名单和受信的站点列表。如果你添加的 RSS 不在受信的站点列表里面的话，你将会在 Confluence 页面中看到相关的提示信息。
在页面中使用 RSS 宏
希望在页面中使用 RSS 宏
- 打开你希望编辑 Confluence 页面，然后单击 编辑（Edit）按钮。页面的编辑模式将会被打开。
- 下一步，在编辑工具栏中单击宏浏览器图标
。这时候宏浏览器将会在屏幕的中间打开。 - 在宏浏览器中，在窗口的右上角的对话框中输入你希望插入的宏的名称。当找到与你输入的宏名称接近的宏后将会在中间的面板上显示。单击需要的宏然后来查看可用进行配置的宏选项，在这里你可以对需要插入的宏设置相关参数，然后单击 插入（insert）来将需要的宏插入到页面中。
参数
宏参数的定义为，你可以使用这些参数在宏输出的内容和格式上进行定义。
Confluence 使用的存储格式或者 wikimarkup 格式中使用的参数和在宏浏览器中使用的标签是不同的，这些将会在下面在括号内容中列出(example)。
参数 | 默认值 | 说明 |
|---|---|---|
RSS 源 URL（RSS Feed URL） | none | 你希望显示的 RSS 源地址。 |
显示的最大实体数量（Maximum Number of Entries） | 15 | 限制在宏中显示多少数量的内容。 |
值显示项目标题（Show Item Titles Only） | false | 仅仅显示新内容的标题，不显示内容。 |
显示 RSS 的名字和标题（Show Name/Title of RSS Feed） | true | 隐藏 RSS 宏的标题栏。 |
RSS 源的更新频率
默认情况下，RSS 宏每 60 分钟更新一次信息。
如果你希望修改默认的缓存时间，你可以使用缓存宏中来定义 RSS 宏的更新频率。你需要在你的 Confluence 站点中安装缓存插件。
如果页面有不允许的 URL
你的 Confluence 管理员可以在系统中设置 URL 的白名单列表。在这种情况下，你将会在 RSS 宏中看到错误信息。
一个用户可以添加 RSS 宏 或者 包含 HTML（HTML Include） 宏 到 Confluence 页面中。这些宏将会包含有一个有内容的 URL。当页面被显示的时候 Confluence 将会检查你给定的 URL是不是在白名单页面中。
如果你使用的 URL 不在 Confluence 的白名单中，页面将会显示错误信息。
错误信息说的是 Confluence 不能访问内容的 URL ，因为这是不允许的信息来源。
如果查看这个页面的用户是系统管理员的话，那么系统将会把用户带到系统管理员界面中，然后让你配置 URL 的白名单列表。
这里是错误信息的示例，这里提供了 Confluence 的管理员界面连接：
这里显示的是错误信息示例，这里没有提供 Confluence 的管理员界面连接：
授权
外部站点的私有 RSS 源代
如果你的 RSS 是需要收取的话，那么 RSS 宏将不能正常读取和处理 RSS 源。
访问内部的 HTTPS 源
这个给仅仅在 Confluence启用了 Https 为所有内容的时候才有效。如果你的站点是完全建立在 https 协议下的话。RSS 宏是不能访问这些内部的源的。希望 RSS 宏能够访问所有内部的源而绕过 https 设置，需要启用本地的 http 访问才可以。
- 关闭 Confluence 运行实例
- 参考 SSL 的配置指南来启用 Confluence 的 HTTP 访问。你需要确定你同时又 HTTP 连接器和 SSL 连接器。这个意思是 Confluence 可以同时通过 http 和 https 访问。但是你不应该重定向的的端口或者 web.xml 中的内容来重定向你的所有页面流量。
- 而不是使用的web.xml将流量重定向，插入防火墙规则，以所有的HTTP请求重定向不是从 Confluence 服务器为等效的HTTPS URL。这可确保用户将只能通过HTTPS访问 Confluence，如预期。如果你仍然留给附件启用HTTP访问（避免IE下载的bug），你必须选择性地启用这些网址为好。
- 修改你的 Confluence RSS 宏链接来使用 HTTP URL 同时重启 Confluence 服务器。
启用和禁用 RSS 宏
RSS 宏是 Confluence HTML 宏插件的一个模块。
希望启用和禁用 RSS 宏。
- 通过启用 Confluence HTML Macros 插件来启用 RSS 宏。
- 在 HTML 宏插件的模块列表中，找到 RSS (rss-xhtml) 模块，然后来启用和禁用它。
代码示例
宏名称： rss
宏内容： None
存储格式代码示例
|
Wiki 标记格式代码示例
|