doc/plugins/theme.mdwn

   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/`. See [[themes]] for an overview
   8 of the themes included in ikiwiki and the [[theme market]] for third party themes.
   9
  10 You can set the theme via the **theme** option in your config file (after
  11 enabling the plugin). Refresh the wiki (with `ikiwiki --setup <file>`)
  12 after changing it to see the changes.
  13
  14 Hints for theme builders
  15 ------------------------
  16
  17  * Start from an existing [[CSS file|css]], see also the [[css market]] for examples
  18  * You can override the [[templates]] files by dropping them in a `templates` subdirectory
  19  * Try to stick with modifying the CSS however, maintaining custom templates is harder