什么是语法突出显示，它如何工作？

#1 楼

什么是语法突出显示？
语法突出显示允许根据所写语言突出显示帖子中的代码，以使其更易于阅读。
它如何工作？有自己的语法高亮引擎。它使用highlight.js，不一定使用该库的最新版本。因此，Stack Exchange无法处理与语法突出显示有关的任何错误和功能请求。
在您停止键入5秒钟后，在创建或编辑帖子时，将基于标签将语法突出显示分配给预览。 />为什么我的代码无法正确突出显示？
1。检查您正在使用的网站是否启用了语法突出显示
完整列表可在Meta上找到。如果未在站点上启用语法突出显示，请按照此问题中的说明进行操作。
2。检查highlight.js是否支持该语言。
查看highlight.js支持的语言列表。如果您的语言不在列表中，则需要先在highlight.js项目中创建该语言，然后才能由Stack Exchange部署。
如果该语言已在列表中但未在Stack Exchange中使用，请提出Meta上的功能请求，以将其部署到网络上。
3。检查Stack Exchange是否使用该语言。查看dev CDN上的highlight-loader.js文件，在您喜欢的编辑器中打开它，然后搜索语言提示。例如，搜索“飞镖”会将您带到包含hljs.registerLanguage('dart', ...的行。这意味着lang-dart是可用的语言提示。搜索“ psh”或“ powershell”不会返回任何结果，这意味着Highlight.js的Stack Exchange版本不支持psh。
4。检查问题标签是否启用了语法突出显示
在后台，Stack Exchanges使用问题上的标签来确定您使用的语言。每个标签在其属性中都有突出显示的语言，或者没有语言。如果有多个标签指定了突出显示语言，或者没有一个标签指定了突出显示语言，则它会使用默认设置，并让Prettify推断出最适合使用的语言。问题的答案也使用相同的突出显示语言。
访问该标记的Wiki页面。单击一个标签（例如“ javascript”），然后单击“了解更多...”，当前用于该标签的语言提示（如果有）将显示在最底部， Wiki：



如果该标记未在应使用的位置指定突出显示语言，则在每个站点元上创建功能请求，以供您的站点请求它。 （只有主持人可以更改标签的突出显示语言。）
如何报告错误或请求新的语言？
如果确实是语法突出显示工具中的错误，请首先检查现有报告查看它是否已经被报告；如果还没有，请继续进行报告。对于Highlight.js已实现但在此处无法使用的错误修复和功能，可以在Meta上提出功能请求以请求部署新版本的Highlight.js。 Stack Exchange不会维护此语法突出显示器（除了安装它的较新版本），并且在Meta上将与之相关的错误报告或功能请求发布到此处不会使它们得到修复或实现。
执行任何操作之前，请确保您已启用正确的突出显示。
如何使用语法突出显示？
只要“为什么我的代码未正确突出显示”中的所有条件？上面的部分已满足，突出显示将根据问题上的标签在代码块上自动启动。 （请参见4。检查问题的标签上方是否启用了语法突出显示功能。）内联代码（例如this）未突出显示。
可以显式覆盖在通过在代码块上方指定语言提示，将您选择的语言张贴在特定代码块中。请注意，仅在使用代码围栅（```）代码格式化方法时才支持此功能。从CommonMark的实现开始，不再支持使用四空间缩进方法在代码块上执行此操作*：

```lang-or-tag-here
code goes here
```

您可以在语言提示中使用语言代码或标记名来激活语法突出显示。请参阅以下有关Prettify支持的语言代码的完整列表。
例如：

Here is a code block with language code (with "lang-" prefix) as a hint:

```lang-js
function greet(person) {
    return "Hello " + person;
}
var user = "John Doe";
alert(greet(user));
```

Here is a code block with tag name (no "lang-" prefix) as a hint:

```typescript
var arr = [0, 1, 2];  // will highlight if typescript tag exists
```

如果不想突出显示任何语法，则可以使用lang-none语言：

```lang-none
[code here]
```

您还可以将语言提示应用于帖子中的所有代码块，因此不必在每个帖子之前添加提示，只需在帖子顶部添加HTML注释即可。然后，该提示将应用于您帖子中的所有代码块，包括那些使用四空格缩进或HTML的代码块。在其答案上；默认情况下，仍会根据问题的标签突出显示这些代码。

Stack Exchange当前可用的语言代码
这是您可以在语言提示中用于语法突出显示的每个标识符的完整列表。每个组中的所有这些语言提示均指向同一荧光笔。由highlight.js设置的其他语言别名可能也可以使用，但是Stack Exchange仅正式支持以下标识符。 >

无：明确不使用任何语法高亮显示
<pre><code>，lang-default，lang-none，lang-plaintext


Bash
lang-text，lang-txt， lang-bash


C，C ++和其他C-likes
lang-sh，lang-zsh，lang-c，lang-h，lang-cpp，lang-hpp，lang-c++，lang-h++，lang-cc，lang-hh，q4312079 >

C＃
lang-cxx，lang-hxx，lang-c-like


Clojure
lang-cs，lang-csharp


CoffeeScript
lang-c#，lang-clojure，lang-clj，lang-coffee


CSS
lang-coffeescript


Dart
lang-cson


Erlang
lang-iced，lang-css


Go
lang-dart，lang-erl



哈斯克尔
lang-erlang，lang-go


HTML，XML，XSL等
lang-golang，lang-hs，lang-haskell，lang-html，lang-xml，lang-xsl，lang-xhtml，lang-rss，lang-atom，q4312079


HTTP标头
lang-xjb，lang-xsd


Ini和TOML
lang-plist，lang-wsf


Java
lang-svg，lang-http


JavaScript
lang-https，lang-ini，lang-toml，lang-java，lang-jsp


> JSON
lang-js


科特林
lang-javascript，lang-jsx


LaTeX，TeX
lang-mjs，lang-cjs


更少
lang-json


Lisp
lang-kotlin


Lua
lang-kt


Makefile
lang-latex，lang-tex，lang-less


降价
lang-lisp，lang-lua，lang-makefile，lang-mk


MATLAB
lang-mak


Objective-C
lang-markdown，lang-md，lang-mkdown，lang-mkd



OCaml
lang-matlab，lang-objectivec

>
Pascal，Delphi
lang-mm，lang-objc，lang-obj-c，lang-ocaml，lang-ml，lang-pascal，lang-delphi，lang-dpr，lang-dfm


Perl
lang-pas，lang-freepascal lang-lazarus


PHP
lang-lpr，lang-lfm，lang-pl，lang-perl，lang-pm，lang-php


PHP模板
lang-php3
/>

协议缓冲区
lang-php4


Python
lang-php5，lang-php6，lang-php7，lang-php-template


R
lang-protobuf


Ruby
lang-py，lang-python，lang-gyp，lang-ipython，lang-r，lang-rb


锈
lang-ruby，lang-gemspec


Scala
lang-podspec


方案
lang-thor


SCSS
lang-irb


Shell
lang-rs，lang-rust


SQL
lang-scala


Swift
lang-scheme


TypeScript
lang-scss，lang-shell


VHDL
lang-console


VB.NET
lang-sql，lang-swift


YAML
lang-typescript，lang-ts


突出显示功能无法识别的帖子在功能上将默认设置为lang-vhdl。可以为null（无提示），默认值或特定的语言代码。
请记住，默认情况下，所有标签均以lang-vbnet作为其语言代码开头。指定为lang-vb作为其语言代码的标签将被忽略并恢复为lang-yaml。您还可以使用普通的lang-yml关键字手动指定不语法突出显示，类似于上面的lang-default代码。 > *前一种指定突出显示语言的方法仍可用于HTML代码块：将HTML注释none放在none标记之前，它将起作用。空格缩进的代码块，但仅不推荐使用。虽然暂时仍可在四空间缩进的代码块上使用，但将来可能会/将其删除。


编辑者注意：除非您100％确信存在，否则将其添加到上面的列表中。请记住，无效的标识符会恢复为默认值。



此外，由于必须由Stack Exchange手动安装新版本的highlight.js，因此Highlight中指示支持的语言。 js的文档可能实际上未受到Highlight.js的Stack Exchange版本的支持。在列表中添加新提示。
注释者注意：请不要问将来是否会支持某些语言。这不是我们可以回答的问题，因为Stack Exchange不维护此荧光笔。请访问Highlight.js以获取语言支持。