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
70
71
72
73
74

<!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;margin:0 auto;max-width:650px;padding:1rem;}img{max-width:100%;}pre{overflow:auto;}</style>
</head>

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

<main>
<h1>barf</h1>
<p><strong>barf is an extremely minimal blog generator.</strong></p>
<p>The entire build script is less than 100 lines of shell.</p>
<p>It could almost be called "suckless", but probably isn'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> 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 &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://git.btxx.org/barf">barf</a>. <br>
        The <a href="https://git.btxx.org/barf">code for this site</a> is MIT.
    </small>
</footer>