docs: redesign documentation site

.github/workflows/docs.yml

@@ -13,23 +13,18 @@ concurrency:
 permissions:
   contents: read
 
-env:
-  NO_MKDOCS_2_WARNING: "1"
-
 jobs:
   build:
     name: Build docs
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v7
       - uses: astral-sh/setup-uv@v9.0.0
-        with:
-          enable-cache: true
       - uses: actions/setup-python@v7
         with:
           python-version: "3.14"
-      - name: Build MkDocs site
-        run: uv run --group docs mkdocs build --strict
+      - name: Build documentation site
+        run: uv run --frozen --group docs zensical build --strict --clean
       - name: Upload Pages artifact
         if: github.event_name == 'push' && github.ref == 'refs/heads/master'
         uses: actions/upload-pages-artifact@v5

Makefile

@@ -33,7 +33,7 @@ lint:
 	uv run mypy py_clickhouse_migrator/
 
 docs:
-	NO_MKDOCS_2_WARNING=1 uv run --group docs mkdocs build --strict
+	uv run --frozen --group docs zensical build --strict --clean
 
 docs-serve:
-	NO_MKDOCS_2_WARNING=1 uv run --group docs mkdocs serve
+	uv run --frozen --group docs zensical serve