Update README.md

These changes:

- Update base container image from Bookworm to Trixie Debian
- Update Pandoc version
- Add a `make shell` command

Caveats:

- Uses the "bookworm" version of OpenResty until "trixie" is released

Reviewed-on: #4

Dockerfile

@@ -9,7 +9,7 @@ ARG RESTY_DEB_VERSION="=1.27.1.2-1~bookworm1"
 ARG RESTY_LUAROCKS_VERSION="3.12.2"
 
 RUN apt-get update && apt-get install -y \
-        python3-pygments lua-inotify wget curl tar make && \
+        python3-pygments lua-inotify wget && \
         wget -q -O $pkgname $pkgurl && dpkg -i $pkgname && rm $pkgname
 
 RUN wget -qO - https://openresty.org/package/pubkey.gpg | gpg --dearmor > /etc/apt/trusted.gpg.d/openresty-keyring.gpg \

README.md

@@ -1,23 +1,26 @@
 ## requirements
 
-`pandoc` utility must be installed
+* Docker
 
-- Debian Bookworm:
+## up and running
 
-      $ apt-get update && apt-get install -y pandoc
-
-## start default openresty
-
-1. Run `docker run --rm -it --init -w /opt -v $PWD:/opt -p 80:80 openresty/openresty:1.27.1.2-0-bookworm-buildpack`
-2. Visit `localhost` in web browser.
-
-## start a custom site
-
-### build docker image
+### build container image
 
     $ make image-build
 
-### rebuild an existing docker image
+### build site
+
+    $ make build
+
+### start dev server
+
+    $ make serve
+
+Visit `localhost:8080` in web browser
+
+## getting around
+
+### rebuild the container image
 
     $ make image-rm image-build
 
@@ -27,9 +30,11 @@
 
 ### add an index page
 
+#### create the file
+
     $ docker run --rm -w /opt/app -v $PWD:/opt/app miti.sh sitegen page /opt/app index
 
-### add to `site.moon`
+#### add to `site.moon`
 
     add "index.md"
 
@@ -52,20 +57,10 @@
         }
     }
 
-### build site
-
-    $ make build
-
 ### build a single file
 
     $ make build file=index.html
 
-### start dev server
-
-    $ make serve
-
-Visit `localhost:8080` in web browser
-
 ### start a shell
 
     $ make shell