{“content”:“\u003cdiv data-theme-toc="true"\u003e \u003c/div\u003e\n\nDiscourse 具有使用 Javascript API 创建 IFRAME 的功能，以便将主题的评论嵌入到远程站点中。有关此功能实际应用的示例，请查看 Coding Horror 的博客。该博客通过 Ghost 运行，但评论是从他的 Discourse 论坛 嵌入的。\n\n使用此设置时，需要注意的一点是用户必须导航到您的论坛才能发表回复。这是故意的，因为我们认为 Discourse 论坛上的发帖界面目前比我们能通过 Javascript 嵌入的界面要丰富得多。\n\n本指南将向您展示如何在自己的博客或网站上设置评论嵌入。\n\n### 工作原理\n\n在 Discourse 中，一个主题由许多帖子组成。当您在另一个站点上嵌入 Discourse 时，您是将一个文档（博客文章、HTML 页面等）与单个主题关联起来。当人们在该主题中发帖时，他们的评论将自动显示在您嵌入它的页面上。\n\nYou have the choice to have Discourse create the topics automatically when a new embedding is found, or you can create the topics yourself in advance. \n\n### 配置 Discourse 以进行嵌入（简单设置）\n\n以下设置将在 Discourse 论坛（运行于 =DISCOURSE=）上嵌入评论源，在虚构博客 URL http://example.com/blog/entry-123.html 上的页面中显示。\n\n论坛的域名\n博客的域名\n\n1. 访问 Discourse 安装中的 管理 > 自定义 > 嵌入。 https://=DISCOURSE=/admin/customize/embedding\n\n2. 创建至少一个可嵌入主机。这应该是您希望嵌入评论的主机名（域名）。在本例中，主机是 =BLOG= —— 请注意没有 http:// 和路径。\n\n - 路径白名单 允许您指定远程主机上接受嵌入的路径。\n\n - 发布到分类 - 如果您在输入主机时提供了分类，则从该主机导入的帖子将自动进入该分类。不同的主机可以发布到不同的分类。\n\n - 标签 - 您可以为从给定主机创建的主题自动应用标签。\n\n - 帖子作者 - 您可以选择按主机覆盖主题创建用户。如果未设置，则使用“帖子和主题”选项卡中的默认值。\n \n3. 导航到帖子和主题选项卡，填写主题创建的用户名字段。这是在新嵌入被发现时创建主题的用户。让我们假设我们的 discourse 有一个名为 eviltrout 的用户，所以其值为 eviltrout。\n\n4. 将以下 HTML 插入到 http://=BLOG=/blog/entry-123.html 处的网页上\n\nhtml\n\u003cdiv id='discourse-comments'\u003e\u003c/div\u003e\n\n\u003cscript type=\"text/javascript\"\u003e\n DiscourseEmbed = {\n discourseUrl: 'https://discourse.example.com/',\n discourseEmbedUrl: 'http://example.com/blog/entry-123.html',\n // className: 'CLASS_NAME',\n };\n\n (function() {\n var d = document.createElement('script'); d.type = 'text/javascript'; d.async = true;\n d.src = DiscourseEmbed.discourseUrl + 'javascripts/embed.js';\n (document.getElementsByTagName('head')[0] || document.getElementsByTagName('body')[0]).appendChild(d);\n })();\n\u003c/script\u003e\n\n\n代码片段中可配置的部分位于 DiscourseEmbed 对象中。discourseUrl 是到您的 Discourse 基础的完整路径，包含尾部斜杠。discourseEmbedUrl 是当前嵌入评论源的文档。\n\n如果正确设置了此项，当您第一次访问 http://=BLOG=/blog/entry-123.html 时，它将尝试加载博客文章的评论。由于没有评论，它会指示 Discourse 论坛在后台创建一个新主题。eviltrout 将在后台创建一个新主题，并且将抓取您的博客内容作为第一篇帖子，并自动提取文本。\n\n新主题创建后，用户可以对其进行评论，下次访问 http://=BLOG=/blog/entry-123.html 时，他们的评论将自动显示。\n\nclassName 是可选的，它将向嵌入项添加一个您选择的类，以便您可以使用 CSS 进行自定义。\n\n\u003e 
提示： 如果您的博客有多个作者，您可以在每页添加一个 \u003cmeta name=\"discourse-username\" content=\"author_username\"\u003e 标签。当 Discourse 抓取页面以创建主题时，它将使用此 meta 标签来确定帖子作者，覆盖管理设置中设置的默认用户名。\n\n### 在多个页面上嵌入\n\n在上面的示例中，我们在 Javascript 代码片段中硬编码了我们的 http://=BLOG=/blog/entry-123.html URL。这通常是不够的，因为许多网站都有许多自动生成的页面。例如，在博客中，每篇文章通常都有自己的页面。为了支持这一点，请在希望显示评论的每个页面上放置相同的代码片段，但用当前页面的 URL 替换传递给 discourseEmbedUrl 的值。在我的博客上，我为 discourseEmbedUrl 使用的值是：'http://eviltrout.com\u003c%= current_page.url %\u003e' —— 随着新博客页面的创建，Discourse 上也会自动为它们创建新主题。\n\n### 样式化您的嵌入内容\n\nYou have the ability to add a stylesheet for your embedded comments. Use the Embedded CSS section of the Theme editor at Admin \u003e Customize \u003e Themes \u003e [your theme] \u003e Edit CSS/HTML and you can add a custom stylesheet that will be served up with your embedded comments. By default we think the layout looks nice on a white background, but if your site has a unique layout you’ll want to style it yourself.\n\n###（可选）添加轮询源\n\n如上所述，Discourse 将自动抓取嵌入它的任何站点。但是，HTML 有时可能难以解析，并且可能无法正确提取您的帖子内容。许多博客和网站支持 RSS/Atom 源进行联合，Discourse 可以使用它来更准确地提取您的博客文章内容。\n\nDiscourse 附带 RSS 轮询插件（默认包含）。如果您在嵌入 Discourse 的站点上设置了 RSS 或 Atom 源，您可以启用 rss_polling_enabled 站点设置，并通过管理 > 插件 > RSS 轮询添加您的源 URL。添加源 URL 后，Discourse 将解析该源，并根据您添加到“嵌入设置”中的“允许的主机”将帖子发布到相应的分类中。\n\n###（替代配置）链接到现有主题\n\n有些人更喜欢不让 Discourse 在他们的论坛上自动创建主题。他们希望自己创建主题，然后只需告诉他们的嵌入代码他们想要关联哪个主题。您可以通过稍微更改嵌入代码来实现这一点：\n\nhtml\n\u003cdiv id='discourse-comments'\u003e\u003c/div\u003e\n\n\u003cscript type=\"text/javascript\"\u003e\n window.DiscourseEmbed = {\n discourseUrl: 'https://=DISCOURSE=/',\n topicId: 12345\n };\n\n (function() {\n var d = document.createElement('script'); d.type = 'text/javascript'; d.async = true;\n d.src = window.DiscourseEmbed.discourseUrl + 'javascripts/embed.js';\n (document.getElementsByTagName('head')[0] || document.getElementsByTagName('body')[0]).appendChild(d);\n })();\n\u003c/script\u003e\n\n\n唯一的区别是我们用 Discourse 中某个主题的 ID 替换了 discourseEmbedUrl。如果您这样做，将不会创建任何主题，并且该主题的评论将自动显示。\n\n### 设置引用策略\n\n由于最近（2020 年 9 月）浏览器默认引用策略的更改，Discourse 现在明确默认将 iframe 的引用策略设置为 \"no-referrer-when-downgrade\"。如果出于安全原因您的网站需要更严格的引用策略，可以通过在嵌入脚本的 DiscourseEmbed 对象中添加 discourseReferrerPolicy 值来设置。例如：\n\njs\nDiscourseEmbed = { discourseUrl: 'https://forum.example.com/',\n discourseEmbedUrl: '\u003cyour_posts_canonical_URL\u003e',\n discourseReferrerPolicy: 'strict-origin-when-cross-origin'};\n\n\n### 以编程方式查询嵌入详情\n\n我们有一个 API 端点，可以使用 embed_url 作为参数查询嵌入详情：\n\n\ncurl 'https://meta.discourse.org/embed/info?embed_url=https://blog.discourse.org/2021/04/discourse-team-grows-to-50' -H 'API-KEY: logapikeygoeshere' -H 'API-USERNAME: apiusernamehere' \n\n\n响应如下：\n\njson\n{\n \"topic_id\": 187794,\n \"post_id\": 925017,\n \"topic_slug\": \"discourse-team-grows-to-50-blog\",\n \"comment_count\": 2\n}\n\n\n### 嵌入私人站点评论\n\n对于私有 Discourse 实例，如果 Discourse 位于博客域名的子域名下，那么已登录 Discourse 的用户将看到评论。未登录 Discourse 的用户将看到“拒绝连接”消息。如果 Discourse 和博客位于完全不同的域下，则私人论坛不会显示任何评论。\n\n### 故障排除\n\n用户在嵌入 Discourse 时遇到的最常见问题是为添加的可嵌入主机设置了不正确的值。请务必仔细检查它是否仅是您站点的域名，并且不包含任何多余的斜杠或无效字符。”}
Is it possible to use this method if the Discourse category is hidden from public view?
Probably not, but it might work if all of your viewers are logged in.
I’ve created a tutorial that walks you through the process of setting up a local discourse instance on vagrant for your local tests to embed discourse in your front-end development project. You can find it here: Local discourse: vagrant, ansible, lxd, docker, discourse-embedding
This is different from other descriptions that I found before in that it allows you to run locally a complete discourse set-up like you would do in production to get a feel for the “real” set-up process. In addition this set-up is able to serve as a local development playground for embedding discourse into your project.
你好，有没有办法禁用草稿状态帖子的嵌入功能？我在 Ghost 中找不到与帖子状态相关的 Handlebars 变量，能否修改嵌入设置以排除用于预览帖子的 /p/ 路径？我遇到的问题是，预览中的帖子会被添加到 Discourse 中。谢谢。
似乎再也找不到设置来样式化嵌入的 iframe 了……？原帖是不是有些过时了？
编辑：没关系，它只是换了位置。我可以把它添加到主题组件中 
谢谢！
这听起来像是关于 Ghost 的问题，而不是 Discourse 的问题？不过，既然你的 Ghost 集成正在运行，就需要考虑到这一点，而不是 Discourse。
大家好！
我需要一些帮助，将 Discourse 嵌入到 READTHEDOCS（使用 Sphinx）
有人有这方面的经验吗？
看起来有一个 GitHub - pdavide/sphinxcontrib-discourse · GitHub 项目，它总是嵌入单个主题。
感谢您的回复，让我们查看一下。
大家好
我在嵌入特定主题时遇到了一些问题：
我尝试了各种设置变体，但在我的网站上仍然只显示“嵌入错误”。
您能看出我可能哪里做错了吗？我花了很长时间试图解决这个问题，任何帮助都将不胜感激。
当前嵌入到网站中的代码
您的 JavaScript 控制台中有错误吗？
在你的第一张截图中，所有路径都设置为发布到“未分类”类别。如果你希望将所有帖子发布到同一个类别，只需创建一个“可嵌入”主机记录即可。
你在主机条目中添加的“路径白名单”值可能会导致问题。你可以将该值留空，以发布已添加 Discourse 嵌入脚本的博客站点中的所有帖子。如果你想为发布到特定 Discourse 类别设置特定路径，该路径应以 /.* 结尾。例如：/sites/.*
你路径 /t/newsletter-discussions/105 开头的双斜杠可能是一个问题。此外，这看起来像是 Discourse 主题的路径。如果设置，该路径应指向你博客上的一组帖子的路径。“路径白名单”设置的目的是允许你将博客上特定路径的帖子发布到特定的 Discourse 类别。
好的，谢谢西蒙，我很感激。我会试试看。
和 @codinghorror 一样，我也在使用 Ghost 的 Discourse 集成 使用默认配置，该配置将绝对 URL 用作 discourseEmbedURL。
大约一周前，我决定更改 Ghost 博客的路由，使 URL 如 https://engineerworkshop.com/2020/02/20/how-to-set-up-wireguard-on-a-raspberry-pi/ 的文章重定向到 https://engineerworkshop.com/blog/how-to-set-up-wireguard-on-a-raspberry-pi/，其中 https://engineerworkshop.com/blog/how-to-set-up-wireguard-on-a-raspberry-pi/ 成为新的永久链接。
问题所在
您可能已经预见到了这个问题：discourseEmbedURL 仍设置为旧 URL，因此当嵌入脚本被调用时（此时 URL 已不同），Discourse 中会创建一个新的评论帖子。
尝试的解决方案（但失败了）
在此之前，我已经预见到了这个问题，并自以为聪明地使用正则表达式配合 remap 来修复 URL：rake posts:remap["[0-9]{4}\/[0-9]{2}\/[0-9]{2}","blog",regex]
虽然这“某种程度上”奏效了，但在原始 Discourse 评论帖子中使用的任何 URL，不幸的是，当我加载博客文章时，Discourse 中又创建了新的评论主题。
最终，我只是重新加载了网站上的每篇文章，并将评论从旧主题转移到了新主题，然后删除了原始主题（我知道，我知道）。显然，删除页面会对 SEO 产生负面影响，更不用说对用户体验的影响了。
我的问题
我猜测我的正则表达式补丁尝试之所以失败，是因为 Discourse 主题在后台 somehow 与 URL 关联。（我坦率承认自己对 Discourse 的数据结构并不了解）。为了未来的知识积累，也为了任何未来可能尝试同样操作的人，是否有办法将 Discourse 主题重新映射到新的博客文章 URL？
提前感谢！
7 篇帖子已合并到现有主题：WP Discourse Embed 插件
我非常喜欢这个功能，因为我运营着许多杂志风格的内容网站，可以自动生成话题到我们的论坛。但有没有办法让 URL 预览像 Discourse 中那样正常工作呢？
比如，不是这样：
而是像这样：
谢谢，
Jim
如果链接单独占一行，它应该会自动生成预览卡片。
然后将您的完整描述行放在下方，包括链接，就像您在第一张图中展示的那样。该描述将显示在预览卡片下方。
嗯……这确实是个问题，因为预览的正是页面本身。因此，在页面 HTML 或文章正文的开头放置链接会有些棘手。这是相关页面：
https://modelshipwrights.com/news/us-navy-light-cruiser-cl-89-miami
大家好。我快让这功能跑起来了，但意识到我设想的使用场景可能没我想象的那么直接，也不确定需要多少额外的工作量。
我希望利用这个功能来驱动一个基于用户生成内容的网站上的讨论。对于评论的嵌入、设置单点登录（SSO），以及确保我的用户能自动成为社区成员（使用相同的邮箱、用户名等），我都没有问题。
我原本希望的是：当我的网站上创建新的用户内容时，发布该内容的用户能成为相关 Discourse 帖子的作者，而不是嵌入功能中“创建话题的用户名”设置里定义的单一用户。我不会允许在我的现有注册流程之外进行注册，因此我可以 100% 确定 Discourse 用户要么已经存在，要么至少可以在创建新线程的同时被创建。
我想这样做的原因应该很明显。也就是说，内容创作者将成为我 Discourse 网站上该讨论的原作者（OP），可以自动订阅该线程并收到回复通知，其帖子会被高亮显示以区别于其他评论，等等。
有什么关于从哪里开始的建议吗？
谢谢！