ikiwiki/doc/css.mdwn

[[!meta title="CSS"]]

## Using CSS with ikiwiki

Ikiwiki comes with two CSS stylesheets: [[style.css]] and [[local.css]].
The idea is to customize the second one, overriding the first one and
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 [[css_market]] page is an attempt to collect user contributed local.css
files.

## Per-page CSS

The [[plugins/meta]] plugin can be used to add additional style sheets to a
page.

The [[plugins/localstyle]] plugin can be used to override the toplevel
[[local.css]] for a whole section of the wiki.
Migrate everything else via prefix_directives This is a partial commit of: egrep -rl '\[\[[a-z]+ ' doc \| xargs --max-args 1 ./ikiwiki-transition prefix_directives 2008-07-21 13:32:31 +02:00			`[[!meta title="CSS"]]`
web commit by JoshTriplett: meta title 2007-02-14 02:13:47 +01:00
update 2006-09-23 01:59:57 +02:00			`## Using CSS with ikiwiki`
web commit by StefanoZacchiroli 2006-09-22 16:46:25 +02:00
update 2006-09-23 02:04:19 +02:00			`Ikiwiki comes with two CSS stylesheets: [[style.css]] and [[local.css]].`
add a pointer to meta 2009-11-09 19:12:14 +01:00			`The idea is to customize the second one, overriding the first one and`
update 2006-09-23 02:04:19 +02:00			`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.`
web commit by StefanoZacchiroli 2006-09-22 16:46:25 +02:00
typo 2006-09-23 01:59:33 +02:00			`The [[css_market]] page is an attempt to collect user contributed local.css`
			`files.`
add a pointer to meta 2009-11-09 19:12:14 +01:00
			`## Per-page CSS`

			`The [[plugins/meta]] plugin can be used to add additional style sheets to a`
			`page.`
localstyle: New plugin, allows overrding the toplevel local.css with one that is closer to a page. I chose not to have it override style.css, because style.css is not really intended to be edited; the one from the underlay is intended to be used as a base that local.css overrides. I chose to use a plugin rather than changing the default behavior, both because I didn't want to have to worry about possibly breaking backwards compatability (though this seems unlikely), and because it seemed cleaner to not include style template parameters in the main page template code. I suppose someone might want a way to not override the toplevel local.css, but instead include it as well as foo/local.css. Probably the best way to do that would be to have foo/local.css @import ../local.css (modulo browser compatability issues). Alternatively, edit page.tmpl to always include the toplevel local.css, or swap out this plugin for another one. 2009-11-09 19:32:08 +01:00
			`The [[plugins/localstyle]] plugin can be used to override the toplevel`
			`[[local.css]] for a whole section of the wiki.`