M README.md => README.md +11 -7
@@ 38,13 38,12 @@ linux
-----
- rsync
-- lowdown
+- coreutils
- entr (optonal)
-- standard UNIX tools
Example on Alpine:
- sudo apk add rsync lowdown
+ sudo apk add rsync
openbsd
-------
@@ 55,13 54,12 @@ https://barf.btxx.org/openbsd
- coreutils
- gcc
- cmake
-- lowdown
- gsed
- entr (optional)
Example:
- doas pkg_add coreutils gcc cmake lowdown gsed
+ doas pkg_add coreutils gcc cmake gsed
macOS
-----
@@ 72,12 70,11 @@ https://barf.btxx.org/macos
- coreutils
- gnu-sed
- rsync
-- lowdown
- entr (optional)
Example:
- brew install coreutils gnu-sed rsync lowdown
+ brew install coreutils gnu-sed rsync
basic setup
-----------
@@ 87,6 84,13 @@ 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!
+Next, clone and install the minimal markdown parser `smu`:
+
+ git clone https://git.sr.ht/~bt/smu
+ cd smu
+ make
+ make install
+
Then build:
make build
M index.md => index.md +11 -4
@@ 18,19 18,26 @@ You can learn more by reading the [official README](https://git.sr.ht/~bt/barf).
For Linux (Alpine example):
- sudo apk add rsync lowdown coreutils
+ sudo apk add rsync coreutils
For macOS:
- brew install rsync lowdown coreutils gnu-sed
+ brew install rsync coreutils gnu-sed
For OpenBSD:
- doas pkg_add lowdown coreutils gsed cmake gcc
+ doas pkg_add coreutils gsed cmake gcc
+
+**Clone `smu` for markdown parsing:**
+
+ git clone https://git.sr.ht/~bt/smu
+ cd smu
+ make
+ make install
**Clone barf:**
- git clone https://git.btxx.org/barf
+ git clone https://git.sr.ht/~bt/barf
1. Open project, change the `domain` variable at the top of the core barf file
2. Run: `make build`
M posts/qol.md => posts/qol.md +2 -0
@@ 19,6 19,8 @@ I haven't circled back to `barf` in quite a bit of time, so I'm happy to announc
**Swapped out `smu` for `lowdown`**
+> IMPORTANT! This is no longer true. I have gone to back to using my own forked version of `smu`
+
* The default Markdown parser is now set to `lowdown`. The original parser (`smu`) is great, but I wanted to make the project simpler by avoiding users to clone and build a separate package.
That's it really! I've also updated the original blog posts about setting up `barf` on macOS and OpenBSD to reflect these changes.