about summary refs log tree commit diff
diff options
context:
space:
mode:
authorEmile <git@emile.space>2022-04-08 19:18:49 +0200
committerEmile <git@emile.space>2022-04-08 19:18:49 +0200
commitc937802732521929850490b6cc2ad83367d2733f (patch)
treeaa1c05f478f06d7c9658ed7a6f2b557992afb33a
parenta6aea48860229c180bcec23b2da7a478c3dc88ef (diff)
filled the README.md with useful information
-rw-r--r--README.md106
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!