aboutsummaryrefslogtreecommitdiff
path: root/README.md
diff options
context:
space:
mode:
authorDylan Garrett <dylan.garrett@gmail.com>2021-06-13 14:20:15 -0700
committerDylan Garrett <dylan.garrett@gmail.com>2021-06-13 14:20:15 -0700
commit9ee86c545e14ade1fd14b7068bdda6cf5a7c47a9 (patch)
tree3fa8c8f8a76ee7fc4f0b7d324b49cd6eef9d9ebe /README.md
parent23eb4d3a39c7f02506a9b735257bb5eaa6c3bb0e (diff)
downloadroka-9ee86c545e14ade1fd14b7068bdda6cf5a7c47a9.tar.gz
roka-9ee86c545e14ade1fd14b7068bdda6cf5a7c47a9.zip
Move base_url to config. Add README info about config override
Diffstat (limited to 'README.md')
-rw-r--r--README.md19
1 files changed, 13 insertions, 6 deletions
diff --git a/README.md b/README.md
index 4d76afe..7a7af22 100644
--- a/README.md
+++ b/README.md
@@ -33,16 +33,18 @@ 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.
+1. Set `BASE_URL` in app.cfg to the base url where the static site will be
+ uploaded.
+
+2. Run roka.py with the `--generate <output_directory>` parameter, where
+ `<output_directory>` is an output directory to place the generated site.
```bash
- ./roka.py --generate ./static --base_url "https://example.com/"
+ ./roka.py --generate ./static
```
-2. Upload the static site to any static web hosting. Make sure it is accessible
- at the URL previously passed in as `--base_url`
+3. Upload the static site to any static web hosting. Make sure it is accessible
+ at the URL set as `BASE_URL`
## Design decisions
@@ -68,3 +70,8 @@ support a username and password.
4. No rebuild endpoint exists; cache-affecting routines are run externally by
calling roka.py directly
+
+5. Configuration can either be placed in a file named `app.cfg`, or it can be
+ overridden on the terminal by passing a JSON string as the `--config`
+ parameter. I.E. `./roka.py --generate ./static --config '{"ROOT_PATH":
+ "/path/to/audiobooks", "BASE_URL": "https://example.com/"}'`