some hints for people building themes
authorhttps://id.koumbit.net/anarcat <https://id.koumbit.net/anarcat@web>
Fri, 16 Dec 2011 06:40:00 +0000 (02:40 -0400)
committeradmin <admin@branchable.com>
Fri, 16 Dec 2011 06:40:00 +0000 (02:40 -0400)
doc/plugins/theme.mdwn

index ebbb0be8e6473bfea363013972e4149aa8a90cdb..58ac9c5934420e9bfd309fdcb1bb81b6fd9c5f94 100644 (file)
@@ -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