summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
Diffstat (limited to 'doc')
-rw-r--r--doc/css.mdwn3
-rw-r--r--doc/css_market.mdwn3
-rw-r--r--doc/plugins/theme.pm11
3 files changed, 16 insertions, 1 deletions
diff --git a/doc/css.mdwn b/doc/css.mdwn
index 29a335596..35db57b0c 100644
--- a/doc/css.mdwn
+++ b/doc/css.mdwn
@@ -9,6 +9,9 @@ defining brand new rendering rules.
While ikiwiki's default use of stylesheets is intentionally quite plain and
minimalistic, CSS allows creating any kind of look you can dream up.
+The [[theme_plugin|plugins/theme]] provides some prepackaged themes in an
+easy to use way.
+
The [[css_market]] page is an attempt to collect user contributed local.css
files.
diff --git a/doc/css_market.mdwn b/doc/css_market.mdwn
index a0943547c..0e5a68740 100644
--- a/doc/css_market.mdwn
+++ b/doc/css_market.mdwn
@@ -5,7 +5,8 @@ these style sheets can be installed by copying them into your wiki's source
dir with a filename of `local.css`.
Feel free to add your own stylesheets here. (Upload as wiki pages; wiki
-gnomes will convert them to css files..)
+gnomes will convert them to css files..) Selected ones from here are
+included in the [[theme_plugin|plugins/theme]].
* **[[css_market/zack.css]]**, contributed by [[StefanoZacchiroli]],
customized mostly for *blogging purposes*, can be seen in action on
diff --git a/doc/plugins/theme.pm b/doc/plugins/theme.pm
new file mode 100644
index 000000000..7149cc163
--- /dev/null
+++ b/doc/plugins/theme.pm
@@ -0,0 +1,11 @@
+[[!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.