From 8a3e4e5207f59d42bfd6075e3792267266c86e71 Mon Sep 17 00:00:00 2001 From: Bradley Taunt Date: Fri, 7 Jun 2024 10:27:38 -0400 Subject: Homepage changes, README updates, swap to lowdown, cleanup --- README.md | 34 +++++++++++++++++----------------- 1 file changed, 17 insertions(+), 17 deletions(-) (limited to 'README.md') diff --git a/README.md b/README.md index ada76ca..6fedcb2 100644 --- a/README.md +++ b/README.md @@ -3,12 +3,11 @@ barf barf is an extremely minimal blog generator. -The entire build script is less than 100 lines of shell. +The entire build script is >170 lines of shell. It could *almost* be called "suckless", but probably isn't. -(barf is a modified/forked version of Karl Bartel's fantastic blog.sh -(https://github.com/karlb/karl.berlin). Be sure to check it out since +(barf is a modified/forked version of Karl Bartel's fantastic [blog.sh](https://github.com/karlb/karl.berlin). Be sure to check it out since my version does things slightly different.) You can see a [live demo here](https://barf.btxx.org) @@ -39,10 +38,14 @@ linux ----- - rsync -- smu (see below) +- lowdown - entr (optonal) - standard UNIX tools +Example on Alpine: + + sudo apk add rsync lowdown + openbsd ------- @@ -53,10 +56,12 @@ https://barf.btxx.org/openbsd - gcc - cmake - rsync +- lowdown - gsed -- smu (see below) - entr (optional) + doas pkg_add coreutils gcc cmake rsync lowdown gsed + macOS ----- @@ -66,9 +71,11 @@ https://barf.btxx.org/macos - coreutils - gnu-sed - rsync -- smu (see below) +- lowdown - entr (optional) + brew install coreutils gnu-sed rsync lowdown + basic setup ----------- @@ -77,14 +84,7 @@ and "footer.html" files with your own information, navigation, etc. Be sure to edit the **domain** variable inside `barf` or else your feed won't validate! -Then, clone and build my patched version of smu: - - git clone https://git.btxx.org/smu - cd smu - # OpenBSD users: change sudo to doas - sudo make install - -Then clone this directory and build: +Then build: make build @@ -155,11 +155,11 @@ or even speed things up are more than welcome! ## Can I use other Markdown parsers? -Of course! Simply edit the main `barf` script and swap out `smu` with +Of course! Simply edit the main `barf` script and swap out `lowdown` with something else. I wouldn't advise doing this if you already have pre-existing -content based-off `smu`, since this could break some of your pages. +content based-off `lowdown`, since this could break some of your pages. -But give smu (https://git.btxx.org/smu) a try - it is very lightweight and fast! +But give `lowdown` a try - it is very lightweight and fast! MORE FAQs TO COME... -- cgit v1.2.3-54-g00ecf