mirror of
https://github.com/gohugoio/hugo.git
synced 2024-12-18 18:16:57 -05:00
39 lines
1.2 KiB
Markdown
39 lines
1.2 KiB
Markdown
|
---
|
||
|
|
title: transform.HighlightCodeBlock
|
||
|
|
description: Highlights code received in context within a code block render hook.
|
||
|
|
categories: []
|
||
|
|
keywords: []
|
||
|
|
action:
|
||
|
|
aliases: []
|
||
|
|
related:
|
||
|
|
- functions/transform/CanHighlight
|
||
|
|
- functions/transform/Highlight
|
||
|
|
returnType: highlight.HighlightResult
|
||
|
|
signatures: ['transform.HighlightCodeBlock CONTEXT [OPTIONS]']
|
||
|
|
---
|
||
|
|
|
||
|
|
This function is only useful within a code block render hook.
|
||
|
|
|
||
|
|
Given the context passed into a code block render hook, `transform.HighlightCodeBlock` returns a `HighlightResult` object with two methods.
|
||
|
|
|
||
|
|
.Wrapped
|
||
|
|
: (`template.HTML`) Returns highlighted code wrapped in `<div>`, `<pre>`, and `<code>` elements. This is identical to the value returned by the transform.Highlight function.
|
||
|
|
|
||
|
|
.Inner
|
||
|
|
: (`template.HTML`) Returns highlighted code without any wrapping elements, allowing you to create your own wrapper.
|
||
|
|
|
||
|
|
```go-html-template
|
||
|
|
{{ $result := transform.HighlightCodeBlock . }}
|
||
|
|
{{ $result.Wrapped }}
|
||
|
|
```
|
||
|
|
|
||
|
|
To override the default [highlighting options]:
|
||
|
|
|
||
|
|
```go-html-template
|
||
|
|
{{ $opts := merge .Options (dict "linenos" true) }}
|
||
|
|
{{ $result := transform.HighlightCodeBlock . $opts }}
|
||
|
|
{{ $result.Wrapped }}
|
||
|
|
```
|
||
|
|
|
||
|
|
[highlighting options]: /functions/transform/highlight/#options
|