Merge commit '35dec7c96f7ee3eb17dd444f7067f0c776fb56ae'

This commit is contained in:
Bjørn Erik Pedersen
2023-12-04 15:24:01 +01:00
810 changed files with 24147 additions and 7766 deletions

View File

@@ -1,16 +1,13 @@
---
title: debug.Dump
description: Returns an object dump as a string.
categories: [functions]
categories: []
keywords: []
menu:
docs:
parent: functions
function:
action:
aliases: []
related: []
returnType: string
signatures: [debug.Dump VALUE]
relatedFunctions: []
---
```go-html-template
@@ -43,8 +40,6 @@ relatedFunctions: []
}
```
{{% note %}}
Output from this function may change from one release to the next. Use for debugging only.
{{% /note %}}

View File

@@ -0,0 +1,37 @@
---
title: debug.Timer
description: Creates a named timer that reports elapsed time to the console.
categories: []
keywords: []
action:
aliases: []
related: []
returnType: debug.Timer
signatures: [debug.Timer NAME]
---
{{< new-in 0.120.0 >}}
Use the `debug.Timer` function to determine execution time for a block of code, useful for finding performance bottle necks in templates.
The timer starts when you instantiate it, and stops when you call its `Stop` method.
```go-html-template
{{ $t := debug.Timer "TestSqrt" }}
{{ range seq 2000 }}
{{ $f := math.Sqrt . }}
{{ end }}
{{ $t.Stop }}
```
Use the `--logLevel info` command line flag when you build the site.
```sh
hugo --logLevel info
```
The results are displayed in the console at the end of the build. You can have as many timers as you want and if you don't stop them, they will be stopped at the end of build.
```text
INFO timer: name TestSqrt total 12.429355ms
```

View File

@@ -0,0 +1,12 @@
---
title: Debug functions
linkTitle: debug
description: Template functions to debug your templates.
categories: []
keywords: []
menu:
docs:
parent: functions
---
Use these functions to debug your templates.