folderblog 0.2.0

Photo gallery

Turn it on with folderblog gallery on, then drop pictures into the blog's gallery/ folder.

• Folders inside gallery/ become albums; an optional index.md gives an album its title, date, tags and cover
• Tag and caption a photo with a Markdown file beside it (sunset.md next to sunset.jpg); every tag gets its own page
• Photo pages with captions, camera settings and previous/next links; a full-screen viewer with arrow keys and swipe
• Only resized copies are published, never your originals, so the GPS location stored in phone photos stays private. Resizing is cached, so rebuilds stay fast
• The gallery uses your theme's own layout, fonts and colours; theme/_gallery/ is yours to restyle, and AGENTS.md documents every field
• JPEG, PNG, WebP and GIF. HEIC and RAW files are skipped with a warning

A guide for everyone

• A new step-by-step guide explains every feature and every command in plain words: docs/GUIDE.md
• Built in: folderblog guide shows it in the terminal, and man folderblog shows it as a manual page (the packages install it)
• --help now describes every option

Upgrading from 0.1.0

Install the new package below. Existing blogs keep working unchanged; run folderblog gallery on in a blog to add a gallery, and folderblog agents-md --write to refresh its AGENTS.md.

Install (x86_64 Linux)

System	Command
Arch / Omarchy	sudo pacman -U folderblog-bin-0.2.0-1-x86_64.pkg.tar.zst
Debian / Ubuntu	sudo apt install ./folderblog_0.2.0-1_amd64.deb
Fedora / RHEL / openSUSE	sudo dnf install ./folderblog-0.2.0-1.x86_64.rpm
Anything else	unpack folderblog-0.2.0-x86_64-linux.tar.gz and put folderblog on your PATH

Verify downloads with sha256sum -c SHA256SUMS.