docs: use Zola for static docs

https://www.getzola.org/

For local development use: `just docs`

.github/workflows/ci.yml

@@ -139,6 +139,15 @@ jobs:
         run: just init-db
       - name: Rebuild All
         run: just build-all
+  docs:
+    name: Build Docs
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          submodules: true
+      - uses: cashapp/activate-hermit@v1
+      - run: cd docs && zola build
   integration-shard:
     name: Shard Integration Tests
     runs-on: ubuntu-latest

.github/workflows/docs.yml

@@ -0,0 +1,22 @@
+on:
+  push:
+    branches:
+      - main
+name: Publish Docs
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    if: github.ref == 'refs/heads/main'
+    steps:
+      - name: checkout
+        uses: actions/checkout@v4
+        with:
+          submodules: true
+      - name: build_and_deploy
+        uses: shalzz/[email protected]
+        env:
+          # Target branch
+          PAGES_BRANCH: gh-pages
+          # Or if publishing to the same repo, use the automatic token
+          TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          BUILD_DIR: docs

.gitignore

@@ -25,3 +25,4 @@ go.work*
 junit*.xml
 /readme-tests
 **/_ftl
+/docs/public

.gitmodules

@@ -0,0 +1,3 @@
+[submodule "docs/themes/adidoks"]
+	path = docs/themes/adidoks
+	url = https://github.com/aaranxu/adidoks.git

Justfile

@@ -135,3 +135,8 @@ lint-frontend: build-frontend
 # Lint the backend
 lint-backend:
   @golangci-lint run ./...
+
+# Run live docs server
+docs:
+  git submodule update --init --recursive
+  cd docs && zola serve

bin/.zola-0.18.0.pkg

@@ -0,0 +1 @@
+hermit

bin/zola

@@ -0,0 +1 @@
+.zola-0.18.0.pkg