From 8c47200dd81639b7cb1a3a165f4bb2eec2517970 Mon Sep 17 00:00:00 2001 From: bt Date: Thu, 6 Jun 2024 10:08:36 -0400 Subject: Add new blog post, update walkthroughs, new step by step help on homepage --- README.md | 16 ++++++---------- barf | 1 + build/atom.xml | 41 ++++++++++++++++++++++++++------------- build/index.html | 27 ++++++++++++++++++++++++++ build/macos/index.html | 11 +---------- build/openbsd/index.html | 1 - build/posts.tsv | 1 + build/qol/index.html | 50 ++++++++++++++++++++++++++++++++++++++++++++++++ build/rss.xml | 40 +++++++++++++++++++++++++------------- index.md | 21 ++++++++++++++++++++ posts/macos.md | 17 +--------------- posts/openbsd.md | 2 -- posts/qol.md | 22 +++++++++++++++++++++ 13 files changed, 185 insertions(+), 65 deletions(-) create mode 100644 build/qol/index.html create mode 100644 posts/qol.md diff --git a/README.md b/README.md index 2f2105f..ada76ca 100644 --- a/README.md +++ b/README.md @@ -75,22 +75,18 @@ basic setup 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! +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 - + git clone https://git.btxx.org/smu + cd smu + # OpenBSD users: change sudo to doas + sudo make install Then clone this directory and build: - -$ make build - + make build Your blog content will be in the `build` directory. diff --git a/barf b/barf index a88f32a..47ba095 100755 --- a/barf +++ b/barf @@ -7,6 +7,7 @@ os_name=$(uname -s) if [ "$os_name" = "OpenBSD" ]; then alias sed=gsed + alias date=gdate elif [ "$os_name" = "Darwin" ]; then alias sed=gsed alias date=gdate diff --git a/build/atom.xml b/build/atom.xml index dfdebe1..8b1b84d 100644 --- a/build/atom.xml +++ b/build/atom.xml @@ -2,11 +2,36 @@ barf - 2024-06-06T08:48:45Z + 2024-06-06T10:08:02Z - Bradley Taunt + https://barf.btxx.org,2024-01-19:default-atom-feed/ + + Quality of Life Improvements + <h1>Quality of Life Improvements</h1> +<p>2024-06-06</p> +<p>I haven't circled back to <code>barf</code> in quite a bit of time, so I'm happy to announce a small update mainly focused on quality of life improvements! I'll keep things brief and get right into the core changes:</p> +<p><strong>Automatic detection of your operating system (supports Linux, macOS and OpenBSD currently)</strong></p> +<ul> +<li><code>barf</code> now checks your current OS and sets aliases accordingly</li> +<li>this removes the need to hard-set your own aliases or run syslinks</li> +</ul> +<p><strong>Added a semantically valid RSS feed</strong></p> +<ul> +<li><code>barf</code> initially launched with Atom support only, now a separate RSS feed is generated at build time</li> +</ul> +<p><strong>Removed hardcoded feed links from <code>header.html</code></strong></p> +<ul> +<li>You now only need to set your main domain at the top of the core <code>barf</code> file.</li> +</ul> +<p>That's it really! I've also updated the original blog posts about setting up <code>barf</code> on macOS and OpenBSD to reflect these changes.</p> +<p>Cheers!</p> + + https://barf.btxx.org/qol + 2024-06-06T10:00:00Z + 2024-06-06T10:00:00Z + Running `barf` on OpenBSD <h1>Running <code>barf</code> on OpenBSD</h1> @@ -16,7 +41,6 @@ <p>Along with your Markdown parser of choice (<code>barf</code> assumes you will be using my version of <a href="https://git.sr.ht/~bt/smu">smu</a>) you will also need to install the required packages on your OpenBSD system:</p> <pre><code>doas pkg_add rsync coreutils gsed cmake gcc </code></pre> -<p>Then ensure that you alter all instances of <code>sed</code> with <code>gsed</code> in the core <code>barf</code> file. (Or make an alias if you'd prefer not to alter the main file)</p> <p>After that, everything should work perfectly fine when building!</p> https://barf.btxx.org/openbsd @@ -268,22 +292,13 @@ tags.</p> <h1>Running <code>barf</code> on MacOS</h1> <p>2023-01-18</p> <p>The <code>barf</code> project was built on Linux and was catered towards Linux users. The core of the project will remain focused on Linux/GNU tools, but that doesn't mean MacOS needs to be left out in the cold.</p> -<p>There are some very minor changes you'll need to make to your default <code>sed</code> and <code>date</code> paths if you plan to run barf on MacOS.</p> <h2>Download Packages</h2> <p>This walkthrough assumes that you already have <a href="https://brew.sh/">homebrew</a> installed on your machine.</p> <p>You will need to install the GNU versions of both <code>date</code> and <code>sed</code> in order to avoid breaking things when <code>barf</code> tries to build.</p> <pre><code>brew install coreutils brew install gnu-sed </code></pre> -<h2>Setting <code>gsed</code> and <code>gdate</code> as Default</h2> -<p>Now run the following in a terminal shell:</p> -<pre><code>sudo ln -fs /opt/homebrew/bin/gsed /usr/local/bin/sed -sudo ln -fs /opt/homebrew/bin/gdate /usr/local/bin/date -</code></pre> -<p>and add the following to your <code>.bash_profile</code> file:</p> -<pre><code>export PATH=&quot;/usr/local/bin:$PATH&quot; -</code></pre> -<p>Reload your <code>bash</code> instance and everything should work as intended!</p> +<p>Now everything should work as intended!</p> https://barf.btxx.org/macos 2023-01-18T10:00:00Z diff --git a/build/index.html b/build/index.html index 6786dc8..488a398 100644 --- a/build/index.html +++ b/build/index.html @@ -22,8 +22,35 @@

