summaryrefslogtreecommitdiffhomepage
path: root/docs
diff options
context:
space:
mode:
authordigitalcraftsman <[email protected]>2017-09-28 19:52:34 +0200
committerBjørn Erik Pedersen <[email protected]>2017-09-28 19:52:34 +0200
commit2818878994e906c292cbe00cb2a83f1531a21f32 (patch)
treec4d86e358b82736ff1fb1243d5fe8ef9d5baba82 /docs
parentb6a30283f099ce9578d491ba8fbbf45f673dbf3b (diff)
downloadhugo-2818878994e906c292cbe00cb2a83f1531a21f32.tar.gz
hugo-2818878994e906c292cbe00cb2a83f1531a21f32.zip
tpl: Add os.fileExists template function
Fixes #3839
Diffstat (limited to 'docs')
-rw-r--r--docs/content/functions/fileExists.md29
1 files changed, 29 insertions, 0 deletions
diff --git a/docs/content/functions/fileExists.md b/docs/content/functions/fileExists.md
new file mode 100644
index 000000000..3d535aaca
--- /dev/null
+++ b/docs/content/functions/fileExists.md
@@ -0,0 +1,29 @@
+---
+title: "fileExists"
+linktitle: "fileExists"
+date: 2017-08-31T22:38:22+02:00
+description: Checks whether a file exists under the given path.
+godocref:
+publishdate: 2017-08-31T22:38:22+02:00
+lastmod: 2017-08-31T22:38:22+02:00
+categories: [functions]
+menu:
+ docs:
+ parent: "functions"
+signature: ["fileExists PATH"]
+workson: []
+hugoversion:
+relatedfuncs: []
+deprecated: false
+aliases: []
+---
+
+`fileExists` allows you to check if a file exists under a given path, e.g. before inserting code into a template:
+
+```
+{{ if (fileExists "static/img/banner.jpg") -}}
+<img src="{{ "img/banner.jpg" | absURL }}" />
+{{- end }}
+```
+
+In the example above, a banner from the `static` folder should be shown if the given path points to an existing file. \ No newline at end of file