Makko is the markdown-based, people-oriented static site generator, that allows you to setup your quirky dream blog in a matter of minutes: No complicated theming systems, no coding, little to no setup, simple to learn and understand. All of that under a specially tiny package, a portable binary you can run on pretty much anything.

Installing#

1. Download a release off our releases page
2. Extract it somewhere in your $PATH (or somewhere you like)
3. Run it! it's a cli tool so you will need a terminal (cmd, powershell, iTerm, etc.) _{though probably not for too long}

Documentation#

The documentation is still a work in progress, but you can find it here.

We believe that makko is already pretty simple to understand just by understanding basic concepts such as templating and markdown, and by looking into the example that comes bundled with makko, but if you are having any trouble understanding how to use makko, please contact us about it.

Building#

# You will need the zig compiler, 0.14.1
# 
# We also recommend just getting Anyzig installed 
# and let it handle versions for you!
# (https://github.com/marler8997/anyzig)

git clone https://forge.starlightnet.work/Team/Makko
cd Makko

# Run in debug mode
zig build run -- ...arguments

# Or build in debug mode
zig build

# ... ooor build in release mode
zig build -Doptimize=ReleaseSmall

# You can also cross compile
zig build -Doptimize=ReleaseSmall -Dtarget=x86_64-windows-gnu

# The result binary will be stored in zig-out/bin/ if everything went right. :)