commit - 1d280856feae01dc135cdbb28bfa681ad7d6a63e
commit + 8c47200dd81639b7cb1a3a165f4bb2eec2517970
blob - 2f2105fa7b0d28424805a97085493cc179bdeb35
blob + ada76ca71e72163bb0d7b0e0dd54c485b9a23a39
--- README.md
+++ README.md
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
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
<feed xmlns="http://www.w3.org/2005/Atom">
<title>barf</title>
<link href="https://barf.btxx.org/atom.xml" rel="self" />
- <updated>2024-06-06T08:48:45Z</updated>
+ <updated>2024-06-06T10:08:02Z</updated>
<author>
- <name>Bradley Taunt</name>
+ <name></name>
</author>
<id>https://barf.btxx.org,2024-01-19:default-atom-feed/</id>
<entry>
+ <title>Quality of Life Improvements</title>
+ <content type="html"><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></content>
+ <link href="https://barf.btxx.org/qol"/>
+ <id>https://barf.btxx.org/qol</id>
+ <updated>2024-06-06T10:00:00Z</updated>
+ <published>2024-06-06T10:00:00Z</published>
+ </entry>
+ <entry>
<title>Running `barf` on OpenBSD</title>
<content type="html"><h1>Running <code>barf</code> on OpenBSD</h1>
<p>2023-08-12</p>
<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></content>
<link href="https://barf.btxx.org/openbsd"/>
<id>https://barf.btxx.org/openbsd</id>
<content type="html"><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></content>
+<p>Now everything should work as intended!</p></content>
<link href="https://barf.btxx.org/macos"/>
<id>https://barf.btxx.org/macos</id>
<updated>2023-01-18T10:00:00Z</updated>
blob - 6786dc832b9caaec49dc655e8127db7bd5040c57
blob + 488a398a962805b7b4364dd89877919746b5990b
--- build/index.html
+++ build/index.html
<p>You can learn more by reading the <a href="https://git.btxx.org/barf/about">official README</a> and view the generated <a href="/atom.xml">Atom feed here</a></p>
<p><strong>barf</strong> = blogs are really fun</p>
<hr />
+<h3>Get setup in 2 minutes</h3>
+<p><strong>Install dependencies:</strong></p>
+
+<ul>
+<li>For Linux: <code>rsync</code></li>
+<li>For macOS: <code>brew install coreutils gnu-sed</code></li>
+<li>For OpenBSD: <code>doas pkg_add rsync coreutils gsed cmake gcc</code></li>
+</ul>
+<p><strong>Clone and install the lightweight markdown parser, <code>smu</code></strong></p>
+
+<ul>
+<li><code>git clone https://git.btxx.org/smu</code></li>
+<li><code>cd smu ; make ; sudo make install</code></li>
+</ul>
+<p><strong>Clone <code>barf</code>:</strong> </p>
+
+<ul>
+<li><code>git clone https://git.btxx.org/barf</code></li>
+</ul>
+<ol>
+<li>Open project, change the <code>domain</code> variable at the top of the core barf file</li>
+<li>Run: <code>make build</code></li>
+<li>Upload the contents of <code>build</code> to your server! </li>
+<li>Profit?</li>
+</ol>
+<hr />
<h3>Articles</h3>
<ul>
+<li>2024-06-06 · <a href="qol/">Quality of Life Improvements</a></li>
<li>2023-10-09 · <a href="cleanup/">Cleaning Up barf's Structure</a></li>
<li>2023-08-12 · <a href="openbsd/">Running `barf` on OpenBSD</a></li>
<li>2023-03-07 · <a href="dark-mode/">Supporting Basic Dark Mode</a></li>
blob - 02464e5d67342c0791498a2083d7970f61022309
blob + 06a1e4d05c711080c021ca53b5ce33922ccf555e
--- build/macos/index.html
+++ build/macos/index.html
<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="/usr/local/bin:$PATH"
-</code></pre>
-<p>Reload your <code>bash</code> instance and everything should work as intended!</p>
+<p>Now everything should work as intended!</p>
<footer role="contentinfo">
<hr>
<h3 id="menu">Menu Navigation</h3>
blob - 1b80e587a0fb9f426c2ab93b05a746a59d767e8e
blob + dc586750c9494bd859b35580f9e693304ff934e3
--- build/openbsd/index.html
+++ build/openbsd/index.html
<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>
<footer role="contentinfo">
<hr>
blob - 374d954a0f2583bcc61ab5e8b2164432ec25d644
blob + c02db1cf4583185f4214905b1d3d86db618a3ca1
--- build/posts.tsv
+++ build/posts.tsv
+posts/qol.md Quality of Life Improvements
posts/openbsd.md Running `barf` on OpenBSD
posts/markdown-examples.md Markdown Examples in barf
posts/macos.md Running `barf` on MacOS
blob - 52220d3d03bc890f7b3e4dd33422efe9b9bbcc49
blob + 992412c8f303dfce96b1b7b93d94b12ba1051e2d
--- build/rss.xml
+++ build/rss.xml
<title>barf</title>
<link>https://barf.btxx.org/rss.xml</link>
<description>Feed description here</description>
- <lastBuildDate>Thu, 06 Jun 2024 12:48:45 +0000</lastBuildDate>
- <pubDate>Thu, 06 Jun 2024 12:48:45 +0000</pubDate>
+ <lastBuildDate>Thu, 06 Jun 2024 14:08:02 +0000</lastBuildDate>
+ <pubDate>Thu, 06 Jun 2024 14:08:02 +0000</pubDate>
<generator>Custom RSS Generator</generator>
<ttl>1800</ttl>
+ <item>
+ <title>Quality of Life Improvements</title>
+ <description><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></description>
+ <link>https://barf.btxx.org/qol</link>
+ <guid isPermaLink="false">https://barf.btxx.org/qol</guid>
+ <pubDate>Thu, 06 Jun 2024 00:00:00 +0000</pubDate>
+ </item>
<item>
<title>Running `barf` on OpenBSD</title>
<description><h1>Running <code>barf</code> on OpenBSD</h1>
<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></description>
<link>https://barf.btxx.org/openbsd</link>
<guid isPermaLink="false">https://barf.btxx.org/openbsd</guid>
<description><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></description>
+<p>Now everything should work as intended!</p></description>
<link>https://barf.btxx.org/macos</link>
<guid isPermaLink="false">https://barf.btxx.org/macos</guid>
<pubDate>Wed, 18 Jan 2023 00:00:00 +0000</pubDate>
blob - /dev/null
blob + bdebf623b835592fad36add9d65a811102abb855 (mode 644)
--- /dev/null
+++ build/qol/index.html
+<!doctype html>
+<html lang="en">
+<head>
+ <meta charset="utf-8">
+ <meta name="viewport" content="width=device-width, initial-scale=1">
+ <link rel="icon" href="data:,">
+ <title>Quality of Life Improvements</title>
+ <link href="/atom.xml" type="application/atom+xml" rel="alternate" title="Atom feed for blog posts" />
+ <link href="/rss.xml" type="application/rss+xml" rel="alternate" title="RSS feed for blog posts" />
+ <style>*{box-sizing:border-box;}body{font-family:sans-serif;margin:0 auto;max-width:650px;padding:1rem;}img{max-width:100%;}pre{overflow:auto;}</style>
+</head>
+
+<nav>
+ <a href="#menu">Menu ↓</a>
+</nav>
+
+<main>
+<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>
+<footer role="contentinfo">
+ <hr>
+ <h3 id="menu">Menu Navigation</h3>
+ <ul>
+ <li><a href="/">Home</a></li>
+ <li><a href="/about">About</a></li>
+ <li><a href="/websites">Websites</a></li>
+ <li><a href="https://git.btxx.org/barf">Source Code</a></li>
+ </ul>
+ <small>
+ Feeds: <a href="/atom.xml">Atom</a> | <a href="/rss.xml">RSS</a> <br>
+ Built with <a href="https://git.btxx.org/barf">barf</a>. <br>
+ The <a href="https://git.btxx.org/barf">code for this site</a> is MIT.
+ </small>
+</footer>
\ No newline at end of file
blob - d55ab3e94954a3f01c38a339ec680a0df2116754
blob + 5451da3823f8f004d96b88dbdc7d63dcf1daf87f
--- index.md
+++ index.md
---
+### 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. Run: `make build`
+3. Upload the contents of `build` to your server!
+4. Profit?
+
+---
+
### Articles
blob - 85f263078eff8b2e81bc3a78d0a34a4b022c2cab
blob + 4ecaaa84581be465d50ea282745324b24dea10ee
--- posts/macos.md
+++ posts/macos.md
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](https://brew.sh/) 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!
blob - 82200e0047e319e2ea976dd199e9aaf34282a73e
blob + 7054ef07bdfaa0c3172ac4864a0ba3c135dac3d7
--- posts/openbsd.md
+++ posts/openbsd.md
doas pkg_add rsync coreutils gsed cmake gcc
```
-Then ensure that you alter all instances of `sed` with `gsed` in the core `barf` file. (Or make an alias if you'd prefer not to alter the main file)
-
After that, everything should work perfectly fine when building!
blob - /dev/null
blob + f09694ef6e5a18fb5431c5d1daddc323a7c8a42b (mode 644)
--- /dev/null
+++ posts/qol.md
+# Quality of Life Improvements
+
+2024-06-06
+
+I haven't circled back to `barf` 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:
+
+**Automatic detection of your operating system (supports Linux, macOS and OpenBSD currently)**
+
+* `barf` now checks your current OS and sets aliases accordingly
+* this removes the need to hard-set your own aliases or run syslinks
+
+**Added a semantically valid RSS feed**
+
+* `barf` initially launched with Atom support only, now a separate RSS feed is generated at build time
+
+**Removed hardcoded feed links from `header.html`**
+
+* You now only need to set your main domain at the top of the core `barf` file.
+
+That's it really! I've also updated the original blog posts about setting up `barf` on macOS and OpenBSD to reflect these changes.
+
+Cheers!
