fix: render config

Author: jmattheis

config.data.ts

@@ -0,0 +1,34 @@
+import {createMarkdownRenderer} from 'vitepress';
+
+const SOURCE = 'https://raw.githubusercontent.com/gotify/server/master/gotify-server.env.example';
+
+const uncomment = (line: string): string => line.replace(/^#( ?)/, '');
+const codeBlock = (text: string) => '```\n' + text.trimEnd() + '\n```';
+
+const renderSetting = (block: string[]): string => {
+  const assignment = block.find((l) => /^[A-Z][A-Z0-9_]*=/.test(uncomment(l)));
+  if (!assignment) throw Error('could not find assignment ' + block);
+
+  const name = uncomment(assignment).split('=')[0];
+  return ['### ' + name, codeBlock(block.join('\n'))].join('\n\n');
+};
+
+export default {
+  async load() {
+    const res = await fetch(SOURCE);
+    if (!res.ok) throw Error('could not fetch gotify-server.env.example');
+
+    const [header, ...blocks] = (await res.text())
+      .trimEnd()
+      .split(/\n *\n/)
+      .map((b) => b.split('\n'))
+      .filter((b) => b.some((l) => l.trim()));
+
+    const markdown = [
+      codeBlock(header.map(uncomment).join('\n')),
+      ...blocks.map(renderSetting),
+    ].join('\n\n');
+
+    return (await createMarkdownRenderer('.')).render(markdown);
+  },
+};

docs/config.md

@@ -1,5 +1,20 @@
 # Configuration
 
+<script setup>
+import {data as envExample} from '../config.data.ts'
+</script>
+
+::: details 3.x Config
+
+Gotify 3.x is configured through environment variables, which can be loaded from
+an env file. [`gotify-server.env.example`](https://raw.githubusercontent.com/gotify/server/refs/heads/master/gotify-server.env.example)
+
+<div v-html="envExample"></div>
+
+:::
+
+::: details 2.x Config
+
 gotify/server can be configured per config file and environment variables.
 When using docker it is recommended to use environment variables.
 
@@ -158,3 +173,5 @@ GOTIFY_OIDC_REDIRECTURL=http://gotify.example.org/auth/oidc/callback
 GOTIFY_OIDC_AUTOREGISTER=true
 GOTIFY_OIDC_USERNAMECLAIM=preferred_username
 ```
+
+:::