alnah.io

Technical blog about building reliable tools, and systems in Go.

Languages

Content is available in three languages:

• English (/en/)
• Français (/fr/)
• Português Brasil (/pt-br/)

Local Development

# Clone with submodules (theme)
git clone --recurse-submodules https://github.com/alnah/alnah.github.io.git
cd alnah.github.io/blog

# Run local server
hugo server

# Run with future-dated posts
hugo server --buildFuture

Requires Hugo Extended v0.140+.

Structure

alnah.github.io/
├── .github/workflows/    # GitHub Actions deployment
├── blog/
│   ├── content/
│   │   ├── en/           # English content
│   │   ├── fr/           # French content
│   │   └── pt-br/        # Portuguese content
│   ├── assets/           # SCSS, images
│   ├── layouts/          # Template overrides
│   └── hugo.yaml         # Site configuration
└── docs/                 # Additional documentation

Deployment

Automatic deployment to GitHub Pages on push to main. The workflow:

1. Builds the Hugo site with --gc --minify
2. Deploys to alnah.io

Theme

Uses Hugo Stack as a git submodule.

# Update theme
git submodule update --remote themes/stack

License

Content is licensed under CC BY-SA 4.0.