create static docs site with module options

docs/layouts/partials/details.html

@@ -0,0 +1,40 @@
+{{ $name := index . "name" }}
+{{ $option := index . "option" }}
+{{ $repo := index . "repo" }}
+
+{{ $path := path.Join (after 2 (split (index $option.declarations 0) "/")) }}
+
+<details id="{{ $name }}">
+    <summary>
+        <pre>{{ $name }}</pre>
+    </summary>
+
+    <table>
+        <tr>
+            <td>Description</td>
+            <td>{{ $option.description }}</td>
+        </tr>
+
+        <tr>
+            <td>Type</td>
+            <td><pre>{{ $option.type }}</pre></td>
+        </tr>
+
+        <tr>
+            <td>Default</td>
+            <td>{{ partial "highlight" $option.default }}</td>
+        </tr>
+
+        {{ with $option.example }}
+        <tr>
+            <td>Example</td>
+            <td>{{ partial "highlight" . }}</td>
+        </tr>
+        {{ end }}
+
+        <tr>
+            <td>Declared in</td>
+            <td><a href="{{ $repo }}/blob/main/{{ $path }}" target="_blank">{{ $path }}</a></td>
+        </tr>
+    </table>
+</details>

docs/layouts/partials/docs/inject/body.html

@@ -0,0 +1,24 @@
+<script>
+  window.onload = function(){
+    // open details of option in URL fragment
+    document.getElementById(decodeURI(window.location.hash.substring(1)))?.setAttribute("open", "");
+
+    var options = document.getElementsByTagName('details');
+    for(var i = 0; i < options.length; i++) {
+        options[i].getElementsByTagName("summary")[0].onclick = function() {
+
+            // set URL fragment to option id
+            window.location.hash = this.parentElement.id;
+
+            // is current panel open, return immediately as it's just being closed
+            if (this.parentElement.hasAttribute("open")) return;
+
+            // collapse all other options
+            for(var j = 0; j < options.length; j++) {
+                options[j].removeAttribute("open");
+            }
+        };
+    }
+
+  }; 
+</script>

docs/layouts/partials/docs/inject/head.html

@@ -0,0 +1 @@
+<link rel="icon" href="/logo.svg">

docs/layouts/partials/highlight.html

@@ -0,0 +1,10 @@
+{{ $text := . }}
+
+{{/* if text is a multiline string add nix's double single-quotes */}}
+{{ if in $text "\n" }}
+  {{ $text = print "''\n  " (strings.TrimSuffix "  " (replace $text "\n" "\n  ") ) "''" }}
+{{ else }}
+  {{ $text = jsonify $text }}
+{{ end }}
+
+<pre class="highlight"><code>{{ $text }}</code></pre>