shithub: hugo

--- a/docs/content/en/templates/shortcode-templates.md

+++ b/docs/content/en/templates/shortcode-templates.md

@@ -346,6 +346,24 @@

 <img src="/images/three.jpg">

```

+## Error Handling in Shortcodes

+Use the [errorf](/functions/errorf) template func and [.Position](/variables/shortcodes/) variable to get useful error messages in shortcodes:

+```bash

+{{ with .Get "name" }}

+{{ else }}

+{{ errorf "missing value for param 'name': %s" .Position }}

+{{ end }}

+```

+When the above fails, you will see an `ERROR` log similar to the below:

+```bash

+ERROR 2018/11/07 10:05:55 missing value for param name: "/Users/bep/dev/go/gohugoio/hugo/docs/content/en/variables/shortcodes.md:32:1"

+```

 ## More Shortcode Examples

 More shortcode examples can be found in the [shortcodes directory for spf13.com][spfscs] and the [shortcodes directory for the Hugo docs][docsshortcodes].

--- a/docs/content/en/variables/shortcodes.md

+++ b/docs/content/en/variables/shortcodes.md

@@ -26,6 +26,12 @@

 .Parent

 : provides access to the parent shortcode context in nested shortcodes. This can be very useful for inheritance of common shortcode parameters from the root.

+.Position

+: Contains [filename and position](https://godoc.org/github.com/gohugoio/hugo/common/text#Position) for the shortcode in a page. Note that this can be relatively expensive to calculate, and is meant for error reporting. See [Error Handling in Shortcodes](/templates/shortcode-templates/#error-handling-in-shortcodes).

 .IsNamedParams

 : boolean that returns `true` when the shortcode in question uses [named rather than positional parameters][shortcodes]