diff --git a/docs/content/extras/datafiles.md b/docs/content/extras/datafiles.md index ba57f748f..acf7af610 100644 --- 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" ) }} +
Short Description of {{.Site.Data.User0123.Name}}:

{{ $.Scratch.Get "ShortDesc" }}

+{{ end }} +```