feat: add demo site.

Author: PttCodingMan

.github/workflows/demo.yml

@@ -0,0 +1,55 @@
+name: Demo site
+
+on:
+  push:
+    branches: [main]
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: pages
+  cancel-in-progress: false
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          enable-cache: true
+
+      - name: Set up Python
+        run: uv python install 3.12
+
+      - name: Install backend dependencies
+        run: |
+          cd backend
+          uv venv
+          uv pip install -r requirements.txt
+
+      - name: Build demo site
+        run: |
+          cd backend
+          source .venv/bin/activate
+          PYTHONPATH=. python scripts/build_demo_site.py ../public
+
+      - uses: actions/upload-pages-artifact@v3
+        with:
+          path: ./public
+
+  deploy:
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    steps:
+      - id: deployment
+        uses: actions/deploy-pages@v4

backend/app/routers/export.py

@@ -270,6 +270,37 @@ async def export_page(
     })
 
 
+def build_site_files(pages):
+    """Render pages into ``[(filename, html), ...]`` for a static export.
+
+    Shared by the HTTP zip endpoint and the CLI demo-site builder so both
+    paths produce byte-identical output.
+    """
+    files = []
+    page_links = []
+    for p in pages:
+        page = dict(p)
+        html_content = _inline_media_srcs(md_to_simple_html(page["content_md"]))
+        safe_title = _html.escape(page["title"])
+        safe_slug = _html.escape(page["slug"])
+        full_html = HTML_TEMPLATE.format(
+            title=safe_title,
+            slug=safe_slug,
+            content=html_content,
+        )
+        files.append((f"{page['slug']}.html", full_html))
+        # Both href and link text need escaping — slug may contain chars
+        # that break the attribute, title may contain HTML.
+        page_links.append(
+            f'<li><a href="{urllib.parse.quote(page["slug"], safe="")}.html">'
+            f'{safe_title}</a></li>'
+        )
+
+    index_html = SITE_INDEX_TEMPLATE.format(page_list="\n".join(page_links))
+    files.append(("index.html", index_html))
+    return files
+
+
 @router.get("/site")
 async def export_site(
     format: str = Query("html"),
@@ -287,29 +318,8 @@ async def export_site(
 
     buf = io.BytesIO()
     with zipfile.ZipFile(buf, "w", zipfile.ZIP_DEFLATED) as zf:
-        # Generate page files
-        page_links = []
-        for p in pages:
-            page = dict(p)
-            html_content = _inline_media_srcs(md_to_simple_html(page["content_md"]))
-            safe_title = _html.escape(page["title"])
-            safe_slug = _html.escape(page["slug"])
-            full_html = HTML_TEMPLATE.format(
-                title=safe_title,
-                slug=safe_slug,
-                content=html_content,
-            )
-            zf.writestr(f"{page['slug']}.html", full_html)
-            # Both href and link text need escaping — slug may contain chars
-            # that break the attribute, title may contain HTML.
-            page_links.append(
-                f'<li><a href="{urllib.parse.quote(page["slug"], safe="")}.html">'
-                f'{safe_title}</a></li>'
-            )
-
-        # Generate index
-        index_html = SITE_INDEX_TEMPLATE.format(page_list="\n".join(page_links))
-        zf.writestr("index.html", index_html)
+        for filename, content in build_site_files(pages):
+            zf.writestr(filename, content)
 
     buf.seek(0)
     return StreamingResponse(

backend/scripts/build_demo_site.py

@@ -0,0 +1,51 @@
+"""Render the seeded welcome content into a static HTML site.
+
+Run from ``backend/`` with ``PYTHONPATH=.`` so ``app`` is importable:
+
+    PYTHONPATH=. python scripts/build_demo_site.py ../public
+
+The script points JustWiki at a throwaway data directory, runs the same
+init + seed path the server uses on first boot, then writes every page
+through ``app.routers.export.build_site_files``.
+"""
+import asyncio
+import os
+import sys
+import tempfile
+from pathlib import Path
+
+
+def main():
+    out_dir = Path(sys.argv[1] if len(sys.argv) > 1 else "./public").resolve()
+
+    tmp = Path(tempfile.mkdtemp(prefix="justwiki-demo-"))
+    os.environ["DATA_DIR"] = str(tmp)
+    os.environ["DB_PATH"] = str(tmp / "just-wiki.db")
+    os.environ["MEDIA_DIR"] = str(tmp / "media")
+
+    # Imports must happen after env vars are set so pydantic-settings reads
+    # the throwaway paths instead of the repo's .env / defaults.
+    from app.auth import ensure_admin_exists
+    from app.database import close_db, get_db, init_db, seed_welcome_page
+    from app.routers.export import build_site_files
+
+    async def run():
+        await init_db()
+        await ensure_admin_exists()
+        db = await get_db()
+        await seed_welcome_page(db)
+        pages = await db.execute_fetchall(
+            "SELECT id, slug, title, content_md FROM pages "
+            "WHERE deleted_at IS NULL ORDER BY title"
+        )
+        out_dir.mkdir(parents=True, exist_ok=True)
+        for filename, content in build_site_files(pages):
+            (out_dir / filename).write_text(content, encoding="utf-8")
+        await close_db()
+
+    asyncio.run(run())
+    print(f"Wrote demo site to {out_dir}")
+
+
+if __name__ == "__main__":
+    main()