The default theming of ikiwiki is described as an anti theme and that’s right to the point: it looks like from the early 90s. To avoid loosing potential users too early in the process due to the very basic look we switch to a different theme now.
In general there are two ways to adjust the look of ikiwiki:
- use a pre-built theme
- create a
local.cssfor complete custom theming with CSS and/or adjust the included template files (install in
These two methods can also be combined. We only cover the pre-built themes here with three examples.
First we switch to an alternate built-in theme.
Theming 1: Enable the builting theme “actiontabs”
myiki.setup to enable the
theme plugin and select the more pleasing
actiontabs included in the distribution:
$ diff -u myiki.setup.org myiki.setup --- myiki.setup.org 2014-07-25 00:36:11.238747239 +0400 +++ myiki.setup 2014-07-25 01:26:43.515001820 +0400 @@ -40,6 +40,7 @@ add_plugins: - goodstuff - websetup +- theme # plugins to disable disable_plugins:  # additional directory to search for template files @@ -288,6 +289,7 @@ # theme plugin # name of theme to enable #theme: actiontabs +theme: actiontabs # websetup plugin # list of plugins that cannot be enabled/disabled via the web interface
After rebuilding the wiki (
ikiwiki -f ~/myiki.setup rebuild) the site shows
in the new theme.
See actiontabs-theme live at Branchable.
Theming 2: Local copy of a bootstrap (2.0) theme
There is a theme market on the ikiwiki homepage, from there we get the link to the following Bootstrap-based theme.
get theme from http://anonscm.debian.org/cgit/users/jak/website.git/
git clone git://anonscm.debian.org/users/jak/website.git
copy over stuff to
email@example.com:~$ cp -a website/templates website/bootstrap.min.css website/local.css myiki/
rebuild the wiki as usual to activate
firstname.lastname@example.org:~$ ikiwiki -setup ~/myiki.setup rebuild -v
Adjustments can be made in
local.css, e.g. removing the
gives the default-width for the content.
The logo image at the very top can be adjusted in
See this boostrap-theme live at Jak Linux.
Theming 3: A theme using external (current) Bootstrap 3.2.0
Same reference as previous one. Homepage on GH: https://github.com/ramseydsilva/ikiwiki-bootstrap-theme
email@example.com:~$ git clone https://github.com/ramseydsilva/ikiwiki-bootstrap-theme.git
templatedir: /home/vagrant/ikiwiki-bootstrap-theme // ensure not theme is selected (e.g. actiontabs)
rebuild the wiki
*.tmpl to use local copies of bootstrap instead of fetching
it online each time.
Unfortunately this theme is not live.
The default (anti-) theme should at least be changed to the included
actiontabs to get a more decent look for the wiki. This works with the
out-of-the-box setup and thus has no impact on future updates.
The Bootstrap 3.2 theme provides an up-to-date look for Ikiwiki and offers the features of Bootstrap. It may require a bit of extra work and may need some tweaking in future versions of Ikiwiki (updating of the custom template files) though.