build/index.html


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69

<!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>barf</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;line-height:1.33;margin:0 auto;max-width:650px;padding:1rem;}img{max-width:100%;}pre{border:1px solid;overflow:auto;padding:5px;}.footnotes{font-size:90%;}</style>
</head>

<nav>
	<a href="#menu">Menu &darr;</a>
</nav>

<main>
<h1 id="barf">barf</h1>
<p><strong>barf is an extremely minimal blog generator.</strong></p>
<p>The entire build script is &#62;170 lines of shell.</p>
<p>It could almost be called &#8220;suckless&#8221;, but probably isn&#8217;t. It was created for those focused on writing, not tinkering.</p>
<p>You can learn more by reading the <a href="https://git.btxx.org/barf/about">official README</a>.</p>
<p><strong>barf</strong> = blogs are really fun</p>
<hr/>
<h3 id="get-setup-in-2-minutes">Get setup in 2 minutes</h3>
<p><strong>Install dependencies:</strong></p>
<p>For Linux (Alpine example):</p>
<pre><code>sudo apk add rsync lowdown coreutils
</code></pre>
<p>For macOS:</p>
<pre><code>brew install rsync lowdown coreutils gnu-sed
</code></pre>
<p>For OpenBSD:</p>
<pre><code>doas pkg_add lowdown coreutils gsed cmake gcc
</code></pre>
<p><strong>Clone barf:</strong> </p>
<pre><code>git clone https:&#47;&#47;git.btxx.org&#47;barf
</code></pre>
<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 id="articles">Articles</h3>
<ul>
<li>2024-06-06 &middot; <a href="qol/">Quality of Life Improvements</a></li>
<li>2023-10-09 &middot; <a href="cleanup/">Cleaning Up barf's Structure</a></li>
<li>2023-08-12 &middot; <a href="openbsd/">Running `barf` on OpenBSD</a></li>
<li>2023-03-07 &middot; <a href="dark-mode/">Supporting Basic Dark Mode</a></li>
<li>2023-01-18 &middot; <a href="macos/">Running `barf` on MacOS</a></li>
<li>2023-01-05 &middot; <a href="markdown-examples/">Markdown Examples in barf</a></li>
</ul>
<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://barf.btxx.org">barf</a>. <br>
        The <a href="https://git.sr.ht/~bt/barf">code for this site</a> is MIT.
    </small>
</footer>