From: https://id.koumbit.net/anarcat Date: Fri, 16 Dec 2011 06:40:00 +0000 (-0400) Subject: some hints for people building themes X-Git-Url: https://sipb.mit.edu/gitweb.cgi/ikiwiki.git/commitdiff_plain/c43f5308ff5b27fd9174f880f50fa2eb5ff7d150 some hints for people building themes --- diff --git a/doc/plugins/theme.mdwn b/doc/plugins/theme.mdwn index ebbb0be8e..58ac9c593 100644 --- a/doc/plugins/theme.mdwn +++ b/doc/plugins/theme.mdwn @@ -9,3 +9,12 @@ of the themes included in ikiwiki. 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. + +Hints for theme builders +------------------------ + + * Start from an existing [[CSS file|css]], see also the [[css market]] for examples + * You can override the [[templates]] files by dropping them in a `templates` subdirectory + * Try to stick with modifying the CSS however, maintaining custom templates is harder + * If you *do* override a template, note that you will need to rebuild the wiki for it to be applied... + * ...it may therefore be preferable to load the template directly in your browser to develop it