Table of Contents

  1. How do I set up a personal wiki?
    1. Editing
      1. Git Wiki
      2. ikiwiki
      3. Org Publishing
    2. Hosting

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

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.

Git Wiki

Poject Github

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.

ikiwiki

Project Homepage

It's not for everyone but I want to have static-ish sites that fit on neocities.

  1. Setup

    SRCDIR="$(pwd)"
    DESTDIR="$(pwd)_staging"
    ikiwiki --verbose $SRCDIR $DESTDIR --url=<url> --dumpsetup wiki.setup
    
  2. Rebuilding

    ikiwiki --setup wiki.setup --rebuild
    
  3. Cleanup

    rm -rf *.org
    find . -type f -exec sed -i 's/\.md">/\.html">/g' {} \;
    

Org Publishing

Manual Page

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.

Hosting

There's a facinating 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.