From e1094255578e7af82d34eb5a043403e05346909e Mon Sep 17 00:00:00 2001 From: Alessandro Mauri Date: Thu, 10 Sep 2020 00:49:01 +0200 Subject: [PATCH] slightly better readme --- README.md | 28 +++++++++++++++++++++++++++- 1 file changed, 27 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index 0e002e8..387df12 100644 --- a/README.md +++ b/README.md @@ -1,11 +1,37 @@ # Rivet: static site genetator River takes a source directory containing a the file sources and produces an -output directoru that can actually be uploaded to a server. +output directory that can actually be uploaded to a server. ## Dependencies - [lowdown](https://kristaps.bsd.lv/lowdown/) +- POSIX utilities - POSIX sh +## Examples +Generate site from directory to `cool_site` +```sh +$ rivet -o cool_site source_of_cool_site/ +``` + +The makefile I use to generate my site +```make +SRCDIR = src +DESTDIR = dst + +all: + mkdir -p ${DESTDIR} + ssg -o ${DESTDIR} ${SRCDIR} + +test: all + xdg-open ${DESTDIR}/index.html + +install: all + rsync -vmruLz --delete ${DESTDIR}/ www@${URL}:/www/ + +clean: + rm -rf ${DESTDIR} +``` + ## Similar tools - [saait](https://git.codemadness.org/saait/file/README.html)