Discourse脚注

[Discourse]

	摘要	Discourse Footnote 插件允许用户在帖子中创建 Markdown 脚注。
	安装指南	该插件已包含在 Discourse 核心中。无需单独安装该插件。

由于这是由 Discourse 团队维护的#官方插件，#支持、#Bug、#用户体验和#功能请求可以在 Meta 的相应类别中提出，并打上适当的插件标签。点击下方链接即可开始创建。

 支持  Bug  用户体验  功能

启用脚注

Footnote 插件默认已启用，但可以从 admin/plugins 页面禁用或重新启用：

功能

启用后，您可以通过以下方式在帖子中添加脚注：

需要脚注的句子。^[脚注内容] 
另一个需要脚注的句子。^[第二个脚注内容]

或者像这样：

需要脚注的句子。[^1] 
另一个需要脚注的句子。[^2]

[^1]: 脚注内容
[^2]: 第二个脚注内容

您可以在帖子中混合使用这两种风格，也可以使用非编号锚点。

有两种显示脚注的方式，由 display footnotes inline 管理设置控制：

非内联：

内联：

需要脚注的句子^[1]
另一个需要脚注的句子^[2]

内联版本既适用于引用也适用于移动设备。

设置

名称	描述
enable markdown footnotes	在此站点启用 Markdown 脚注
display footnotes inline	启用脚注的内联展开

由我们托管？此插件可在我们所有托管层级上提供 Footnote | Discourse - Civilized Discussion

开发历史

Discourse footnote 将 @Vitaly 的 footnote markdown.it 扩展 重新打包为 Discourse 插件。

---

1. 脚注内容 ↩︎

2. 第二个脚注内容 ↩︎

[Kayla]

@sam

普遍的共识是，该扩展应该允许如下语法：

一些深刻的想法，需要引用[^1]

[^1]: 这里是引用。

只是提醒一下，该扩展似乎不允许使用常规的脚注 Markdown [^1]。除非我使用“内联”格式，否则我无法获得格式化的脚注，如下所示：

@sam

您也可以使用“内联”脚注——不是内联展开，而是注释本身。像这样：

更多明智的说法 ^[林肯，或爱因斯坦，或别的什么]

启用使用内联脚注格式的脚注会生成自动编号的脚注，这些脚注会一起出现在帖子下方，同时启用内联展开会产生省略号工具提示式体验，帖子下方不会出现脚注。如果您启用了内联展开选项，您的帖子预览窗口将显示为传统的编号脚注，但发布后您将看到内联展开的效果。

我很欣赏使用内联格式自动编号的脚注，只是我花了几个小时才弄清楚我应该如何实际格式化 Markdown 以及哪些选项可以让它们按预期运行。希望这个评论能帮助其他人避免同样的困惑。

编辑补充：内联展开选项是您的脚注在移动设备上的显示方式，无论该选项是否被启用（也适用于桌面）。

[denvergeeks]

允许用户使用此 Discourse Footnote 插件创建内联弹出内容的方法：

将此插件与 Composer Footnote Button 主题组件 ^[1] 结合使用（它在 Composer/编辑器中提供了一个创建脚注的按钮）

您可以将任何内容放入弹出窗口中，包括 HTML。

示例：

文本 ^[2]

---

文本和图片上传 ^[3]

---

HTML 内容 ^[4]

---

1. (同时安装它们) ↩︎

2. 此处为纯文本。 ↩︎

3. 文本和图片上传
   

   
   ↩︎

4. 

   初次接触开源社群时，可能会感到困惑。无论是首次在邮件列表中发帖、撰写关于你正在进行的项目博客，还是在 IRC 频道闲逛——人们的互动方式以及他们对彼此的期望，与在课堂上或与家人朋友相处时截然不同。

   
   

   开放与分享

   开源交流可能千差万别。一个共同的核心价值是分享代码是好的。无论许可证、语言或缩进风格如何，开源开发者共同创建、分享和修改源代码。

   ↩︎

[jrgong]

页脚插件是否也适用于公共页面？在我的特定情况下，我希望它不适用于公共页面，并且只在常规主题视图中可见（用于内部笔记等）。

[denvergeeks]

@jrgong – 不…

Adding DiscoTOC to Published Pages

at the moment page publishing is not designed to support theme components or anything using plugin api and especially decorateCooked. Not saying this is impossible, but we didn’t work on it and at this point I dont know if we will.

不过，有另一种方法，我正在为此开发一个主题组件… 在 Github 上。

[pfaffman (Jay Pfaffman)]

Looks like this got moved to core 17 hours ago.

I’ll let someone else update this appropriately.

Translation missing: en.The discourse-footnote plugin has been integrated into discourse core. Please remove the plugin from your app.yml and rebuild your container.

FEATURE: Bundle discourse-footnote plugin into core

[LoveMCJ]

迁移到core后，

我删除了app.yml中的插件并运行了./launcher rebuild app，

但设置仍然保留在插件页面上。就这样放着可以吗？

[JammyDodger]

这是新的。：+1：这是两者的对比图：

[LoveMCJ]

@JammyDodger

这是新的。 这是两者的对比图：

这声音真好听！ 谢谢分享。

[blake (Blake Erickson)]

@pfaffman

我会让其他人来适当地更新这个。

Translation missing: en.The discourse-footnote...

感谢您的提及，我刚刚推送了一个修复程序。

[pfaffman (Jay Pfaffman)]

另一个问题是，您不再需要安装插件，如果您已经安装了，则无需在 yml 文件中包含 git clone。

[JammyDodger]

我更新主题的速度太慢了，你已经抢先一步了。

无论如何，我现在还是要补充一下……

---

Discourse Footnote 现在已与 Discourse 核心捆绑在一起，因此无需单独安装此插件。

如果您是自托管用户，您应该会在仪表板上看到有关从 app.yml 中移除它的信息。

由我们托管？此更改不会以任何方式影响您。 您可以继续使用此插件，无需担心任何事情。

[pfaffman (Jay Pfaffman)]

是的。抱歉。

太棒了！我就知道你有计划。我本应该等等的，因为我指出的其他事情确实是一个问题，而且已经被别人解决了，我本应该耐心等待，因为我知道你会处理它。（而且它也很漂亮！）。

距离现在还不到 24 小时，所以，你知道，这也很不错。

谢谢。

[Turtle]

有没有办法让脚注正常格式化？这样它就不会像这样与三个点内联？^[1]

而是像这样？

---

1. 对我来说，这看起来很奇怪 ↩︎

[sam (Sam Saffron)]

@Discourse

display footnotes inline

是这个设置吗？

[Turtle]

但我的意思是作为普通用户，而不是管理员更改设置。

[Jagster (Jakke Flemming)]

没有，就没有针对这个的用户设置。只有全局设置。

[kiefferr (Ryan Kieffer)]

我注意到脚注不允许在脚注括号内使用许多常见的 Markdown 语法^[1]\n\n不是什么大问题，但这确实限制了您可以在脚注中放置内容的可用性！

---

1. 例如：这在脚注括号内，但每当我引入段落、标题、列表等时，布局都会中断。\n\n这里有一个段落中断。 ↩︎

[Arkshine]

您可以，请确保至少缩进 4 个空格。

例如：

这里是脚注引用[^1]，还有另一个[^longnote]。

[^1]：这是脚注。

[^longnote]：这是一个有多段的脚注。

    后续段落会缩进以显示它们属于前面的脚注。

    * 项目 1
    * 项目 2

    **更多**文本

    *斜体*

这里是脚注引用[^1]，还有另一个[^longnote]。

[^1]：这是脚注。

[^longnote]：这是一个有多段的脚注。

后续段落会缩进以显示它们属于前面的脚注。

* 项目 1
* 项目 2

**更多**文本

*斜体*

渲染为：