mirror of
https://github.com/gohugoio/hugo.git
synced 2024-11-14 20:37:55 -05:00
5fd1e74903
``` git subtree add --prefix=docs/ https://github.com/gohugoio/hugoDocs.git master --squash ``` Closes #11925
38 lines
1.2 KiB
Markdown
38 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
|