Include small description explaining the post file format and set proper date of blog post since it is 2023 - not 2022
barf is an extremely minimal blog generator.
The entire build script is less than 100 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. Be sure to check it out since my version does things slightly different.)
You can see a live demo here
Blogs Are Really Fun
Clone this repo and navigate inside it. Edit the "header.html" and "footer.html" files with your own information, navigation, etc.
Be sure to edit the RSS meta url or else your feed won't validate!
Then, clone and build my patched version of smu:
git clone https://git.sr.ht/~bt/smu cd smu sudo make install
Then clone this directory and build:
Your blog content will be in the
Now you can delete the dummy posts/pages and start making your own!
Media (such as images, videos) are placed in the "public" folder and carried over to the "build" folder via rsync. You can easily remove this altogether inside the main
barf script if you plan to store media elsewhere (or not use any at all).
The first line of any markdown file inside your
posts directory should start
with a h1 heading, then a line break, then the date in
# This is the Post Title 2023-01-05
Changing this structure or date format will break things or require you to edit
barf script accordingly.
Please use the official mailing list to submit your patches or bug fixes. Thanks!
Please refer to the main tutorial on setting up barf on MacOS
Inside your project directory run:
make watch cd build && python3 -m http.server 3003
Most likely not. I'm happy with how things are currently. If you want to add something - great! The point of this project is to give others the ability to fork it, tweak it, patch it, and share it as much as they'd like. The core of barf will remain minimal for this reason.
Of course, any patches that can help reduce the project's footprint or even speed things up are more than welcome!
Of course! Simply edit the main
barf script and swap out
smu 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.
But give smu a try - it is very lightweight and fast!
MORE FAQs TO COME...