这是关于使用 Discourse 的 Onebox 创建丰富链接预览的指南。它解释了如何创建 Onebox、使用内联 Oneboxing、避免 Oneboxing、使用超链接以及处理高级 iFrame。
所需用户级别：所有用户
Onebox 会将您的网络链接转换为有用的预览摘要，帮助读者在点击之前了解目标内容。
摘要
本指南介绍如何：
- 创建 Onebox
- 使用内联 Oneboxing
- 避免 Oneboxing
- 使用超链接代替 Oneboxing
- 处理高级 iFrame
创建 Onebox
要创建 Onebox，只需将任何链接粘贴到帖子中并单独占一行，如下所示：
https://www.google.com/
结果如下：
Onebox 支持通用的 oEmbed 和 OpenGraph 标签，并为维基百科、Twitter、亚马逊、YouTube 等热门网站提供自定义规则。
尝试将链接粘贴到您的帖子中，看看会发生什么。请记住，要使 Oneboxing 生效，链接必须单独占一行！
内联 Oneboxing
如果启用了 enable inline onebox on all domains（此功能默认启用）网站设置，将链接粘贴到文本内会用页面标题替换原始链接，如下所示 Understanding Discourse Trust Levels
like this https://blog.discourse.org/2018/06/understanding-discourse-trust-levels/
避免 Oneboxes
如果您希望链接显示为纯粹的、未修饰的原始链接，请将其放在 < 和 > 括号中：
<https://blog.discourse.org/2018/06/understanding-discourse-trust-levels/>
或者，您可以在链接前放置一个空格或在链接后放置任何字符。
使用超链接
您可以通过以下方式向文本添加链接：
- 使用编辑器工具栏中的链环按钮
- 选择帖子中的一些文本并粘贴剪贴板中的链接
- 添加 Markdown / BBCode / HTML 链接：
[link here](https://example.com)
[link=https://example.com]link here[/link]
<a href="https://example.com">link here</a>
高级 iFrames
默认情况下，出于安全原因，<iframe> 会被阻止。但是，如果 iframe 来自高度受信任的来源，Discourse 管理员可以将该域名添加到 allowed iframes 网站设置中。
您可能还需要粘贴完整的嵌入代码，例如下面地图的代码：
<iframe src="https://www.google.com/maps/embed?pb=!1m18!1m12!1m3!1d24202.451099423397!2d-74.06201522657554!3d40.68924937923285!2m3!1f0!2f0!3f0!3m2!1i1024!2i768!4f13.1!3m3!1m2!1s0x89c25090129c363d%3A0x40c6a5770d25022b!2sStatue+of+Liberty+National+Monument!5e0!3m2!1sen!2suk!4v1533203877892" width="600" height="450" frameborder="0" style="border:0" allowfullscreen></iframe>
结果如下：
附加资源
有关 Onebox 的更多信息和故障排除，请访问以下相关主题：