biscuit #

biscuit is a simple, opinionated static site generator written in go.

it uses a very simple templating system with html and markdown; no need to learn some complex templating language.

installation #

add to a nix devshell (recommended) #

you don't need biscuit installed systemwide; just add it to a devshell:

{
  inputs = {
    # ...
    biscuit = {
      url = "https://tangled.org/indium114/biscuit";
      inputs.nixpkgs.follows = "nixpkgs";
    };
  };

  outputs = inputs: {
    # ...
    devShells.x86_64-linux.default = pkgs.mkShell {
      packages = [
        # ...
        inputs.biscuit.${pkgs.stdenv.hostPlatform.system}.biscuit
      ];
    }
  };
}

building a website #

refer to the docs to learn how to create your biscuit site.
if you prefer to learn by example, see the example/ directory in this repo for a basic site template.

then, run the following command to build your site:

biscuit

yes, it is that simple.

there is also a command that lets you run a test server on http://127.0.0.1:8156.

biscuit serve