aboutsummaryrefslogtreecommitdiff
path: root/README.md
diff options
context:
space:
mode:
authorDylan Garrett <dylan.garrett@gmail.com>2021-06-13 14:09:55 -0700
committerDylan Garrett <dylan.garrett@gmail.com>2021-06-13 14:09:55 -0700
commit23eb4d3a39c7f02506a9b735257bb5eaa6c3bb0e (patch)
tree4ece4b32bea6648f95350e81bac9fd144504b168 /README.md
parent3a2c067bd6790f9c10d7cf3f82cee7aa46777681 (diff)
downloadroka-23eb4d3a39c7f02506a9b735257bb5eaa6c3bb0e.tar.gz
roka-23eb4d3a39c7f02506a9b735257bb5eaa6c3bb0e.zip
Update README for static generation
Diffstat (limited to 'README.md')
-rw-r--r--README.md17
1 files changed, 17 insertions, 0 deletions
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 <output_directory> --base_url <url>` parameters
+ where `<output_directory>` is a directory to place the generated site and
+ `<url>` 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