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 ++--- barf | 2 +- build/about/index.html | 12 +- build/atom.xml | 254 ++++++++++++++++++------------------- build/cleanup/index.html | 12 +- build/dark-mode/index.html | 15 ++- build/index.html | 47 +++---- build/macos/index.html | 8 +- build/markdown-examples/index.html | 205 ++++++++++++++---------------- build/openbsd/index.html | 8 +- build/qol/index.html | 12 +- build/rss.xml | 254 ++++++++++++++++++------------------- build/websites/index.html | 4 +- header.html | 2 +- index.md | 26 ++-- posts/markdown-examples.md | 8 ++ posts/qol.md | 4 + 17 files changed, 445 insertions(+), 462 deletions(-) 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... diff --git a/barf b/barf index 47ba095..10a92ca 100755 --- a/barf +++ b/barf @@ -14,7 +14,7 @@ elif [ "$os_name" = "Darwin" ]; then fi set -eu -MARKDOWN=smu +MARKDOWN=lowdown IFS=' ' # Create tab separated file with filename, title, creation date, last update diff --git a/build/about/index.html b/build/about/index.html index fac6c41..698aa5c 100644 --- a/build/about/index.html +++ b/build/about/index.html @@ -7,7 +7,7 @@ About `barf` - +
-

About barf

-

barf is a minimal and suckless-inspired blog generator. It is a tweaked and slightly patched version of Karl Bartel's fantastic blog.sh.

-

Why?

-

This project was created by me, Bradley Taunt, out of frustration with overly complex and bloated blogging options. I tried so many "minimal" generators but each one ended up having some glaring issue or heavy reliance on dependencies.

-

I wanted to have a system that I could easily replicate on any Linux machine. Something that didn't require me to download half the internet just to get up and running. I'm a sucker for keeping things simple.

+

About barf

+

barf is a minimal and suckless-inspired blog generator. It is a tweaked and slightly patched version of Karl Bartel’s fantastic blog.sh.

+

Why?

+

This project was created by me, Bradley Taunt, out of frustration with overly complex and bloated blogging options. I tried so many “minimal” generators but each one ended up having some glaring issue or heavy reliance on dependencies.

+

I wanted to have a system that I could easily replicate on any Linux machine. Something that didn’t require me to download half the internet just to get up and running. I’m a sucker for keeping things simple.