Update datafiles.md

additional example for named data values

diff --git a/docs/content/extras/datafiles.md b/docs/content/extras/datafiles.md
index ba57f748fb59e5449f86a52378710c054bc8a5c3..acf7af6106242260d6c3e3133f1dad31aed0b766 100644 (file)
--- a/docs/content/extras/datafiles.md
+++ b/docs/content/extras/datafiles.md
@@ -81,3 +81,24 @@ And then in `partial/artist.html`:
 ```
 
 Discover a new favourite bass player? Just add another TOML-file.
+
+## Example: Accessing named values in a Data File
+
+Assuming you have the following YAML structure to your `User0123.yml` Data File located directly in `data/`
+
+```
+Name: User0123
+"Short Description": "He is a jolly good fellow."
+Achievements:
+  - "Can create a Key, Value list from Data File"
+  - "Learns Hugo"
+  - "Reads documentation"
+```
+
+To render the `Short Description` in your `layout` File following code is required.
+
+```
+{{ $.Scratch.Set "ShortDesc" ( index $.Site.Data.User0123 "Short Description" ) }}
+<div>Short Description of {{.Site.Data.User0123.Name}}: <p>{{ $.Scratch.Get "ShortDesc" }}</p></div>
+{{ end }}
+```