Personal site and blog — Issa Sanogo.
Live: ngsanogo.github.io Stack: Hugo + Docker
- Site engine: Hugo
- Automation: Makefile + Docker Compose profiles (
dev,build,test,lint) - Quality gate: pre-commit (YAML/Markdown/JSON checks, Prettier)
- CI/Deploy: GitHub Actions (
CI,Deploy Pages)
- Docker Desktop (includes Docker Compose)
No local Python, Node.js, Hugo, or other tools required on macOS.
git clone https://github.com/ngsanogo/ngsanogo.github.io.git
cd ngsanogo.github.io
make setup # builds Docker images & configures git hooks
make dev # starts dev server at http://localhost:1313| Task | Command |
|---|---|
| Build Docker images | make setup |
| Configure git hooks only | make hooks |
| Dev server (hot reload) | make dev |
| Build site | make build |
| Run tests | make test |
| Validate post metadata | make test-content |
| Validate links | make test-links |
| Scan secrets | make test-secrets |
| Run local full checks | make ci |
| Stop containers | make stop |
| Clean output | make clean |
| Lint and format | make lint |
| Create a new blog post | make new-post TITLE="..." |
Pull requests to main run CI checks.
Push to main runs CI and then triggers GitHub Pages deployment.
MIT License. See LICENSE.