BLOGC-MAKE(1)

📦

version 0.20.1^20240602.b1ae9c9 · 3 versions

0.20.1^20240602.b1ae9c9 · fedora 43 (latest)
0.20.1 · nixos 26.05, nixpkgs unstable
0.20.1^20240602.b1ae9c9 · fedora 44

💖 BLOGC-MAKE(1) 💖

okay bestie, welcome to the blogc Manual, and specifically to blogc-make — the little build tool that runs the whole show. sit down, grab a boba, we're doing this 🧋✨

🌸 NAME 🌸

blogc-make — a simple build tool for blogc

✨ SYNOPSIS ✨

blogc-make [-V] [-f FILE] [RULE ...]
blogc-make [-h|-v]

🦋 DESCRIPTION 🦋

so blogc-make is, like, a simple build tool for blogc websites. no cap. it reads a blogcfile(5) and then generates your output files using blogc(1) plus some predefined rules — and those rules are genuinely useful enough for most common use cases. like, they ate. 💅

if you wanna know the tea about the file format, go read blogcfile(5). that's where it all lives.

🎀 OPTIONS 🎀

-D — builds for the development environment. this is the one you want when you're loading local, non-optimized assets for development purposes. it adds two global variables to all blogc(1) calls: MAKE_ENV_DEV=1 and MAKE_ENV=dev. cute, right?
-V — activates verbose mode, which gives you way more details of the commands that run. it's giving "tell me everything" energy 🔍
-f FILE — reads FILE as the blogcfile.
-v — show program name, version, and exit. bye 👋
-h — show help message and exit.

🌈 HELPER RULES 🌈

these are the little guys that keep the whole operation running 🫶

⭐ `all`

Run all build rules. this is the default rule, so if you just run blogc-make with nothing else, this is what you get. main character energy tbh 👑

⭐ `clean`

Clean built files and empty directories in the output directory. it's giving spring cleaning 🧹✨

⭐ `runserver`

Run blogc-runserver(1) (if it's available) pointing at the output directory, watching for changes in the source files and rebuilding as needed. it literally never sleeps. 😭

this rule accepts some arguments, in the following format:

runserver:host=127.0.0.1,port=8080,threads=20

the values in the example are the default values, so no need to type them unless you want different ones. rebuilds are done by running blogc-make all internally.

⭐ `watch`

Watch for changes in the source files, rebuilding as needed. yes bestie, it's watching. always watching. 👀

rebuilds are done by running blogc-make all internally.

⭐ `atom_dump`

Dump the default Atom feed template based on the current blogcfile(5) settings.

the template gets dumped to the standard output, and you can use it as a base for customized Atom feed templates. build your own, make it iconic 🌟

👑 BUILD RULES 👑

these are the actual builders. every single one of them passes helper variables to blogc(1), so let's go one by one 💜