From 518ec9aba88d5d6861ddbe57fa3b07f50c7cfe23e229215180288cf314a2ce2c Mon Sep 17 00:00:00 2001 From: Nicholas Johnson Date: Sun, 23 Oct 2022 00:00:00 +0000 Subject: Add a README --- README.md | 18 ++++++++++++++++++ 1 file changed, 18 insertions(+) create mode 100644 README.md diff --git a/README.md b/README.md new file mode 100644 index 0000000..e51c11f --- /dev/null +++ b/README.md @@ -0,0 +1,18 @@ +# hugo-theme-nicksphere +An accessible, no-JS, minimalist, high-contrast Hugo theme that outputs Gemtext and HTML. Suitable for blogs. + +## Clone to Your Theme Directory +```bash +$ git clone https://git.nicksphere.ch/hugo-theme-nicksphere themes/hugo-theme-nicksphere +``` + +## Generate The Blog +Since Hugo can't separate the Gemtext and HTML output by itself, this theme uses two scripts to handle the output: + +* `python3 themes/hugo-theme-nicksphere/scripts/generate.py` outputs the site and the capsule +* `python3 themes/hugo-theme-nicksphere/scripts/clean.py` removes previously generated output + +If the correct media types, output formats, markup settings, and outputs are not specified in config.toml, the above scripts may fail or the blog may render correctly. Have a look at the [nicksphere repository](https://git.nicksphere.ch/nicksphere/tree/config.toml) for ideas on how to set up your config.toml. + +## License +GPLv3 or later -- cgit v1.2.3