从编辑器提供 CommonMark 文档的链接

我认为提供一个指向 CommonMark 参考文档 的链接,或者可选地链接到一个自定义主题,将有助于用户进行那些无法通过工具栏按钮完成的编辑。如果可以配置指向自定义主题的链接,那么还可以记录特定于插件的标记语法,例如用于勾选框插件的标记。

在工具栏最右侧添加一个问号按钮,似乎是实现此链接的一个好方法。

7 个赞

我无法确定这是否会在长期内被纳入核心功能,但看起来它非常适合作为初始的主题组件。

11 个赞

响应非常迅速:自定义网站上的 education.* 键文本,将其链接到您网站的自定义主题。:sunglasses:

6 个赞

这些信息是否只在您首次撰写新主题或回复时显示?

2 个赞

是的,但这同时也使它们成为存放这些信息的更合适场所 :information_source:

4 个赞

我不同意。这应该是一个参考链接,供你在忘记某些不常用的 Markdown 语法时查阅。它不是那种只需阅读一次、之后便无需再回顾的内容。

1 个赞

你似乎还抱有一种错觉,认为用户会阅读屏幕上显示的任何内容。

其实他们不会。

最好的做法是在用户最需要信息的时候,及时提供给他们——而不是在屏幕上堆砌一堆随机链接,说是“以防万一”,结果 99.999% 的情况下都被忽略,反而给所有用户增加了视觉杂乱。

3 个赞

不,很抱歉让你失望了。:grin: 这仅仅是一个出于我个人便利的自私建议。它灵感来源于 GitHub 编辑器,其中包含一个指向 GH Markdown 规范的链接,我会时不时地查阅。

同意,那确实是理想的解决方案。当然,说起来容易做起来难。这在不同用户之间差异巨大,因此如果没有广泛的测试,我对这种方法的有效性持怀疑态度。否则,这仅仅是基于假设。

我猜“你点击过 :heart 按钮吗?”就是这种方法的例子?不知何故,Discourse 会假设我赞同我回复的帖子,只要我的消息包含的字符很少。当我第一次遇到这种情况时,这种假设是错误的,除了造成困惑和沮丧外,没有任何实际意义。

话虽如此,我认为教育用户并没有简单的解决方案。面对背景各异的用户,可能根本不存在完美的解决方案,所以请不要将此视为批评。

2 个赞

如果您想要一个通用的 Markdown 提醒,请查看 commonmark.org

1 个赞

再投一票,建议在作曲框的右上角或右下角添加一个小小的 :grey_question:

:ballot_box:

这个插件已经存在一段时间了

15 个赞

会觉得这个功能实用的人,通常能够主动寻找并获取所需信息来自我解决。他们已经是 :star: 级别的用户了。

此外……如果用户真的 阅读 了任何内容(但他们并没有),他们本应该看到所有新用户都会收到的 交互式 Discobot 欢迎私信中的格式设置步骤。这是最好的方式,因为它基于实际编辑器动态且交互式地呈现,并包含帮助链接。

查看你的私信,你也会在那里看到同样的欢迎私信。

6 个赞

谢谢。我原以为应该已经有类似的东西了,但没能找到。

不幸的是,它对我来说无法使用。相关 Bug 已在此报告:Plugin not working with Discourse 2.5.0.beta1 · Issue #12 · cpradio/discourse-plugin-composer-help-button · GitHub

3 个赞

很多人问我如何使用 Markdown,因此我支持这个想法。我自己也花了很长时间才意识到编辑器使用了 Markdown,并找到相关的使用说明。

我的建议是,为新用户在编辑器顶部添加一个蓝色提示框,内容类似:

“点击此处了解如何使用 Markdown 格式化文本:[链接]”

蓝色提示框的右上角可以带有一个关闭按钮,这样不想再看到它的用户可以永久关闭它。

3 个赞

正如 Jeff 所说,Discobot 会教授一些 Markdown 基础知识。您的实例上是否启用了 Discobot?

3 个赞

确实如此。机缘巧合下,有人一直纠缠我,并威胁说如果我不解释如何使用 Discourse,他们就不再使用它。

最终,我复制并粘贴了这篇文章,并在论坛中将其全局置顶。在这个过程中,我也学到了一些以前不知道的东西。

2 个赞

一个更简单的做法可能是链接到

https://commonmark.org/help/

https://blog.discourse.org/2016/12/discourse-new-user-tips-and-tricks/

这两个链接都会包含在 Discourse 中每个新用户创建账户后收到的新用户欢迎私信里。

3 个赞