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
|
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<meta name="color-scheme" content="dark light">
<link rel="icon" href="data:,">
<title>Switching Things Over to ikiwiki</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;}blockquote{background:rgba(0,0,0,0.1);border-left:4px solid;padding-left:5px;}img{max-width:100%;}pre{border:1px solid;overflow:auto;padding:5px;}table{text-align:left;width:100%;}.footnotes{font-size:90%;}</style>
</head>
<nav>
<a href="#menu">Menu ↓</a>
</nav>
<main>
<h1 id="switching-things-over-to-ikiwiki">Switching Things Over to ikiwiki</h1>
<p>2023-12-17</p>
<p>I’ve done it again. My personal website is no longer generated with <a href="https://barf.btxx.org">barf</a> but is instead built on top of ikiwiki. The old RSS feed (<a href="https://btxx.org/atom.xml">btxx.org/atom.xml</a>) still exists but will no longer receive updates. The new feed can be found on the bottom of the homepage (<a href="/index.rss">index.rss</a>)</p>
<h2 id="why-a-wiki">Why a Wiki?</h2>
<p>I love the simplicity of a minimal blog, which is why I always gravitated towards purely “static” site builders. Over time though, I found two minor issues that slowly chipped away at me: ease-of-use and flexibility.</p>
<p>I had a vision, back when I began tinkering with my own place on the web, of building out my own personal “resource center” or wiki. Often times through work or personal projects I stumble into little problems that I need to solve. Most times I find a solution and move on with my life. The problem with this approach is <em>lack of documentation</em>.</p>
<p>What if I come across that issue at a later point in time? Will I even remember my old solution? Probably not. So, I’ve made the switch to a more flexible, personal wiki (which also happens to be a blog!)</p>
<h2 id="text-editors-terminals-and-web-ui---oh-my">Text Editors, Terminals, and Web UI - Oh My!</h2>
<p>ikiwiki comes packed with multiple ways to publish pages and posts. Since it is built with ikiwiki and git version control in mind, you have the ability to push out changes directly to your server similar to that of pre-existing static site generators. It also gives you the choice to <code>ssh</code> directly into your server and publish content from your terminal if you so desire.</p>
<p>Best of all, ikiwiki offers a web UI interface. This is something I have long missed since leaving “dynamic” websites behind.</p>
<h2 id="but-wait-theres-more">But Wait, There’s More!</h2>
<p>Did I mention that this site now supports a built-in search form <em>and</em> a comment system? I’ve been wanting comments or discussions directly on my personal web space for the longest time and now I do! The search function is really an added bonus, mostly for my own personal use to find something I documented quickly.</p>
<h2 id="broken-links-and-bugs">Broken Links and Bugs</h2>
<p>I’ve done my best to properly forward all original posts and pages to their new URLs - but I’m sure some things will be overlooked. So please feel free to reach out and let me know if anything seems broken.</p>
<p>I look forward to growing out this “platform” and seeing how it impacts my workflow writing documentation / blog posts. I hope you’ll come along for the ride!</p>
<footer role="contentinfo">
<h2>Menu Navigation</h2>
<ul id="menu">
<li><a href="/">Home</a></li>
<li><a href="/projects">Projects</a></li>
<li><a href="/uses">Uses</a></li>
<li><a href="/wiki">Wiki</a></li>
<li><a href="/resume">Resume</a></li>
<li><a href="/colophon">Colophon</a></li>
<li><a href="/now">Now</a></li>
<li><a href="/donate">Donate</a></li>
<li><a href="/atom.xml">RSS</a></li>
<li><a href="#top">↑ Top of the page</a></li>
</ul>
<small>
Built with <a href="https://barf.btxx.org">barf</a>. <br>
Feeds: <a href="/atom.xml">Atom</a> & <a href="/rss.xml">RSS</a><br>
Maintained with ♥ for the web. <br>
Proud supporter of <a href="https://usefathom.com/ref/DKHJVX">Fathom</a> & <a href="https://nextdns.io/?from=74d3p3h8">NextDNS</a>. <br>
The content for this site is <a href="https://creativecommons.org/licenses/by-sa/2.0/">CC-BY-SA</a>.<br> The <a href="https://git.sr.ht/~bt/bt.ht">code for this site</a> is <a href="https://git.sr.ht/~bt/bt.ht/tree/master/item/LICENSE">MIT</a>.
</small>
</footer>
|
