mirror of
https://github.com/gohugoio/hugo.git
synced 2024-11-14 20:37:55 -05:00
30 lines
844 B
Markdown
30 lines
844 B
Markdown
|
---
|
||
|
title: Name
|
||
|
description: Returns the shortcode file name, excluding the file extension.
|
||
|
categories: []
|
||
|
keywords: []
|
||
|
action:
|
||
|
related:
|
||
|
- methods/shortcode/Position
|
||
|
- functions/fmt/Errorf
|
||
|
returnType: string
|
||
|
signatures: [SHORTCODE.Name]
|
||
|
---
|
||
|
|
||
|
The `Name` method is useful for error reporting. For example, if your shortcode requires a "greeting" parameter:
|
||
|
|
||
|
{{< code file=layouts/shortcodes/myshortcode.html >}}
|
||
|
{{ $greeting := "" }}
|
||
|
{{ with .Get "greeting" }}
|
||
|
{{ $greeting = . }}
|
||
|
{{ else }}
|
||
|
{{ errorf "The %q shortcode requires a 'greeting' parameter. See %s" .Name .Position }}
|
||
|
{{ end }}
|
||
|
{{< /code >}}
|
||
|
|
||
|
In the absence of a "greeting" parameter, Hugo will throw an error message and fail the build:
|
||
|
|
||
|
```text
|
||
|
ERROR The "myshortcode" shortcode requires a 'greeting' parameter. See "/home/user/project/content/about.md:11:1"
|
||
|
```
|