Mechanics of a Personal Wiki
Table of Contents
1. How do I set up a personal wiki?
This is where I'll store my ideas about setting up and maintaining this wiki, and any others I make or maintain.
There are several options, personally I use orgmode to compose my files and I'm unsure what I will use for hosting and displaying, though orgmode gives me many options
1.1. Editing
orgmode is originally a major mode for emacs, but it has ports for neovim and many other tools, and there are even wiki tools.
Another great example is jortscity's jortswiki where you can also learn about PIVOT TO WIKI, in this case both the editing and hosting is handled by obsidian, and the files are plain markdown, which makes this an especially appealing option for it's ease of entry.
1.1.1. Org Publishing
Sooner or later it looks like I'll need to use something like this to make sense
of all the different files in this wiki, this should probably help with keeping
things organized too.
I got around to it! Using a combination of make and emacs on the command line I can publish both an HTML and Markdown version of this wiki. I can also integrate this wiki into my personal notes, to link to pages in the wiki from them or factor parts of my notes into the wiki for publishing.
Most importantly conversion to both Markdown and HTML allows for easy solicitation of edits, as even very lightly technical users can create pull requests at the wiki's repository. No familiarity with a command line is necessary, and all major OS's have GUI based git programs.
For more information see
1.1.2. Git Wiki
A jekyll plugin that can take markdown pages and host them on Github pages.
Doesn't require any software installation beyond git, but is unsuitable for this project, it can't be hosted on a static site service like Neocities.
1.1.3. ikiwiki
It's not for everyone but I want to have static-ish sites that fit on neocities.
1.1.3.1. Setup
SRCDIR="$(pwd)" DESTDIR="$(pwd)_staging" ikiwiki --verbose $SRCDIR $DESTDIR --url=<url> --dumpsetup wiki.setup
1.1.3.2. Rebuilding
ikiwiki --setup wiki.setup --rebuild
1.1.3.3. Cleanup
rm -rf *.org
find . -type f -exec sed -i 's/\.md">/\.html">/g' {} \;
1.2. Hosting
There's a fascinating project groundmist to store files in your ATProto PDS, which allows a secure and distributed store of files that are directly attributable to your bluesky account.