1.5 高亮(highlight)

highlight 使用语法高亮显示来呈现您的代码。

1print("Hello World!")

用法

这个简码与 Hugo 的 highlight 简码但提供了一些扩展。

它的调用方式与 Hugo 自己的短代码相同，提供位置参数或简单地使用 codefences。

您也可以自由地从自己的部分调用此短代码。在这种情况下，它类似于雨果的highlight功能语法，如果使用兼容性语法将此简码称为部分。

虽然示例使用带有命名参数的短代码，但建议改用 codefences。这是因为越来越多的其他软件支持共同防御（例如。GitHub），因此您的 Markdown 变得更加可移植。

```py { lineNos="true" wrap="true" title="python" }
print("Hello World!")
```

{{< highlight lineNos="true" type="py" wrap="true" title="python" >}}
print("Hello World!")
{{< /highlight >}}

{{< highlight py "lineNos=true,wrap=true,title=python" >}}
print("Hello World!")
{{< /highlight >}}

参数

名称	位置	默认	Note注释s
type	1	<空>	要突出显示的代码语言。从支持的语言之一中进行选择。不区分大小写。
title		<空>	扩展。代码的任意标题。如果出现以下情况，则会像单个选项卡一样显示代码`hl_inline=false`（这是 Hugos 的默认设置）。
wrap			扩展。当内容可以换行时，否则它将是可滚动的。默认值true,可以在`hugo.toml`并通过 `frontmatter` 覆盖。见下文。
options	2	<空>	此表中零个或多个 Hugo 支持的选项以及扩展参数的可选逗号分隔列表。
<option>		<空>	Hugo 支持的任何选项.
<content>		<空>	需要语法高亮的代码.

配置

Hugo 支持选项的默认值可以通过 goldmark 设置hugo.toml

扩展选项的默认值可以通过hugo.toml或被每个单独页面的 frontmatter 覆盖。

全局配置文件

您可以在颜色变体样式表文件中配置用于代码块的颜色样式。

可选设置

[params]
  highlightWrap = true

页面 Frontmatter

highlightWrap = true

案例

带起始偏移量的行号

如上所述，如果代码换行，布局中的行号将发生变化，因此最好使用table inline.为了让您更轻松，请将lineNumbersInTable = false在你的hugo.toml并添加lineNos = true调用简码而不是特定值时，或者table inline.

{{< highlight lineNos="true" lineNoStart="666" type="py" >}}
# the hardest part is to start writing code; here's a kickstart; just copy and paste this; it's free; the next lines will cost you serious credits
print("Hello")
print(" ")
print("World")
print("!")
{{< /highlight >}}

666# the hardest part is to start writing code; here's a kickstart; just copy and paste this; it's free; the next lines will cost you serious credits
667print("Hello")
668print(" ")
669print("World")
670print("!")

有标题的Codefence

```py { title="python" }
# a bit shorter
print("Hello World!")
```

# a bit shorter
print("Hello World!")

带装饰

{{< highlight type="py" wrap="true" hl_lines="2" >}}
# Quicksort Python One-liner
lambda L: [] if L==[] else qsort([x for x in L[1:] if x< L[0]]) + L[0:1] + qsort([x for x in L[1:] if x>=L[0]])
# Some more stuff
{{< /highlight >}}

# Quicksort Python One-liner
lambda L: [] if L==[] else qsort([x for x in L[1:] if x< L[0]]) + L[0:1] + qsort([x for x in L[1:] if x>=L[0]])
# Some more stuff

无装饰

{{< highlight type="py" wrap="false" hl_lines="2" >}}
# Quicksort Python One-liner
lambda L: [] if L==[] else qsort([x for x in L[1:] if x< L[0]]) + L[0:1] + qsort([x for x in L[1:] if x>=L[0]])
# Some more stuff
{{< /highlight >}}

# Quicksort Python One-liner
lambda L: [] if L==[] else qsort([x for x in L[1:] if x< L[0]]) + L[0:1] + qsort([x for x in L[1:] if x>=L[0]])
# Some more stuff