From 23eb4d3a39c7f02506a9b735257bb5eaa6c3bb0e Mon Sep 17 00:00:00 2001 From: Dylan Garrett Date: Sun, 13 Jun 2021 14:09:55 -0700 Subject: Update README for static generation --- README.md | 17 +++++++++++++++++ 1 file changed, 17 insertions(+) diff --git a/README.md b/README.md index 75572fe..4d76afe 100644 --- a/README.md +++ b/README.md @@ -27,6 +27,23 @@ A screenshot of the web interface is [available here](screenshots/web.png). ./uwsgi.sh ``` +## Static generation + +In addition to running as a server, Roka can also generate a static index and +set of RSS feeds that can be deployed to static hosting. This mode does not +support a username and password. + +1. Run roka.py with `--generate --base_url ` parameters + where `` is a directory to place the generated site and + `` is the base url where the static site will be uploaded to. + + ```bash + ./roka.py --generate ./static --base_url "https://example.com/" + ``` + +2. Upload the static site to any static web hosting. Make sure it is accessible + at the URL previously passed in as `--base_url` + ## Design decisions 1. Directories contained within config:ROOT_PATH are marked as audiobooks if and -- cgit v1.2.3-54-g00ecf