diff options
author | Emile <git@emile.space> | 2022-04-08 19:18:49 +0200 |
---|---|---|
committer | Emile <git@emile.space> | 2022-04-08 19:18:49 +0200 |
commit | c937802732521929850490b6cc2ad83367d2733f (patch) | |
tree | aa1c05f478f06d7c9658ed7a6f2b557992afb33a | |
parent | a6aea48860229c180bcec23b2da7a478c3dc88ef (diff) |
filled the README.md with useful information
-rw-r--r-- | README.md | 106 |
1 files changed, 104 insertions, 2 deletions
diff --git a/README.md b/README.md index e75d455..54814db 100644 --- a/README.md +++ b/README.md @@ -1,3 +1,105 @@ -# vokobe -A minimal static site generator tailored to my needs. \ No newline at end of file +# Vokobe + +A minimal static site generator tailored to my needs. + + + + +## Installation + +Install my-project with npm + +```bash +; cargo build --release +``` + +## Usage/Examples + +```javascript +; ./target/release/vokobe --help +vokobe 0.1.0 +A static site generator + +USAGE: + vokobe [FLAGS] <in-path> <out-path> <site-name> + +FLAGS: + -a, --analytics Activate sending analytics to stats.emile.space + -h, --help Prints help information + -V, --version Prints version information + +ARGS: + <in-path> Input path + <out-path> Output path + <site-name> Site name (e.g. emile.space) +``` + + +## Deployment + +The following subsections contain some example for small shell scripts that might be useful for Deployment. + +### build.sh + +Remove the output dir, build it from scratch and update the perms. + +I'm actually considering rebuilding vokobe with incremental builds in mind, as it can take a bit to create some really large projects. + +```bash +rm -rf out/ +vokobe -a ./in ./out emile.space +chmod -R +r out/ +``` + +### sync.sh + +Syncronize the generated output to the remote host for hosting it. + +```bash +rsync -avz --delete <out-path>/* <user>@<host>:<path> +``` + +### publish.sh + +Build and Syncronize. + +```bash +./build.sh +./sync.sh +``` + +### host.sh + +Host the local version + +```bash +python3 -m http.server 8081 -d <outpath>/ -b 0.0.0.0 +``` + +### watchbuild.sh + +rebuild on changes + +```bash +#! /usr/bin/env nix-shell +#! nix-shell -i bash -p fd entr + +while sleep 0.5; do + fd . in | entr -d ./build.sh +done +``` + +### local.sh + +run a script updating it on changes and one hosting the output. + +```bash +sh ./watchbuild.sh & +sh ./host.sh +``` + + +## Contributing + +Send patches! |