本指南介绍如何在 Discourse 帖子中的代码块内选择编程语言,以及如何禁用语法高亮显示。
所需用户级别:所有用户
当您在帖子中使用三个反引号将代码括起来时,Discourse 使用 highlight.js 来自动检测并应用语法高亮显示到代码上。但是,如果自动检测不按预期工作,您可以指定编程语言。
为代码块指定编程语言
要为代码块指定编程语言,请在第一组反引号后键入该语言的名称:
``` your_language
# 您的代码在这里
```
例如,要指定 Ruby:
``` ruby
3.times do |stuff|
stuff.do
end
```
结果将如下所示:
3.times do |stuff|
stuff.do
end
该语言必须是您的站点上为语法高亮显示的配置的 highlighted languages(已高亮显示的语言)之一。如果某种语言不起作用,请咨询您的站点管理员。
禁用高亮显示
如果您想阻止任何语法高亮显示,可以将 text、plain 或 pre 用作语言:
``` text
您不想高亮显示的文本在这里
```
结果将显示为纯文本,没有任何高亮显示:
您不想高亮显示的文本在这里
最佳实践
- 如果自动检测无法正确识别您的代码,请务必指定语言。
- 对于管理员:请确保验证所选语言是否已在
highlighted languages站点设置中配置。