# Blog du Yax 

This blog is built on top of the great work performed by fspaolo on [Makesite.py](https://github.com/fspaolo/makesite). 
I cut some features and wristed the code to focus on blog posts and support my [commenting system](https://gitea.zaclys.com/yannic/stacosys). 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](https://creativecommons.org/licenses/by-nc-sa/3.0)

## 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

```bash
# 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
```