No description
  • Zig 76.7%
  • HTML 13.7%
  • Nix 6.1%
  • CSS 2%
  • Shell 1.5%
Find a file
2026-04-25 23:58:42 +03:00
.forgejo merge tangled PR 2026-02-21 15:29:08 +01:00
branding Uodated README and other thingies. 2025-07-21 08:49:06 -04:00
doc adjust "custom" section of docs 2026-04-08 13:56:56 +02:00
src fix: id bug 2026-04-25 23:58:42 +03:00
.gitignore nix: update to 2.1.3-prerelease and add deprecation warning 2026-03-09 14:13:50 +01:00
AGENTS.md add AGENTS.md and CLAUDE.md. 2025-12-09 22:34:59 +01:00
build.zig Get rid of 'mime' dependency, I do not even remember why it is there. 2026-01-07 23:18:45 -03:00
build.zig.zon lock xcode_frameworks to commit 2026-04-10 08:32:16 +02:00
CLAUDE.md add AGENTS.md and CLAUDE.md. 2025-12-09 22:34:59 +01:00
CONTRIBUTING.md add CONTRIBUTING.md 2026-02-28 01:47:36 +01:00
default.nix nix: update to 2.1.3-prerelease and add deprecation warning 2026-03-09 14:13:50 +01:00
deps.nix Fixing deps so that it builds and the deps works in the nix-flake repo 2026-04-08 21:46:49 +01:00
flake.lock nix: update to 25.11 2025-12-01 10:36:17 +01:00
flake.nix try to fix build errors 2025-12-01 12:39:29 +01:00
LICENSE Bump up year. 2026-01-07 17:28:38 -03:00
Makefile Add Makefile for ease of build 2026-01-20 12:59:47 -03:00
README.md Add some more extra info about fetching zig versions 2026-01-20 13:04:21 -03:00

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. :)