summaryrefslogtreecommitdiff
path: root/doc/plugins/theme.mdwn
blob: 2622abc885d0d3e94140a08747849965713931e3 (plain)

[[!template id=plugin name=theme author="[[Joey]]"]] [[!tag type/web]]

The theme plugin allows easily applying a theme to your wiki, by configuring the theme setting in the setup file with the name of a theme to use. The themes you can choose from are all subdirectories, typically inside /usr/share/ikiwiki/themes/.

A theme provides, via the underlay, an enhanced version of the regular [[style.css]]. This leaves [[local.css]] free for you to further customise. Themes can also provide header and background images.

You can set the theme via the theme option in your config file (after enabling the plugin). Refresh the wiki after changing it to see the changes.