hugo/docs/content/en/functions/templates.Exists.md
2023-05-22 16:47:07 +02:00

26 lines
874 B
Markdown

---
title: templates.Exists
description: "Checks whether a template file exists under the given path relative to the `layouts` directory."
categories: [functions]
tags: []
menu:
docs:
parent: functions
ns: ""
keywords: ["templates", "template", "layouts"]
signature: ["templates.Exists PATH"]
relatedfuncs: []
---
A template file is any file living below the `layouts` directories of either the project or any of its theme components including partials and shortcodes.
The function is particularly handy with dynamic path. The following example ensures the build will not break on a `.Type` missing its dedicated `header` partial.
```go-html-template
{{ $partialPath := printf "headers/%s.html" .Type }}
{{ if templates.Exists ( printf "partials/%s" $partialPath ) }}
{{ partial $partialPath . }}
{{ else }}
{{ partial "headers/default.html" . }}
{{ end }}
```