add examples to docs site

docs/layouts/partials/docs/inject/toc-after.html

@@ -0,0 +1,29 @@
+{{/* only show a directory listing on example pages */}}
+{{- if and (eq $.Section "examples") (ne $.Page.File.Path "examples/_index.md") -}}
+
+{{/* get base directory */}}
+{{- $dir := $.Page.File.Dir -}}
+
+{{- $loc := path.Join $.Site.Params.BookRepo "blob" "main" "docs" "content" $.Page.File.Dir -}}
+
+{{/* create a list of nix files */}}
+{{- $files := slice -}}
+{{- range readDir (path.Join "content" $dir) -}}
+  {{- if strings.HasSuffix .Name ".nix" -}}
+    {{- $files = $files | append . -}}
+  {{- end -}}
+{{- end -}}
+
+<pre class="listing">
+<a href="{{ $loc }}">{{- index (split $dir "/") 1 }}</a>/
+{{- range $i, $file := $files }}
+{{- if ne (add $i 1) (len $files) }}
+├──
+{{- else  }}
+└──
+{{- end -}}
+&nbsp;<a href="{{ path.Join $loc $file.Name }}" >{{ $file.Name }}</a>
+{{- end -}}
+</pre>
+
+{{- end -}}

docs/layouts/shortcodes/option.html

@@ -0,0 +1,11 @@
+{{- $option := .Get 0 -}}
+{{- $module := index (strings.Split $option ".") 0 -}}
+
+{{/* should we use markdown instead of html? some envs strip raw html */}}
+{{- $md := .Get 1 | default false -}}
+
+{{- if $md -}}
+[{{ $option }}](/modules/{{ $module }}/#{{ $option }})
+{{- else -}}
+<a href="/modules/{{ $module }}/#{{ $option }}">{{ $option }}</a>
+{{- end -}}

docs/layouts/shortcodes/source.html

@@ -0,0 +1,6 @@
+{{- $file := .Get 0 -}}
+<div class="source">
+  <pre class="filename">{{ $file }}</pre>
+  {{- $file := path.Join .Page.File.Dir $file -}}
+  {{- highlight ($file | readFile | safeHTML) (path.Ext $file) -}}
+</div>