选择代码块中使用的编程语言

:bookmark: 本指南介绍如何在 Discourse 帖子中的代码块内选择编程语言,以及如何禁用语法高亮显示。

:person_raising_hand: 所需用户级别:所有用户

当您在帖子中使用三个反引号将代码括起来时,Discourse 使用 highlight.js 来自动检测并应用语法高亮显示到代码上。但是,如果自动检测不按预期工作,您可以指定编程语言。

为代码块指定编程语言

要为代码块指定编程语言,请在第一组反引号后键入该语言的名称:

``` your_language
# 您的代码在这里
```

例如,要指定 Ruby:

``` ruby
3.times do |stuff|
  stuff.do
end
```

结果将如下所示:

3.times do |stuff|
  stuff.do
end

该语言必须是您的站点上为语法高亮显示的配置的 highlighted languages(已高亮显示的语言)之一。如果某种语言不起作用,请咨询您的站点管理员。

禁用高亮显示

如果您想阻止任何语法高亮显示,可以将 textplainpre 用作语言:

``` text
您不想高亮显示的文本在这里
```

结果将显示为纯文本,没有任何高亮显示:

您不想高亮显示的文本在这里

最佳实践

  • 如果自动检测无法正确识别您的代码,请务必指定语言。
  • 对于管理员:请确保验证所选语言是否已在 highlighted languages 站点设置中配置。

附加资源

11 个赞