Style updates, doc updates

README.md

@@ -14,18 +14,46 @@ Therefore, `la sampu cu sampu lo ka samtci`!
 
 - [Haskell](https://www.haskell.org)
 - [Twain](https://github.com/alexmingoia/twain)
-- [Lucid2](https://chrisdone.com/posts/lucid2)
+- [Lucid](https://github.com/chrisdone/lucid)
+- [Clay](https://github.com/sebastiaanvisser/clay)
 
 ## Goal
 
 Provide a simple blog engine that is easily customizable via HTML fragments.
 
-## Deployment
+## Build and Deployment
 
-We're not there yet! This project is built and packaged with Nix,
-so I will provide directions on deploying with Nix as well as via OCI 
-containers once there's something viable to run.
+Only Nix build instructions are provided below.
 
+### No Containers
+1) Clone this repository
+2) Build the application (with flakes enabled): `nix build '.#'`
+3) Set the environment variables
+    - File: `cp data/.env.example ./.env; $EDITOR ./.env`
+    - If you want to set them in a different way, you already know how.
+4) Run the application: `./result/bin/sampu`
+
+### Containers
+
+1) Clone this repository
+2) Build the container image (with flakes enabled): `nix build .#sampu-container`
+3) Load the container image: `podman load -i result`
+4) Run the container using your favorite orchestrator or...
+5) Use a NixOS configuration:
+```
+virtualisation.oci-containers.containers.sampu = {
+  image = "sampu";
+  ports = [ "${SAMPUR_EXTERNAL_PORT}:3000" ];
+  volumes = [
+    "/PATH/TO/SAMPU/data:/app/data"
+  ];
+  environment = {
+    SAMPU_PORT = "3000";
+    SAMPU_TITLE = "Your Blog Title Here!";
+    SAMPU_BASEURL = "http://example.public.tld"; 
+  };
+};
+```
 ## Development and Support
 
 Per the permissive ISC license, you are free to do what you wish with this