blog/README.md
Yax 3b7484fbe6 Replace JSON config with .env files
- Add python-dotenv dependency for environment variable loading
- Replace params.json and params-local.json with .env files
- Add --local and --local-stacosys flags to makesite.py
- Update Makefile to auto-detect stacosys availability
- Document configuration and usage in README.md
2026-01-10 16:03:53 +01:00

1.4 KiB
Executable file

Blog du Yax

This blog is built on top of the great work performed by fspaolo on Makesite.py. I cut some features and wristed the code to focus on blog posts and support my commenting system. You should check fspaolo's repository to really understand Makesite.py's philosophy and find technical details.

This static blog generator code is under MIT license.

"Blog du Yax" content is under CC-BY-NC-SA

Configuration

Configuration is managed through .env files:

File Description
.env Production configuration
.env.local Local development (no Stacosys)
.env.local-stacosys Local development with local Stacosys

Environment variables:

  • TITLE - Site title
  • SUBTITLE - Site subtitle
  • AUTHOR - Author name
  • SITE_URL - Base URL for the site
  • STACOSYS_URL - Stacosys API endpoint (optional)
  • EXTERNAL_CHECK - Script for git change detection

Usage

# Production build (uses .env)
uv run python makesite.py

# Local development without Stacosys (uses .env.local)
uv run python makesite.py --local

# Local development with local Stacosys (uses .env.local-stacosys)
uv run python makesite.py --local-stacosys

# Or use make for local development
make site