Overall configuration

This wiki was created using the default setup instructions. The resulting .setup file is available through the setup branch of the git checkout in case this wiki needs to be reconstructed. Eventually, the wiki was redeployed using the Ikiwiki mass-hosting software called ikiwiki-hosting, but you should be able to deploy a simple clone using vanilla Ikiwiki. See replication for more information on how to deploy that.

See the branchable tab above to clone this wiki.

HTTP acceleration and performance

First, ikiwiki is designed to serve static pages, which is very efficient. Unless the wiki gets edited a lot, there should be no performance issues hosting it. Also, the wiki emits headers (E-Tag and Last-Modified) based on the content, which means that pages are cached by proxies and your browser will not fetch new data until it is told so or the page changes, which is very useful. This seems to be the default Apache configuration on my machine...

License

The wiki content is under GFDL, as detailed in the footer. A plugins/meta tag is in every page to document that fact, and that is enforced through the edit templates below.

Theme

The plugins/theme (actiontabs) was slightly tweaked to have the footer display properly, based on the work at the GNU HURD wiki. For this, the local.css file was created and can be modified through git.

Plugins

Enabled plugins

On top of the default plugins, the following plugins are enabled in the wiki:

... and more, see the setup file.

Contrib plugins to install

Those plugins are special, as they are not shipped with Ikiwiki out of the box.

Possible plugins to enable

  • plugins/anonok - may provoke a deluge of spam
  • plugins/favicon - once we have an icon (but can't we just edit favicon.ico in the root of the wiki?)

Templates

This section documents which templates are available and to what pages they apply, see also the plugins/editemplate plugin.

  • edittemplate node registered for nodes/*
  • edittemplate link registered for links/*

Other tools

  • tips/inside dot ikiwiki - good tips on how to interact with ikiwiki's metadata
  • If you want to host your own map tiles instead of using the openstreetmap server (for instance, if you run without internet access), see Hosting your own maps