Hugo 语法高亮

Hugo 提供多种方法为代码示例添加语法高亮：

• 在模板中使用 transform.Highlight 函数
• 使用 highlight shortcode 与任何 content format
• 使用 Markdown 内容格式的围栏代码块

围栏代码块

在默认配置中，Hugo 高亮围栏代码块内的代码示例，格式如下：

```LANG [OPTIONS]
CODE
```

CODE

要高亮的代码。

LANG

要高亮的代码语言。从 supported languages 中选择一个。此值不区分大小写。

OPTIONS

一个或多个空格分隔或逗号分隔的键值对，包裹在花括号中。在 site configuration 中为每个选项设置默认值。键名不区分大小写。

例如，使用此 Markdown：

```go {linenos=inline hl_lines=[3,"6-8"] style=emacs}
package main

import "fmt"

func main() {
    for i := 0; i < 3; i++ {
        fmt.Println("Value of i:", i)
    }
}
```

Hugo 渲染这个：

1package main
2
3import "fmt"
4
5func main() {
6    for i := 0; i < 3; i++ {
7        fmt.Println("Value of i:", i)
8    }
9}

选项

anchorLineNos

(bool) 是否将每个行号渲染为 HTML 锚元素，将周围 span 元素的 id 属性设置为行号。如果 lineNos 为 false，则此选项无关。默认为 false。

codeFences

(bool) 是否高亮代码围栏。默认为 true。

guessSyntax

(bool) 如果 LANG 参数为空或设置为没有相应 词法分析器 的语言，是否自动检测语言。如果无法自动检测语言，则回退到纯文本词法分析器。默认为 false。

Chroma 语法高亮器包含约 250 种语言的词法分析器，但其中只有 5 种实现了自动语言检测。

hl_Lines

(string) 要在高亮代码中强调的行的空格分隔列表。要强调第 2、3、4 和 7 行，将此值设置为 2-4 7。此选项独立于 lineNoStart 选项。

hl_inline

(bool) 是否在没有包装容器的情况下渲染高亮代码。默认为 false。

lineAnchors

(string) 在将行号渲染为 HTML 锚元素时，将此值前置到周围 span 元素的 id 属性。当页面包含两个或更多代码块时，这提供了唯一的 id 属性。如果 lineNos 或 anchorLineNos 为 false，则此选项无关。

lineNoStart

(int) 在第一行显示的数字。如果 lineNos 为 false，则此选项无关。默认为 1。

lineNos

(any) 控制行号显示。默认为 false。

• true：启用行号，由 lineNumbersInTable 控制。
• false：禁用行号。
• inline：启用内联行号（将 lineNumbersInTable 设置为 false）。
• table：启用基于表格的行号（将 lineNumbersInTable 设置为 true）。

lineNumbersInTable

(bool) 是否在 HTML 表格中渲染高亮代码，包含两个单元格。左表格单元格包含行号，右表格单元格包含代码。如果 lineNos 为 false，则此选项无关。默认为 true。

noClasses

(bool) 是否使用内联 CSS 样式而不是外部 CSS 文件。默认为 true。要使用外部 CSS 文件，将此值设置为 false 并从命令行生成 CSS 文件：

hugo gen chromastyles --style=monokai > syntax.css

style

(string) 应用于高亮代码的 CSS 样式。区分大小写。默认为 monokai。请参阅 语法高亮样式。

tabWidth

(int) 用此数量的空格替换高亮代码中的每个制表符。如果 noClasses 为 false，则此选项无关。默认为 4。

wrapperClass

New in v0.140.2

(string) 用于高亮代码最外层元素的类。默认为 highlight。

转义

记录 shortcode 用法时，转义标签分隔符：

```text {linenos=inline}
{{</* shortcode-1 */>}}

{{%/* shortcode-2 */%}}
```

Hugo 渲染这个：

1{{< shortcode-1 >}}
2
3{{% shortcode-2 %}}

语言

以下是支持的语言。在指定语言时使用以下标识符之一，而不是语言名称：

• transform.Highlight 函数
• highlight shortcode
• 围栏代码块