add installation instructions to landing page of docs site

Makefile

@@ -68,7 +68,7 @@ clean:
 ### Sphinx Docs ###
 # Catch-all target: route all unknown targets to Sphinx using the new
 # "make mode" option.  $(O) is meant as a shortcut for $(SPHINXOPTS).
-docs: Makefile
+zkdocs: Makefile
 	mkdir -p docs-build
 	sphinx-build -a docs docs-build 
 

docs/conf.py

@@ -26,5 +26,5 @@
 # https://www.sphinx-doc.org/en/master/usage/configuration.html#options-for-html-output
 
 html_theme = "furo"
-html_static_path = ["_static"]
+# html_static_path = ["_static"]
 master_doc = "index"

docs/index.rst

@@ -7,7 +7,64 @@
 
 `zk` is a plain text note-taking tool that leverages the power of the command line. 
 
-Let's :doc:`get started <tips/getting-started>`.
+Install as below and then... :doc:`get zettling <tips/getting-started>`!
+
+Installation
+============
+
+Homebrew:
+
+.. code-block:: sh
+
+   brew install zk
+
+   # Or, if you want to be on the bleeding edge:
+   brew install --HEAD zk
+
+
+Nix:
+
+.. code-block:: sh
+
+   # Run zk from Nix store without installing it:
+   nix run nixpkgs#zk
+
+   # Or, to install it permanently:
+   nix-env -iA zk
+
+Alpine Linux:
+
+.. code-block:: sh
+
+   # `zk` is currently available in the `testing` repositories:
+   apk add zk
+
+Arch Linux:
+
+You can install [the zk package](https://archlinux.org/packages/extra/x86_64/zk/) from the official repos.
+
+.. code-block:: sh
+
+   sudo pacman -S zk
+
+Build from scratch:
+
+Make sure you have a working [Go 1.21+ installation](https://golang.org/), then clone the repository:
+
+.. code-block:: sh
+
+   git clone https://github.com/zk-org/zk.git
+   cd zk
+
+On macOS / Linux:
+
+.. code-block:: sh
+
+   make
+   ./zk -h
+
+
+
 
 .. toctree::
    :hidden: