DokuWiki

DokuWiki is the software you are currently looking at. It is running in a Docker container on tex-drug-den.

All pages are public by default, but pages can be put behind a login by editing the access control list. Admin credentials are stored in Vaultwarden.

You need to be logged in to edit pages. Once logged in, click on 'Page' in the top right and 'Edit this page'.

While editing, use the preview function to see what it will look like, then save. Importantly, this doesn't use markdown; see syntax for a guide on the markup language.

If you're struggling with the syntax, then there is a visual editor extension installed. Press the button below the toolbar to toggle between syntax and visual editing. Please note that the extension, plugin:prosemirror, is labelled as a 'beta'.

The create page button seems to either be broken, or I'm not using it properly. The method I recommend using and that I find works the most reliably is navigating to the url you want your new page to exist at. Then click “Page” → “Create this page”. To create a new folder, follow the same process, but suffix your folder name with :start. For example, if you wanted to create a new folder called “test” you would navigate to wiki.cssbham.com/test:start and then click Page → Create this page

To Create a new top level category / folder you would follow the steps laid out above in the “Creating Pages” section, but this will not automatically add it to the sidebar. To do this you need to edit the sidebar page, following the same layout that exists already.

Settings like the theme, ACLs, and extensions can be changed by logging in as the admin user.

DokuWiki was chosen for the following reasons:

• it's super simple to set up
• it's incredibly lightweight
• it doesn't need a database
• it stores pages as text files which…
  • allows for easy backup
  • allows easy migration should we ever want to switch wiki software
  • is simple!