diff options
| author | bt <bt@btxx.org> | 2024-06-06 10:08:36 -0400 |
|---|---|---|
| committer | bt <bt@btxx.org> | 2024-06-06 10:08:36 -0400 |
| commit | 8c47200dd81639b7cb1a3a165f4bb2eec2517970 (patch) | |
| tree | 951c9a471b039f01ffb378c1c33f3798fa42e98a | |
| parent | 1d280856feae01dc135cdbb28bfa681ad7d6a63e (diff) | |
Add new blog post, update walkthroughs, new step by step help on homepage
| -rw-r--r-- | README.md | 16 | ||||
| -rwxr-xr-x | barf | 1 | ||||
| -rw-r--r-- | build/atom.xml | 41 | ||||
| -rw-r--r-- | build/index.html | 27 | ||||
| -rw-r--r-- | build/macos/index.html | 11 | ||||
| -rw-r--r-- | build/openbsd/index.html | 1 | ||||
| -rw-r--r-- | build/posts.tsv | 1 | ||||
| -rw-r--r-- | build/qol/index.html | 50 | ||||
| -rw-r--r-- | build/rss.xml | 40 | ||||
| -rw-r--r-- | index.md | 21 | ||||
| -rw-r--r-- | posts/macos.md | 17 | ||||
| -rw-r--r-- | posts/openbsd.md | 2 | ||||
| -rw-r--r-- | posts/qol.md | 22 |
13 files changed, 185 insertions, 65 deletions
@@ -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. @@ -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,12 +2,37 @@ <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> @@ -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></content> <link href="https://barf.btxx.org/openbsd"/> <id>https://barf.btxx.org/openbsd</id> @@ -268,22 +292,13 @@ tags.</p></content> <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> 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 @@ <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> 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 @@ <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> diff --git a/build/openbsd/index.html b/build/openbsd/index.html index 1b80e58..dc58675 100644 --- a/build/openbsd/index.html +++ b/build/openbsd/index.html @@ -22,7 +22,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> <footer role="contentinfo"> <hr> diff --git a/build/posts.tsv b/build/posts.tsv index 374d954..c02db1c 100644 --- a/build/posts.tsv +++ b/build/posts.tsv @@ -1,3 +1,4 @@ +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 diff --git a/build/qol/index.html b/build/qol/index.html new file mode 100644 index 0000000..bdebf62 --- /dev/null +++ b/build/qol/index.html @@ -0,0 +1,50 @@ +<!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 diff --git a/build/rss.xml b/build/rss.xml index 52220d3..992412c 100644 --- a/build/rss.xml +++ b/build/rss.xml @@ -4,11 +4,35 @@ <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>2023-08-12</p> @@ -17,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></description> <link>https://barf.btxx.org/openbsd</link> <guid isPermaLink="false">https://barf.btxx.org/openbsd</guid> @@ -267,22 +290,13 @@ tags.</p></description> <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> @@ -12,4 +12,25 @@ You can learn more by reading the [official README](https://git.btxx.org/barf/ab --- +### 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 diff --git a/posts/macos.md b/posts/macos.md index 85f2630..4ecaaa8 100644 --- a/posts/macos.md +++ b/posts/macos.md @@ -4,28 +4,13 @@ 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! diff --git a/posts/openbsd.md b/posts/openbsd.md index 82200e0..7054ef0 100644 --- a/posts/openbsd.md +++ b/posts/openbsd.md @@ -12,6 +12,4 @@ Along with your Markdown parser of choice (`barf` assumes you will be using my v 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! diff --git a/posts/qol.md b/posts/qol.md new file mode 100644 index 0000000..f09694e --- /dev/null +++ b/posts/qol.md @@ -0,0 +1,22 @@ +# 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! |