add theme plugin
[ikiwiki] / doc / plugins / theme.pm
1 [[!template id=plugin name=theme author="[[Joey]]"]]
2 [[!tag type/web]]
3
4 The theme plugin allows easily applying a theme to your wiki, by
5 configuring the `theme` setting in the setup file with the name of a theme
6 to use. The themes you can choose from are all subdirectories, typically
7 inside `/usr/share/ikiwiki/themes/`.
8
9 A theme provides, via the underlay, an enhanced version of the regular
10 [[style.css]]. This leaves [[local.css]] free for you to further
11 customise. Themes can also provide header and background images.