commit 8c47200dd81639b7cb1a3a165f4bb2eec2517970 from: bt date: Thu Jun 06 14:08:36 2024 UTC Add new blog post, update walkthroughs, new step by step help on homepage commit - 1d280856feae01dc135cdbb28bfa681ad7d6a63e commit + 8c47200dd81639b7cb1a3a165f4bb2eec2517970 blob - 2f2105fa7b0d28424805a97085493cc179bdeb35 blob + ada76ca71e72163bb0d7b0e0dd54c485b9a23a39 --- README.md +++ README.md @@ -75,23 +75,19 @@ 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. Now you can delete the dummy posts/pages and start making your own! blob - a88f32af414f2b137a05457baad5139062005581 blob + 47ba0956d5e1b1c456c1f0e74290e7a3bf3d021e --- barf +++ 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 blob - dfdebe18354097f6495a57e13365740edaaeae9d blob + 8b1b84d3e937cb6f5ff31733d3111f96e2ff994a --- build/atom.xml +++ build/atom.xml @@ -2,12 +2,37 @@ 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> <p>2023-08-12</p> @@ -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 blob - 6786dc832b9caaec49dc655e8127db7bd5040c57 blob + 488a398a962805b7b4364dd89877919746b5990b --- build/index.html +++ 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. +
  3. Run: make build
  4. +
  5. Upload the contents of build to your server!
  6. +
  7. Profit?
  8. +
+

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
  • blob - 02464e5d67342c0791498a2083d7970f61022309 blob + 06a1e4d05c711080c021ca53b5ce33922ccf555e --- build/macos/index.html +++ 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!