You can learn more by reading the official README and view the generated Atom feed here

barf = blogs are really fun

+

Get setup in 2 minutes

+

Install dependencies:

+ +
    +
  • For Linux: rsync
    • +
  • For macOS: brew install coreutils gnu-sed
    • +
  • For OpenBSD: doas pkg_add rsync coreutils gsed cmake gcc
    • +
+

Clone and install the lightweight markdown parser, smu

+ +
    +
  • git clone https://git.btxx.org/smu
    • +
  • cd smu ; make ; sudo make install
    • +
+

Clone barf:

+ +
    +
  • git clone https://git.btxx.org/barf
    • +
+
    +
  1. Open project, change the domain variable at the top of the core barf file
    2. +
  2. Run: make build
    3. +
  3. Upload the contents of build to your server!
    4. +
  4. Profit?
    5. +
+

Articles

    +
  • 2024-06-06 · Quality of Life Improvements
  • 2023-10-09 · Cleaning Up barf's Structure
  • 2023-08-12 · Running `barf` on OpenBSD
  • 2023-03-07 · Supporting Basic Dark Mode
    • diff --git a/build/macos/index.html b/build/macos/index.html index 02464e5..06a1e4d 100644 --- a/build/macos/index.html +++ b/build/macos/index.html @@ -18,22 +18,13 @@

    Running barf on MacOS

    2023-01-18

    The barf project was built on Linux and was catered towards Linux users. The core of the project will remain focused on Linux/GNU tools, but that doesn't mean MacOS needs to be left out in the cold.

    -

    There are some very minor changes you'll need to make to your default sed and date paths if you plan to run barf on MacOS.

    Download Packages

    This walkthrough assumes that you already have homebrew installed on your machine.

    You will need to install the GNU versions of both date and sed in order to avoid breaking things when barf tries to build.

    brew install coreutils
 brew install gnu-sed
    -

    Setting gsed and gdate as Default

    -

    Now run the following in a terminal shell:

    -
    sudo ln -fs /opt/homebrew/bin/gsed /usr/local/bin/sed
-sudo ln -fs /opt/homebrew/bin/gdate /usr/local/bin/date
-
    -

    and add the following to your .bash_profile file:

    -
    export PATH="/usr/local/bin:$PATH"
-
    -

    Reload your bash instance and everything should work as intended!

    +

    Now everything should work as intended!