shithub: hugo

Info  •  Files  •  Log  •  Branches

Update datafiles.md

additional example for named data values

--- a/docs/content/extras/datafiles.md

+++ b/docs/content/extras/datafiles.md

@@ -81,3 +81,24 @@

 ```

 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 }}

+```