Skip to content

Add MkDocs static site generation with nginx#805

Merged
undera merged 6 commits intomasterfrom
mkdocs-static-site
Mar 31, 2026
Merged

Add MkDocs static site generation with nginx#805
undera merged 6 commits intomasterfrom
mkdocs-static-site

Conversation

@undera
Copy link
Copy Markdown
Owner

@undera undera commented Mar 31, 2026

Summary

  • MkDocs with Material theme replaces PWE PHP rendering
  • Dockerfile.static: multi-stage build producing a ~30MB nginx:alpine image
  • nginx.conf serves static files, /repo/ proxy placeholder for later
  • build.sh runs mkdocs + copies static assets (stats, repo JSON)
  • All 114 baseline URLs verified returning 200

What this does NOT change

  • /repo/ dynamic endpoint — stays on existing PHP for now
  • No changes to markdown content or repo JSON files

Test plan

  • docker build -f Dockerfile.static -t jpgc-static . from site/
  • docker run -p 8082:80 jpgc-static and browse http://localhost:8082
  • Verify wiki pages, catalogue, stats, install page render correctly

🤖 Generated with Claude Code

undera and others added 6 commits March 31, 2026 12:09
Replace PWE PHP rendering with MkDocs + nginx:alpine.
- mkdocs.yml with material theme and full nav structure
- nginx.conf serving static files, with /repo/ proxy placeholder
- Dockerfile.static: multi-stage build (python→nginx:alpine)
- build.sh copies static assets (stats JSON, repo JSON, robots.txt)
All 114 baseline URLs verified.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Stats data lives on prod only, generated by log analysis.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@undera undera marked this pull request as ready for review March 31, 2026 13:39
@undera undera merged commit 22c4903 into master Mar 31, 2026
2 checks passed
@undera undera deleted the mkdocs-static-site branch March 31, 2026 13:41
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant